Metadata-Version: 1.1
Name: django-multisite
Version: 0.3.1
Summary: Serve multiple sites from a single Django application
Home-page: http://github.com/ecometrica/django-multisite
Author: Ecometrica
Author-email: info@ecometrica.com
License: UNKNOWN
Description: README
        ======
        
        Get the code via git::
        
            git clone git://github.com/ecometrica/django-multisite.git django-multisite
        
        Add the django-multisite/multisite folder to your PYTHONPATH.
        
        
        Quickstart
        ----------
        
        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
                    ...
                },
            }
        
        
        Domain fallbacks
        ----------------
        
        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.com
        
        
        Cross-domain cookies
        --------------------
        
        *New 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.tld
        
        In order to fetch a new version of the list,
        run::
        
            manage.py update_public_suffix_list
        
        .. _cross-domain cookies: http://en.wikipedia.org/wiki/HTTP_cookie#Domain_and_Path
        .. _Public Suffix List: http://publicsuffix.org/
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
