{"id":326318,"date":"2026-07-07T13:55:11","date_gmt":"2026-07-07T13:55:11","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/rankology-ajax-live-search\/"},"modified":"2026-08-03T12:54:45","modified_gmt":"2026-08-03T12:54:45","slug":"rankology-ajax-live-search","status":"publish","type":"plugin","link":"https:\/\/ar.wordpress.org\/plugins\/rankology-ajax-live-search\/","author":21085192,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.0.4","requires":"6.2","requires_php":"8.1","requires_plugins":null,"header_name":"Rankology Ajax Live Search","header_author":"Rankology","header_description":"High-performance AJAX live search with relevance ranking, advanced filters, custom SERP templates, search analytics, and WooCommerce support. Built for WordPress.org security and coding standards.","assets_banners_color":"cbd3f4","last_updated":"2026-08-03 12:54:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/rankology.io","rating":0,"author_block_rating":0,"active_installs":0,"downloads":196,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"rankology","date":"2026-07-10 12:26:29"},"1.1.0":{"tag":"1.1.0","author":"rankology","date":"2026-08-03 12:54:45"}},"upgrade_notice":{"1.1.0":"<p>Adds Zero-Result\/Low-CTR alerts, a Trending Searches widget, WooCommerce add-to-cart in results, multisite per-subsite overrides, and scheduled merchandising campaigns, plus an updated admin layout. Database schema updates automatically \u2014 no manual steps required.<\/p>","1.0.0":"<p>Initial release of Rankology Ajax Live Search. After updating, rebuild the search index from <strong>Rankology \u2192 Search Indexing<\/strong> if you are upgrading from a pre-release build.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3599138,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3599138,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3602504,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3602504,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"rankajlisrh\/search":{"name":"rankajlisrh\/search","title":"Rankology Live Search"}},"tagged_versions":["1.0.0","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3632989,"resolution":"1","location":"assets","locale":"","width":1600,"height":900},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3632989,"resolution":"10","location":"assets","locale":"","width":1600,"height":900},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3632989,"resolution":"11","location":"assets","locale":"","width":1600,"height":900},"screenshot-12.png":{"filename":"screenshot-12.png","revision":3632989,"resolution":"12","location":"assets","locale":"","width":1600,"height":900},"screenshot-13.png":{"filename":"screenshot-13.png","revision":3632989,"resolution":"13","location":"assets","locale":"","width":1600,"height":900},"screenshot-14.png":{"filename":"screenshot-14.png","revision":3632989,"resolution":"14","location":"assets","locale":"","width":1600,"height":900},"screenshot-15.png":{"filename":"screenshot-15.png","revision":3632989,"resolution":"15","location":"assets","locale":"","width":1600,"height":900},"screenshot-16.png":{"filename":"screenshot-16.png","revision":3632989,"resolution":"16","location":"assets","locale":"","width":1600,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3632989,"resolution":"2","location":"assets","locale":"","width":1600,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3632989,"resolution":"3","location":"assets","locale":"","width":1600,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3632989,"resolution":"4","location":"assets","locale":"","width":1600,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3632989,"resolution":"5","location":"assets","locale":"","width":1600,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3632989,"resolution":"6","location":"assets","locale":"","width":1600,"height":900},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3632989,"resolution":"7","location":"assets","locale":"","width":1600,"height":900},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3632989,"resolution":"8","location":"assets","locale":"","width":1600,"height":900},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3632989,"resolution":"9","location":"assets","locale":"","width":1600,"height":900}},"screenshots":{"1":"Dashboard \u2014 index status, quick actions, and an at-a-glance overview.","2":"Search Widgets \u2014 manage independent search placements with their own layout, theme, and relevance overrides.","3":"Appearance \u2014 Design &amp; Layout tab, covering result layout, color themes, and visual options.","4":"Integrations \u2014 detected third-party plugins and compatibility status.","5":"Modal Search \u2014 configuration for the overlay search experience.","6":"Analytics &amp; reporting settings tab \u2014 logging, engagement tracking, and email report options.","7":"Smart Search \u2014 Overview tab summarizing AI provider status and enabled features.","8":"Search Filter \u2014 Filter Display Rules, controlling which filters appear and where.","9":"Smart Search \u2014 Usage Analytics tab with token usage and estimated cost per provider.","10":"Analytics &amp; Logs \u2014 Overview: search volume trends and search outcomes.","11":"Analytics &amp; Logs \u2014 Overview: results breakdown by day, top and trending searches.","12":"Analytics &amp; Logs \u2014 Search Logs, detailed query history with results and click data.","13":"Analytics &amp; Logs \u2014 Engagement tab, scroll-depth funnel and mouse heat zones.","14":"Search Form Replacement \u2014 swapping in the Rankology search bar.","15":"Search Filter \u2014 live filter panel on the frontend.","16":"Search Results \u2014 live AJAX results with thumbnails and keyword highlighting."}},"plugin_section":[],"plugin_tags":[37961,165862,37974,6034,5198],"plugin_category":[36,45],"plugin_contributors":[254682],"plugin_business_model":[],"class_list":["post-326318","plugin","type-plugin","status-publish","hentry","plugin_tags-ajax-product-filter","plugin_tags-search-by-sku","plugin_tags-woocommerce-filter","plugin_tags-woocommerce-product-filter","plugin_tags-woocommerce-product-search","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-rankology","plugin_committers-rankology"],"banners":{"banner":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/banner-772x250.png?rev=3602504","banner_2x":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/banner-1544x500.png?rev=3602504","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/icon-128x128.png?rev=3599138","icon_2x":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/icon-256x256.png?rev=3599138","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-1.png?rev=3632989","caption":"Dashboard \u2014 index status, quick actions, and an at-a-glance overview."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-2.png?rev=3632989","caption":"Search Widgets \u2014 manage independent search placements with their own layout, theme, and relevance overrides."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-3.png?rev=3632989","caption":"Appearance \u2014 Design &amp; Layout tab, covering result layout, color themes, and visual options."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-4.png?rev=3632989","caption":"Integrations \u2014 detected third-party plugins and compatibility status."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-5.png?rev=3632989","caption":"Modal Search \u2014 configuration for the overlay search experience."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-6.png?rev=3632989","caption":"Analytics &amp; reporting settings tab \u2014 logging, engagement tracking, and email report options."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-7.png?rev=3632989","caption":"Smart Search \u2014 Overview tab summarizing AI provider status and enabled features."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-8.png?rev=3632989","caption":"Search Filter \u2014 Filter Display Rules, controlling which filters appear and where."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-9.png?rev=3632989","caption":"Smart Search \u2014 Usage Analytics tab with token usage and estimated cost per provider."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-10.png?rev=3632989","caption":"Analytics &amp; Logs \u2014 Overview: search volume trends and search outcomes."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-11.png?rev=3632989","caption":"Analytics &amp; Logs \u2014 Overview: results breakdown by day, top and trending searches."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-12.png?rev=3632989","caption":"Analytics &amp; Logs \u2014 Search Logs, detailed query history with results and click data."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-13.png?rev=3632989","caption":"Analytics &amp; Logs \u2014 Engagement tab, scroll-depth funnel and mouse heat zones."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-14.png?rev=3632989","caption":"Search Form Replacement \u2014 swapping in the Rankology search bar."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-15.png?rev=3632989","caption":"Search Filter \u2014 live filter panel on the frontend."},{"src":"https:\/\/ps.w.org\/rankology-ajax-live-search\/assets\/screenshot-16.png?rev=3632989","caption":"Search Results \u2014 live AJAX results with thumbnails and keyword highlighting."}],"raw_content":"<!--section=description-->\n<p>Rankology Ajax Live Search upgrades the native WordPress search experience with fast, modern AJAX results, a dedicated relevance index, and a polished admin workflow. Visitors get instant suggestions as they type; site owners get visibility into what people search for and what they cannot find.<\/p>\n\n<p>Built for production sites, Rankology is suitable for blogs, business websites, membership portals, and WooCommerce stores that need accurate, configurable search without slowing down the front end.<\/p>\n\n<h4>Search experience<\/h4>\n\n<ul>\n<li><strong>Live AJAX search<\/strong> \u2014 Results update as visitors type, with configurable debounce and keyboard-friendly navigation.<\/li>\n<li><strong>Autocomplete suggestions<\/strong> \u2014 Surface popular, recent, and Google-style query suggestions before a full search runs.<\/li>\n<li><strong>Multiple result layouts<\/strong> \u2014 Vertical dropdown, horizontal grid, polaroid tiles, and isotopic masonry.<\/li>\n<li><strong>Visual polish<\/strong> \u2014 Thumbnails, keyword highlighting, smart excerpts, and 8 built-in color themes (Classic, Dark Pro, E-commerce, Glass, Magazine, Material Design, Minimal, Neon).<\/li>\n<li><strong>Single-result redirect<\/strong> \u2014 Optionally send visitors straight to the destination when only one match is found.<\/li>\n<li><strong>Modal and voice search<\/strong> \u2014 Open search in a modal overlay and accept voice input where supported by the browser.<\/li>\n<li><strong>Add to cart from results<\/strong> \u2014 Add WooCommerce products straight from the live results dropdown, no page reload required.<\/li>\n<li><strong>Trending \/ popular searches widget<\/strong> \u2014 Surface trending queries on the frontend as a standalone block, shortcode, or classic widget.<\/li>\n<li><strong>Live filtering on archive pages<\/strong> \u2014 Apply the same AJAX filters directly on taxonomy and post-type archive pages, not just the search results view.<\/li>\n<li><strong>Responsive UI<\/strong> \u2014 Mobile-friendly search instances and result panels.<\/li>\n<\/ul>\n\n<h4>Relevance and performance<\/h4>\n\n<ul>\n<li><strong>Custom search index<\/strong> \u2014 Dedicated indexing engine with BM25-style relevance scoring and configurable field weights.<\/li>\n<li><strong>Configurable content scope<\/strong> \u2014 Include posts, pages, products, custom post types, taxonomies, and custom fields.<\/li>\n<li><strong>File indexing<\/strong> \u2014 Optional extraction of text from attached PDF, DOCX, and TXT files.<\/li>\n<li><strong>WooCommerce ready<\/strong> \u2014 Search products, show prices, add to cart from results, and weight SKU and catalog fields.<\/li>\n<li><strong>Caching and rate limiting<\/strong> \u2014 Protect the public search endpoint from abuse while keeping responses fast.<\/li>\n<\/ul>\n\n<h4>Filters and discovery<\/h4>\n\n<ul>\n<li><strong>Live filters<\/strong> \u2014 Taxonomy, price range, and custom field filters with AJAX updates, usable in search results and on archive pages.<\/li>\n<li><strong>Filter builder<\/strong> \u2014 Configure filter panels from the admin without writing code.<\/li>\n<li><strong>SERP templates<\/strong> \u2014 Customize the on-site search results page experience, including archive fields, SEO fields, and template layout.<\/li>\n<li><strong>Result Tuning<\/strong> \u2014 a dedicated workspace covering:\n\n<ul>\n<li><strong>Redirects<\/strong> \u2014 send specific queries to a chosen URL by pattern, role, or language.<\/li>\n<li><strong>Merchandising<\/strong> \u2014 pin, promote, or hide specific results, with optional scheduled campaign windows (e.g. Black Friday) that activate and expire automatically.<\/li>\n<li><strong>A\/B Experiments<\/strong> \u2014 test ranking or layout variations and compare performance.<\/li>\n<li><strong>Synonyms<\/strong> \u2014 map alternate terms to the same results.<\/li>\n<li><strong>Stop Words<\/strong> \u2014 exclude noise words from matching.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>Search widgets<\/h4>\n\n<p>Create unlimited <strong>Search Widgets<\/strong> \u2014 each an independent placement with its own post types, layout, theme, behavior, filters, and relevance-weight overrides.<\/p>\n\n<ul>\n<li>Gutenberg block (<code>rankajlisrh\/search<\/code>)<\/li>\n<li>Shortcode: <code>[rankajlisrh]<\/code><\/li>\n<li>Standalone filter panel shortcode: <code>[rankajlisrh_filters]<\/code><\/li>\n<li>Trending searches shortcode: <code>[rankajlisrh_trending_searches]<\/code><\/li>\n<li>Classic widget<\/li>\n<li>Per-widget shortcodes for precise placement in headers, sidebars, and landing pages<\/li>\n<\/ul>\n\n<h4>Smart Search (AI-assisted, optional)<\/h4>\n\n<p>Connect OpenAI, Google Gemini, or Anthropic Claude to layer AI features on top of the core search engine \u2014 nothing here is required for the plugin to work:<\/p>\n\n<ul>\n<li><strong>AI Overviews<\/strong> \u2014 a generated summary paragraph above the result list.<\/li>\n<li><strong>Per-result AI summaries<\/strong> \u2014 short AI-written summaries for individual hits.<\/li>\n<li><strong>Smart query understanding<\/strong> \u2014 typo correction and natural-language constraint parsing (e.g. \"red shoes under $50\").<\/li>\n<li><strong>Intent ranking<\/strong> \u2014 reorders results based on detected query intent.<\/li>\n<li><strong>Semantic redirects<\/strong> \u2014 AI-assisted fallback matching for redirect rules when no exact pattern matches.<\/li>\n<li><strong>Related content &amp; \"People also search for\"<\/strong> \u2014 AI-surfaced related content carousel and related-query suggestions.<\/li>\n<li><strong>Personalization &amp; click learning<\/strong> \u2014 results adapt per-session based on prior clicks, without user accounts or persistent profiles.<\/li>\n<li><strong>Phrase autocomplete<\/strong> \u2014 AI-assisted phrase-level suggestions.<\/li>\n<li><strong>Usage &amp; cost dashboard<\/strong> \u2014 track token usage and estimated cost per provider.<\/li>\n<li><strong>Encrypted API keys<\/strong> \u2014 provider keys are encrypted at rest, never stored as plaintext.<\/li>\n<\/ul>\n\n<h4>Analytics and optimization<\/h4>\n\n<p>Understand how search performs on your site:<\/p>\n\n<ul>\n<li><strong>Overview dashboard<\/strong> \u2014 Top queries, trending terms, and zero-result searches.<\/li>\n<li><strong>Search logs<\/strong> \u2014 Detailed query history with results count, click tracking, device, and locale.<\/li>\n<li><strong>Per-search detail view<\/strong> \u2014 Drill into an individual search: query, filters applied, results returned, and clicks.<\/li>\n<li><strong>Engagement tracking<\/strong> \u2014 Anonymous scroll-depth funnel and mouse heat-zone data for the search results area.<\/li>\n<li><strong>Zero-result and low-CTR alerts<\/strong> \u2014 Scheduled checks that flag queries returning nothing or rarely getting clicked, so content or indexing gaps get noticed automatically.<\/li>\n<li><strong>Query redirect rules<\/strong> \u2014 Send specific searches to a chosen URL by pattern, role, or language.<\/li>\n<li><strong>Exports<\/strong> \u2014 Download analytics as CSV or a printable PDF report.<\/li>\n<li><strong>Scheduled email reports<\/strong> \u2014 Optional periodic analytics summaries sent via WordPress <code>wp_mail()<\/code>.<\/li>\n<\/ul>\n\n<h4>Developer tools<\/h4>\n\n<ul>\n<li><strong>REST API<\/strong> \u2014 Headless and custom integrations under the <code>rankajlisrh\/v1<\/code> namespace: search, click tracking, redirects, merchandising, A\/B experiments, engagement tracking, personalization, voice parsing, and streaming AI summaries.<\/li>\n<li><strong>WP-CLI commands<\/strong> \u2014 <code>wp rankajlisrh index rebuild|status|reindex<\/code>, <code>cache flush<\/code>, <code>benchmark<\/code>, and <code>embed<\/code> (generate Smart Search embeddings) from the command line.<\/li>\n<li><strong>Extensible hooks<\/strong> \u2014 Customize search criteria and response payloads via WordPress filters.<\/li>\n<li><strong>Multisite aware<\/strong> \u2014 Network-level settings synchronization, with optional per-subsite overrides for individual sites in a WordPress multisite install.<\/li>\n<li><strong>Privacy tools integration<\/strong> \u2014 Search logs are included in WordPress core's personal data export and erase tools, and analytics tracking respects the WP Consent API \"statistics\" category when active.<\/li>\n<li><strong>Compatibility layer<\/strong> \u2014 Automatic detection of, and remediation adapters for, common caching plugins (so cached pages don't serve stale search results) and page builders (Elementor, Divi, WPBakery, Bricks).<\/li>\n<li><strong>Migration tools<\/strong> \u2014 One-click import from Ajax Search Pro and SearchWP, plus Rankology's own JSON settings export\/import for backups and staging-to-production moves.<\/li>\n<\/ul>\n\n<h4>Admin<\/h4>\n\n<p>A unified <strong>Rankology<\/strong> menu in wp-admin: Dashboard, Search Indexing, Appearance, Search Filter, SERP Builder, Result Tuning, Smart Search, Analytics &amp; Logs, Integrations, Tools, and Settings \u2014 organized set up \u2192 tune \u2192 measure \u2192 maintain, for clarity on both small blogs and larger editorial teams. Search Widgets are managed from their own screen (<strong>Rankology \u2192 Search Widgets<\/strong>).<\/p>\n\n<h3>Credits<\/h3>\n\n<h4>Bundled libraries<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/github.com\/composer\/composer\">Composer ClassLoader<\/a> \u2014 MIT License. Copyright (c) Nils Adermann, Jordi Boggiano. Used for PSR-4 autoloading in <code>vendor\/composer\/<\/code>.<\/li>\n<\/ul>\n\n<h4>WordPress core dependencies (not bundled)<\/h4>\n\n<ul>\n<li>jQuery \u2014 Admin and frontend UI interactions.<\/li>\n<li>WordPress packages (<code>wp-element<\/code>, <code>wp-components<\/code>, <code>wp-i18n<\/code>) \u2014 Admin dashboard hub UI.<\/li>\n<\/ul>\n\n<h4>Optional Composer libraries (not bundled)<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/github.com\/smalot\/pdfparser\">smalot\/pdfparser<\/a> \u2014 LGPL-3.0. Optional. PDF attachment text extraction.<\/li>\n<li><a href=\"https:\/\/github.com\/PHPOffice\/PHPWord\">phpoffice\/phpword<\/a> \u2014 LGPL-3.0. Optional. DOCX attachment text extraction.<\/li>\n<\/ul>\n\n<p>TXT file extraction uses native PHP only.<\/p>\n\n<h4>Compatible plugins (not bundled)<\/h4>\n\n<ul>\n<li>WooCommerce \u2014 Product search, prices, SKU weighting, and variation indexing.<\/li>\n<li>WPML \u2014 Per-language indexing and search filtering.<\/li>\n<li>Polylang \u2014 Per-language indexing and search filtering.<\/li>\n<li>Advanced Custom Fields (ACF) \u2014 Custom field indexing and filter UI.<\/li>\n<li>WP Mail Logging \u2014 View scheduled analytics email content from the admin.<\/li>\n<\/ul>\n\n<h3>Privacy Policy<\/h3>\n\n<p>This plugin stores search analytics, index data, and plugin settings in your WordPress database. It does not phone home to Rankology servers.<\/p>\n\n<h4>Personal data export and erasure<\/h4>\n\n<p>Search logs associated with a visitor are included automatically in WordPress core's built-in personal data export and erase tools (<strong>Tools \u2192 Export\/Erase Personal Data<\/strong>), so data-subject requests can be fulfilled without manual database work.<\/p>\n\n<h4>Consent Awareness<\/h4>\n\n<p>When the <a href=\"https:\/\/wordpress.org\/plugins\/wp-consent-api\/\">WP Consent API<\/a> is active, Rankology checks the visitor's \"statistics\" consent category before logging search queries, clicks, or engagement data. If a compatible consent plugin has not granted that category, tracking is skipped for that visitor.<\/p>\n\n<h4>Google Suggest API<\/h4>\n\n<p>When <strong>Google-style autocomplete<\/strong> is enabled in <strong>Rankology \u2192 Appearance \u2192 Autocomplete<\/strong>, the plugin may send partial search terms from your site to Google's public suggestion service at <code>https:\/\/suggestqueries.google.com\/complete\/search<\/code>.<\/p>\n\n<ul>\n<li><strong>What is sent:<\/strong> The current partial search query and optional language or region parameters.<\/li>\n<li><strong>When it is sent:<\/strong> Only while autocomplete is enabled and local suggestion sources do not already fill the suggestion list.<\/li>\n<li><strong>Why it is sent:<\/strong> To retrieve Google-style query suggestions for visitors.<\/li>\n<li><strong>Caching:<\/strong> Responses are cached locally with WordPress transients to reduce repeat requests.<\/li>\n<li><strong>Third-party policy:<\/strong> Review <a href=\"https:\/\/policies.google.com\/privacy\">Google's Privacy Policy<\/a> for how Google handles data sent to its services.<\/li>\n<\/ul>\n\n<h4>AI provider integrations (optional)<\/h4>\n\n<p>When Smart Search AI features are enabled and an API key is configured, the plugin may send request data to your selected provider (OpenAI, Google Gemini, or Anthropic Claude) to generate summaries, query understanding, or related AI-assisted search output.<\/p>\n\n<ul>\n<li><strong>What may be sent:<\/strong> Search query text and limited content context required to generate a response (for example, titles and excerpts for summary generation).<\/li>\n<li><strong>When it is sent:<\/strong> Only when AI features are enabled and a remote provider is selected in plugin settings.<\/li>\n<li><strong>Why it is sent:<\/strong> To return AI-generated search enhancements configured by the site owner.<\/li>\n<li><strong>Caching:<\/strong> AI responses may be cached locally (WordPress transients) when response caching is enabled.<\/li>\n<li><strong>Third-party policies:<\/strong> <a href=\"https:\/\/openai.com\/policies\/privacy-policy\">OpenAI Privacy Policy<\/a>, <a href=\"https:\/\/policies.google.com\/privacy\">Google Privacy Policy<\/a>, <a href=\"https:\/\/www.anthropic.com\/privacy\">Anthropic Privacy Policy<\/a>.<\/li>\n<\/ul>\n\n<h4>Email reports<\/h4>\n\n<p>If you enable scheduled analytics email reports, message content is sent through your WordPress site's configured mail transport (<code>wp_mail()<\/code>). Rankology does not provide or operate that mail service.<\/p>\n\n<h4>Voice search<\/h4>\n\n<p>When voice search is used in supported browsers, speech recognition is handled by the visitor's browser. Rankology does not record or transmit audio to its own servers.<\/p>\n\n<!--section=installation-->\n<h4>Automatic installation<\/h4>\n\n<ol>\n<li>In your WordPress admin, go to <strong>Plugins \u2192 Add New<\/strong>.<\/li>\n<li>Search for <strong>Rankology Ajax Live Search<\/strong>.<\/li>\n<li>Click <strong>Install Now<\/strong>, then <strong>Activate<\/strong>.<\/li>\n<\/ol>\n\n<h4>Manual installation<\/h4>\n\n<ol>\n<li>Upload the <code>rankajlisrh<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> screen in WordPress.<\/li>\n<li>Go to <strong>Rankology \u2192 Appearance<\/strong> to review global search settings.<\/li>\n<li>Go to <strong>Rankology \u2192 Search Widgets<\/strong> to create your first search widget, or add the block\/shortcode to a page.<\/li>\n<\/ol>\n\n<h4>After activation<\/h4>\n\n<ol>\n<li>Visit <strong>Rankology \u2192 Search Indexing<\/strong> and run an initial index build if one is not started automatically.<\/li>\n<li>Place a search widget using the Gutenberg block, <code>[rankajlisrh]<\/code> shortcode, or classic widget.<\/li>\n<li>Optional: enable search logging under <strong>Rankology \u2192 Settings<\/strong>, then review results under <strong>Rankology \u2192 Analytics &amp; Logs<\/strong>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20rankology%20work%20with%20woocommerce%3F\"><h3>Does Rankology work with WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. Rankology can include WooCommerce products in search results, display product prices where appropriate, and apply relevance weighting to SKU and product fields when WooCommerce is active.<\/p><\/dd>\n<dt id=\"does%20this%20replace%20the%20default%20wordpress%20search%3F\"><h3>Does this replace the default WordPress search?<\/h3><\/dt>\n<dd><p>Rankology does not remove WordPress core search automatically. You place the Rankology search bar where you want it \u2014 via block, shortcode, or widget \u2014 and can customize the on-site search results template for a complete replacement experience.<\/p><\/dd>\n<dt id=\"how%20do%20i%20add%20search%20to%20my%20theme%20header%3F\"><h3>How do I add search to my theme header?<\/h3><\/dt>\n<dd><p>Create a Search Widget in <strong>Rankology \u2192 Search Widgets<\/strong>, copy its shortcode, and paste it into your header template, a block theme header pattern, or a hook-friendly location. You can also use the <strong>Rankology Search<\/strong> Gutenberg block in the site editor.<\/p><\/dd>\n<dt id=\"what%20is%20a%20search%20widget%3F\"><h3>What is a Search Widget?<\/h3><\/dt>\n<dd><p>A Search Widget is an independent search configuration. Each widget can target different post types, use a different layout or theme, enable its own filters, and override relevance weights \u2014 useful when a shop search and a blog search need different behavior.<\/p><\/dd>\n<dt id=\"will%20rankology%20slow%20down%20my%20site%3F\"><h3>Will Rankology slow down my site?<\/h3><\/dt>\n<dd><p>Rankology is built for performance. Search queries use a dedicated index and cached responses where appropriate, and the public endpoint includes rate limiting. Initial indexing runs in the background and can be managed from the admin or WP-CLI.<\/p><\/dd>\n<dt id=\"can%20i%20see%20what%20visitors%20search%20for%3F\"><h3>Can I see what visitors search for?<\/h3><\/dt>\n<dd><p>Yes. Enable search analytics and visit <strong>Rankology \u2192 Analytics &amp; Logs<\/strong> for top queries, trending terms, zero-result searches, engagement (scroll\/mouse) tracking, and individual log entries. Data can be exported for reporting, and zero-result\/low-CTR alerts flag emerging gaps automatically.<\/p><\/dd>\n<dt id=\"what%20are%20query%20redirect%20rules%3F\"><h3>What are query redirect rules?<\/h3><\/dt>\n<dd><p>Redirect rules let you send specific search queries (exact or pattern-based) to a custom URL \u2014 for campaigns, synonyms, or steering users to the right landing page. Rules can be scoped by user role and language, and live under <strong>Rankology \u2192 Result Tuning \u2192 Redirects<\/strong>. With Smart Search enabled, semantic matching can also catch queries that don't match a rule's exact pattern.<\/p><\/dd>\n<dt id=\"what%20does%20smart%20search%20%2F%20ai%20do%2C%20and%20is%20it%20required%3F\"><h3>What does Smart Search \/ AI do, and is it required?<\/h3><\/dt>\n<dd><p>No \u2014 Smart Search is entirely optional. When enabled with an API key for OpenAI, Google Gemini, or Anthropic Claude, it adds AI overviews, per-result summaries, typo-tolerant query understanding, intent-based ranking, semantic redirects, related-content suggestions, and click-based personalization on top of the core keyword\/BM25 search engine, which works fully on its own without it.<\/p><\/dd>\n<dt id=\"is%20there%20a%20rest%20api%3F\"><h3>Is there a REST API?<\/h3><\/dt>\n<dd><p>Yes. Rankology exposes REST endpoints under <code>rankajlisrh\/v1<\/code> covering search, click tracking, redirects, merchandising, A\/B experiments, engagement tracking, personalization, voice parsing, and Smart Search summary streaming \u2014 suitable for headless WordPress and custom front ends.<\/p><\/dd>\n<dt id=\"does%20rankology%20work%20on%20multisite%3F\"><h3>Does Rankology work on multisite?<\/h3><\/dt>\n<dd><p>Yes. Network-level settings synchronization is available for WordPress multisite installations, with optional per-subsite overrides when individual sites need different settings.<\/p><\/dd>\n<dt id=\"do%20i%20need%20extra%20libraries%20for%20pdf%20or%20docx%20indexing%3F\"><h3>Do I need extra libraries for PDF or DOCX indexing?<\/h3><\/dt>\n<dd><p>Yes, if you want file content indexing beyond plain TXT files. Install <code>smalot\/pdfparser<\/code> for PDF support and <code>phpoffice\/phpword<\/code> for DOCX support via Composer on your server. Rankology detects them automatically when available. They are not bundled with the plugin.<\/p><\/dd>\n<dt id=\"does%20rankology%20bundle%20react%20or%20other%20javascript%20frameworks%3F\"><h3>Does Rankology bundle React or other JavaScript frameworks?<\/h3><\/dt>\n<dd><p>No. The admin dashboard hub uses WordPress core packages (<code>wp-element<\/code>, <code>wp-components<\/code>, <code>wp-i18n<\/code>). Frontend scripts are custom and depend on jQuery, which WordPress provides.<\/p><\/dd>\n<dt id=\"does%20rankology%20send%20data%20to%20external%20services%3F\"><h3>Does Rankology send data to external services?<\/h3><\/dt>\n<dd><p>When <strong>Google-style autocomplete<\/strong> is enabled, partial search terms are sent to Google's public suggest API (<code>suggestqueries.google.com<\/code>) to retrieve suggestion phrases. Responses are cached locally with WordPress transients. All other search, indexing, and analytics data stays on your WordPress site unless you configure email reports through your own mail server via <code>wp_mail()<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Zero-result and low-CTR alerts \u2014 scheduled analytics checks that flag queries returning nothing or rarely clicked.<\/li>\n<li>Trending \/ Popular Searches frontend widget \u2014 Gutenberg block, shortcode, and classic widget support.<\/li>\n<li>Add to cart directly from live search results for WooCommerce products.<\/li>\n<li>Multisite per-subsite overrides on top of existing network settings sync.<\/li>\n<li>Privacy tools integration \u2014 search logs are exportable\/erasable via WordPress core's personal data tools, and tracking respects the WP Consent API \"statistics\" category when present.<\/li>\n<li>Scheduled campaign windows for result merchandising rules (pin\/promote\/hide rules can activate and expire automatically on start\/end dates).<\/li>\n<li>Cache-plugin compatibility layer \u2014 automatic detection and remediation adapters for common caching plugins so cached pages don't serve stale search results.<\/li>\n<li>Admin information architecture consolidated from 15 to 11 sidebar rows, with several settings relocated to their correct tabs.<\/li>\n<li>Search Tuning tabs now switch in place with per-tab hero sections; sidebar \"jump\" links now stay in sync with the active tab across all Settings and Integrations pages.<\/li>\n<li>Analytics &amp; Logs Engagement tab now shows the scroll-depth funnel and mouse heat zones side by side.<\/li>\n<li>Admin settings clarity, field dependency wiring, and save-safety across multiple settings tabs.<\/li>\n<li>Full PHPCS compliance pass across analytics, multisite, and Smart Search code, and remaining unprefixed JS globals prefixed per WordPress.org plugin review guidance.<\/li>\n<li>Database schema updated to version 1.10.0 (automatic on activation\/update, no manual action needed).<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>Live AJAX search with autocomplete, multiple layouts, themes, and responsive UI.<\/li>\n<li>Custom search index with BM25 relevance scoring, field weights, and optional PDF\/DOCX\/TXT extraction.<\/li>\n<li>Search Widgets (custom post type) with Gutenberg block, shortcode, and classic widget support.<\/li>\n<li>Advanced live filters: taxonomy, price range, custom fields, and visual filter builder.<\/li>\n<li>WooCommerce product search with price display and SKU weighting.<\/li>\n<li>Analytics &amp; Search Logs: top queries, trending terms, zero-result tracking, click logging, CSV\/PDF export, and email reports.<\/li>\n<li>Query redirect rules with admin UI and REST API.<\/li>\n<li>REST API, rate limiting, transient caching, modal search, and voice search.<\/li>\n<li>WP-CLI index commands, multisite network settings sync, and legacy plugin migration tools.<\/li>\n<\/ul>","raw_excerpt":"High-performance AJAX live search with relevance ranking, advanced filters, search analytics, and WooCommerce support.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/326318","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=326318"}],"author":[{"embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/rankology"}],"wp:attachment":[{"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=326318"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=326318"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=326318"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=326318"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=326318"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ar.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=326318"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}