1. A propos du cours

1. Auteur : django CMS Association et contributeurs
2. Type : Documentation officielle complète du système de gestion de contenu django CMS, Release 3.9.0
3. Langue : Anglais
4. Date : 27 juin 2022
5. Licence : La licence n’est pas explicitement indiquée sur la page de titre du document consulté

2. Prérequis

1. Posséder des notions de base en Python pour comprendre la structure d’un projet et les extensions développées autour de django CMS.
2. Connaître les principes essentiels du framework Django est recommandé pour l’installation manuelle, la personnalisation et le développement de fonctionnalités avancées.
3. Comprendre les bases du développement Web, notamment HTML, les URL, les requêtes HTTP et l’organisation générale d’une application Web.
4. Connaître le fonctionnement des templates Django facilite la création de modèles de pages, de placeholders et l’intégration des contenus gérés par le CMS.
5. Savoir utiliser un terminal et exécuter des commandes Python et Django est recommandé pour installer, configurer et administrer un projet.
6. Des notions sur pip, les environnements virtuels Python et les dépendances facilitent l’installation manuelle du CMS.
7. Une connaissance élémentaire de Docker est utile pour suivre l’une des méthodes d’installation présentées dans la documentation, mais elle n’est pas obligatoire.

3. Publique cible

Cette documentation s’adresse aux développeurs Web, étudiants, enseignants, intégrateurs et administrateurs souhaitant créer ou personnaliser des sites avec django CMS. Les premières parties permettent aux nouveaux utilisateurs de découvrir rapidement la plateforme, tandis que les guides avancés et la référence technique répondent aux besoins des développeurs expérimentés souhaitant créer des plugins, intégrer des applications Django et personnaliser profondément le CMS.

4. Outils matériels et logiciels

4.1 Outils matériels

1. Un ordinateur de bureau ou portable permettant d’exécuter Python, Django et django CMS.
2. Un espace disque suffisant pour installer les dépendances Python, Docker si nécessaire, les fichiers médias et les ressources du projet.
3. Une connexion Internet est recommandée pour télécharger les packages, récupérer les projets de démonstration et consulter les ressources complémentaires.
4. Un serveur local, distant, VPS ou environnement Cloud peut être utilisé pour héberger un projet django CMS.

4.2 Outils logiciels

1. Le langage Python dans une version compatible avec la version de Django et de django CMS utilisée.
2. Le framework Django, sur lequel django CMS est construit.
3. Le système de gestion de contenu django CMS.
4. Le gestionnaire de packages pip pour installer django CMS et ses dépendances.
5. Un environnement virtuel Python avec venv ou un outil équivalent pour isoler les dépendances du projet.
6. Docker et Docker Compose peuvent être utilisés pour installer et exécuter le projet de démonstration présenté dans le tutoriel.
7. Un éditeur ou environnement de développement tel que Visual Studio Code, PyCharm ou un autre éditeur adapté à Python, Django et HTML.
8. Un navigateur Web moderne pour utiliser l’interface d’administration, l’édition front-end et visualiser les pages publiées.
9. Une base de données compatible avec Django pour conserver les pages, contenus, utilisateurs, plugins et autres informations du site.

5. Champs d'applications

1. Création de sites Web avec Django et django CMS.
2. Développement de sites institutionnels, portails, sites d’entreprise et plateformes de publication.
3. Création de sites Web multilingues grâce aux fonctions d’internationalisation du CMS.
4. Gestion de pages et de contenus à travers une interface d’édition front-end.
5. Création de modèles de pages personnalisés avec les templates Django.
6. Organisation des zones de contenu à l’aide des placeholders et placeholders statiques.
7. Développement de plugins django CMS destinés à ajouter des composants de contenu réutilisables.
8. Intégration d’applications Django existantes dans un site géré par django CMS.
9. Utilisation des Apphooks pour rattacher des applications à des pages du CMS.
10. Gestion de structures de navigation, menus et hiérarchies de pages.
11. Gestion des utilisateurs, groupes et permissions d’édition et de publication.
12. Création de types de pages prédéfinis destinés aux éditeurs de contenu.
13. Gestion du cache pour améliorer les performances du site.
14. Développement d’extensions et personnalisation avancée de l’interface et du comportement du CMS.
15. Intégration de django CMS dans un projet Django existant.

6. Courte description

Cette documentation présente django CMS, une plateforme de gestion de contenu construite avec Django. Elle couvre l’installation, la création et publication de pages, les templates, placeholders, menus, plugins, Apphooks, applications intégrées, multilingue, permissions, cache, configuration et API nécessaires à la création de sites Web personnalisables.

7. Longue description du cours

Cette documentation constitue un guide complet consacré à django CMS, une plateforme moderne de publication Web construite sur le framework Django. Le système propose directement de nombreuses fonctionnalités attendues d’un CMS tout en conservant une architecture suffisamment flexible pour permettre aux développeurs de le personnaliser, de l’étendre et de l’intégrer dans des projets Django plus vastes. Cette caractéristique constitue l’un de ses principes essentiels : django CMS n’est pas présenté comme une application monolithique fermée, mais comme un système pouvant être adapté aux besoins précis d’un projet.

