=== WildRock ===
Contributors: wildrock
Tags: woocommerce, search, ai search, product search, analytics
Requires at least: 4.9
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 0.3.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI search that understands what shoppers mean, plus store analytics. One thin plugin; all the AI runs in the WildRock cloud.

== Description ==

WildRock adds an **AI-powered search** to your WooCommerce store that understands intent — not just keywords. Shoppers can type the way they talk ("a gift for a Goku fan", typos included) and find the right products. It also connects your store to **WildRock Insights** for real-time analytics (orders, carts, visits, conversion).

This is a **thin client**: the plugin only (1) syncs your catalog to the WildRock API and (2) injects the search widget on your site. All the AI, indexing and analytics run in the WildRock cloud — nothing heavy runs on your server, so your store stays fast.

**What you get**

* Semantic AI search: intent, synonyms and typo tolerance.
* Embeddable search widget (compact or full-screen), customizable color and logo — no code.
* Storefront, sale badges and merchandising controls from a dashboard.
* GEO: product feeds, sitemaps and llms.txt to improve visibility in AI answers.
* WildRock Insights: real-time store analytics on the same account.

**How it works**

1. Create a free account and get your two API keys at https://app.wildrock.io
2. Install this plugin, paste your keys and press *Sync*.
3. The search widget appears on your store; analytics start flowing.

A WildRock account is required (free tier available). See pricing at https://wildrock.io

== External services ==

This plugin connects to the **WildRock** cloud service to provide search and analytics. It is required for the plugin to work.

What is sent, and when:

* **Catalog sync** — when you press *Sync* (and automatically when products change), your product data (title, description, price, stock, images, categories) is sent to `https://app.wildrock.io/api/ingest` so it can be indexed for search.
* **Search** — the search widget on your storefront sends shopper queries to `https://app.wildrock.io/api/search` to return results. Queries are stored anonymized for your own search analytics.
* **Analytics (optional)** — if enabled, order, cart and visit events are sent to `https://insights.wildrock.io/api/helper/ingest` to power WildRock Insights.

The service is provided by WildRock.
Terms of Service: https://wildrock.io/terminos
Privacy Policy: https://wildrock.io/privacidad

== Installation ==

1. In your WordPress admin: Plugins → Add New → Upload Plugin, choose the WildRock zip, Install and Activate.
2. Create your account and copy your keys at https://app.wildrock.io
3. Go to Settings → WildRock, paste your API URL and keys, and press *Sync now*.
4. Done — the AI search appears on your store and syncs automatically from then on.

== Frequently Asked Questions ==

= Do I need to know how to code? =
No. Install the plugin, paste two keys and press a button.

= Does it slow down my store? =
No. The plugin is light and all the intelligence runs in the WildRock cloud; your store only sends its catalog.

= Is a paid account required? =
A WildRock account is required, and there is a free tier. Paid plans unlock more products and WildRock Insights. See https://wildrock.io

= What data is sent to WildRock? =
Your product catalog (for indexing), shopper search queries (anonymized), and — only if you enable analytics — order/cart/visit events. See the "External services" section.

== Screenshots ==

1. AI search widget on the storefront (full-screen layout with filters).
2. Compact search box embedded in the theme header.
3. Settings screen: paste your keys and sync — no code.
4. WildRock Insights: real-time store analytics on the same account.

== Changelog ==

= 0.3.9 =
* Compliance with the WordPress.org plugin checks: removed heredoc syntax, aligned plugin name and text domain, and sanitized plain-text output.

= 0.3.8 =
* AI visibility (GEO): your store now publishes its own llms.txt at yourdomain.com/llms.txt, so AI assistants (ChatGPT, Perplexity, Gemini) can discover your catalog. Cached 12h, updates itself.

= 0.3.7 =
* Fix: cart values were sent as 0 € (WooCommerce hadn't calculated totals yet when the cart was tracked). Amounts are now computed from the displayed product price, so abandoned-cart values are correct in WildRock Insights.

= 0.3.6 =
* Sales attribution: orders that started with a search are now credited to the search engine, so your dashboard shows the revenue WildRock generated. Anonymous (no personal data).

= 0.3.5 =
* Prices are now synced as displayed in your store (tax included if your shop shows tax-inclusive prices), so search results match the product page. Re-sync your catalog after updating.

= 0.3.4 =
* New "Search size" setting: full-screen (recommended, with left filters and product grid) or compact window. Default: full-screen.

= 0.3.3 =
* The plugin now updates itself from wp-admin (standard "Update" button / auto-updates) — no more manual zip uploads.

= 0.3.2 =
* Fix: the search widget now appears on sites using WP Rocket / Autoptimize "Delay JavaScript" (the boot no longer depends on the window load event, and it retries while the delayed widget script arrives).

= 0.3.1 =
* Catalog sync now runs in batches with a live progress bar ("Syncing… 1,200 / 5,342 products") instead of a silent spinner, and can't time out on large catalogs.

= 0.3.0 =
* Easy placement without touching your theme: floating button, "replace my theme's search", or manual via the "WildRock Search" block / [wildrock] shortcode.

= 0.2.0 =
* Unified plugin: AI search + WildRock Insights analytics in one install.
* Full-screen search layout with left filters; "Surprise me" and popular searches.
* Sale badge on product images; category/series filters.

= 0.1.0 =
* Initial release: catalog sync and embeddable AI search widget.

== Upgrade Notice ==

= 0.3.5 =
Search prices now match your storefront (tax-inclusive display). Press "Sync now" after updating so indexed prices refresh.

= 0.3.2 =
Fixes the widget not appearing on stores with WP Rocket/Autoptimize "Delay JS". Update recommended.

= 0.3.1 =
Catalog sync now shows a live progress bar and won't time out on large catalogs.

= 0.3.0 =
Adds easy placement (floating button, replace theme search, block/shortcode). Pick one in Settings → WildRock.

= 0.2.0 =
Adds analytics and the full-screen search layout. Re-sync your catalog after updating.
