Django-SEKH
Django Search Engine Keywords Highlighter,
is a middleware for Django providing the capacities to highlight the user's search keywords if he is coming from a search engine like Google, Yahoo or a custom search form plugged in your Website.
It retrieves the keywords of the search and decorate them with a span
markup containing the classes highlight term-X
for CSS makuping.
Contents
Installation
First of all you need to install BeautifulSoup >= 4.0.
Then install the package in your PYTHON_PATH
by getting the sources and run setup.py
or use pip
.
$ pip install -e git://github.com/Fantomas42/django-sekh.git#egg=django-sekh
Usage
In your settings file, simply add this middleware at the end of the list.
MIDDLEWARE_CLASSES = ( ... 'sekh.middleware.KeywordsHighlightingMiddleware', )
This is it !
Search Engines
Currenty django-sekh supports these search engines :
- Ask
- Baidu
- Bing
- Hotbot
- Lycos
- Yahoo
And even if you have a custom search engine plugged on your website, sekh
can highlight the searched keywords. Currently sekh
will highlight all the terms contained in this list of GET variables :
['highlight', 'hl', 'q', 'query', 'pattern']
You can change the supported values by defining a variable named HIGHLIGHT_GET_VARNAMES
representing a list of supported variable names in your project's settings.
Testing
If you want to test the highlighter, you can pass keywords in the hl
parameter in GET.
http://localhost:8000/admin?hl=django%20admin