=== RecallLens – CPSC Product Recall Search ===
Contributors: lulzasaur9192
Tags: recall, product safety, cpsc, consumer, safety
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Product-recall search widget: visitors check any product against official U.S. CPSC recall data. Shortcode + Gutenberg block.

== Description ==

**RecallLens** lets your visitors instantly check whether a product, brand, or item has been recalled by the U.S. Consumer Product Safety Commission (CPSC) — right on your site.

Great for parenting blogs, deal sites, product-review sites, resellers, and safety-focused pages.

* Add it anywhere with the `[recall_lens]` shortcode or the **RecallLens – CPSC Product Recall Search** Gutenberg block.
* Visitors type a product, brand, or item; results show the recall title, date, hazard, remedy, and a link to the official CPSC notice.
* Recall data is cached on your server for fast responses and to minimize external requests.
* Clean, mobile-friendly, no configuration required.

= Free vs Pro =

* **Free:** the complete recall-search widget — unlimited searches and results, shortcode + Gutenberg block, cached for speed. No feature limits.
* **Pro (optional):** adds a **CSV export** of the search results. (More Pro features planned.) Pro is entirely optional — the free plugin is fully functional on its own.

== External services ==

This plugin connects to the **U.S. Consumer Product Safety Commission (CPSC) public recall API** to retrieve recall information.

* Service: CPSC Recalls REST API — https://www.saferproducts.gov/RestWebServices/Recall
* What is sent, and when: when a visitor performs a search (or when the server refreshes its hourly recall cache), the plugin requests recent recall records. Only the standard request is made; the visitor's search terms are matched locally on your server against the cached list — **your visitors' search terms are not transmitted to CPSC.**
* This is a public U.S. government data service. CPSC terms: https://www.cpsc.gov/ , privacy: https://www.cpsc.gov/About-CPSC/Privacy-Policy

== Installation ==

1. Upload the `recall-lens-cpsc-search` folder to `/wp-content/plugins/`, or install via the Plugins screen.
2. Activate the plugin.
3. Add the `[recall_lens]` shortcode to any post/page, or insert the **RecallLens – CPSC Product Recall Search** block.

== Frequently Asked Questions ==

= Where does the data come from? =
The official U.S. CPSC recall database (saferproducts.gov). Absence of a result is not a guarantee a product is safe — always confirm at cpsc.gov.

= Does it slow down my site? =
No. The recall list is cached on your server (hourly) and searches are matched locally.

== Changelog ==

= 1.1.0 =
* Renamed to RecallLens. Removed front-end attribution. All identifiers prefixed.

= 1.0.1 =
* Free tier is now unlimited (no result paywall). Pro adds CSV export.

= 1.0.0 =
* Initial release: shortcode + Gutenberg block, cached CPSC search, free/Pro tiers.
