wagtail-dsfr 2.4.0rc2

Gestionnaire de contenu permettant de créer et gérer un site internet basé sur le Système de design de l'État, accessible et responsive

wagtail_dsfr

Package Python pour Wagtail Dsfr, un gestionnaire de contenu permettant de créer et gérer un site internet basé sur le Système de design de l'État (DSFR), accessible et responsive.

Ce package est généré automatiquement à partir du projet Sites Faciles officiel.

Installation

pip install wagtail_dsfr

Ou avec poetry :

poetry add wagtail_dsfr

Utilisation

Ajoutez les applications à votre INSTALLED_APPS dans settings.py :

INSTALLED_APPS = [
    # ... vos autres apps
    "dsfr",
    "wagtail_dsfr",
    "wagtail_dsfr.blog",
    "wagtail_dsfr.content_manager",
    "wagtail_dsfr.events",
    "wagtail.contrib.settings",
    "wagtail.contrib.typed_table_block",
    "wagtail.contrib.routable_page",
    "wagtail_modeladmin",
    "wagtailmenus",
    "wagtailmarkdown",
]

Ajoutez les context processors nécessaires :

TEMPLATES[0]["OPTIONS"]["context_processors"].extend(
    [
        "wagtailmenus.context_processors.wagtailmenus",
        "wagtail_dsfr.content_manager.context_processors.skiplinks",
        "wagtail_dsfr.content_manager.context_processors.mega_menus",
    ]
)

Configurez les URLs dans votre urls.py :

# Option 1 : Utiliser directement la configuration d'URLs de wagtail_dsfr (recommandé)
from wagtail_dsfr.config.urls import *

# Option 2 : Configuration personnalisée
# Si vous avez besoin de personnaliser les URLs, vous pouvez copier le contenu
# de wagtail_dsfr.config.urls et l'adapter à vos besoins

Migration depuis Sites Faciles

Si vous migrez un site existant depuis le dépôt Sites Faciles vers ce package, vous devez mettre à jour les références ContentType dans votre base de données.

Étapes de migration

1. Installez le package comme décrit ci-dessus et ajoutez toutes les applications à INSTALLED_APPS

2. Exécutez les migrations Django pour créer les nouveaux ContentTypes :

   python manage.py migrate
   

3. Migrez les ContentTypes existants :

   python manage.py migrate_contenttype
   

   Cette commande va :

   • Identifier tous les ContentTypes de l'ancienne structure (blog, events, forms, content_manager, config)
   • Mettre à jour toutes les pages Wagtail pour pointer vers les nouveaux ContentTypes
   • Supprimer les anciens ContentTypes

4. Vérifiez la migration (optionnel - mode dry-run) :

   python manage.py migrate_contenttype --dry-run
   

Pourquoi cette migration est nécessaire

Lorsque vous renommez des applications Django (par exemple de blog à wagtail_dsfr_blog), Django crée de nouveaux ContentTypes. Les pages Wagtail existantes référencent toujours les anciens ContentTypes, ce qui provoque l'erreur :

PageClassNotFoundError: The page 'xxx' cannot be edited because the model class
used to create it (blog.blogindexpage) can no longer be found in the codebase.

La commande migrate_contenttype résout ce problème en mettant à jour toutes les références.

Documentation

Pour plus d'informations sur l'utilisation de Sites Faciles, consultez la documentation officielle.

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

Crédits

Ce package est basé sur Sites Faciles développé par la DINUM.