Configuration¶

Ce guide couvre uniquement les réglages spécifiques à sites_conformes. Pour la configuration générale Wagtail/Django, référez-vous à leurs documentations officielles.

La plupart des réglages se lisent depuis l’environnement, ce qui permet de les modifier sans toucher au code. Les valeurs par défaut indiquées ci-dessous sont celles utilisées dans le config/settings.py fourni en exemple par le package.

HOST_URL¶

Hôte de votre site (sans protocole). Sert à construire les URL absolues.

HOST_URL = os.getenv("HOST_URL", "localhost")

HOST_PROTO¶

Protocole utilisé (http ou https). Par défaut https.

HOST_PROTO = os.getenv("HOST_PROTO", "https")

HOST_PORT¶

Port HTTP utilisé pour les URL générées (laissez vide en production).

HOST_PORT = os.getenv("HOST_PORT", "")

FORCE_SCRIPT_NAME¶

Préfixe d’URL si le site est servi depuis un sous-chemin (/site-conformes/, par exemple). Voir la doc Django.

FORCE_SCRIPT_NAME = os.getenv("FORCE_SCRIPT_NAME", "").rstrip("/")

WAGTAILADMIN_PATH¶

Chemin d’accès à l’administration Wagtail. Par défaut cms-admin/, pour éviter la collision avec /admin/ (souvent réservé à Django admin).

WAGTAILADMIN_PATH = os.getenv("WAGTAILADMIN_PATH", "cms-admin/")

WAGTAIL_I18N_ENABLED¶

Active l’internationalisation de Wagtail :

WAGTAIL_I18N_ENABLED = True

PROCONNECT_ACTIVATED¶

Active l’authentification ProConnect (réservée aux agents de l’État). Lue depuis l’environnement, désactivée par défaut.

PROCONNECT_ACTIVATED = os.getenv("PROCONNECT_ACTIVATED", "") in ("1", "True")

Quand True, le package ajoute automatiquement sites_conformes.proconnect à INSTALLED_APPS et configure le backend OIDC (voir Installation).

SF_USE_DB_STORAGE¶

Stocke les fichiers médias en base de données plutôt que sur le filesystem. Utile pour les PaaS avec filesystem éphémère (Scalingo, Heroku). Non recommandé au-delà de ~1 Go de médias : privilégiez S3.

SF_USE_DB_STORAGE = getenv_bool("SF_USE_DB_STORAGE", False)

Quand True, sites_conformes.db_storage doit être ajouté à INSTALLED_APPS (voir Installation).

SF_USE_WHITENOISE¶

Active WhiteNoise pour servir les fichiers statiques sans serveur de fichiers dédié. Désactivé par défaut.

SF_USE_WHITENOISE = getenv_bool("SF_USE_WHITENOISE", False)

SF_DISABLE_LOCAL_LOGIN¶

Désactive la connexion par mot de passe au profit d’un SSO (ProConnect, etc.). Désactivé par défaut.

SF_DISABLE_LOCAL_LOGIN = os.getenv("SF_DISABLE_LOCAL_LOGIN", "") in ("1", "True")

Pour les réglages Django et Wagtail, référez-vous à leurs documentations officielles : https://docs.djangoproject.com/ et https://docs.wagtail.org/.