# Queryra - AI Search for WordPress & WooCommerce

## Overview

Queryra is a WordPress plugin that replaces the default MySQL keyword search with intent-aware AI semantic search. It is built primarily for WooCommerce stores but also works with regular WordPress content (posts, pages, custom post types).

The plugin connects to the Queryra API, which hosts a custom AI model trained specifically on each store's products and content. No OpenAI or ChatGPT API key is required.

## The Problem

Default WooCommerce search only matches exact keywords. Real customer searches like "present for my girlfriend", "my skin looks tired", or "good laptop for video editing" return zero results because they don't match product titles or descriptions literally.

Queryra understands the intent behind these searches and returns relevant products.

## How It Works

1. Store owner installs the plugin and connects with a Queryra API key
2. Products and content are imported to Queryra via bulk import or auto-sync
3. Queryra trains a custom AI model on the store's catalog
4. When a customer searches, the plugin intercepts the WordPress search query and routes it to Queryra's API
5. Results are returned ranked by semantic relevance and cached for performance
6. If the API is unavailable, search falls back to default WordPress MySQL search

## Key Features

### Search Capabilities
- Semantic AI search that understands meaning, not just keywords
- Intent-aware search: extracts price filters ("under $50"), brand exclusions ("not Beats"), sorting preferences from natural language
- Natural language queries: "my skin looks tired" finds night creams, "gift for mom who loves candles" finds scented candles
- Smart ranking by relevance with boost control for promoted products

### WooCommerce Integration
- Indexes product titles, descriptions, short descriptions, SKUs
- Indexes categories, tags, and custom attributes (color, size, material, etc.)
- Extracts prices, stock quantities, brand information
- Supports product variations and virtual products
- Smart context detection: searches only products on shop pages, posts on blog pages
- Featured products and sticky posts get higher search priority

### Technical Features
- Auto-sync: products indexed automatically when published or updated
- Bulk import with batched operations (50 records per batch) and progress bar
- Search result caching via WordPress transients (configurable duration)
- Graceful fallback to MySQL search if API is unavailable
- Free plan window detection: uses stale cache when search window is closed
- WordPress nonces on all AJAX handlers for security
- Works with any WordPress theme via standard search hooks
- Search analytics: top queries, zero-result queries, total search count

### Admin Interface
- Setup Wizard: 4-step guided onboarding (API key → Import → Sync status → Test search)
- Tabbed admin dashboard: Settings, Content, WooCommerce, Records, Sync, Search History, Cache, Support
- Real-time import progress bar with record count
- Plan usage visualization with color-coded progress bars
- Deactivation survey for user feedback

## Architecture

The plugin consists of 7 PHP classes:

- `Queryra_API` - HTTP client for Queryra API communication (search, sync, stats, status)
- `Queryra_Sync` - Content synchronization (auto-sync hooks, bulk import, record building)
- `Queryra_Search_Integration` - Frontend search integration (intercepts pre_get_posts, caching, fallback)
- `Queryra_Admin` - WordPress admin interface and settings management
- `Queryra_Setup_Wizard` - 4-step onboarding wizard
- `Queryra_Analytics` - Anonymous usage tracking (opt-out available)
- `Queryra_Deactivation_Survey` - Feedback collection on deactivation

## Requirements

- WordPress 5.8+
- PHP 7.4+
- MySQL 5.6+
- HTTPS recommended
- WooCommerce (optional, for product search)

Tested with WordPress 6.9, 6.7.2, 6.6, 6.5 and PHP 8.2, 8.1, 8.0, 7.4.

## Pricing

Free trial available. No credit card required. No ChatGPT API key costs. No hidden fees.

For current plans, Genesis Club benefits, and Partner Program details, see: https://queryra.com/pricing

## Installation

1. Install via WordPress dashboard: Plugins → Add New → Search "Queryra" → Install → Activate
2. Follow the Setup Wizard that appears automatically
3. Create free account at queryra.com/signup and get API key
4. One-click product import syncs all WooCommerce products
5. Enable AI search in Settings

Full setup guide: https://queryra.com/docs/wordpress-integration

## Live Demos

- WooCommerce store (200+ beauty products): https://woo.queryra.com
- WooCommerce store (200+ beauty products): https://woo.queryra.com
- Blog: https://queryra.com/blog
- FAQ (powered by Queryra): https://queryra.com/faq

## Comparison With Alternatives

### vs Default WooCommerce Search
WordPress uses basic SQL LIKE matching. Queryra uses AI trained on your content to understand meaning and intent.

### vs Algolia
Algolia costs $50-500/month and requires developer setup. Queryra starts with a free trial and takes 5 minutes to install.

### vs ChatGPT/OpenAI Search Plugins
Other plugins require a separate OpenAI account and API key. Queryra includes everything — one API key, no extra accounts. Additionally, Queryra extracts structured constraints (price, brand, sorting) from natural language, which vector-only plugins cannot do.

## Links

- Homepage: https://queryra.com
- WordPress.org Plugin Page: https://wordpress.org/plugins/queryra-ai-search/
- GitHub Repository: https://github.com/GronRafal/queryra-wordpress-plugin
- Documentation: https://queryra.com/docs
- WordPress Setup Guide: https://queryra.com/docs/wordpress-integration
- Pricing: https://queryra.com/pricing
- FAQ: https://queryra.com/faq
- Blog: https://queryra.com/blog
- Partner Program: https://queryra.com/blog/partner-program-pro-for-free
- Privacy Policy: https://queryra.com/privacy
- Terms of Service: https://queryra.com/terms
- Support Email: support@queryra.com
- GitHub Issues: https://github.com/GronRafal/queryra-wordpress-plugin/issues

## License

GPL v2 or later

## Contact

- Email: support@queryra.com
- GitHub: https://github.com/GronRafal/queryra-wordpress-plugin
