=== Andale Search Insights ===
Contributors: andaleplugins
Tags: search, analytics, site search, reporting
Requires at least: 6.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track WordPress internal search behavior and review analytics in a clean, extensible dashboard.

== Description ==

Andale Search Insights is the free core plugin for Andale Search Insights Pro. It captures WordPress internal search activity, stores it in custom tables, and exposes a stable extension surface for analytics enhancements and intelligence features.

Core capabilities:

* Track committed WordPress search terms.
* Record zero-result searches and result click activity.
* Provide a Vue-powered analytics dashboard in wp-admin.
* Export filtered analytics data to CSV.
* Run retention cleanup with configurable limits and manual tools.
* Offer actions and filters for Pro and third-party integrations.

This plugin does not replace the site search engine. It analyzes search behavior and provides visibility into demand and discoverability gaps.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it through the WordPress admin.
2. Activate `Andale Search Insights`.
3. Configure the optional tracking settings as needed for your site search setup.
4. Visit `Andale Search Insights` in wp-admin to review analytics and settings.

== Frequently Asked Questions ==

= Does Andale Search Insights replace WordPress search? =

No. Andale Search Insights observes and analyzes internal search behavior. It does not replace the underlying search engine.

= Is Andale Search Insights only for WooCommerce? =

No. Andale Search Insights is a WordPress search analytics plugin. Some optional integrations may be especially useful on WooCommerce sites, but the core plugin is not limited to WooCommerce.

= Does Andale Search Insights Pro require this plugin? =

Yes. Andale Search Insights Pro extends the free core and requires Andale Search Insights to be active.

= Are source JavaScript files included? =

Yes. The package includes both built assets and source files used to generate them.

= Where can I review the non-compiled frontend source and build process? =

The distributed build artifacts live in `dist/`.

The non-compiled source files that generate those assets are included in the plugin package under:

* `resources/js/` for the admin Vue application and related source files
* `resources/public/js/` for frontend tracking and autocomplete scripts
* `resources/public/css/` for frontend autocomplete styles

Build configuration is included in:

* `package.json`
* `webpack.config.js`

Typical build commands are:

* `npm install`
* `npm run build`

== Screenshots ==

1. Analytics dashboard with filters, KPI cards, and term detail drill-down.
2. Settings screen with tracking, retention, and maintenance controls.
3. Tools screen showing retention status and dry-run estimates.

== Changelog ==

= 1.0.0 =

* Initial public release of the Andale Search Insights free core.

== Upgrade Notice ==

= 1.0.0 =

Initial release.
