外掛說明
Aknex Fast Product Search replaces the default WooCommerce product search with a lightning-fast, search-as-you-type widget backed by its own denormalized MySQL index. Because search queries run against a single flat index table instead of wp_posts and wp_postmeta, results are returned in milliseconds even on shared hosting with 100,000+ products.
Premium Turbo edition
A separately licensed Turbo edition includes:
- SHORTINIT direct search — uses a lightweight endpoint when supported by the host, with the WordPress REST API as a fallback.
- License management — activate and validate an Aknex license for the Turbo site.
- Automatic updates — receive Turbo releases through the WordPress plugin updater while the license is valid.
An active Aknex license is required. Learn about Turbo.
Key features:
- Variation-aware — variations are indexed as individual rows. Choose between three result modes per widget instance: parents only, all variations as standalone results, or variations collapsed under their parent.
- Field-scoped search — restrict search to any combination of title, SKU, categories, tags, and attributes using a simple shortcode parameter.
- Configurable index fields — choose which product data (SKU, categories, tags, attributes, short description) is included in the full-text index via the admin settings page.
- REST transport — search requests run through a dedicated WordPress REST API route for compatibility with WordPress.org requirements.
- Gutenberg block + shortcode — embed the search widget anywhere. An optional filter automatically replaces the default WooCommerce search form site-wide.
- Smart indexing — full rebuild runs as a chunked, resumable background job using Action Scheduler (bundled with WooCommerce). Incremental updates are queued automatically on product save, stock change, and deletion. A nightly reconciliation job keeps the index consistent.
- Micro-cache — a short-lived database cache layer prevents redundant queries for popular search terms under high traffic.
- Rate limiting — configurable per-IP request throttling protects the search endpoint.
- WP-CLI support —
wp fastsearch rebuild,wp fastsearch status, andwp fastsearch flushcommands for DevOps workflows. - HPOS compatible — fully compatible with WooCommerce High-Performance Order Storage.
- Multisite ready — one index table per site via
$wpdb->prefix.
Shortcode usage:
[fastsearch]
Optional attributes:
placeholder— input placeholder textmode—parents(default),all, orcollapsefields— comma-separated:title,sku,categories,tags,attributes, orall(default)cat— restrict results to a category IDlimit— number of results (1–50, default 10)
Example: [fastsearch mode="collapse" fields="title,sku" limit="8"]
Requirements:
- WordPress 6.2 or later
- WooCommerce 8.0 or later
- PHP 7.4 or later
- MySQL 5.7+ or MariaDB 10.3+ with InnoDB and FULLTEXT support
If FULLTEXT indexing is unavailable on your host, the plugin automatically falls back to prefix-LIKE mode with a notice in the admin dashboard.
適用於區塊編輯器
這個外掛提供 1 個可供區塊編輯器使用的區塊。
- FastSearch Fast WooCommerce live search widget.
安裝方式
- Upload the
aknex-fast-product-searchfolder to the/wp-content/plugins/directory, or install through the WordPress plugin screen directly. - Activate the plugin through the Plugins screen in WordPress.
- Navigate to WooCommerce > FastSearch to configure settings.
- Click Rebuild index to build the initial product index.
- Add
[fastsearch]to any page or widget area, or enable Replace WooCommerce search form in settings to replace the theme’s search form automatically.
Recommended after installation:
- After changing any Index fields settings, click Rebuild index to apply the changes.
常見問題集
-
Does this plugin require WooCommerce?
-
Yes. Aknex Fast Product Search is a WooCommerce extension and will not activate without WooCommerce installed and active.
-
Will it work with variable products and variations?
-
Yes. Variable products and their variations are indexed individually, giving you precise control over how variations appear in results via the
modeshortcode attribute. -
What happens if my server does not support FULLTEXT indexing?
-
The plugin detects this at activation and falls back to prefix-LIKE search mode automatically. You will see a notice in the admin dashboard. Search still works correctly in LIKE mode; you lose mid-word matching for longer tokens.
-
Does the plugin add load to my database on every search?
-
Queries run against the plugin’s own index table — a single flat, indexed table. The search path never touches
wp_postsorwp_postmeta. Combined with the built-in micro-cache, repeated popular queries are served from a cache table with zero query overhead. -
How do I keep the index up to date?
-
The index is updated automatically when products are saved, their stock status changes, or they are deleted. A nightly reconciliation job also runs to catch any missed changes. You can trigger a full rebuild at any time from the settings page or via WP-CLI (
wp fastsearch rebuild). -
Is the plugin multisite compatible?
-
Yes. Each site in a multisite network gets its own index table via WordPress’s
$wpdb->prefix. -
What data is stored, and is any data sent externally?
-
The plugin stores a denormalized copy of your product data (title, SKU, categories, tags, attributes, price, stock status, image URL, product URL) in a local database table. No data is sent to any external service. All processing happens on your own server.
-
How do I remove all plugin data on uninstall?
-
Enable Delete all data on uninstall in the plugin settings before deactivating and deleting the plugin. When enabled, all index tables and plugin options are removed on uninstall.
-
Can I use multiple search widgets on one page?
-
Yes. Each
[fastsearch]shortcode instance is independent and can be configured with different parameters.
使用者評論
參與者及開發者
變更記錄
1.0.0
- Initial release.