djangocms-multisite

django-multisite support for django CMS

Supported Django versions:

• Django 1.6
• Django 1.7
• Django 1.8
• Django 1.9

Supported django CMS versions:

• django CMS 3.*

Usage

1. Configure django-multisite as documented upstream

2. Use SITE_ID = SiteID(default=1) instead of the documented SITE_ID = SiteID()

3. Add multisite, djangocms_multisite to INSTALLED_APPS:

   INSTALLED_APPS=[
       ...
       'multisite',
       'djangocms_multisite',
       ...
   ]
   

4. Add multisite.middleware.DynamicSiteMiddleware and djangocms_multisite.middleware.CMSMultiSiteMiddleware to MIDDLEWARE_CLASSES; multisite.middleware.DynamicSiteMiddleware must be applied before cms.middleware.utils.ApphookReloadMiddleware, while djangocms_multisite.middleware.CMSMultiSiteMiddleware must right after that:

   MIDDLEWARE_CLASSES = [
       ...
       'multisite.middleware.DynamicSiteMiddleware',
       'cms.middleware.utils.ApphookReloadMiddleware',
       'djangocms_multisite.middleware.CMSMultiSiteMiddleware',
       ...
   ]
   

5. Configure the URL mapping as follows:

   MULTISITE_CMS_URLS={
       'www.example.com': 'tests.test_utils.urls1',
       'www.example2.com': 'tests.test_utils.urls2',
   },
   MULTISITE_CMS_ALIASES={
       'www.example.com': ('alias1.example.com', 'alias2.example.com',),
       'www.example2.com': ('alias1.example2.com', 'alias2.example2.com',),
   },
   MULTISITE_CMS_FALLBACK='www.example.com'
   

6. Run python manage.py migrate

Settings

MULTISITE_CMS_URLS

Dictionary (or OrderedDict) containing the mapping between the domain (as configured in django sites) and the corresponding urlconf.

MULTISITE_CMS_FALLBACK

The default domain to load if any of the above does not match.

MULTISITE_CMS_ALIASES

Dictionary (or OrderedDict) containing the mapping between the domain (as configured in django sites) and a list of aliases. This is optional if all the aliases are configured as django-multisite aliases