django-iubenda

GitHub

Test

Compliance for websites and apps

Click here and get 10% discount on first year at Iubenda

Check Demo Project

• Check the demo repo on GitHub

Requirements

• Python +3.8 supported.
• Django +3.2 supported.

Setup

1. Install from pip:

   pip install django-iubenda
   

2. Modify settings.py by adding the app to INSTALLED_APPS:

   INSTALLED_APPS = (
       "modeltranslation",
       # ...
       "iubenda",
       # ...
   )
   

3. Modify settings.py by adding the app's context processor to TEMPLATES:

   TEMPLATES = [
       {
           # ...
           "OPTIONS": {
               "context_processors": [
                   # ...
                   "iubenda.context_processors.iubenda",
                   # ...
               ],
           },
       },
   ]
   

4. Be sure the Django's Locale middleware is enabled inside settings.py:

   MIDDLEWARE = (
       # ...
       "django.middleware.locale.LocaleMiddleware",
       # ...
   )
   

5. Optionally, but sugguested, the Django's Current Site middleware is enabled inside settings.py:

   MIDDLEWARE = (
       # ...
       "django.contrib.sites.middleware.CurrentSiteMiddleware",
       # ...
   )
   

6. Modify url.py by adding the app's urls to urlpatterns:

   urlpatterns += [
       path("", include("iubenda.urls")),
   ]
   

7. Modify url.py by adding the app's sitemaps to sitemaps:

   from iubenda.sitemaps import PrivacySitemap, CookieSitemap
   
   sitemaps = {
       # ...
       "privacy": PrivacySitemap,
       "cookie": CookieSitemap,
       # ...
   }
   

8. Be sure the variable LANGUAGE_CODE is available for HTML templates:

   {% load i18n %}
   {% get_current_language as LANGUAGE_CODE %}
   

9. Modify your project's template to add privacy and cookie policies. For example inside the footer.html add following code:

   {% if not debug %}
       {% block iubenda %}{% include "iubenda/include-content.html" %}{% endblock iubenda %}
   {% endif %}
   

Optional

Autoblocking

If Iubenda autoblocking's configurations are implemented in your account, the variable IUBENDA_AUTOBLOCKING can be set to import the site's script.

Content Security Policy

If Content Security Policy are implemented in your server and inline scripts are disabled, the variable IUBENDA_CSP_NONCE can be set with nonce tag will be inserted script's nonce.