===  WPSOLR – AI & Elasticsearch Search for WordPress ===
Contributors: wpsolr
Author: wpsolr
Current Version: 24.4
Author URI: https://www.wpsolr.com/
Tags: ai search, search, ajax search, live search, product search
Requires at least: 6.0
Tested up to: 6.9.1
Stable tag: 24.4
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Replace WordPress search with AI, vector, and Elasticsearch-powered search

== Description ==

WPSOLR replaces WordPress native search with fast, scalable AI and keyword search.

Connect WordPress to modern search engines like Weaviate, Vespa.ai, Elasticsearch, OpenSearch, and Apache Solr using Docker or cloud services.

Features include instant search results, autocomplete suggestions, faceted navigation, and content recommendations—on the frontend and in the WordPress admin.

* No more slow MySQL LIKE queries
* Built for large content sites, WooCommerce stores, and communities
* Works with AI, vector, hybrid, and keyword search engines

See WPSOLR in action: search 700,000 WordPress posts in real time.
[youtube https://www.youtube.com/watch?v=sttS9fD6DnE]

= Core features =

- Replaces WordPress search and archive queries (frontend & backend)
- Adds real-time search suggestions inside search bars
- Adds faceted search widgets (filters)
- Adds More-Like-This recommendation widgets on the frontend

---

== Option 1 – Use the setup wizard (no Docker required) ==

If you cannot install Docker, our guided wizard configures WordPress search automatically using:

- A free trial Apache Solr index hosted by [OpenSolr](https://opensolr.com/faq/view/billing/34/solr-cloud-free-membership)
- AJAX search with instant results
- Autocomplete and suggestions
- Facets (filters)
- Related content recommendations

---

== Option 2 – Install your own search engine with Docker ==

Run your [search stack](https://github.com/eostis-sarl/wpsolr-stacks) on-premise or in the cloud using Docker:

- Docker search for [PostgreSQL with Timescale extensions](https://www.wpsolr.com/how-to-easily-configure-postgresql-ai-search-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keyword BM25 / hybrid / vector)
- Docker search for [OpenSearch](https://www.wpsolr.com/how-to-easily-configure-opensearch-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keyword / hybrid / vector)
- Docker search for [Weaviate](https://www.wpsolr.com/how-to-easily-configure-weaviate-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free)  (keyword / hybrid / vector)
- Docker search for [Vespa.ai](https://www.wpsolr.com/how-to-easily-configure-vespa-ai-search-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keyword / hybrid / vector)
- Docker search for [Elasticsearch](https://www.wpsolr.com/how-to-easily-configure-elasticsearch-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keywords)
- Docker search for [Apache Solr](https://www.wpsolr.com/how-to-easily-configure-solr-on-wordpress/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keywords)

---

== Option 3 – Cloudways users ==

Use Cloudways’ pre-installed search services:

- Cloudways WordPress search for [OpenSearch](https://www.wpsolr.com/guide/configuration-step-by-step-schematic/configure-your-indexes/0-connect-your-indexes/create-an-elasticsearch-index/create-a-cloudways-elasticsearch-index/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keywords)
- Cloudways WordPress search for [Elasticsearch](https://www.wpsolr.com/guide/configuration-step-by-step-schematic/configure-your-indexes/0-connect-your-indexes/create-an-elasticsearch-index/create-a-cloudways-elasticsearch-index/?utm_source=wordpress.org&utm_campaign=wpsolr_free) (keywords)

---

== Free vs Enterprise ==

= Free version =
- Replace WordPress search (frontend & backend)
- Keyword search with Solr, Elasticsearch, OpenSearch
- AI / vector search with Weaviate and Vespa.ai
- Search suggestions & autocomplete
- Faceted search widgets
- More-Like-This recommendations
- Docker & Cloudways support

= WPSOLR Enterprise =
- WooCommerce advanced search (prices, stock, variations, orders, coupons)
- AI-powered vector & hybrid search at scale
- Multiple search engines at the same time
- AI personalization (Algolia AI, Google Retail)
- AI recommendations (Algolia Recommend, Amazon Personalize, Recombee)
- AI connectors for RAG & Chatbots (AWS, GCP, Kafka, Pub/Sub)
- Advanced facets (range, sliders, hierarchy, color, date)
- ACF custom fields as facets
- Enterprise hosting providers & SLA support
Visit us to discover [more features](https://www.wpsolr.com/?utm_source=wordpress.org&utm_campaign=wpsolr_free)


== Videos – WPSOLR Enterprise ==

Searching 180,000 Products in WooCommerce
[youtube https://youtu.be/vwvIrNPm_jY?si=AKG3LD_087iLuD4n]

Searching 200,000 Posts in a WordPress News Site
[youtube https://youtu.be/ZRJhXbOIxiw]

Searching 3 million topics in bbPress
[youtube https://www.youtube.com/watch?v=f2hSN1gCyvA]

Destination Site Search with Keyword Autocompletion and Infinite Load
[youtube https://youtu.be/06oYnIA9tmA]

Multilingual vector search with Weaviate and Cohere
[youtube https://www.youtube.com/watch?v=PwmI9VHJSkg]

10× faster suggestions with Elasticsearch
[youtube https://www.youtube.com/watch?v=plJ3Sv4ypUI]

WooCommerce suggestions in 250 ms (100k products)
[youtube https://www.youtube.com/watch?v=YVB3eFG5nLY]

WooCommerce suggestions in 195 ms (873 products)
[youtube https://www.youtube.com/watch?v=ARj32Ltcwb0]

Image search in WordPress media with Weaviate
[youtube https://www.youtube.com/watch?v=6hocA93nqjg]

== Screenshots ==
1. Search results displayed with the plugin - 700,000 posts
2. Search results displayed with the plugin - 7 Million visits/month

== Changelog ==

= 24.4 =
* (New) Opensearch with vectors: BM25 search, vector search, hybrid RRF search, recommendations. Local docker with pre-trained embedding models.

= 24.3 =
* (New) PostgreSQL with Timescale extensions: BM25 search, vector search, hybrid RRF search, recommendations. Local docker with pgai and Ollama embeddings.

= 24.2 =
* (new) Weaviate delete by post type
* (fix) Apache Solr/SolrCloud facet limit

= 24.1 =
* (new) New <a href="https://www.wpsolr.com/wpsolr-search-hosting/" target="_new" rel="noopener">Opensearch search hosting</a> with WPSOLR support

= 24.0.2 =
* (fix) Remove Monolog from dependencies

= 24.0.1 =
* (fix) Security patch
* (fix) Fatal error due to <a href="https://www.wpsolr.com/forums/topic/php-fatal-error-declaration-of-monologloggeremergency/" target="_new" rel="noopener">Monolog incompatible version</a> detected with WordPress 6.7.2

= 24.0 =
* (fix) OpenSearch shard and replication
* (fix) OpenSearch logs warning

= 23.9.1 =
* (new) Vespa.ai vector/hybrid/keywords search

= 23.9 =
* (new) 60 seconds configuration wizard with free opensolr.com hosting

= 23.8 =
* (new) Related posts with Weaviate: retrieve semantically similar posts, with extra filters.
* (new) Related posts with Elasticsearch: retrieve text similar posts (More Like This), with extra filters.
* (new) Related posts with OpenSearch: retrieve text similar posts (More Like This), with extra filters.
* (new) Related posts with Solr: retrieve text similar posts (More Like This), with extra filters.
* (fix) Fix missing $ajax_delay_ms initialization

= 23.7 =
* (new) Add settings to use any jQuery-Autocomplete option with suggestions
* (new) Add post excerpt to boosts
* (new) Index taxonomy’s featured image url for helping catalog discovery in external tools like Algolia

= 23.6 =
* (new) Index featured image url for helping catalog discovery in external tools
* (fix) real-time indexing not working on creation
* (fix) SQL full-text search should not be executed
* (fix) Random sort with Elasticsearch
* (fix) Deprecated parse_str()

= 23.5 =
* (Fix) Solr syntax error with facets containing ” and ”
* (Fix) Facets containing “:” are not selected
* (fix) Facets javascript error in backend search when several views

= 23.4 =
* (deprecation) Deprecated Elasticsearch server 7.x version. Requires Elasticsearch server 8.x version
* (php client) Update Elasticsearch PHP client from version 7. to version 8.
* (new) Weaviate GPT4All vectorizer
* (new) Self-signed node certificate setting for docker OpenSearch SSL
* (new) Self-signed node certificate setting for docker Elasticsearch SSL
* (new) Self-signed node certificate setting for docker Apache Solr SSL
* (new) Self-signed node certificate setting for docker Weaviate SSL
* (new) Button to clone index settings
* (fix) Option to switch Solarium client from http to curl
* (fix) Weaviate slider (numeric and dates),and range, facets
* (fix) Weaviate sort on archive taxonomies

= 23.3 =
* Tested with PHP 8.1 and WordPress 6.2.2
* (new) Rerank Weaviate search results with the <a href="https://weaviate.io/developers/weaviate/modules/retriever-vectorizer-modules/reranker-transformers" rel="noopener" target="_blank">local cross-encoder transformers</a>.
* (Fix) <a href="https://www.wpsolr.com/forums/topic/wonky-results-when-terms-have-same-name-but-belong-to-different-parents">Taxonomy archives with duplicate term names</a>.
* (Fix) Weaviate maximum number of facet items
* (Fix) Weaviate alphabetical sort of facet items

= 23.1 =
* Tested with PHP 8.1 and WordPress 6.2.2
* (new) Set horizontal/vertical orientation on views’ facets. For instance, choose horizontal facets on admin search and vertical on front-end search.
* (fix) Boost categories does not work
* (fix) Wrong archive results with duplicated category names
* (fix) Filters are wrongly showing results with partial matching
* (Fix) Fix some “utf-8-middle-byte” errors with mb_substr()

= 23.0 =
* (fix) Tested with PHP8.1
* (fix) Apply <a href="https://weaviate.io/developers/weaviate/configuration/schema-configuration#property-tokenization">property tokenization</a> to Weaviate indices, to prevent tokenization on facets.
* (fix) <a href="https://www.wpsolr.com/forums/topic/error-in-region-field/">OpenSolr credentials error</a>.