La documentation est organisée de manière à répondre à plusieurs niveaux d’utilisation. Une partie Getting Started accompagne les nouveaux développeurs depuis l’installation jusqu’à la création de leurs premières fonctionnalités. Des How-to guides proposent ensuite des procédures détaillées destinées aux utilisateurs possédant déjà une certaine expérience. Les sections consacrées aux concepts fondamentaux expliquent le fonctionnement des éléments essentiels du CMS, tandis qu’une importante référence technique documente les classes, méthodes, API, commandes et paramètres utilisables par les développeurs.

Le document commence par présenter les raisons pouvant conduire à choisir django CMS. Parmi ses caractéristiques figurent un support robuste de l’internationalisation permettant de construire des sites multilingues, un système d’édition directement accessible depuis le front-end, la prise en charge de différents éditeurs de contenu et surtout une architecture flexible reposant sur des plugins. Ceux-ci permettent aux développeurs de fournir des outils puissants aux éditeurs sans imposer à ces derniers une interface technique complexe.

La documentation souligne également la capacité de django CMS à s’intégrer dans des projets Django existants. Cette possibilité est importante lorsqu’une organisation dispose déjà d’applications métiers développées avec Django et souhaite leur ajouter un véritable système de gestion éditoriale. Le CMS peut alors compléter les applications existantes sans obliger les développeurs à reconstruire l’ensemble du projet autour d’une nouvelle architecture.

La partie consacrée à l’installation de django CMS présente plusieurs approches. Il est notamment possible de mettre en place un projet dans un environnement Cloud, d’utiliser Docker pour créer un environnement local reproductible ou d’effectuer une installation manuelle avec un environnement virtuel Python. Le tutoriel utilise Docker pour montrer rapidement le fonctionnement du CMS, tandis qu’un guide plus détaillé explique comment réaliser une installation manuelle et comment intégrer django CMS dans un projet existant.

Une fois le projet installé, le tutoriel conduit l’utilisateur vers la création de sa première page. Depuis l’interface du CMS, un éditeur peut créer une nouvelle page, lui attribuer un titre et ajouter son contenu. Une distinction fondamentale est établie entre la version de travail et la version publiée : après la création, la page reste un brouillon visible par l’éditeur jusqu’à ce qu’elle soit explicitement publiée. Les modifications ultérieures peuvent également rester sous forme de brouillon avant une nouvelle publication.

Cette logique facilite un véritable workflow éditorial. Un rédacteur peut préparer ou modifier une page sans que ses changements deviennent immédiatement visibles par les visiteurs. Une fois le contenu vérifié, la nouvelle version peut être publiée. La documentation montre également comment revenir au mode d’édition et modifier directement certains contenus depuis le front-end, ce qui constitue l’une des fonctionnalités caractéristiques de django CMS.

Une place importante est accordée aux templates et placeholders. Les templates HTML définissent la structure visuelle générale des pages. Un projet peut proposer plusieurs templates correspondant à différentes mises en page, et le modèle utilisé par une page peut être remplacé selon les besoins. Les templates restent fondés sur le langage de templates Django, auquel django CMS ajoute ses propres balises.

Les placeholders représentent des zones d’un template destinées à recevoir du contenu administré par le CMS. Le développeur peut ainsi construire la structure générale d’une page puis définir précisément les emplacements dans lesquels les éditeurs pourront insérer des composants. Lorsque la page est rendue, le contenu enregistré dans la base de données vient remplir ces zones. Cette approche permet de séparer la conception de la structure du site de la gestion quotidienne du contenu.

La documentation présente également les static placeholders. Contrairement aux placeholders ordinaires dont le contenu peut varier d’une page à une autre, un placeholder statique permet de réutiliser le même contenu à plusieurs endroits du site. Cette fonctionnalité convient notamment à un pied de page, un bloc institutionnel ou une information qui doit rester identique sur plusieurs pages tout en demeurant administrable depuis le CMS.

Le système de menus permet de générer la navigation du site à partir de la hiérarchie des pages. Des balises spécifiques peuvent être insérées dans les templates pour produire automatiquement les menus correspondant à la structure éditoriale. Cette intégration évite de maintenir manuellement les liens de navigation chaque fois qu’une page est créée, déplacée ou réorganisée.

L’un des thèmes majeurs du document concerne l’intégration d’applications Django. La documentation utilise notamment une application de sondage pour montrer comment une application Django existante peut être incorporée dans un projet django CMS. L’objectif ne consiste pas simplement à faire fonctionner côte à côte le CMS et l’application, mais à les réunir dans un projet cohérent afin que l’application puisse profiter de l’organisation, des templates et des fonctionnalités éditoriales du site.

