wagtail-tenants

wagtail_tenants is a Django/Wagtail app to provide multitenancy to your wagtail project. You are able to run a main Wagtail Site and from within you are able to host as many Wagtailsites as you want. django_tenants is used to slice the database layer in a postgres database based on a given schema.

Detailed documentation will be in the "docs" directory.

Quick start

Installation

pip install wagtail-tenants

Configuration

1. Add "wagtail_tenants" to your INSTALLED_APPS setting like this:

   SHARED_APPS = (
       'wagtail_tenants.customers',
       'wagtail_tenants',
       'wagtail.contrib.forms',
       ...
       "wagtail_tenants.users",
       "wagtail.users",
       ...
   )
   
   TENANT_APPS = (
       'wagtail_tenants',
       "django.contrib.contenttypes",
       ...
       # rest of the wagtail apps
       ...
       "wagtail_tenants.users",
       "wagtail.users",
       ...
   )
   
   INSTALLED_APPS = list(SHARED_APPS) + [
       app for app in TENANT_APPS if app not in SHARED_APPS
   ]
   

2. Include the the tenants middleware at the beginning of your middlewares:

   MIDDLEWARE = [
   "wagtail_tenants.middleware.main.WagtailTenantMainMiddleware",
   ...
   ]
   

3. Define the Tenant model Constants (and also set the default auto field if not already done):

   AUTH_USER_MODEL = 'wagtail_tenants.User' 
   TENANT_MODEL = "customers.Client" 
   TENANT_DOMAIN_MODEL = "customers.Domain"
   DEFAULT_AUTO_FIELD='django.db.models.AutoField'
   

4. Set the Database backend to the django_tenants backend:

   DATABASES = {
       "default": {
           "ENGINE": "django_tenants.postgresql_backend",
           "NAME": "db_name",
           "USER": "db_user",
           "PASSWORD": "",
           "HOST": "127.0.0.1",
           "PORT": "5432",
       }
   }
   

5. Set the Database Router to work with the tenants:

   DATABASE_ROUTERS = ("wagtail_tenants.routers.WagtailTenantSyncRouter",)
   

6. Set the authentication backend to fit to our Tenant model.

   AUTHENTICATION_BACKENDS = [
       'wagtail_tenants.backends.TenantBackend',
   ]
   

7. Run the migrations with ./manage.py migrate_schemas --shared

8. Create a public schema with ./manage.py create_tenant and use public as the schema name and localhost

9. Create a superuser for the public tenant ./manage.py create_tenant_superuser

10. Start the Server and have fun

11. You are able to create tenants within the admin of your public wagtailsite. If you want to log into a tenant you need at least one superuser for the tenant. You can use ./manage.py create_tenant_superuser for that.

Update 0.1.10

The new version of wagtail_tenants is now able to archive the follwing features:

wagtail 4.2. support

As the developemt of wagtail still goes on, so we do. Wagtail incuded a reference index for models it was necessary to handle this feature, as we don 't need this feature on our tenant models.

Create tenantaware apps

Only users of a given tenant are able to interact within the wagtail admin with that kind of app. This works in two ways:

1. Add a tenantaware property to the apps AppConfig class in yourtenantapp.apps.py in the admin.py create a ModelAdmin or ModelAdminGroup for your app and use the menu_item_name property to fit to your apps name from your AppConfig. If this fits the app will be hidden for all tenants withou a TenantFeaure of the same name. This feature is good for providing different tiers of your app (eg. free | premium )

2. You can specify the tenant directly within the AppConfig so that only users of the tenant have access to this app. This is necessary if you want to create complete and complex functionality only for one tenant. To archive this you have to add the WagtailTenantPermissionMiddlewareto your middlewares in your settings like so:

MIDDLEWARE = [
    "wagtail_tenants.middleware.main.WagtailTenantMainMiddleware",
    "wagtail_tenants.middleware.main.WagtailTenantPermissionMiddleware",
    "..."
]

Exclude permissions from normal users in the group create and group edit view

We are able to hide apps from the group create and group edit views in the wagtail admin. With this approach it is possible to create a tenant admin group with all permissions and distribute it to a tenant user. The tenant admin is able to create and edit groups, but you can decide which apps should be excluded from the view. By default this should include all customers apps. But feel free to extend the list.

TENANT_EXCLUDE_MODEL_PERMISSIONS = [
    "customers.Client",
    "customers.ClientFeature",
    "customers.Domain",
    "customers.ClientBackup",
]