=== WPSOLR Search Engine ===

Contributors: WPSOLR.COM

Current Version: 3.7

Author:  WPSOLR.COM

Author URI: http://wpsolr.com/ 

Tags: Solr in WordPress, relevance, Solr search, fast search, wpsolr, apache solr, better search, site search, category search, search bar, comment search, faceting, relevant search, custom search, facets, page search, autocomplete, post search, online search, search, spell checking, search integration, did you mean, typeahead, search replacement, suggestions, search results, search by category, multi language, seo, lucene, solr, suggest, apache lucene

Requires at least: 3.7.1

Tested up to: 4.2.2

Stable tag: 3.7

Replace your sluggish and rigid SQL search with the world open source leader Apache Solr wich powers the leading internet websites

== Description ==

Compatible with Apache Solr up to Solr 5.2

Boost your search with multi-media content (pdf, .xls, .doc), facet filters, autocompletion, suggestions, and optional hosting.

Standard WP search is performed by SQL queries directly on the database. So do most of search plugins.
But SQL is awfully greedy in computer resources, especially when it comes to table joins and wild cards (select * where field like ‘%keyword%’), which are both heavily used by search.
And SQL can’t keep well with natural language: synonyms, language specific plurals, stop-words, …

Fortunately, performance and relevance are features built specifically in full-text search engines.
Using a search engine, you’ll be able to deliver more accurate search to your visitors, for far less computer resources, which means better for cheaper.

The purpose of this plugin is to help you setup your dear Wordpress search to your own Apache Solr server, or to a hosted Apache server.
Apache Solr is the World leading Open source full-text Search Engine. No question on that.

And now, with this plugin, you can get it for free. So, fasten your seat belt, and enjoy the trip.


= Features =

1. Benefit from Apache Solr for faster, better search results.
2. Incremental indexing: only new or updated posts are indexed. Perfect for tens of thousands of posts.
3. Real-time indexing: as soon as a post is published/unpublished, it is indexed/de-indexed. No outdated results are displayed.
3. Search in post attachements: pdf, .doc, .xls ...
4. Text-analysis to break down search phrases, to search entire phrase or individual words.
5. Advanced faceted search on fields such as tags, categories, author, and page type and custom fields.
6. Highlighted search words in the text.
7. Autocomplete suggestions, correct spelling mistakes
8. Provide a "Did you mean?" query suggestion.
9. Sorting based on time and number of comments.
10. Configuration options allow you to select pages to ignore.
11. Host Solr remotely using gotosolr.
12. Solr configuration made easy.

For more details visit <a href='http://wpsolr.com'>wpsolr.com</a>

For a live demo visit <a href='http://www.gotosolr.com/search-results/?search=solr'>live search page demo</a>. Try the live search (autocompletion), on words like « solr », « cassandra », « security », « indexes », « search ». Notice the facets on the left side with their nice clicked Ajax display, the terms highlighting in the results snippets, the « order by » drop-down list. To test the « did you mean » (suggestions on misspelled words), you can search on « soler » (suggested as « solr »), or « casandra » (suggested as « cassandra »).


== Installation ==

1. Upload the WPSOLR-Search-Engine folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to the 'WPSOLR' settings page and configure the plugin.
4. Please refer the Installation and User Guide for further reference.


== Changelog ==

= 3.7 =
* Fix random error "undefined index: skey" when setting local Solr hosting.

= 3.6 =
* Fix JQuery issues on button emptying the index (not working on Safari, false errors displayed elsewhere).

= 3.5 =
* Add a debug checkbox on the indexing admin screen. By activating the debug mode, many details are displayed during the indexing process, to help solve difficult issues with Solr.

= 3.4 =
* Display errors occurring while deleting the Solr index data.
* Increase Solr timeout from 5 seconds to 30 seconds.

= 3.3 =
* Fix curl CA verification error when calling a Solr index protected with https.

= 3.2 =
* WPSOLR is now compatible with the latest Solr 5.x versions. Tested up to Solr 5.2.

= 3.1 =
* Fix bug on filters which prevented custom fields to be indexed.

= 3.0 =
* Prevent new posts/pages in status 'auto-draft' from calling Solr.

= 2.9 =
* Fix bug on Windows installations: "Warning: session_start(): Cannot send session cache limiter - headers already sent ".

