Handle opensearch.xml
Project description
django-opensearch is a Django reusable application to handle opensearch.xml
Installation
Obtain your copy of source code from the git repository: $ git clone https://github.com/vint21h/django-opensearch.git. Or download the latest release from https://github.com/vint21h/django-opensearch/tags/.
Run $ python ./setup.py install from the repository source tree or unpacked archive. Or use pip: $ pip install django-opensearch.
Configuration
Add "opensearch" to settings.INSTALLED_APPS.
# settings.py
INSTALLED_APPS += [
"opensearch",
]
Add "opensearch" to your URLs definitions.
# urls.py
from django.conf.urls import url
urlpatterns += [
url(r"^opensearch/", include("opensearch.urls")),
]
Usage
Load "opensearch_tags" to your base template and place opensearch rel meta tag to <head> HTML tag by calling {% opensearch_meta %}.
{# base.html #}
{% load opensearch_tags %}
<head>
{% opensearch_meta %}
</head>
Settings
- OPENSEARCH_CONTACT_EMAIL
Contains an email address at which the maintainer of the description document can be reached. Defaults to "".
- OPENSEARCH_SHORT_NAME
Contains a brief human-readable title that identifies this search engine. Defaults to "".
- OPENSEARCH_DESCRIPTION
Contains a human-readable text description of the search engine. Defaults to "".
- OPENSEARCH_FAVICON_WIDTH
Contains width of an image that can be used in association with this search content. Defaults to 16.
- OPENSEARCH_FAVICON_HEIGHT
Contains height of an image that can be used in association with this search content. Defaults to 16.
- OPENSEARCH_FAVICON_TYPE
Contains mimetype of an image that can be used in association with this search content. Defaults to "image/x-icon".
- OPENSEARCH_FAVICON_FILE
Contains a URL that identifies the location of an image that can be used in association with this search content. Defaults to "favicon.ico".
- OPENSEARCH_SEARCH_URL
Contains a Django URL name to search content. Defaults to "search".
- OPENSEARCH_SEARCH_QUERYSTRING
Contains the querystring to prepend to search parameter. Defaults to "q=".
- OPENSEARCH_INPUT_ENCODING
Contains a string that indicates that the search engine supports search requests encoded with the specified character encoding. Defaults to "UTF-8".
Licensing
django-opensearch is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. For complete license text see COPYING file.
Contacts
Project Website: https://github.com/vint21h/django-opensearch/
Author: Alexei Andrushievich <vint21h@vint21h.pp.ua>
For other authors list see AUTHORS file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_opensearch-0.13.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5f2df3eaf38057c79b11aaa10b2fedf01b1a8b80379a1cfd4e07f9e5ae5fa448 |
|
MD5 | 86bf39b79aaa904822d4b79b9ecdfec4 |
|
BLAKE2b-256 | a33373f8be5046baaf240795f3cfca1366a98c6a05ef7514bd66e0a9f933c5c8 |