Title: Solr for WordPress
Author: mattweber
Published: <strong>April 21, 2009</strong>
Last modified: December 13, 2011

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/solr-for-wordpress.svg)

# Solr for WordPress

 By [mattweber](https://profiles.wordpress.org/mattweber/)

[Download](https://downloads.wordpress.org/plugin/solr-for-wordpress.0.5.1.zip)

 * [Details](https://scn.wordpress.org/plugins/solr-for-wordpress/#description)
 * [Reviews](https://scn.wordpress.org/plugins/solr-for-wordpress/#reviews)
 *  [Installation](https://scn.wordpress.org/plugins/solr-for-wordpress/#installation)
 * [Development](https://scn.wordpress.org/plugins/solr-for-wordpress/#developers)

 [Support](https://wordpress.org/support/plugin/solr-for-wordpress/)

## Description

A WordPress plugin that replaces the default WordPress search with Solr. Features
include:

 * Index pages and posts
 * Enable faceting on fields such as tags, categories, author, and page type.
 * Indexing and faceting on custom fields
 * Multisite support
 * Treat the category facet as a taxonomy
 * Add special template tags so you can create your own custom result pages to match
   your theme.
 * Completely replaces default WordPress search, just install and configure.
 * Completely integrated into default WordPress theme and search widget.
 * Configuration options allow you to select pages to ignore, features to enable/
   disable, and what type of result information you want output.
 * i18n Support
 * Multi server/core support
 * Note that this plugin requires you to have an instance of Solr using a schema
   with the following fields: id, permalink, title, content, numcomments, categories,
   categoriessrch, tags, tagssrch, author, type, and text. The facet fields (categories,
   tags, author, and type) should be string fields. You can make tagssrch and categoriessrch
   of any type you want as they are used for general searching. The plugin is distributed
   with a Solr schema you can use at `solr-for-wordpress/schema.xml`.

### Credits

Dominique Bejean for custom field support and testing.
 Eric Pugh multi server support.
Dustin Rue – fixes for batch import and multisite.

## Screenshots

 * [[
 * Configuration Page
 * [[
 * Example of results page in default WordPress Theme

## Installation

 1. Upload the `solr-for-wordpress` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Configure the plugin with the hostname, port, and URI path to your Solr installation.
 4. Load all your posts and/or pages via the “Load All Posts” button in the settings
    page.

#### Custom Theme Integration

 1. Create a new theme file called “s4w_search.php”.
 2. Insert your markup, use template methods s4w_search_form() and s4w_search_results()
    to insert the search box and results respectively.
 3. Add result styling to your theme css file, see `solr-for-wordpress/template/search.
    css` for an example.
 4. You can use the search widget in your sidebar for search, or use a custom search
    box that submits the query in the parameter “s”.

## FAQ

  What version of WordPress does Solr for WordPress work with?

Solr for WordPress works with WordPress 3.0 and greater.

  What version of Solr is required.

Solr 1.4 or greater.

  Can I enable/disable specific facets.

Yes, from the settings page. Uncheck the “Facet on FIELD” option, for the FIELD 
you don’t want a facet for.

  Do I need to run my own Solr server to use this plugin?

No, there are Solr hosting providers that will setup and manager Solr for you. As
long as they allow custom schema’s and support the
 standard Solr http api, then
the plugin should work. Some sites:

http://www.mysolrserver.com/
 http://www.websolr.com/ http://powcloud.com/

  Can I run a local instance of Solr for testing?

Yes, you may grab a copy from the apache website: http://www.apache.org/dist/lucene/
solr/
 Since it runs on java solr is platform independent, just make sure you have
java install So go ahead and Download the .tgz/.zip file (there is no difference).
1) Extract the files you have downloaded 2) Copy the schema file (schema.xml) from
this plugin to the folder you extracted ‘apache-solr-_/examples/solr/conf/’ (yes
overwrite the file there) 3) Open up terminal and then go to where you extracted
the files and inside ‘./apache-solr-/examples’ run the command “java -jar start.
jar”

For any further information please the README that comes with solr.

  What is a taxonomy

A taxonomy is a hierarchal facet. This means that your subcategories will be treated
as a child to the parent category instead of an individual facet.

Here is what an example category taxonomy look like:

    ```
    -States
    ---California
    ------Los Angeles
    ---New York
    ------New York
    ```

Here is that same category not treating it as a taxonomy:

    ```
    -States
    -California
    -Los Angeles
    -New York
    -New York
    ```

As you can see, treating it as a taxonomy is much better.

  I was treating the category as a taxonomy disabled it, now my category facet looks
weird

You need to delete and re-index your data.

  How do I know what html tags to style in my custom theme

See `solr-for-wordpress/template/search.css` for an example, or view the source 
of the search results.

  Can I create a custom search page such as http://www.myblog.com/search/?

Yes, it is fairly trivial as well. Follow the steps for custom theme integration.
At the top of that page, insert a comment similar to the following:

Login to the WordPress admin GUI, select add new page, set the title of the page
to “Search”. On the right hand side you will see a drop-down box that says “Template”,
click that and select “Search”. Leave the content of the page blank and publish 
the page.

You will have have your “/search/” page.

  I need the output of this plugin in a different language

Solr for WordPress is internationalized. There is supplied .pot file that you can
use for translations. See https://codex.wordpress.org/Translating_WordPress for 
more details.

  How do I find out the page or post id to exclude?

Login to the WordPress admin, select pages, click the page you want to exclude. 
The post id is what you are looking for, you can find it in the titlebar as the &
post= parameter. In this example, the page id is 22, http://www.yourblog.com/wp-
admin/page.php?action=edit&post=22.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Solr for WordPress” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ mattweber ](https://profiles.wordpress.org/mattweber/)

[Translate “Solr for WordPress” into your language.](https://translate.wordpress.org/projects/wp-plugins/solr-for-wordpress)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/solr-for-wordpress/),
check out the [SVN repository](https://plugins.svn.wordpress.org/solr-for-wordpress/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/solr-for-wordpress/)
by [RSS](https://plugins.trac.wordpress.org/log/solr-for-wordpress/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **0.5.1**
 *  Last updated **14 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **3.2.1**
 *  Language
 * [English (US)](https://wordpress.org/plugins/solr-for-wordpress/)
 * Tags
 * [custom search](https://scn.wordpress.org/plugins/tags/custom-search/)[search](https://scn.wordpress.org/plugins/tags/search/)
   [search integration](https://scn.wordpress.org/plugins/tags/search-integration/)
   [search results](https://scn.wordpress.org/plugins/tags/search-results/)[solr](https://scn.wordpress.org/plugins/tags/solr/)
 *  [Advanced View](https://scn.wordpress.org/plugins/solr-for-wordpress/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/solr-for-wordpress/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/solr-for-wordpress/reviews/)

## Contributors

 *   [ mattweber ](https://profiles.wordpress.org/mattweber/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/solr-for-wordpress/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://www.mattweber.org)