FlyUpSpace AI Chat Assistant

Description

FlyUpSpace AI Chat Assistant adds a floating AI chat widget to your site. It is designed to answer from your own WordPress content and WooCommerce catalog instead of relying only on a static prompt.

When a visitor sends a message, the plugin can analyze the question, generate compact search queries, retrieve relevant local site content, build a temporary context, and send that context to the selected AI provider for a grounded answer.

Features:
– Floating assistant launcher with chat panel UI
– Provider switcher: Google Gemini, OpenAI, Anthropic, or DeepSeek
– Separate API key fields per provider
– AI-assisted query planning for routing questions to products or site content
– Site-aware retrieval from WordPress posts, pages, public custom post types, WooCommerce products, taxonomies, and cleaned meta fields
– Support for content stored by builders such as Elementor when available in post content or post meta
– WooCommerce product answers with compact product cards and product links
– Token-conscious temporary context building instead of sending the full site catalog
– Browser-side chat history restoration after page reloads and navigation
– Configurable assistant title and greeting
– One global system prompt for AI behavior
– Optional short-term conversation memory for better follow-up answers
– Built-in appearance controls for launcher position, size, border, and pulse effect
– Server-side AJAX requests with nonce verification
– No API keys exposed in frontend JavaScript
– Plugin interface language can be selected independently from the site language

The custom prompt in settings is used as additional behavior/tone guidance. Factual answers are intended to come from the retrieved site context.

No tracking/analytics code is included.

How Site-Aware Answers Work

For each chat request, the plugin follows a retrieval-first flow:

  1. Analyze the visitor question and decide whether it is mainly about WooCommerce products or site information.
  2. Generate short search queries and important terms, including typo-tolerant and multilingual variants where possible.
  3. Search local WordPress data such as posts, pages, public custom post types, WooCommerce products, categories, tags, attributes, and non-technical meta fields.
  4. Clean retrieved content to remove builder/design metadata, CSS-like fragments, scripts, and layout settings where possible.
  5. Build a compact temporary context from the most relevant matches.
  6. Send the visitor message, configured prompt, compact context, and optional short-term conversation memory to the selected AI provider.

The plugin does not send the full product catalog or full website database to the AI provider.

External Services

This plugin can connect to third-party AI APIs, but only after an administrator configures an API key and a visitor/admin sends a message in the chat.

Services used:

  1. Google Gemini API

– Service: Google Generative Language API
– Endpoint: https://generativelanguage.googleapis.com/
– Terms: https://ai.google.dev/terms
– Privacy: https://policies.google.com/privacy

  1. OpenAI API

– Service: OpenAI Chat Completions API
– Endpoint: https://api.openai.com/v1/chat/completions
– Terms: https://openai.com/policies/terms-of-use
– Privacy: https://openai.com/policies/privacy-policy

  1. Anthropic API

– Service: Anthropic Messages API
– Endpoint: https://api.anthropic.com/v1/messages
– Terms: https://www.anthropic.com/legal/consumer-terms
– Privacy: https://www.anthropic.com/legal/privacy

  1. DeepSeek API

– Service: DeepSeek Chat Completions API
– Endpoint: https://api.deepseek.com/chat/completions
– Terms: https://platform.deepseek.com/downloads/DeepSeek%20Open%20Platform%20Terms%20of%20Service.html
– Privacy: https://platform.deepseek.com/downloads/DeepSeek%20Open%20Platform%20Privacy%20Policy.html

When sending a chat request, the plugin may use the selected AI provider to help plan compact search queries. The plugin then searches local WordPress content for relevant facts and transmits the user message, configured system prompt, temporary relevant site context, and if enabled a short recent conversation context, to the selected provider.
No request is sent to any third-party API until the site administrator adds an API key and a chat message is submitted.

Privacy

  • The plugin does not include analytics, ad tracking, or remote asset loading.
  • API keys are stored in WordPress options and used only for server-side requests.
  • Chat requests are sent only to the provider selected by the site administrator.
  • Relevant snippets from site content and WooCommerce product data may be included in AI requests as temporary context for answering the visitor question.
  • The plugin uses retrieved context only for the current answer and does not create a persistent external vector database.
  • Visible chat messages and product result cards may be stored in the visitor browser local storage so the chat can be restored after page reloads or navigation.
  • Optional short-term conversation context is sent only with the current request from the visitor browser when enabled; the plugin does not create public server-side chat memory transients.

