Plattio Search

Description

Plattio Search provides an icon-based slide-out search or a permanently visible search bar with live WooCommerce product results.

Highlights:

  • Live product search with product image, title and price.
  • SKU, product-title, category and fuzzy fallback matching.
  • Optional add-to-cart and quantity controls for simple products.
  • Manual category/product suggestions or personalized recent/popular suggestions.
  • Search statistics under WooCommerce settings.
  • Results rendered in a body-level portal to avoid clipping by headers and page builders.
  • Keyboard navigation and an accessible live-result region.
  • Bundled translations for 32 WordPress locales.
  • RTL styling for both the frontend and WooCommerce administration screens.

The result panel and suggestion keywords remain hidden until the visitor actively engages the search input by clicking/tapping it or starts typing after keyboard focus. Merely opening the icon, focusing during an animation, resizing the window or triggering another page interaction does not reveal the panel.

Usage

Add this shortcode in a header builder, block, widget or content area:

[plattio_search]

Default icon setup:

[plattio_search display="icon" placeholder="Søk via varenummer eller varenavn..." post_type="product" 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" close_color="rgba(7,35,32,0.55)" close_hover_color="#0e3f3f" limit="6" add_to_cart="yes" add_button_text="+ Legg til" options_button_text="Velg"]

Default visible search bar:

[plattio_search display="bar" placeholder="Søk via varenummer eller varenavn..." post_type="product" width="520px" primary_color="#0e3f3f" button_size="38px" height="44px" border_radius="10px" limit="6" add_to_cart="yes" add_button_text="+ Legg til" options_button_text="Velg"]

More squared field:

[plattio_search placeholder="Søk via varenummer eller varenavn..." post_type="product" width="520px" border_radius="12px" limit="6"]

WooCommerce settings:

  • WooCommerce Settings Plattio Search Primærfarge controls the default primary color.
  • primary_color can override the global setting for one shortcode instance.
  • Standardresultater lets administrators choose existing product categories and products as suggestions, or enable personalized suggestions.
  • Statistikk shows popular search terms and products visited through search results.
  • The shortcode generator automatically hides settings that do not apply to the selected display mode.

Shortcode attributes:

  • display: icon or bar.
  • placeholder: Search-field placeholder.
  • post_type: Kept for shortcode compatibility; WooCommerce live results are restricted to products.
  • width, height, button_size, icon_size, border_radius and radius.
  • icon_color, icon_hover_color, close_color, close_hover_color and primary_color.
  • close_button: yes or no.
  • limit: 1–10 live results.
  • add_to_cart: yes or no.
  • add_button_text: Label for simple-product add-to-cart.
  • options_button_text: Label for products that require option selection.

Languages and RTL

The plugin includes complete PO/MO files for Arabic, Chinese (Simplified and Traditional), Czech, Danish, Dutch, English (United Kingdom and United States), Finnish, French, German, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Norwegian Bokmål, Persian, Polish, Portuguese (Brazil and Portugal), Romanian, Russian, Spanish, Swedish, Thai, Turkish, Ukrainian, Urdu and Vietnamese.

Arabic, Hebrew, Persian and Urdu are bundled as RTL locales. The frontend portal and WooCommerce administration interface also follow WordPress’ active dir="rtl" direction for other RTL locales.

Security notes

  • Public AJAX actions require action-specific WordPress nonces.
  • Search, tracking and cart endpoints have separate request-rate limits.
  • Search and tracking terms are normalized, sanitized and length-limited.
  • Result counts are clamped server-side.
  • WooCommerce product visibility and purchasability APIs are used before output or cart changes.
  • Admin settings require the manage_woocommerce capability and WooCommerce’s settings nonce flow.
  • Dynamic output is escaped or passed through constrained allowlists.
  • CSS shortcode values are restricted to supported colors and dimensions.

Installation

  1. Upload the installable ZIP through Plugins Add New Upload Plugin.
  2. Activate WooCommerce, then activate Plattio Search.
  3. Add [plattio_search] where the search should appear.
  4. Configure defaults under WooCommerce Settings Plattio Search.

FAQ

Why do suggestions no longer appear when I only open the search icon?

This is intentional. Suggestions and live results become visible only after direct interaction with the input field, or when a keyboard user starts typing in the focused field.

Does it support WooCommerce HPOS?

Yes. The plugin does not read or write order tables and declares compatibility with WooCommerce custom order tables.

Are variable products added directly?

No. Products requiring variation or option selection link to their product page. Simple purchasable products can be added directly when add_to_cart="yes" is enabled.

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

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.0

  • 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.
  • Validated all 32 bundled translation catalogs and RTL styling for frontend and administration.
  • Updated compatibility metadata and version to 1.3.0.

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.