Plattio Search

Description

Plattio Search helps WooCommerce customers find products faster without adding a heavy search platform to your store.

Display the search as a compact icon that opens a slide-out field, or as a permanently visible search bar. Results update while the customer types and may include product images, prices, quantity controls and direct add-to-cart actions.

The plugin also includes a lightweight zero-result search report. Store owners can see which searches returned no products, identify missing products or common synonyms, mark opportunities as resolved and export the filtered report as CSV.

Live WooCommerce product search

  • Fast live results with product image, title and price.
  • Multiple matching methods for SKU, product title, category and fuzzy fallback matching.
  • Two display modes: compact search icon or visible search bar.
  • Direct cart actions for simple purchasable products.
  • Quantity controls when direct add-to-cart is enabled.
  • Variable product handling: products requiring options open their product page.
  • Body-level result portal to prevent clipping inside sticky headers, builders and overflow containers.
  • Keyboard navigation and an accessible live-result region.

Search suggestions

  • Select existing WooCommerce categories and products as manual suggestions.
  • Optionally show popular searches to new visitors and recently used searches to returning visitors.
  • Suggestions remain hidden until the customer clicks or taps inside the search field.
  • Programmatic focus, animations, resizing and unrelated page interactions do not open the result panel.

Zero-result search report

The report is available under WooCommerce > Settings > Plattio Search > Statistics.

  • See search phrases that returned no products.
  • View total searches, language, first seen and last seen dates.
  • Filter by 7, 30 or 90 days, or view all stored data.
  • Filter open and resolved merchandising opportunities.
  • Mark phrases as resolved or reopen them later.
  • Delete individual phrases or clear all zero-result data.
  • Export the active filtered report as a UTF-8 CSV file.
  • Exclude store administrators from tracking by default.

The reporting system is intentionally lightweight. It uses one local aggregated table, no external analytics service, no background cron jobs and no charting framework.

International and RTL ready

Plattio Search includes translations for 32 WordPress locales. Arabic, Hebrew, Persian and Urdu include RTL support, and the frontend and administration screens follow WordPress’ active text direction.

Designed for WordPress and WooCommerce

  • Uses WordPress and WooCommerce APIs.
  • Declares WooCommerce HPOS compatibility.
  • Loads frontend assets only when required.
  • Loads administration assets only on Plattio Search settings screens.
  • Uses capability checks, nonces, sanitization and escaped output.
  • Supports WordPress multisite installation and cleanup.

Shortcode

Use the basic shortcode:

[plattio_search]

Visible search bar:

[plattio_search display="bar" placeholder="Search products or SKU..." width="520px" limit="6"]

Compact search icon:

[plattio_search display="icon" placeholder="Search products or SKU..." width="520px" icon_color="#000000" icon_hover_color="#0e3f3f" primary_color="#0e3f3f" icon_size="25px" button_size="38px" height="44px" border_radius="10px" close_button="yes" limit="6"]

Search with direct add-to-cart:

[plattio_search display="bar" placeholder="Search products..." add_to_cart="yes" add_button_text="Add" options_button_text="Choose options" limit="6"]

Available attributes

  • displayicon or bar.
  • placeholder – Search-field placeholder text.
  • width – Maximum field and result-panel width.
  • height – Search-field height.
  • button_size – Search-button size.
  • icon_size – Search-icon size.
  • border_radius or radius – Field and panel corner radius.
  • icon_color – Default search-icon color.
  • icon_hover_color – Search-icon hover color.
  • close_color – Close-button color.
  • close_hover_color – Close-button hover color.
  • primary_color – Primary accent color for one shortcode instance.
  • close_buttonyes or no.
  • limit – Number of live products, from 1 to 10.
  • add_to_cartyes or no.
  • add_button_text – Button text for simple products.
  • options_button_text – Button text for products requiring options.
  • post_type – Retained for shortcode compatibility; live results remain limited to WooCommerce products.

The built-in shortcode generator hides options that do not apply to the selected display mode.

Privacy

When zero-result tracking is enabled, Plattio Search stores only:

  • The normalized search phrase.
  • The active site language.
  • An aggregated search count.
  • The first-seen time.
  • The last-seen time.
  • The open or resolved report status.

The zero-result report does not store raw IP addresses, WordPress user IDs or tracking cookies, and it does not send analytics data to an external service.

Duplicate suppression is kept in memory while the page is open and does not write the search phrase to browser storage. Public AJAX endpoints use a temporary one-way request hash for abuse prevention.

Store administrators can disable zero-result tracking, exclude users who can manage WooCommerce, export the report, delete individual entries or remove all stored report data. Suggested text is also added to the WordPress Privacy Policy Guide.

Support

For help with installation, configuration or troubleshooting:

  • Use the WordPress.org support forum for Plattio Search.
  • Email support@plattio.no.
  • Documentation: https://plattio.no/docs/?pkb_product=plattio-search

When requesting support, include your WordPress version, WooCommerce version, Plattio Search version, active theme, shortcode and a clear description of the issue.

Installation

  1. In WordPress, go to Plugins > Add New Plugin > Upload Plugin.
  2. Upload the Plattio Search ZIP file and activate it.
  3. Make sure WooCommerce is installed and active.
  4. Add [plattio_search] to a page, widget, block, header builder or template.
  5. Configure defaults under WooCommerce > Settings > Plattio Search.

FAQ

How do I add Plattio Search to my store?

Add [plattio_search] to any shortcode-compatible location, including pages, widgets, blocks, header builders and theme templates. Use display="bar" for a permanently visible field or display="icon" for a compact search button.

