Skip to main content

A drop-in replacement for the Haystack Elasticsearch backend which allows multilingual indexes for Django.

Project description

# django-multilingual-search
A multilingual Haystack plugin for Django and Elasticsearch.
The module is a drop-in replacement for the Haystack `ElasticsearchSearchEngine`.

Instead of a single index it creates an index for each language specified in `settings.LANGUAGES`.

A query is routed to the index of the currently active language.

[![Build Status](https://travis-ci.org/sbaechler/django-multilingual-search.svg?branch=master)](https://travis-ci.org/sbaechler/django-multilingual-search)

## Installation

Install with pip:

pip install django-multilingual-search

The major and minor versions of this project correspond to the Haystack version the package was
tested against. This version is for Haystack 2.4.


## Configuration

The app provides a drop-in replacement for the ElasticsearchEngine of Haystack.
To use it, specify this engine in `settings.py`:

HAYSTACK_CONNECTIONS = {
'default': {
'ENGINE': 'multilingual.elasticsearch.ElasticsearchMultilingualSearchEngine',
'URL': 'http://127.0.0.1:9200/',
'INDEX_NAME': 'myproject',
},
}

For automatic indexing of new entries the Haystack
[signal processors](http://django-haystack.readthedocs.org/en/latest/signal_processors.html)
can be used without modification. It is recommended that a custom SignalProcessor be used
instead of the `RealtimeSignalProcessor` because of server timeout issues with the latter.


## Contributing

Please read the [Contributing](./CONTRIBUTING.md) guide.


## Release History

- 2.3.0: First release
- 2.4.0: Update code for compatibility with Haystack 2.4

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-multilingual-search-2.4.0.beta.tar.gz (5.6 kB view details)

Uploaded Source

File details

Details for the file django-multilingual-search-2.4.0.beta.tar.gz.

File metadata

File hashes

Hashes for django-multilingual-search-2.4.0.beta.tar.gz
Algorithm Hash digest
SHA256 04ff95a31cd0a1dd292398b3b4ced085aabfd0b8b7eafb16b9bd1e8fbf9c9717
MD5 a0dea0a01842f2fee88bcd462f928978
BLAKE2b-256 2fce60eef669b294cfa666f121d92dfe25e2089c9ec1daec0d127a8bd929c561

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page