{"title":"The “local flavor” add-ons","version":"1.8","locale":"en","docname":"topics/localflavor","url":"/en/1.8/topics/localflavor/","canonical":"https://djangodocs.dev/en/1.8/topics/localflavor/","summary":"Historically, Django has shipped with django.contrib.localflavor – assorted pieces of code that are useful for particular countries or cultures. This code is now…","html":"

The “local flavor” add-onsLink to this heading#

\n

Historically, Django has shipped with django.contrib.localflavor –\nassorted pieces of code that are useful for particular countries or cultures.\nThis code is now distributed separately from Django, for easier maintenance\nand to trim the size of Django’s codebase.

\n

See the official documentation for more information:

\n
\n

https://django-localflavor.readthedocs.org/

\n
\n

Code is hosted on github at https://github.com/django/django-localflavor.

\n
\n

How to migrateLink to this heading#

\n

If you’ve used the old django.contrib.localflavor package or one of the\ntemporary django-localflavor-* releases, follow these two easy steps to\nupdate your code:

\n
    \n

  1. Install the third-party django-localflavor package from PyPI.

    2. \n

  2. Change your app’s import statements to reference the new package.

    \n

    For example, change this:

    \n
    Code
    from django.contrib.localflavor.fr.forms import FRPhoneNumberField\n
    \n

    …to this:

    \n
    Code
    from localflavor.fr.forms import FRPhoneNumberField\n
    \n
    3. \n
\n

The code in the new package is the same (it was copied directly from Django),\nso you don’t have to worry about backwards compatibility in terms of\nfunctionality. Only the imports have changed.

\n
\n
\n

Deprecation policyLink to this heading#

\n

In Django 1.5, importing from django.contrib.localflavor will result in a\nDeprecationWarning. This means your code will still work, but you should\nchange it as soon as possible.

\n

In Django 1.6, importing from django.contrib.localflavor will no longer\nwork.

\n
","rootId":"the-local-flavor-add-ons","toc":[{"title":"How to migrate","anchor":"how-to-migrate","children":[]},{"title":"Deprecation policy","anchor":"deprecation-policy","children":[]}],"breadcrumbs":[{"docname":"topics/index","title":"Using Django","url":"/en/1.8/topics/"}],"prev":{"docname":"topics/i18n/timezones","title":"Time zones","url":"/en/1.8/topics/i18n/timezones/"},"next":{"docname":"topics/logging","title":"Logging","url":"/en/1.8/topics/logging/"},"formats":{"html":"/en/1.8/topics/localflavor/","markdown":"/en/1.8/topics/localflavor.md","json":"/en/1.8/topics/localflavor.json"},"source":"https://github.com/django/django/blob/stable/1.8.x/docs/topics/localflavor.txt","official":"https://docs.djangoproject.com/en/1.8/topics/localflavor/","inVersions":["1.8"],"inLocales":["en"]}