Installation

  1. Upload the flyupspace-ai-chat-assistant folder to /wp-content/plugins/.
  2. Activate the plugin in WordPress admin.
  3. Open Settings -> FlyUpSpace AI Chat Assistant.
  4. Select an AI provider, add its API key, and save.
  5. Optionally customize the greeting, prompt, and launcher appearance.

FAQ

Where can I move the button?

Use the launcher position and offset controls in plugin settings.

Is API key public on frontend?

No. API keys are stored in WordPress options and used only server-side.

Can I change the first greeting message?

Yes. Open Settings -> FlyUpSpace AI Chat Assistant and edit Assistant Greeting.

Can I change the input placeholder text?

Yes. Open Settings -> FlyUpSpace AI Chat Assistant and edit Input Placeholder.

Can I adjust the widget appearance?

Yes. The settings page includes form controls for the launcher icon, device-specific position, size, border, and pulse effect.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“FlyUpSpace AI Chat Assistant” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.7

  • Reworked public chat throttling to avoid request-header-derived transient keys.
  • Replaced per-visitor rate limit and cooldown transients with a single bounded throttle state transient that prunes expired entries.
  • Continued using direct AI provider configuration while keeping the WordPress AI Client recommendation under review for a future version.

1.0.6

  • Removed public server-side transient storage for AI query plans and chat memory state.
  • Updated the main plugin class name to use a more unique plugin-specific prefix.
  • Refined WooCommerce product retrieval and numeric product ranking while keeping AI context compact.
  • Updated privacy documentation to reflect browser-side short conversation context handling.

1.0.5

  • Renamed the plugin to FlyUpSpace AI Chat Assistant and aligned the plugin slug, text domain, file names, prefixes, assets, and translation files for WordPress.org review.
  • Updated the main plugin class prefix and removed public server-side transient storage for chat memory and AI query plans.
  • Improved localized defaults so the assistant title, greeting, and input placeholder follow the selected plugin/site language when they still contain built-in default text.
  • Improved WooCommerce product discovery for broad catalog questions, short product attributes, brands, sizes, abbreviations, and SKU-like terms, so the assistant can show several relevant products and a full matching-products link instead of narrowing too aggressively.
  • Improved broad category-style WooCommerce questions so the assistant links to the matching catalog category, tag, or attribute archive instead of showing a small arbitrary product subset.
  • Added local greeting replies, strict site-only knowledge mode, source URLs in RAG context, relevant source excerpts, and real WooCommerce price/stock constraint filtering for higher answer accuracy.
  • Added smart WooCommerce product answer scenarios for catalog overview, category browsing, recommendations, comparisons, price/stock checks, and specific product lookups.
  • Added lightweight chunk ranking so the assistant sends the most relevant product/page blocks, such as price, stock, attributes, descriptions, categories, FAQ-like content, and policy details, instead of one noisy page excerpt.

1.0.4

  • Added site-aware retrieval for posts, pages, public custom post types, WooCommerce products, taxonomies, attributes, and cleaned builder meta fields.
  • Added WooCommerce product cards, exact matching-products result pages, and stricter product relevance filtering.
  • Added browser-side chat history, short-term conversation memory, clear-chat controls, and safe rich formatting for assistant answers.
  • Improved multilingual query planning, typo-tolerant search, contact/about page retrieval, and grounded no-hallucination instructions.
  • Cleaned code, prefixes, documentation, and Plugin Check compatibility for WordPress.org review.

1.0.3

  • Renamed the plugin and aligned metadata for review.
  • Added configurable assistant greeting in plugin settings.
  • Moved admin UI assets to dedicated files for cleaner code and review readiness.
  • Improved sanitization and localization handling.
  • Added language files and improved plugin translation loading.
  • Improved admin settings UX and launcher appearance controls.
  • Added uninstall cleanup.
  • Expanded plugin documentation and external services disclosure.

1.0.0

  • Initial public release.