Contributors: lupasearchteam Tags: woocommerce, search, product search, faceted search, instant search Requires at least: 5.0 Tested up to: 6.8 Stable tag: 1.0.0 License: MIT License URI: https://opensource.org/licenses/MIT
Supercharge your WooCommerce store's search with LupaSearch. Offer customers a fast, relevant, and intuitive product search experience.
LupaSearch is a powerful, AI-driven search solution designed to help your customers find exactly what they're looking for, quickly and easily.
Key Features:
- Lightning-Fast Search: Delivers search results instantly.
- AI-Powered Relevance: Understands user intent to provide the most relevant results.
- Typo Tolerance: Handles typos and misspellings gracefully.
- Synonyms & Autocomplete: Suggests relevant terms and completes queries as users type.
- Faceted Navigation: Allows users to filter search results by attributes, price, categories, and more.
- Customizable Search UI: Tailor the look and feel of your search results page.
- WooCommerce Integration: Works seamlessly with your products, categories, and attributes.
- Search Analytics: Gain insights into what your customers are searching for.
- Widget & Shortcode Support: Easily add the LupaSearch box to sidebars and other areas.
- Gutenberg Blocks: Dedicated blocks for adding a search box and displaying search results.
- 404 Page Enhancement: Replaces the default WordPress/WooCommerce search on 404 (Not Found) pages with the LupaSearch box for a better user experience.
- Download & Upload:
- Download the plugin ZIP file.
- Log in to your WordPress admin area.
- Navigate to Plugins > Add New.
- Click Upload Plugin and choose the downloaded ZIP file.
- Click Install Now.
- Activate:
- After installation, click Activate Plugin.
- Configure:
- Go to WooCommerce > LupaSearch in your WordPress admin menu.
- Enter your LupaSearch UI Plugin Key. You can find this in your LupaSearch dashboard.
- Configure other settings as needed, such as overriding the default WordPress search.
Q: How do I get a LupaSearch UI Plugin Key? A: You need to sign up for a LupaSearch account at lupasearch.com. Your UI Plugin Key will be available in your LupaSearch dashboard.
Q: How do I add the LupaSearch box to my theme's sidebar? A:
- Go to Appearance > Widgets.
- Find the "LupaSearch Box" widget.
- Drag and drop it into your desired sidebar or widget area.
- Optionally, give it a title.
Q: Can I use a shortcode to display the LupaSearch box?
A: Yes, while this plugin primarily focuses on automatic integration and widgets, the core LupaSearch functionality is initialized on a div with the ID searchBox. You can manually add <div id="searchBox"></div> to any page or post content where you want the search box to appear, provided the LupaSearch scripts are loaded on that page. The plugin ensures scripts are loaded globally if the LupaSearch integration is active.
Q: How does the 404 page search override work? A: If a user lands on a 404 (Not Found) page, this plugin will:
- Attempt to replace the theme's standard search form (if it uses
get_search_form()) with the LupaSearch box. - Hide the default WooCommerce product search widget if it's present on the 404 page. This provides a more helpful search experience directly on the 404 page, powered by LupaSearch.
Q: Are LupaSearch Gutenberg blocks available? A: Yes, the plugin includes two Gutenberg blocks: * LupaSearch Box: Adds a LupaSearch search input field. * LupaSearch Results: Designates an area for LupaSearch results to be displayed (typically used on a dedicated search results page).
Q: Where can I find more detailed documentation? A: For more detailed setup and customization options, please refer to the official LupaSearch documentation available on the LupaSearch website.
If you have cloned the plugin repository or are making code changes and need to generate a production-ready .zip file, follow these steps:
-
Prerequisites:
- Ensure you have Node.js and npm installed on your system.
-
Navigate to Plugin Directory: Open your terminal and navigate to the root directory of the plugin (e.g.,
cd path/to/lupasearch-wordpress). -
Install Dependencies: Run the following command to install the necessary development dependencies:
npm install
-
Build Assets: Compile and minify JavaScript and CSS assets for production:
npm run build
-
Create Plugin ZIP: Package the plugin into a distributable
.zipfile. This command will create a ZIP file in the plugin's root directory, ready for upload.npm run plugin-zip
The generated ZIP file will typically be named after the plugin's directory (e.g.,
lupasearch-wordpress.zip).
(Consider adding screenshots here if possible, e.g., LupaSearch admin settings, search box widget, search results page)
- LupaSearch Admin Configuration Page
- LupaSearch Box Widget in a Sidebar
- Example of LupaSearch Results Page
1.0.0 - YYYY-MM-DD
- Initial release.
- Integration with LupaSearch API.
- Override default WordPress search option.
- LupaSearch Box widget.
- LupaSearch Box and LupaSearch Results Gutenberg blocks.
- Enhanced 404 page search: Replaces default/WooCommerce search with LupaSearch box.
(Add more versions as they are released)
1.0.0 Initial release of the LupaSearch plugin for WooCommerce.