Get the code via git:
git clone git://github.com/ecometrica/django-multisite.git django-multisiteAdd the django-multisite/multisite folder to your PYTHONPATH.
Replace your SITE_ID in settings.py to:
from multisite import SiteID
SITE_ID = SiteID()Add to settings.py TEMPLATE_LOADERS:
TEMPLATE_LOADERS = (
'multisite.template_loader.Loader',
'django.template.loaders.app_directories.Loader',
) Edit to settings.py MIDDLEWARE_CLASSES:
MIDDLEWARE_CLASSES = (
...
'multisite.middleware.DynamicSiteMiddleware',
...
)Append to settings.py, in order to use a custom cache that can be safely cleared:
# The cache connection to use for django-multisite.
# Default: 'default'
CACHE_MULTISITE_ALIAS = 'multisite'
# The cache key prefix that django-multisite should use.
# Default: '' (Empty string)
CACHE_MULTISITE_KEY_PREFIX = ''If you have set CACHE_MULTISITE_ALIAS to a custom value, e.g. 'multisite', add a separate backend to settings.py CACHES:
CACHES = {
'default': {
...
},
'multisite': {
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
'TIMEOUT': 60 * 60 * 24, # 24 hours
...
},
}By default, if the domain name is unknown, multisite will respond with an HTTP 404 Not Found error. To change this behaviour, add to settings.py:
# The view function or class-based view that django-multisite will
# use when it cannot match the hostname with a Site. This can be
# the name of the function or the function itself.
# Default: None
MULTISITE_FALLBACK = 'django.views.generic.base.RedirectView
# Keyword arguments for the MULTISITE_FALLBACK view.
# Default: {}
MULTISITE_FALLBACK_KWARGS = {'url': 'http://example.com/',
'permanent': False}Create a directory settings.TEMPLATE_DIRS directory with the names of domains, such as:
mkdir templates/example.comNew in version 0.3.0.
In order to support cross-domain cookies, for purposes like single-sign-on, prepend the following to the top of settings.py MIDDLEWARE_CLASSES:
MIDDLEWARE_CLASSES = (
'multisite.middleware.CookieDomainMiddleware',
...
)CookieDomainMiddleware will consult the Public Suffix List for effective top-level domains. It caches this file in the system's default temporary directory as effective_tld_names.dat. To change this in settings.py:
MULTISITE_PUBLIC_SUFFIX_LIST_CACHE = '/path/to/multisite_tld.dat'By default, any cookies without a domain set will be reset to allow *.domain.tld. To change this in settings.py:
MULTISITE_COOKIE_DOMAIN_DEPTH = 1 # Allow only *.subdomain.domain.tldIn order to fetch a new version of the list, run:
manage.py update_public_suffix_list