Trac Advanced Search Plugin

An advanced search plugin for the open source Trac project (http://trac.edgewall.org/). This Trac plugin allows you to use a full-text search engine (such as Apache Solr) as the search backend for performing search in Trac. This plugin also includes a backend for Apache Solr (http://lucene.apache.org/solr/), but other plugins can use the extension point provided by this plugin to query a different backend.

This plugin is known to be compatible with Trac 0.12 with Solr 3.1, as well as Trac 1.0.1 with Solr 4.3.1.

See the interface in plugin-src/advsearch/interface.py for details about which methods to implement.

See http://trac.edgewall.org/wiki/TracDev for more information about developing a Trac plugin.

How it works

Once your existing tickets/wiki documents are indexed in the backend you can make requests using the Advanced Search form. These searches will be handled by the search backend you have configured in trac.ini. When new documents or tickets are added upsert_document() will be called on each search backend to update the index immediately.

Project Status

Stable, and active.

Requirements

The following python packages are required for the solr backend.

pysolr (https://github.com/toastdriven/pysolr)

Installation

This assumes you already have a Trac environment setup.

1. Build and install the plugin

cd plugin-src
python setup.py bdist_egg
cp ./dist/TracAdvancedSearch-*.egg <trac_environment_home>/plugins

2. Setup the search backend. If you're using solr, copy and modify the configuration files provided.

cp ./solr/conf/* <solr_home>/conf

3. Index your current tickets and wiki pages in the search backend. If you're using solr, see ./solr/conf/data-config.xml

4. Configure your trac.ini (see the Configuration section below).

5. Restart the trac server. This will differ based on how you are running trac (apache, tracd, etc).

That's it. You should see an Advanced Search button in the main navbar.

Configuration

In trac.ini you'll need to configure whichever search backend you're using. If you're using the default pysolr backend, add something like this:

[pysolr_search_backend]
solr_url = http://localhost:8983/solr/
timeout = 30

[advanced_search_plugin]
menu_label = Real Search

button_label and timeout are both optional.

The default pysolr backend queries to solr for indexing synchronously. If you want to do indexing asynchronously, add like this:

[pysolr_search_backend]
async_indexing = true
async_queue_maxsize = 10000  # if 0, the queue size is infinity
...

If you want to search with all words as a default, add like this:

[pysolr_search_backend]
default_operator = AND
...

You'll also need to enable the components.

[components]
tracadvsearch.advsearch.* = enabled
tracadvsearch.backend.* = enabled

Remove Search button

To disable the old search add the following to <project_env>/conf/trac.ini. Your trac.ini may already have a components section.

[components]
trac.search.web_ui.SearchModule = disabled