Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

WordPress Sphinx Search Plugin

WordPress Sphinx Search Plugin allows to use Sphinx Search Server power to enable ultra-fast and feature-rich search on WordPress-based websites.

WordPress Sphinx Search Plugin allows to use Sphinx Search Server power to enable ultra-fast and feature-rich search on WordPress-based websites. It is especially useful if your WordPress site becomes very large.

Search results are more relevant and you can search in posts, pages and comments using flexible search syntax, quickly sort the results by freshness, relevance or in both modes. This plugin comes with sidebar widgets to display the most recent searches, top and related search terms.

This plugin replaces WordPress’s built-in search functionality.

Key Features

  • Sort search results by Relevance, Freshness or in both modes
  • Related searches widget is a great SEO tool for finding related search terms
  • Top searches widget is another SEO tool which displays top search terms when no related search terms found
  • Latest searches widget is a SEO tool which is used to display latest search terms of those people are doing right now
  • Widget settings have plenty of options to control widget behavior and quality of widget content
  • Search through posts, pages and comments content
  • Search Management Tools is a set of tools for managing search terms
  • Search Statistics Tool is an analytic tool which can help you analyze search trends of your blog


This plugin is developed by Ivinco. If you need commercial support, or if you’d like WordPress Sphinx Search Plugin customized for your needs, we can help. Visit plugin website for the latest news. See release notes, report bugs and feature wishes on Launchpad:



WordPress Sphinx Search plugin website

WordPress Sphinx Search tutorial

Author Ivinco
Contributors Ivinco, Percona
Tags search, sphinx
  1. wordpress-sphinx-plugin screenshot 1

    You can search by Relevance, Freshness or in both modes

  2. wordpress-sphinx-plugin screenshot 2

    Related searches widget is a great SEO tool for finding related search terms

  3. wordpress-sphinx-plugin screenshot 3

    Search Management Tools is a set of tools for managing search terms

  4. wordpress-sphinx-plugin screenshot 4

    Search Statistics Tool is an analytic tool which can help you analyze search trends of your blog

  5. wordpress-sphinx-plugin screenshot 5

    Widget settings have plenty of options to control widget behavior and quality of widget content


* WordPress 2.0.2 or higher
* Sphinx Search 2.1.9 or higher
* Writable WordPress upload directory for Sphinx configuration files, logs and indexes

Installation guide

Online step-by-step installation guide

Install the plugin

  1. Unpack the plugin archive to wp-content/plugins folder of your WordPress installation
  2. Activate Sphinx Search plugin via WordPress Settings
  3. Make sure WordPress upload directory is writable by web server (by default WordPress is configured to use wp-content/uploads)
  4. Open Sphinx Search settings page and follow Wizard steps to setup Sphinx Search Server first time

Setup scheduled jobs to re-index your website data periodically

