django-favicon

django-favicon

A reusable app to add simple favicon.ico handling for your site.

Installation

Install "django-favicon" using pip or easy_install::

pip install django-favicon

Add "favicon" to your INSTALLED_APPS in settings.py::

  INSTALLED_APPS = (
      ...
      'favicon',
  )

Add favicon URL patterns to urls.py::

  urlpatterns = patterns('',
      ...
      url(r'^', include('favicon.urls')),
  )

Usage

Put favicon.ico into your STATIC_ROOT. and you good to go, /favicon.ico will automatically redirect to /static/favicon.ico if your STATIC_URL = '/static/'.

Otherwise you can set a custom path to your favicon using FAVICON_PATH setting. For example::

 FAVICON_PATH = STATIC_URL + 'images/favicon.png'

Running the Tests

You can run the tests with via::

python setup.py test

or::

python runtests.py

Contribute

PyPI (Downloads) https://pypi.python.org/pypi/django-favicon Official repository https://github.com/littlepea/django-favicon Issue tracker https://github.com/littlepea/django-favicon/issues

Credits

• Developed and maintained under supervision of Evgeny Demchenko_

.. _Evgeny Demchenko: https://github.com/littlepea