=== Ask Roux ===
Contributors: perrylabs
Donate link: https://askroux.com
Tags: search, ai, artificial intelligence, ai search, site search, chatbot
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Enable floating chat, replace default search results, and guide visitors out of dead-end 404 pages from one streamlined settings screen.

== Description ==

Ask Roux adds an intelligent, AI-powered search widget to your WordPress site. The widget is a fully-featured Web Component (`<ai-search>`) that handles SSE streaming, conversation history, tabbed Sources/Tools, floating chat bubble, markdown rendering, citations, and tool use.

**Features:**

* Floating chat bubble mode for site-wide AI search
* Inline widget via shortcode
* Replace WordPress search results with AI-powered search
* 404 page recovery with AI search
* Admin dashboard with search analytics and crawl status
* Light and dark theme modes
* Suggested queries support
* Easy configuration with API key

**How It Works:**

1. Sign up at [askroux.com](https://askroux.com) to get your API key
2. Install the plugin and enter your API key in Settings
3. Enable the features you want (floating chat, search replacement, 404 recovery)
4. Your site visitors now have AI-powered search

== Installation ==

1. Upload the `ask-roux` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > Ask Roux
4. Enter your API key
5. Optionally enter your Admin API Token for dashboard analytics
6. Test the connection and configure widget settings

== Frequently Asked Questions ==

= Where do I get an API key? =

Visit [askroux.com](https://askroux.com) to sign up and get your API key.

= What widget modes are available? =

* **Floating Chat Bubble** - Adds a floating chat bubble to every page (bottom-right)
* **Inline (via Shortcode)** - Use `[ai_search]` to embed the widget inline
* **Replace WordPress Search** - Replaces the search results page with the AI search widget
* **404 Recovery** - Shows AI search on 404 pages to help visitors find what they need

= Can I customize the appearance? =

Yes. Choose Light or Dark theme, set custom placeholder text, a title, and suggested queries.

= What shortcode attributes are available? =

The `[ai_search]` shortcode supports: `placeholder`, `theme`, `title`, `mode`, and `suggestions`.

== Screenshots ==

1. Settings page with connection status
2. Dashboard with analytics cards and crawl status
3. AI search widget in floating chat bubble mode

== Changelog ==

= 2.1.0 =
* Rebranded from PerryLabs AI Search to Ask Roux
* Consolidated Settings and Dashboard into a single tabbed admin page under Settings > Ask Roux
* Fixed header placement so WordPress admin notices appear above the branded header
* Widget branding now shows "Powered by Ask Roux" by default
* Added 404 page recovery feature
* Fixed 404 template crash

= 2.0.0 =
* Major refactor: uses the platform <ai-search> Web Component for all frontend UI
* Separated API key (for widget) from Admin API Token (for dashboard)
* Added widget suggestions setting (pipe-separated)
* New widget modes: float, inline, replace_search, shortcode, disabled
* Shortcode changed from [perrylabs_search] to [ai_search]
* Script tag now uses type="module" for web component loading

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 2.1.0 =
Rebranded to Ask Roux. Admin page moved to Settings > Ask Roux with tabbed layout. Update your bookmarks.