To setup periodical re-indexing, you should run Wizard to create special schedule files. The default location of these files is: /path/to/wp-content/uploads/sphinx/cron/. When wizard finishes, edit your Crontab file. Use “crontab -e” command in Linux terminal and add the following lines to your crontab: `


  • Changed plugin release version for WordPress 4.7.1, CSS fix


  • Changed plugin release version for WordPress 4.2


  • Plugin release for WordPress 4.2


  • Plugin code was revised, fixed and tested to use with WordPress 4.2


  • Plugin code was revised and tested with WordPress 4.1


  • Plugin code was revised and tested with WordPress 4.0 Benny.


  • Updated Sphinx Search engine binaries to version 2.1.9.


  • Checked compatibility with WP v 3.9. Updated common styles.


  • FAQ page is updated. Added description of the problem with Plugin's Wizard.


  • Plugin will use static SSE configuration file now instead of dynamic one.


  • Updated installer's auto-detection mechanism which will allow user admin to choose pre-installed Sphinx binaries even on Windows platform.


  • Updated styles to fit new default theme


  • Added support of WP version up to 3.7.1
  • New feature: Tags search. added missed files.
  • New feature: Added an opportunity to search within post tags.
  • Fixed duplicates of statistics when seo URLs are used.
  • Fixed bug with single quote character.
  • Updates to layout of sphinx installation wizard.
  • Small fixes to verification logic of sphinx dirs security.
  • There is a warning of insecure files has been added to plugin configuration section
  • Fixed bug with unescaped html in snippets


  • fix of the bug related with searching for words that are not in the index


  • few miscellaneous fixes in the plugin admin zone
  • insert into sph_stat table improvement


  • Unhooked unnecessary filters
  • Added checking Sphinx connection on remote or local server to determine is Sphinx running


  • Fixed bug in search term escaping
  • Fixed bug in redirect for friendly URLs


  • Added friendly URLs support
  • Added ability to enable/disable friendly urls in Top/Related and Latest search terms widgets
  • Added ability to set maximum number of search results
  • Added tag for listing top search terms on a page
  • Fixed several bugs


  • Added new template tag: top search terms with pagination


  • Fixed bug in ss_isComment tag
  • Fixed search term highlighting bug


  • Added search management tool
  • Added search statistics/analytic report
  • Added new search mode "Freshness & Relevance"
  • Reworked Admin user interface, made it more simple and clear.
  • Added ability to add custom search terms to the top of the Top/Related widget
  • New option "Show only approved search terms" in Top/Related and Latest widgets
  • New option "Show top Searches for last: day, week, months..." in Top/Related widget
  • Added option to run php in quiet mode in sphinx.conf to prevent displaying HTTP headers
  • Replaced MySQL FullText engine with Sphinx Search in Top/Related and Latest widgets
  • Built search management tool and statistics tool over Sphinx Search
  • Added custom css styles file (templates/style.css) for search forms
  • Ivinco icon looking more smoothly with transparent background


  • Added more settings to Top/Related widget.
  • A few bug fixes and minor improvements


  • Added configuration wizard: you can automatically install or reinstall Sphinx via WordPress wp-admin panel
  • Changed default Sphinx installation directory: now Sphinx is installed to WordPress upload directory
  • Using shebang syntax for Sphinx configuration file - it allows to hide the connection parameters from the public access
  • UI fixes for WordPress wp-admin panel
  • Improved error handling: system output is now hidden and human readable error messages were added
  • Added a new sidebar widgets for displaying top/related and latest search terms and a widget for the extended search form
  • Added search term highlighting for search results (in WordPress' the_excerpt tag)
  • Added automatic generation of cron files


  • Added Search powered by Sphinx Search engine
  • Added sort search resutls by Relevance or Freshness
  • Added search by posts, by comments and by pages.
  • Added exclude posts, comments or pages from search results.
  • Added display comments at search results page.
  • Added search non-password protected pages only
  • Added search only approved comments
  • Added "Match Any" search ability - if no one results was found, then it try to search in "Match Any" mode.
  • Added support for tag title of web page - it changed due to entered search keywords
  • Added log of all search results, except empty results
  • Added tag to display Top-n search keywords
  • Added tag to display Latest-n search keywords
  • Added relevant keywords support to the Top-n search keywords bar.
  • Added support to Disable/Enable search by: comments, posts, pages
  • Added support of keywords wrapper settings:
    • Add tag Before and After search keyword in body/title
    • Separator of result snippets
    • Snippet max length
    • Maximum number of words around keyword in snippet
    • Prefix before Posts, Comments and Pages title
    • List of phrases to cut from search results
  • Added configuration for Sphinx index prefix
  • Added configuration for Host
  • Added configuration for Port
  • Added configuration for Configuration file
  • Added configuration for Searchd file
  • Added configuration for Indexer file
  • Added support to reindex all content manually
  • Added support to stop/start search daemon
  • Added support to install Sphinx Search through web interface

Q: What is Sphinx Search Server?

A: Sphinx is a full-text search engine which provides fast and relevant full-text search functionality. Read more on Sphinx website

Q: How to install Sphinx Search manually?

A: To manually install Sphinx use the official Sphinx Search documentation.

Q: How to update the search index?

A: The best option to update search index is to setup cron job task for it. Also you may manually update search indexes through WordPress Sphinx Search administrative interface.

Q: I have just activated the plugin, however when I try to run the Plugin's Wizard it does not do anything. What is wrong?

A: This might be jQuery version collision. Our plugin uses jQuery v1.4 and supposed to work with WordPress up to 3.8 version which uses jQuery v1.x (i.e. 1.10 for WP3.8). Check if your installation has custom plugin or WP is modified to use jQuery v2.x. If so then it will impossible to use our plugin's Wizard.

Q: I have just installed and run the wizard, however I have the following error message. What to do?

Can not start searchd, try to start it manually.

A: If you use version 2.1 or higher you can see the exact command below message “Can not start searchd, try to start it manually.” which you need to run manually through terminal on your server. If you have ‘Permissions problem’ try to run the command as super user.

Q: How to run indexer manually A: Open terminal and run following command: /path/to/indexer -c /path/to/sphinx.conf --rotate --all

Q: When I run searchd or indexer I got ERROR: invalid section type 'X-Powered-By' in ../sphinx.conf line 1 col 1.

A: You are using CGI version of php, by default it shows a http header like "X-Powered-By: PHP/4.3.6" To prevent this, PHP needs to be invoked with the '-q' option for 'quiet'. Open sphinx.conf in editor and change first line to:

#!/usr/bin/php -q

Q: I got WARNING: index 'wp_main': preload: failed to open /path/to/indexes/wp_main.sph No such file or directory; NOT SERVING

A: That means you have no indexes to serve. You need to build them. You may do it via wp-admin or manually: On wp-admin>Settings>Sphinx Search page click "Re-index WordPress index" Or use run this command manually in terminal:

/path/to/indexer -c /path/to/etc/sphinx.conf --all --rotate

Q: Sphinx installs fine, but when I go to search for something on the blog I get no results.

A: Check Sphinx version, Sphinx version should be 0.9.9 or higher.

Q: How do I modify the plugin php script to specify the path where I have Sphinx installed?

A: Run Sphinx Configuration wizard from WP Admin panel. There are two important steps: 1. Install or use existing Sphinx binaries There you can specify the path to your own indexer and searchd 2. Setup path to Sphinx indexes There you can specify where to store index files and sphinx.conf file. This path should be writeable by web server.

Q: Cannot activate plugin. If I try to activate the plugin I get the following PHP error: Fatal error: Cannot redeclare class SphinxClient in /home/wordpress/wp-content/plugins/wordpress-sphinx-plugin/php/sphinxapi.php

A: Check that you haven't: 1. any other plugins which loaded Sphinx Search API library. 2. Sphinx Search PECL extension installed

Q: I’ve got an error “Indexer: configuration files not found.” on clicking “Run Indexing & Contunue” (“Sphinx data indexing” step of Wizard).

A: Check that the user which is running your web server (it's usually apache, www-data or smth like this) can run indexer/searchd and can read/write into sphinx.conf. Then run Sphinx Configuration wizard from WP Admin panel again.

Q: How to set the maximum number of search results above 100.000?

A: 1)Go to Sphinx Search plugin directory and open rep/sphinx.conf in text editor. 2)Find max_matches parameter in searchd section at the bottom of the file 3)Set new value i.e. max_matches = 1000000 4)Open Sphinx Search control panel in WP Admin 5)Click on "Run Sphinx configuration Wizard" and skip all steps in the Wizard, it will rebuilds sphinx.conf file at the last step, click Finish. 6)Restart Sphinx Search (click on "Stop Sphinx daemon" and then "Start Sphinx daemon") 7)Open tab "Search settings" and set the same max_matches value in the field "Maximum number of search results".

= WordPress Delta index update


= Following cron job update delta index every 5 minutes:

= */5 * * * * /usr/bin/php /path/to/wp-content/uploads/sphinx/cron/cron_reindex_delta.php

= WordPress Main index update


= Following cron job update main index daily (at 0 hours and 5 minutes):

= 5 0 * * * /usr/bin/php /path/to/wp-content/uploads/sphinx/cron/cron_reindex_main.php

= WordPress Stats index update


= Following cron job update stats index every 5 minutes

= */5 * * * * /usr/bin/php /path/to/wp-content/uploads/sphinx/cron/cron_reindex_stats.php

<h4>Setup templates and widgets</h4>
Extended search form on search results page


To find out if the current post is comment

<?php if (function_exists('ss_isComment') )
    if (ss_isComment()) echo 'It is comment'; else echo '';?>

Extended search form at the sidebar Use "Sphinx Search sidebar" widget or add it as template tag:

<?php if (function_exists('ss_search_bar'))
    echo ss_search_bar(true); /*put it in sidebar*/?>

Related/Top searches at the sidebar Use "Sphinx Related/Top Searches" widget or add it as template tag:

<?php if (function_exists('ss_top_searches')) ss_top_searches(); ?>

Top searches with pagination Use "ss_top_searches_pager($max_per_page=10, $show_all=false)" template tag to enable pagination for top search terms:

<?php if (function_exists('ss_top_searches_pager')) ss_top_searches_pager(); ?>

Parameters: * $max_per_page - limit how many search terms to display per page, by default 10 * $show_all - If set to True, then it will show all of the pages instead of a short list of the pages near the current page. By default, the 'show_all' is set to false

Latest searches at the sidebar Use "Sphinx Latest Searches" widget or add it as template tag:

<?php if (function_exists('ss_latest_searches')) ss_latest_searches(); ?>

Upgrade the plugin

  1. Unpack the plugin archive to wp-content/plugins folder of your WordPress installation

Arbitrary section

Semi live update - "main+delta" scheme

To enable semi-live index updates also known as "main+delta" scheme, the plugin will create the following table in your MySQL database: `

= in MySQL

= CREATE TABLE wp_sph_stats ( id int(11) unsigned NOT NULL auto_increment, keywords varchar(255) NOT NULL default '', date_added datetime NOT NULL default '0000-00-00 00:00:00', keywords_full varchar(255) NOT NULL default '', status tinyint(1) NOT NULL DEFAULT '0', PRIMARY KEY (id), KEY keywords (keywords) ); ` If your WordPress installation's table prefix is not "wp_", substitute it with the correct value.

Start Sphinx Search at boot

= How to automatically start Sphinx Search daemon at boot:

= * In Debian based systems i.e. Ubuntu:

% update-rc.d "/path/to/bin/searchd --config /path/to/etc/sphinx.conf" defaults
  • In Redhat based systems i.e. Fedora:
% chkconfig --add "/path/to/bin/searchd --config /path/to/etc/sphinx.conf"
Version 3.10.2

Requires WordPress version: 2.0.2 or higher

Compatible up to: 4.7.2

Last Updated 25 Jan 2017

Date Added: 24 Feb 2009

Plugin Homepage


4 stars
9 ratings


Not Enough Data

Works: 0
Broken: 0