=== Search by GOGO GET ===
Contributors: jbk9
Tags: search, ai search, site search, live search, search analytics
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.3.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered site search with in-admin setup, metrics, and floating or block install.

== Description ==

**Search by GOGO GET** adds fast, AI-powered search to your WordPress site. Set up in minutes from the GOGO GET admin — guided Scan → Configure → Apply — then choose floating site-wide search or an in-content bar/icon.

**Guided setup in WP Admin**
Connect your GOGO account, scan this site, configure search options, and apply your install mode from the Overview dashboard. No portal hop for day-to-day search work.

**Two ways to add search**
* **Floating search** — a site-wide side tab visitors can open from any page
* **In-content** — shortcode `[gogo_search type="bar"]` / `[gogo_search type="icon"]` or the **GOGO Search** Gutenberg block

**Pages and Category Manager**
Review crawled pages (keywords, boost, active state), upload page previews, and organize hierarchical categories — all for this site, in WP Admin.

**Search Metrics**
See what visitors search, zero-result queries, and (on supported plans) product metrics — without leaving WordPress.

**AI-powered search**
GOGO generates better keywords and descriptions at crawl time. Where enabled on your plan, visitors can use **AI mode** to ask in plain language inside the search experience.

**Connect with GOGO**
Sign in with email or Google SSO (Auth0) to link this WordPress site to your GOGO organization. Billing and multi-site management stay in the GOGO portal when needed.

Learn more: https://gogoget.ai

== Installation ==

1. Install and activate the plugin from wordpress.org or upload the zip.
2. Open **GOGO GET** in WP Admin and connect your account (sign in or sign up).
3. Complete guided setup: Scan → Configure → Apply.
4. Choose **Floating** or **In-content** under Search Setup.
5. For in-content: add `[gogo_search type="bar"]` or the GOGO Search block where you want search to appear.

== Frequently Asked Questions ==

= Floating vs in-content — which should I use? =

Floating is the simplest site-wide install (side tab on every page). Use in-content (shortcode or block) when you want search in a specific layout location such as the header.

= Do I need to paste an API key? =

After Connect and setup, Floating and block/shortcode installs use your linked GOGO configuration. You should not need to paste service credentials into the theme.

= What is AI mode? =

Where enabled on your plan, visitors can ask questions in plain language in the search UI. Crawl-time AI still improves keywords and descriptions even when AI mode is off.

= Where do Search Metrics appear? =

In the GOGO GET **Search Metrics** admin page (and in the GOGO portal for deeper charting). Product metrics appear on supported plans.

= Does this update my live site when I use a staging/dev build? =

No. Only publishing a new Stable tag via SVN updates Directory installs. Develop against a staging WordPress site with `define('GOGOGET_ENV', 'test');` in `wp-config.php`.

= Can I manage multiple sites? =

This plugin focuses on the current WordPress site. Additional sites in your GOGO organization are managed in the GOGO portal Site Manager.

== Screenshots ==

1. Overview dashboard — scan status, active configuration, floating or in-content placement, and recent search activity for this site.
2. Pages — review crawled pages, edit keywords and categories, set boost, and control which pages stay active in search.
3. Search Metrics — total searches, click-through rate, abandonment, and zero-result queries without leaving WP Admin.
4. Floating search on your live site — visitors open the side tab to find products and pages instantly (AI mode where enabled on your plan).

== Changelog ==

= 1.3.4 =
* Clear the search term when dismissing results (click-away, Esc, or closing the icon dialog).


= 1.3.3 =
* Pages editor: Active toggle uses activate/deactivate so search index stays in sync; boost clamped to 0–5 (Azure scoring range); clearer keywords vs boost help text.

= 1.3.2 =
* In-content search: live full results as you type (matches floating search), richer result cards, category filter, share links, and visitor AI toggle when enabled.

= 1.3.1 =
* Search Metrics: AI vs keyword search counts.
* Inline widget analytics: AI searches log refined keywords + aiMode (not the full question).

= 1.3.0 =
* Guided Overview setup (Scan → Configure → Apply) with Connect (Auth0 / Google SSO).
* Floating search or in-content shortcode / Gutenberg block.
* Pages and Category Manager in WP Admin (this site).
* Search Metrics with KPI tooltips and product metrics on supported plans.
* Expanded Directory description, tags, and FAQ for discoverability.

= 1.2.23-dev =
* Overview: remove API key stat card; tighten Active Search Config URL overflow handling.

= 1.2.22-dev =
* Search Metrics: info icons with accessible tooltips on KPI cards and zero-result queries list header.

= 1.2.21-dev =
* Overview **Active Search Config** card: rename heading, truncate long URLs, align config summary layout.

= 1.2.20-dev =
* Rename admin **Sites & Pages** to **Pages**; remove Add site from WP admin (this site only).
* Empty states point to Overview setup or GOGO portal support instead of create-site flows.

= 1.1.1-dev =
* In-admin Pages and Category Manager UI (rescan, pages table with keywords/category/boost/active toggle, snapshot upload, hierarchical categories).
* Not published to wordpress.org Stable tag.

= 1.1.0-dev =
* Dev rewrite: Connect, admin hub/subpages, floating vs in-content, metrics UI.
* Not published to wordpress.org Stable tag.

= 1.0.3 =
* Prior Directory release.

== Upgrade Notice ==

= 1.3.4 =
Search bar now clears the typed query when you leave results, so reopen starts fresh.


= 1.3.3 =
Pages Active/boost edits now sync correctly to live search. Boost range is 0–5.

= 1.3.2 =
In-content search now matches floating search more closely: live results, richer cards, filters, shares, and visitor AI toggle.

= 1.3.1 =
Search Metrics now separate AI vs keyword searches; AI mode analytics use refined keywords.

= 1.3.0 =
Major in-admin update: guided setup, Pages, Category Manager, Search Metrics, and Connect. After updating, open GOGO GET in WP Admin and complete setup if prompted.