Why do suggestions appear only after clicking inside the search field?

This is intentional. Suggestions and live results are shown only after the customer directly interacts with the input field. Opening the icon, programmatic focus, CSS transitions, scrolling, resizing or other page interactions do not reveal the panel.

Keyboard users can focus the field and begin typing to activate the results.

What does the zero-result report track?

It records completed searches that returned no WooCommerce products. Equal normalized phrases are aggregated so store owners can identify missing products, alternative wording, common spelling mistakes and useful synonyms.

Where can I find the zero-result report?

Go to WooCommerce > Settings > Plattio Search > Statistics. The report includes filters, open and resolved statuses, merchant actions and CSV export.

Does the zero-result report collect personal data?

The analytics table does not store raw IP addresses, WordPress user IDs or tracking cookies. It stores only the normalized phrase, language, aggregate count, timestamps and report status in the local WordPress database.

Does the CSV button export the selected report?

Yes. Export CSV downloads the report using the active period and status filters. The file includes a summary and all matching rows, uses UTF-8 for spreadsheet compatibility and protects against spreadsheet formula injection.

Can I disable zero-result tracking?

Yes. The feature can be disabled in the Plattio Search settings. Store administrators are excluded by default, and stored entries can be deleted individually or cleared completely.

Can customers add products directly from the search results?

Yes, for simple products that are purchasable and in stock. Enable add_to_cart="yes". Products requiring variations or other options link to the product page instead.

Does Plattio Search support product SKUs?

Yes. The search can match WooCommerce product SKUs as well as product titles and categories. SKU matches are prioritized where appropriate.

Does it work inside sticky headers and page builders?

Yes. Results are rendered in a body-level portal so they are not clipped by header containers, builder wrappers or elements using overflow: hidden.

Does it support WooCommerce HPOS?

Yes. Plattio Search does not read or write WooCommerce order tables and declares compatibility with High-Performance Order Storage.

Does it support multilingual and RTL websites?

Yes. The plugin includes 32 locale packages and supports RTL layouts in both the frontend and WooCommerce administration screens.

Why are no products appearing in the results?

Check that WooCommerce is active, products are published and visible in the catalog, and the search phrase meets the minimum length. Also confirm that caching, optimization or security tools are not blocking WordPress AJAX requests.

Does the plugin replace the standard WordPress search?

No. Plattio Search is added through its shortcode and focuses specifically on live WooCommerce product discovery. It does not modify the standard WordPress search template or search URL globally.

Will the plugin slow down my store?

The plugin is designed to remain lightweight. It loads its frontend assets only when a Plattio Search instance is present, limits result counts, caches eligible search responses and uses an aggregated local table instead of a raw analytics event log.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Plattio Search” is open source software. The following people have contributed to this plugin.

Contributors

“Plattio Search” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Plattio Search” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.1

  • Updated the plugin version and WordPress.org stable tag.
  • Reworked readme.txt to provide a clearer WordPress.org plugin page.
  • Expanded installation, shortcode, privacy and feature documentation.
  • Added a comprehensive WordPress.org FAQ.
  • Added support@plattio.no as the support email.
  • No functional search or analytics behavior was changed in this release.

1.3.0

  • Added lightweight, local tracking for completed product searches that return zero results.
  • Added an indexed aggregate table created with WordPress dbDelta() and a database-version upgrade check.
  • Added filters for 7, 30, 90 days or all time, open/resolved status, CSV export and merchant actions to resolve, reopen, delete or clear records.
  • Added privacy controls, administrator exclusion, page-level duplicate suppression and WordPress Privacy Policy Guide text.
  • The zero-result analytics table stores no raw IP address, user ID or tracking cookie and makes no external analytics request.
  • Prevented the live-result and suggestion panel from appearing before direct interaction with the search input.
  • Removed automatic suggestion fetching caused by icon opening, programmatic focus, transition events and unrelated page interactions.
  • Added request-generation checks so delayed or aborted AJAX responses cannot reopen a closed result panel.
  • Preserved keyboard accessibility by activating live results when a focused input receives typed content.
  • Replaced the invalid listbox/option structure with an accessible polite live-result region and busy-state announcements.
  • Moved WooCommerce settings CSS and JavaScript from inline output to properly enqueued files.
  • Added capability validation before saving WooCommerce settings.
  • Added endpoint-specific rate limits and maximum search/tracking term lengths.
  • Hardened event-type, identifier and IP handling.
  • Added the WordPress Requires Plugins dependency header for WooCommerce.
  • Declared WooCommerce HPOS/custom-order-table compatibility.
  • Updated all 32 bundled translation catalogs and validated RTL styling for frontend and administration.

1.2.4

  • Added optional personalized suggestions and search statistics.
  • Added category, title and fuzzy matching fallbacks.
  • Expanded bundled translations and RTL support.
  • Added icon and visible-bar display modes plus the WooCommerce shortcode generator.
  • Added direct cart and quantity actions in live results.
  • Improved Plugin Check compatibility, AJAX input normalization and asset handling.

1.2.3

  • Added optional quantity and AJAX add-to-cart actions.
  • Added WooCommerce mini-cart fragment refresh.

1.2.2

  • Improved contains and multi-word product-title matching.
  • Prioritized SKU matches.

1.2.1

  • Added the body-level result portal, caching, rate limiting and safer price rendering.

1.2.0

  • Added configurable border radius and accessible close controls.

1.1.0

  • Added live WooCommerce product results and configurable icon styling.