=== SearchLens – Search Analytics & Insights ===
Contributors: vivek34
Tags: search, analytics, ajax search, search tracking, search insights
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track WordPress search activity with powerful analytics, AJAX search support, Gutenberg blocks, widgets, CSV export, and privacy-friendly reporting—all inside your WordPress dashboard.

== Description ==

SearchLens – Search Analytics & Insights helps you understand exactly what your visitors are searching for on your WordPress website.

Monitor search activity, discover popular search terms, identify searches with no results, and improve your website's content using actionable analytics.

Unlike third-party analytics services, SearchLens stores all search data locally inside your WordPress database, making it lightweight, privacy-friendly, and easy to use.

Whether you use the default WordPress search or AJAX-powered search, SearchLens records every search and presents meaningful insights through a clean analytics dashboard.

= Why SearchLens? =

Search analytics help you understand visitor intent and improve your website experience.

With SearchLens you can:

* Discover what users are searching for.
* Identify missing or unavailable content.
* Find searches returning no results.
* Improve navigation and search experience.
* Optimize your content strategy.
* Make data-driven decisions.
* Keep all analytics inside WordPress.
* No external analytics service required.

= Key Features =

* Native WordPress search tracking.
* AJAX search tracking.
* Powerful analytics dashboard.
* Total searches overview.
* Unique searches overview.
* No-result search tracking.
* Recent search activity.
* Top searched keywords.
* Trending searches.
* Search result count tracking.
* Track page title.
* Track page URL.
* Track page type.
* Track referrer.
* Advanced analytics filters.
* Filter by search term.
* Filter by page title.
* Filter by page type.
* Filter by date range.
* CSV export.
* Search widget.
* Gutenberg Search Widget block.
* Search shortcodes.
* Configurable searchable post types.
* Configurable AJAX search settings.
* Responsive admin interface.
* Lightweight and fast.
* Privacy-friendly.
* Stores data locally.
* No third-party services.
* Built following WordPress Coding Standards.

= Included Shortcodes =

Display search forms and analytics anywhere using shortcodes.

Search Form

`[searchlens_form placeholder="Search..." button_text="Search"]`

AJAX Search Form

`[searchlens_ajax_form placeholder="Search..." limit="10"]`

Popular Searches

`[searchlens_popular limit="5" show_count="true"]`

Trending Searches

`[searchlens_trending limit="5" title="Trending Searches"]`

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/` directory, or install the plugin directly through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Open **SearchLens** from the WordPress admin menu.
4. Configure your preferred search settings.
5. Add the search widget, Gutenberg block, or shortcode wherever required.

== Frequently Asked Questions ==

= Does SearchLens support AJAX search? =

Yes. SearchLens supports AJAX search tracking and analytics.

= Does it work with Custom Post Types? =

Yes. You can select which public post types should be searchable.

= Does it support Gutenberg? =

Yes. A dedicated Gutenberg Search Widget block is included.

= Does it support classic widgets? =

Yes. SearchLens includes a classic WordPress widget.

= Can I export analytics? =

Yes. Search analytics can be exported as CSV.

= Can I filter search logs? =

Yes. Filter analytics by search term, page title, page type, and date range.

= Does SearchLens store IP addresses? =

No. Raw IP addresses are never stored.

= Is SearchLens GDPR friendly? =

Yes. All analytics are stored locally inside your WordPress website. No external analytics services are required.

= Does it require any third-party service? =

No. Everything runs entirely inside WordPress.

= Is it lightweight? =

Yes. SearchLens is optimized for performance and minimal overhead.

= Will it work with my theme? =

Yes. SearchLens works with most modern WordPress themes.

== Screenshots ==

1. Search analytics dashboard overview.
2. Advanced search filters and analytics.
3. Search activity and top search terms.
4. Search settings and AJAX configuration.

== Changelog ==

= 1.0.0 =

* Initial public release.
* Native WordPress search tracking.
* AJAX search tracking.
* Analytics dashboard.
* Search statistics overview.
* Top searched keywords.
* Trending searches.
* Recent search activity.
* No-result search tracking.
* Page tracking (title, URL, type, and referrer).
* Advanced analytics filters.
* CSV export.
* Search widget.
* Gutenberg Search Widget block.
* Search shortcode support.
* Configurable searchable post types.
* Configurable AJAX search settings.
* Responsive admin interface.
* Performance improvements.
* Security improvements.
* WordPress Coding Standards compliant.

== Upgrade Notice ==

= 1.0.0 =

Initial public release of SearchLens – Search Analytics & Insights.