=== partyks Search Connector for Bonsai ===
Contributors: partyks
Tags: search, bonsai, woocommerce, instant search, autocomplete
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.4.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced WordPress search powered by Bonsai.io. WooCommerce-ready with fuzzy matching, autosuggestions, and instant results.

== Description ==

**partyks Search Connector for Bonsai** replaces the default WordPress search with a fast, intelligent full-text search engine powered by [Bonsai.io](https://bonsai.io) — which offers a **free plan** for up to 10,000 documents.

= Key Features =

* Instant results as the user types
* Fuzzy search — tolerates typos automatically
* Intent-based sections — products from matching category shown first
* Search analytics — track what users search for
* Synonyms — teach the search engine your customers language
* Custom mappings — pin specific pages for exact phrases
* Full UI customization — colors, presets, placeholder animation
* WooCommerce ready — price, SKU, stock status, categories
* Multilingual — per-language search analyzers
* Local mode — works without Bonsai.io for testing

== Installation ==

1. Upload the plugin to `/wp-content/plugins/`
2. Activate through the Plugins menu
3. Go to **Search via Bonsai** in admin menu
4. Enter your Bonsai.io cluster URL
5. Click **Sync Now** to index content
6. Add `[partyks_sc_bonsai_search]` shortcode to any page

== Frequently Asked Questions ==

= Do I need a Bonsai.io account? =

Yes, a free Bonsai.io account is required for full functionality. The free plan supports up to 10,000 documents which is enough for most WooCommerce stores. A local MySQL mode is also available for testing.

= Is my data safe? =

Search queries are sent to your own Bonsai.io cluster. No data is sent to the plugin author's servers.

= What shortcode should I use? =

Use `[partyks_sc_bonsai_search]` to embed the search form on any page or post.

== External Services ==

This plugin connects to **Bonsai.io** (https://bonsai.io), a managed full-text search service, to perform search queries and sync your WordPress content.

**What data is sent:**
* Search queries typed by site visitors (sent to your own Bonsai.io cluster — not to the plugin author)
* Post content, titles, and metadata during indexing (sent directly from your server to your Bonsai.io cluster)
* No personally identifiable information is collected by the plugin author

**When data is sent:**
* On every search request by a site visitor
* When the admin triggers a content sync (Sync Now)
* Automatically in background batch jobs when content is published or updated

**Third-party service information:**
* Service: Bonsai.io — https://bonsai.io
* Terms of Service: https://bonsai.io/terms
* Privacy Policy: https://bonsai.io/privacy

You must have your own Bonsai.io account and cluster. All search data is stored in your own cluster — the plugin author has no access to it.

=== Cloudflare Workers KV (optional) ===

This plugin can optionally sync your search configuration (synonyms, field mappings, boosting settings) to **Cloudflare Workers KV** — a globally distributed key-value store. This is used to deliver real-time search configuration updates to a Cloudflare Worker proxy, reducing latency for search queries.

**This feature is entirely optional** and only activates if you provide your own Cloudflare account credentials (Account ID, Namespace ID, API Token) in the plugin settings.

**What data is sent:**
* Search configuration data: synonym lists, field mappings, and boost settings
* No user data or personally identifiable information is ever sent to Cloudflare KV through this plugin
* Data is sent only to your own Cloudflare KV namespace — not to the plugin author

**When data is sent:**
* Only when an admin clicks "Push to KV" or when configuration is saved and auto-push is enabled
* Never sent automatically without admin action or explicit configuration

**Third-party service information:**
* Service: Cloudflare Workers KV — https://developers.cloudflare.com/kv/
* Cloudflare Terms of Service: https://www.cloudflare.com/terms/
* Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/



== Screenshots ==

1. Admin panel — Connection tab with search engine selector
2. Search results with category sections and thumbnails
3. Analytics tab — query statistics with zero-result detection
4. Appearance tab — full color customization with presets

== Changelog ==

= 1.4.3 =
* Multilingual index architecture
* Intent-based result sections
* Improved ACF/custom meta field support
* Full internationalization (English + Polish)

= 1.4.0 =
* Analytics, CTR tracking, REST API endpoints

= 1.2.0 =
* WooCommerce support, category sections, instant search

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.4.3 =
Multilingual architecture change requires reindexing after upgrade.
