Intégrer et ajuster le module CMS
Dans ce tutoriel, tu ajusteras le module de blog du CMS bluetronix : de l'activation et de l'intégration de la liste de blogs aux fichiers de module personnalisés, valeurs de configuration et fichiers de langue.
Conditions préalables et objectif du tutoriel
Pour ce tutoriel, tu auras besoin d'un accès développeur au CMS bluetronix. Tu devrais déjà savoir comment fonctionnent les dossiers de développeur et pourquoi les fichiers personnalisés dans les dossiers système sont marqués par _own.
Nous utilisons le module existant News - Blog comme exemple. Tu actives le module, intègres sa vue de liste dans une page CMS et ajustes ensuite spécifiquement un fichier de module personnalisé ainsi que la configuration. Les fichiers originaux restent inchangés.
1. Activer le module de blog
Ouvre dans le CMS Modules et sélectionne News - Blog.
Active l'option Activer le module Blog et confirme la demande de sécurité avec OK.
Ensuite, le configurateur de module est à ta disposition. À gauche se trouvent les paramètres techniques, à droite les textes de module dépendants de la langue.
2. Intégrer une liste de blogs dans une page CMS
Ouvre la page /Blog/index.html et sélectionne Code HTML. La page du blog est intégrée via un court marquage CMS.
<!--bx_Mod/Blog/Modul-Blog-List-->
Le marquage fait référence au module de blog et à sa vue de liste. Le CMS insère à cet endroit la sortie générée du module lors du rendu.
3. Ouvrir des fichiers modules centraux dans le gestionnaire de fichiers
La logique PHP et HTML réelle des modules ne se trouve pas directement dans le HTML de la page, mais de manière centrale dans le dossier système bx_Mod. Ouvre d'abord ce dossier dans le Gestionnaire de fichiers puis le sous-dossier Blog.
Dans le dossier Blog, tu trouveras par exemple Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, d'autres fichiers de module et le sous-dossier languages.
4. Voir le fichier standard de la liste des blogs
Sélectionnez Modul-Blog-List.php et ouvrez-le via Modifier.
Le fichier standard contient la logique de programmation pour la vue de liste. Dans le code montré, la configuration du module ainsi que, si disponible, le config_own.php spécifique au projet sont inclus.
Ainsi, une seule intégration de module peut utiliser la même logique de programme centrale sur différentes pages. Pour les projets utilisant le module standard, des mises à jour ultérieures du CMS peuvent fournir des modifications à ce fichier.
Ne modifiez pas directement le Modul-Blog-List.php original. Il fait partie du système et peut être écrasé lors d'une mise à jour du CMS.
5. Créer une vue de liste personnalisée avec _own
Pour modifier la sortie, vous copiez le fichier standard. La copie reçoit exactement la désignation _own appropriée :
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Ouvrez le nouveau fichier Modul-Blog-List_own.php. Dans cette version spécifique au projet, vous pouvez changer la logique PHP et la sortie HTML sans toucher au fichier standard.
Dans notre test, nous ajoutons à l'en-tête la chaîne de caractères bien visible NEW!!!!. Le reste de la vue de liste reste inchangé.
Enregistrez votre fichier de module personnel et rechargez la page du blog. Le CMS utilise la variante _own appropriée, tandis que l'emplacement dans /Blog/index.html reste inchangé. Vous reconnaîtrez le fichier actif par l'en-tête modifié NEW!!!! DERNIERS ARTICLES.
6. Paramètres des modules et configuration personnelle
En plus de la sortie HTML, vous pouvez également modifier la configuration du module. La capture d'écran montre dans le configurateur, par exemple pour Modul-Blog-ShowCase, la valeur DS Repeats = 3.
Changez la valeur en 2 et enregistrez le paramètre. Cela déterminera le nombre souhaité pour cette zone ShowCase. Le paramètre se rapporte à Modul-Blog-ShowCase et n'est pas automatiquement équivalent au nombre total d'articles de la vue de liste du blog.
La configuration personnelle se trouve sous bx_Mod/Blog/config_own.php. Sélectionnez ce fichier dans le gestionnaire de fichiers.
Le config_own.php montré écrase la valeur uniquement si la zone de module concernée Modul-Blog-ShowCase est chargée :
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Les valeurs par défaut proviennent toujours de config.php. Un fichier de configuration personnel n'a donc pas besoin de répéter toutes les valeurs par défaut, mais peut contenir uniquement les écarts souhaités.
7. Définir la table de base de données et les pages de module
Dans la configuration standard bx_Mod/Blog/config.php, vous trouverez entre autres la table de base de données utilisée ainsi que les chemins vers la vue détaillée et la vue de liste. Dans l'exemple donné, les valeurs sont :
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Si vous développez une variante personnelle du module de blog pour un autre but, vous pouvez par exemple stocker une autre table de base de données dans votre propre configuration. Vérifiez si la nouvelle table contient les champs attendus par votre fichier de module et si les pages de liste et de détails correspondent à la nouvelle variante.
8. Fichiers linguistiques du module
Sous bx_Mod/Blog/languages se trouvent les fichiers de langue du module de blog. Pour les langues existantes, il existe des fichiers PHP séparés, par exemple de.php, en.php et fr.php.
Ici, les textes de module dépendants de la langue sont gérés. Utilisez le format de fichier propre pris en charge par votre version du module pour les modifications spécifiques au projet, au lieu de remplacer directement les fichiers de langue d'origine.
9. Faire la distinction entre le module standard et ta propre version
La règle _own protège vos modifications contre l'écrasement par des mises à jour régulières. En même temps, vous êtes responsable de l'entretien de cette version individuelle. Vérifiez lors des mises à jour ultérieures du CMS si des modifications importantes apportées au fichier standard sont également pertinentes pour votre propre fichier.
10. Résumé
Vous activez le module blog sous Module → News - Blog, intégrez la vue de liste via un marquage CMS et gérez la logique de programme réelle de manière centrale sous bx_Mod/Blog. Pour vos propres modifications, vous copiez Modul-Blog-List.php vers Modul-Blog-List_own.php. Les paramètres qui diffèrent de la norme sont, si nécessaire, enregistrés dans config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteDe cette manière, un module existant peut être étendu de manière ciblée, sans modifier les fichiers système d'origine.
FAQ
ce que nos clients nous demandent souvent
Quel accès ai-je besoin pour personnaliser les modules CMS ?
Vous avez besoin d'un accès développeur au CMS bluetronix. De plus, vous devez connaître les dossiers des développeurs et la règle _own.
Où puis-je activer le module Blog ?
Ouvrez Modules, sélectionnez News - Blog et activez Activer le module Blog. Confirmez la demande de sécurité.
Comment intégrer la liste des blogs dans une page CMS ?
Ouvrez le code HTML de la page souhaitée et insérez le balisage de module <!--bx_Mod/Blog/Modul-Blog-List-->.
Dois-je copier le code PHP complet de la liste des blogs dans la page ?
Non. La page contient uniquement le balisage de module. La logique correspondante est chargée de manière centralisée à partir du module Blog.
Où se trouve le fichier standard de la liste des blogs ?
Vous le trouverez sous bx_Mod/Blog/Modul-Blog-List.php dans la zone développeur du gestionnaire de fichiers.
Comment adapter un fichier de module pour qu'il soit mis à jour ?
Copiez le fichier standard et marquez la copie avec _own, par exemple Modul-Blog-List_own.php. Ensuite, modifiez uniquement ce fichier personnel.
Le balisage de module doit-il être modifié lorsque je crée un fichier _own ?
Non. Pour un fichier de module soutenu par le CMS, la variante _own correspondante peut être utilisée automatiquement sans modifier l'intégration du module existant.
À quoi sert config_own.php ?
Via bx_Mod/Blog/config_own.php, vous pouvez écraser des valeurs spécifiques au projet dans la configuration standard.
Quel est l'effet de DS Repeats dans cet exemple ?
Dans l'exemple montré, le paramètre pour Modul-Blog-ShowCase est changé de 3 à 2. Cela fixe le nombre de répétitions de cette zone de module.
Où est-il précisé quelle table de base de données le module Blog utilise ?
Dans la configuration bx_Mod/Blog/config.php, il est indiqué dans l'exemple $CF_DatabaseTable = "Blog";. L'association peut être adaptée pour une variante de module propre.
Où puis-je trouver les fichiers de langue du module Blog ?
Les fichiers PHP dépendants de la langue se trouvent sous bx_Mod/Blog/languages, par exemple de.php et en.php.
Qui s'occupe de la maintenance d'un fichier de module propre ?
Le fichier _own reste en place lors des mises à jour régulières du CMS. Le développeur doit lui-même vérifier si les nouveaux correctifs ou fonctionnalités du fichier standard doivent être intégrés.