=== Seomedseb Smart Search for WooCommerce ===
Contributors: seomedseb
Tags: woocommerce, search, ajax search, autocomplete, product search
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 0.18.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern, fully customizable AJAX search & autocomplete plugin for WooCommerce. 100% free — no premium tier.

== Description ==

Seomedseb Smart Search for WooCommerce is a fast, self-hosted AJAX search plugin for WooCommerce stores, focused on two things:

1. **Deep, code-free design customization.** The Design tab exposes colors, typography, spacing, border radius, and several built-in style presets (minimal, command palette, glassmorphism, sharp, rounded) as CSS variables, with a live preview.
2. **A relevance engine with typo tolerance built in.** Search runs against a dedicated, optimized index table (not the slow default WordPress search), with fuzzy/SOUNDEX fallback matching so misspelled searches still find the right product.

Every feature in this plugin — including the search engine, the full Design tab, analytics, and the indexer — is free. There is no "Pro" upsell built into this version.

= Key features =

* Custom, optimized search index (own DB table, not `wp_posts` `LIKE` queries)
* AJAX autocomplete with grouped results: products, categories, tags, posts, pages
* Product detail panel on hover — add to cart without leaving the search results
* Typo-tolerant search (fuzzy/SOUNDEX fallback + "did you mean" suggestions)
* Synonyms, and exclude/include filter rules by category, tag, or product
* Full search-scope control (description, short description, SKU, attributes, categories, tags, custom fields)
* Deep design customization: colors, typography, spacing, radius, style presets, dark mode
* Animated ("typewriter") placeholder with a configurable phrase list and speed
* ⌘K / Ctrl+K global search shortcut
* Mobile overlay mode with configurable breakpoint
* Client-side "recent searches" history
* Search analytics: critical (zero-result) search phrases report + dashboard widget
* Scheduled + on-demand index rebuilding, with live progress in the admin

= Adding the search bar to your theme =

1. Shortcode: `[smart_search_bar]`
2. Widget: Appearance → Widgets → "Smart Search bar"
3. PHP: `<?php echo do_shortcode( '[smart_search_bar]' ); ?>`

== Installation ==

1. Upload the `seomedseb-smart-search` folder to `/wp-content/plugins/`, or install the zip via Plugins → Add New → Upload Plugin.
2. Activate the plugin. WooCommerce must already be installed and active.
3. The plugin will automatically build its search index in the background. Check progress under WooCommerce → Smart Search → Indexer.
4. Add `[smart_search_bar]` wherever you want the search bar to appear, or use the widget.

== Frequently Asked Questions ==

= Does this require WooCommerce? =
Yes, WooCommerce must be installed and active.

= Is this really free? =
Yes. Every feature described above is included at no cost. A future paid tier may exist someday, but it is a separate, later decision and does not affect this version.

= Does it work with variable products? =
Yes, and you choose how. Under Search config → Product variations you can show only the parent product (variation SKUs still match it), give each variation its own result row with its own price, stock and image, or list the matching variations underneath their parent.

== Screenshots ==

1. Live autocomplete results — grouped products, categories, tags and posts with the matched text highlighted.
2. The details panel: a full product preview (image, price, SKU, description, quick add-to-cart) shown next to the matching result.
3. The Design tab — colors, typography, spacing and style presets, with a live preview that updates as you edit.
4. Search Analytics — critical (zero-result) search phrases, so you can see what shoppers are looking for and not finding.

== Changelog ==

= 0.18.13 =
* Fixed: on iOS, tapping the search bar could pop up Safari's own "Autofill Contact" suggestion bar above the keyboard — Safari's contact-suggestion heuristic runs on a plain text field regardless of `autocomplete="off"`, but not on a native search field. The input is now `type="search"`, with its default browser styling (round background, built-in clear button) turned back off so nothing looks different, just no more contact-autofill prompt.

= 0.18.12 =
* Added: "Sale badge for any variant" (Search config tab). In "Parent product only" mode, the Sale badge relied on WooCommerce's own price display showing a struck-through price, which only happens when every variation shares one identical sale price — a jacket where just one size was discounted got no badge at all. Off by default (no change to existing behavior); turning it on checks every variation directly so the badge shows the moment any one of them is on sale. Doesn't affect out-of-stock/backorder badges.
* Fixed: the Indexer tab could report "index built successfully" with a lower product count than actually published — it treated any state other than "running" (including an interrupted run that never reached the end) as success. Now only a genuine full pass shows the success message; an incomplete one prompts to rebuild instead.
* Fixed: "indexed products" count included every stored row rather than distinct products — inflated in "Each variation as its own result"/"Grouped" modes, where a variation has its own row.

= 0.18.11 =
* Added: "Category image size" (Design tab) — category/tag thumbnails in the results dropdown were tied to a fixed 85% of "Product image size" with no way to change that ratio. Now an independent slider (50-100%), so a site can make category thumbnails closer to or further from the product thumbnail size without moving both together.

= 0.18.10 =
* Fixed: category thumbnails in the results dropdown rendered at 0.6x the product thumbnail size, hardcoded independently of the "Product image size" setting — next to a full-size product image and bold category name, that looked like a broken, near-illegible dot rather than a deliberately smaller icon. Now scales at 0.85x of the same setting, and its corner radius follows "Product image radius" instead of a fixed 4px.

= Earlier versions =
The full changelog back to the 0.1.0 initial release (0.18.9 through 0.1.0) is kept in `changelog-full.txt` in the plugin's own folder, and in the version history on this plugin's SVN repository — trimmed here so this section stays under WordPress.org's 5000-character display limit for the Changelog tab.