Les plugins django CMS constituent un mécanisme fondamental de cette intégration. Un plugin représente un composant de contenu pouvant être placé dans un placeholder. Le développeur peut créer son propre modèle de plugin, définir la classe chargée de son comportement et lui associer un template de rendu. Une fois enregistré dans le système, le composant devient disponible dans l’interface du CMS et peut être ajouté par les éditeurs dans les zones autorisées des pages.

Cette architecture transforme django CMS en une plateforme particulièrement extensible. Au lieu de limiter les éditeurs à quelques types de contenus prédéfinis, le développeur peut concevoir des composants personnalisés correspondant aux besoins du projet : blocs éditoriaux, contenus dynamiques, formulaires, éléments issus d’applications métiers ou autres fonctionnalités spécialisées. Les éditeurs peuvent ensuite manipuler ces éléments depuis l’interface sans avoir à intervenir directement dans le code.

Les Apphooks constituent un autre mécanisme d’intégration important. Ils permettent de rattacher la configuration d’URL d’une application Django à une page gérée par le CMS. Une application peut ainsi être associée à une position déterminée dans l’arborescence du site plutôt que d’être reliée de manière statique dans la configuration générale des URL. Cette approche renforce la flexibilité de l’architecture et permet aux responsables du site de mieux organiser les différentes applications.

La documentation traite également de la création et de la gestion des types de pages. Un type de page peut servir de modèle prédéfini comportant déjà certains contenus ou plugins. Lorsqu’un éditeur crée une nouvelle page, il peut sélectionner ce type afin de bénéficier immédiatement d’une structure adaptée. Cette fonctionnalité facilite la standardisation des contenus sur des sites comportant un grand nombre de pages similaires.

Le multilinguisme représente l’un des points forts de django CMS. Le système peut être configuré pour gérer plusieurs langues et exploite les mécanismes d’internationalisation et de localisation de Django. La configuration permet notamment de déterminer les langues disponibles, les comportements de repli lorsqu’une traduction n’existe pas et la visibilité des pages non traduites. Les URL multilingues peuvent également intégrer le code de langue afin d’identifier clairement la version linguistique demandée.

Cette gestion multilingue rend django CMS particulièrement adapté aux sites internationaux, institutionnels ou éducatifs devant publier les mêmes informations dans plusieurs langues. Le CMS peut déterminer la langue à servir en utilisant différents mécanismes, notamment le code de langue présent dans l’URL, la langue enregistrée dans la session ou certaines informations conservées lors d’une visite précédente.

La gestion des utilisateurs et permissions est également développée. django CMS peut fonctionner avec les permissions standards de Django ou activer un système plus détaillé de permissions sur les pages. Dans ce second mode, les droits peuvent être attribués globalement ou à des pages particulières et à leurs descendants. Il devient ainsi possible de contrôler précisément qui peut ajouter, modifier, supprimer, publier, déplacer une page ou modifier ses paramètres avancés.

Cette gestion fine est particulièrement importante pour les grands sites dans lesquels plusieurs équipes travaillent sur des sections différentes. La documentation recommande notamment d’organiser les autorisations à l’aide de groupes d’utilisateurs plutôt que d’attribuer systématiquement des permissions individuelles. Une organisation peut ainsi créer différents profils éditoriaux correspondant aux responsabilités de ses collaborateurs.

La documentation aborde aussi la gestion du cache, élément important pour les performances d’un CMS. Les pages et composants dynamiques peuvent nécessiter de nombreux traitements lors de leur génération. Un système de cache correctement configuré permet d’éviter certains calculs répétitifs et de réduire le temps nécessaire pour répondre aux requêtes des visiteurs.

Au-delà de ces fonctions principales, le document fournit de nombreux guides pratiques consacrés à l’installation, aux templates, à la configuration, à la création de plugins, aux sitemaps, aux types de pages et à différentes possibilités d’extension. Ces guides complètent les tutoriels d’introduction en fournissant des explications plus approfondies aux développeurs qui souhaitent adapter django CMS à des projets réels.

Une importante partie de la documentation constitue enfin une référence technique. Elle décrit les paramètres de configuration, les API, les classes, les commandes, les balises de templates, les outils liés aux plugins, les menus, la toolbar et les autres composants internes du CMS. Cette partie est destinée principalement aux développeurs ayant déjà acquis les bases et recherchant une information précise pendant la réalisation ou la maintenance d’un projet.

Dans son ensemble, cette documentation permet donc de comprendre django CMS aussi bien du point de vue de l’éditeur de contenu que du développeur Django. Elle montre comment installer le système, créer et publier des pages, structurer des templates, définir des placeholders, construire des plugins, intégrer des applications, gérer plusieurs langues, organiser les permissions et étendre le CMS. Elle constitue ainsi une ressource complète pour développer avec Python, Django et django CMS des sites Web administrables, extensibles et adaptés à des besoins éditoriaux complexes.

Voir ou télécharger le document sur le site d’origine

Ce document est hébergé par une source externe. Nous ne revendiquons aucun droit sur son contenu. Pour toute demande de retrait, veuillez contacter l’auteur ou l’hébergeur officiel.