= 2.8 =
* Fix bug which prevented some keywords to be highlighted in search results snippets.

= 2.7 =
* Fix bug which prevented partial search "tem1 term3" to match results, while "tem1 term2 term3" did.
* "Did you mean" now displays multiple terms suggestions. For instance "salr serch" can now suggest "solr search".

= 2.6 =
* WARNING: this version will require you to re-index all your documents. It can take a while if you have a large amount of documents in your WP database.
* Introduce a new filter for developpers to tweak custom fields sent to Solr

= 2.5 =
* Compatible with Solr 5.x: you'll need to use the new schema.xml

= 2.4 =
* WARNING: this version will require you to re-index all your documents. It can take a while if you have a large amount of documents in your WP database.
* Improved indexing process for large amount of data: the default batch size can be changed, timeouts are caught.

= 2.3 =
* Integration with <a href="https://wordpress.org/plugins/s2member/" target="_blank">s2member plugin</a>: filter Solr results with user levels and custom capabilities.

= 2.2 =
* Fix custom taxonomies to be searchable (they used to be displayed in facets only). As a side effect, <a href="https://wordpress.org/plugins/woocommerce/" target="_blank">WooCommerce</a> product taxonomies (product_cat , product_tag) are now searchable.

= 2.1 =
* Installation failed with PHP <= 5.3: fixed.

= 2.0 =
* Integration with <a href="https://wordpress.org/plugins/groups/" target="_blank">Groups plugin</a>: filter Solr results with user groups and posts capabilities.
* Stop the indexing process when attacements fail, and display the attachment name in error. Can be related to php security.

= 1.9 =
* Display thumbnail on page result lines.

= 1.8 =
* Do not open a new page when clicking on a page result line.

= 1.7 =
* Restart indexing at last document indexed (wether it fell in error, or timeout occured)
* Prevent index deletion when indexing starts
* Index post attachements
* Add attachements checkbox in menu Solr Options -> Indexing Options -> Post types to be indexed.
* Improve Solr error messages in Solr hosting tab, and Solr operations tab, including timeout messages.

= 1.6 =
* Can now index tens of thousands of documents without freezing or timeout

= 1.5 =
* Fixed an issue with older php versions. Should activate and work from PHP 5.2.4 at least.

= 1.4 =
* Fixed warning on search page for self hosted Solr
* Requires to reload yor index with the new config files (solrconfig.xml, schema.xml). Fixed error on autocomplete, and search page with "did you mean" activated, for self hosted Solr 

= 1.3 =
* Speed up search results display.

= 1.2 =
* Speed up autocompletion by 3 times.

= 1.1 =
* Improved error message when Solr port is blocked by hosting provider.
* Bug fix: Solr port used to be 4 digits. Can now be 2 digits and more.

= 1.0 =
* First version.


== Frequently Asked Questions ==

= Which PHP version is required?=

WPSOLR uses a Solr client library, Solarium, which requires namespaces.

Namespaces are supported by PHP >= 5.3.0

= How do I install and configure Solr? =

Please refer to our detailed <a href='http://wpsolr.com/installation-guide/'>Installation Guide</a>.


= Can I host Solr on my server? =

Yes. But you can also host Solr remotely on gotosolr.


= What version of Solr does the WPSOLR Search Engine plugin need? =

WPSOLR Search Engine plugin is <a href="http://wpsolr.com/releases/#1.0"> compatible with the following Solr versions</a>. But if you were going with a new installation, we would recommend installing Solr version 3.6.x or above.


= Does WPSOLR Search Engine Plugin work with any version of WordPress? =

As of now, the WPSOLR Search Engine Plugin works with WordPress version 3.8 or above.


= Does WPSOLR Search Engine plugin handle custom post type, custom taxonomies and custom fields? =

Yes. The WPSOLR Search Engine plugin provides an option in dashboard, to select custom post types, custom taxonomies and custom fields, which have to be indexed.

 
= Can custom post type, custom taxonomies and custom fields be added faceted search? =

Yes. The WPSOLR Search Engine plugin provides option in dashboard, to select custom post types, custom taxonomies and custom fields, to be added in faceted search.


= Do you offer support? =

You can raise a support question for our plugin from wordpress.org