Shoplistify — How To

Summary

Turn WooCommerce search into a fast, shopping-list style experience with inline add-to-cart, trending picks, and tidy sorting.

Prerequisites

• WordPress + WooCommerce (latest).
• A modern theme (Block or Classic).
• Optional: a cache plugin/CDN with exclusions (see below).

Install & Activate

1. Plugins → Add New → Upload Plugin → upload the ZIP → Activate.
2. Go to WooCommerce → Settings → Shoplistify for global options.

Quick Start (Embed)

• Gutenberg block: add “Shoplistify Search” to header, sidebar, or a page.
• Shortcode: paste into any widget/page:

[shoplistify]

• (If your build uses a different shortcode/block label, check: Settings → Shoplistify → Embed.)

Configure

1. Placeholder text: Settings → Shoplistify → “Search placeholder”.
2. Trending row: toggle On, pick source (auto, manual pins), and max items.
3. Sorting bar: enable and choose options (price, popularity, rating, newest).
4. Inline add-to-cart: enable quantity/variations as needed.
5. Analytics: enable to collect top queries, zero-results, and CTR.

Caching/CDN

Exclude these from full-page cache:

/?add-to-cart=*
/?wc-ajax=*
/cart/
/checkout/
/wp-json/shoplistify/v1/*

If cart count doesn’t update instantly, enable Woo “cart fragments” or your theme’s Ajax mini-cart.

Troubleshooting

• Cart doesn’t update: missing cache exclusions; add the rules above and purge.
• Layout looks off: theme CSS override—toggle “Isolate styles” in Settings, or add a small compat CSS snippet.
• No results appear: confirm products are published, in stock, and not excluded by catalog visibility.

Uninstall

Deactivate → Delete plugin. Your Woo data remains intact (search Analytics are removed if you tick “Remove data on uninstall” in Settings).