Téléchargez l'application maintenant et testez-la gratuitement pendant 10 jours
Devise Choisir la langue Sélectionner une région

Objectif du tutoriel

Dans ce tutoriel, tu importes une mise en page Bootstrap-5 existante dans le CMS bluetronix. Tu décomposes la page HTML d'origine en en-tête, pied de page, modèles de sections individuels et le cadre de mise en page lui-même. Par la suite, tu peux insérer, déplacer et réutiliser librement les différentes parties de la page dans l'éditeur.

Remarque : Ce tutoriel traite de l'importation de mise en page de base. Le traitement supplémentaire ou le remplacement des images sera traité dans un tutoriel ultérieur.

1. Ouvrir le template original sous bx_Import

Ouvre dans le gestionnaire de fichiers le dossier bx_Import. La mise en page importée s'y trouve d'abord dans son état d'origine, par exemple avec les dossiers d'images et les fichiers HTML d'origine. Dans cette zone, tu ne travailles qu'avec les fichiers originaux existants ; les modifications ne seront pas enregistrées dans le modèle d'origine.

Pour cet exemple, ouvre le fichier index.html et passe à Modifier. Ce fichier sera maintenant décomposé en différentes parties de la mise en page du CMS.

Placeholder de capture d'écran : Gestionnaire de fichiers avec le dossier bx_Import ouvert, dossiers d'images et fichiers HTML originaux – dev_bootstrap_import_bx_import_originaldateien.jpeg. Prends encore la photo et intègre-la ensuite ici.

Placeholder de capture d'écran : index.html de bx_Import dans l'éditeur HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. Prends encore la photo et intègre-la ensuite ici.

2. Séparer l'en-tête du fichier index.html

Recherche dans le code HTML avec Ctrl + F header. Dans de nombreux modèles Bootstrap, il est possible de trouver rapidement l'en-tête car il est marqué par un élément HTML approprié. Dans certains modèles, l'en-tête consiste uniquement en une zone div; dans ce cas, tu devras examiner la structure de plus près.

Sélectionne la totalité de la zone d'en-tête et copie-la. Il est préférable de travailler avec deux fenêtres ouvertes, afin de pouvoir basculer entre le modèle d'origine et ton projet CMS.

Placeholder de capture d'écran : Zone d'en-tête de index.html trouvée par la recherche et marquée pour la copie – dev_bootstrap_import_header_markieren.jpeg. Prends encore la photo et intègre-la ensuite ici.

3. Intégrer l'en-tête dans le CMS

Reviens à ton projet, ouvre le répertoire principal et ensuite Header → Code HTML. Colle le code d'en-tête copié précédemment.

Vérifie ensuite les chemins locaux. Pour de nombreuses mises en page, les références relatives et les chemins d'images doivent être précédés d'une barre oblique (slash) pour fonctionner correctement dans la structure du CMS.

href="css/style.css"   →   href="/css/style.css"
src="images/logo.jpg"  →   src="/images/logo.jpg"

Important : Utilise Ctrl + H pour chercher et remplacer, mais ne remplace pas les chemins à l'aveuglette. Vérifie notamment les URL externes, les ancres, les liens mailto : et les chemins absolus déjà présents.

Placeholder de capture d'écran : Répertoire principal → Header → Code HTML avec en-tête inséré – dev_bootstrap_import_header_html_einfuegen.jpeg. Prends encore la photo et intègre-la ensuite ici.

Recherche ensuite le pied de page dans le index.html d'origine. Coupe ou copie la totalité de la zone pied de page et colle-la dans le fichier pied de page prévu à cet effet dans le répertoire principal de ton projet. Vérifie aussi tous les href et src locaux.

Placeholder de capture d'écran : Fichier de pied de page dans le répertoire principal avec code de pied de page inséré – dev_bootstrap_import_footer_html_einfuegen.jpeg. Prends encore la photo et intègre-la ensuite ici.

5. Diviser la zone principale en modèles de sections distincts

Le contenu de la page restant après l'en-tête et le pied de page n'est pas copié directement dans le index.html de ton projet. Ouvre plutôt bx_Layout → SectionTemplate.txt → Code HTML.

Colle la section principale restante du modèle d'origine à la fin de ce fichier. Divise-la ensuite en différentes sections qui seront ensuite disponibles séparément dans l'éditeur.

Entre deux modèles de section, mets exactement le séparateur suivant :

<!--__SP_SectionTemplate__-->

Chaque section ainsi séparée peut ensuite être insérée comme un modèle distinct dans l'éditeur. Cela te permet d'organiser librement les sections, de les réutiliser plusieurs fois ou de les omettre sur une page.

Placeholder de capture d'écran : bx_Layout → SectionTemplate.txt avec plusieurs sections et le séparateur <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Prends encore la photo et intègre-la ensuite ici.

6. Intégrer le cadre de layout dans 00_layout

Après avoir extrait les en-têtes, pieds de page et sections principales, il reste le cadre HTML proprement dit, par exemple avec DOCTYPE, la zone head et d'autres éléments de mise en page supérieurs. Copie ce code restant.

Ensuite, ouvre la gestion de base de données et modifie la base de données 00_layout. Des modèles de mise en page sont déjà disponibles. Tu peux modifier un modèle existant ou créer une nouvelle mise en page.

Colle le cadre copié sous LayoutHTML. Aux emplacements d'origine de l'en-tête, du contenu principal et du pied de page, tu utilises les balises CMS :

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Lors du rendu de la page, ces balises sont remplacées par l'en-tête respectif, la page principale actuelle et le pied de page. Le code PHP associé sous LayoutPHP sera exécuté automatiquement lors du chargement de la mise en page.

Placeholder de capture d'écran : Base de données 00_layout avec LayoutHTML et les balises pour l'en-tête, le contenu principal et le pied de page – dev_bootstrap_import_00_layout_layouthtml.jpeg. Prends encore la photo et intègre-la ensuite ici.

7. Vérifier les chemins CSS, JavaScript et Favicon

Vérifie dans le code de mise en page toutes les références aux fichiers CSS, JavaScript et favicon. Assure-toi d'ajouter le slash précédent pour les chemins locaux. Pour les fichiers CSS et JavaScript, utilise également le marquage de version de fichier du CMS.

Un appel JavaScript peut par exemple ressembler à ceci :

<script src="__FV_/bx_script/core.min.js__"></script>

Le marquage __FV_...__ permet au système de prendre en compte la version du fichier ou la date de modification lors du rendu. Cela permet au navigateur de charger le fichier CSS ou JavaScript actuel après des modifications, sans que l'utilisateur ait à actualiser manuellement le cache de son navigateur.

8. Nettoyer les contenus de l'en-tête et utiliser le HTML de l'en-tête

Vérifie la section head prise en charge et supprime tout contenu déjà défini par le CMS ou chargé ailleurs. Tu peux également supprimer un titre de page figé s'il est généré automatiquement par le système.

Le code d'en-tête nécessaire pour l'éditeur, qui ne doit pas faire directement partie de LayoutHTML, est enregistré sous Extras → Header-HTML. L'éditeur peut ainsi tenir compte des contenus enregistrés là lors de la modification de la page.

Espace réservé pour la capture d'écran : Extras → Header-HTML avec le code d'en-tête déplacé là-bas – dev_bootstrap_import_extras_header_html.jpeg. Prendre l'image et ensuite l'intégrer ici.

9. Sélectionner le layout importé pour la page

Si tu as créé une nouvelle mise en page dans 00_layout, ouvre dans l'éditeur les Paramètres de la page et sélectionne y ta mise en page importée. Ce n'est qu'ainsi que la page concernée sera affichée avec ce cadre de mise en page.

Espace réservé pour la capture d'écran : Paramètres de la page avec la sélection de la nouvelle mise en page importée – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Prendre l'image et ensuite l'intégrer ici.

10. Assembler la page d'accueil à partir des sections importées

Clique sur Modifier pour ta page. La page d'accueil peut d'abord sembler vide. C'est normal car aucune des nouveaux sections de page n'a encore été insérée dans la page réelle.

Sélectionne Insérer → Section de page. Les zones que tu as précédemment séparées dans SectionTemplate.txt avec le séparateur de section devraient apparaître.

Insère les sections nécessaires l'une après l'autre pour reconstituer la page d'origine. Tu peux ensuite déplacer, omettre ou insérer plusieurs fois les sections comme tu le souhaites.

Espace réservé pour la capture d'écran : Éditeur → Insérer → Section de page avec les modèles de section importés – dev_bootstrap_import_sections_einfuegen.jpeg. Prendre l'image et ensuite l'intégrer ici.

11. Utiliser la page originale comme référence

Sous Fichiers → bx_Import, tu peux toujours ouvrir l'index.html d'origine en aperçu. Utilise-le comme référence pendant que tu construis ta nouvelle page CMS à partir des différentes sections.

Si certaines modèles ne contiennent d'abord pas d'images, leur bonne prise en charge sera abordée dans un tutoriel ultérieur.

12. Vérifier les chemins et la modifiabilité de toutes les sections

À la fin, vérifie encore une fois Sections → Modèle de section et examine tous les chemins locaux. Pour de nombreux chemins similaires, tu peux effectuer les modifications efficacement dans un éditeur de texte avec Ctrl + H.

Teste ensuite chaque section importée dans l'éditeur. Vérifie si tous les contenus sont affichés correctement et si les textes et éléments prévus peuvent être modifiés.

Si, par exemple, un texte ne peut pas être modifié, vérifie la structure HTML. Si un texte normal se trouve directement dans un conteneur div, il peut être judicieux de déplacer le texte dans un élément p approprié en fonction de la structure.

Espace réservé pour la capture d'écran : Page d'accueil finale après l'insertion et l'agencement des sections – dev_bootstrap_import_fertige_startseite.jpeg. Prendre l'image et ensuite l'intégrer ici.

13. Pourquoi le layout est-il divisé

Grâce à la séparation de l'en-tête, du pied de page, du cadre de mise en page et des différentes sections, tu n'as pas besoin de copier à chaque fois ces éléments dans de nouvelles pages à partir du fichier Bootstrap d'origine.

L'en-tête et le pied de page centraux peuvent être réutilisés, tandis que les différentes sections de page sont disponibles comme des modèles flexibles dans l'éditeur. Cela te permet de composer différentes pages à partir d'un modèle Bootstrap et de modifier l'ordre des contenus à tout moment.

Résumé

Pour l'importation de Bootstrap 5, utilise les fichiers d'origine sous bx_Import comme modèle. L'en-tête et le pied de page sont intégrés séparément dans les zones du CMS prévues, la zone principale est décomposée en modèles individuels via SectionTemplate.txt et le cadre HTML restant est enregistré sous 00_layout → LayoutHTML.

Ensuite, choisis la mise en page dans les paramètres de page et assemble la page via Insérer → Section de page à partir des sections importées. Vérifie enfin tous les chemins, références CSS et JavaScript, ainsi que la modifiabilité des différentes sections.

FAQ

ce que nos clients nous demandent souvent

Pourquoi le modèle Bootstrap d'origine est-il conservé sous bx_Import ?

Le dossier bx_Import sert de point de départ et de référence pour le modèle original importé. Les éléments nécessaires en sont extraits vers les zones CMS respectives.

Quel fichier dois-je utiliser pour le premier import ?

Ce tutoriel utilise index.html comme point de départ. Il en extrait l'en-tête, le pied de page, les sections principales et le reste de la structure de mise en page.

Comment trouver rapidement l'en-tête et le pied de page dans le code HTML ?

Utilisez Ctrl + F et recherchez par exemple header ou footer. Pour les modèles sans balises HTML appropriées, vous devez examiner de plus près les structures div environnantes.

Où sont stockées les sections de page individuelles ?

Les modèles sont sauvegardés sous bx_Layout dans SectionTemplate.txt et séparés par le délimiteur <!--__SP_SectionTemplate__-->.

Quelles balises sont nécessaires pour LayoutHTML ?

Aux emplacements des zones retirées, vous utilisez __DB_Layout_Header__, __DB_Layout_Main__ et __DB_Layout_Footer__.

Pourquoi les fichiers CSS et JavaScript sont-ils marqués avec __FV_?

Cela permet au CMS de prendre en compte la version du fichier ou la date de modification lors du rendu. Après un changement, le navigateur peut ainsi charger le fichier actuel plutôt que d'utiliser une version mise en cache obsolète.

Pourquoi la page d'accueil est-elle d'abord vide après l'importation du modèle ?

Le modèle fournit d'abord seulement la structure. Les sections de page réelles doivent être insérées via Insérer → Section de page.

Puis-je réutiliser une section de page importée plusieurs fois ?

Oui. Les modèles de section séparés peuvent être insérés, déplacés et utilisés plusieurs fois dans l'éditeur selon les besoins.

Que dois-je faire si les chemins d'images ou de liens relatifs ne fonctionnent pas ?

Vérifiez les chemins href et src locaux et ajoutez un slash au début si nécessaire. Avec Ctrl + H, vous pouvez remplacer les chemins récurrents, mais ne modifiez pas aveuglément les URLs externes, les ancres et autres chemins spéciaux.

Que puis-je faire si un texte ne peut pas être modifié dans l'éditeur ?

Vérifiez la structure HTML de la section concernée. Si du texte normal se trouve directement dans un conteneur div, il peut être judicieux d'utiliser un élément p approprié selon la configuration.

Comment puis-je comparer la page d'origine lors de la reconstruction ?

Ouvrez le fichier index.html d'origine sous Fichiers → bx_Import via l'aperçu et utilisez-le comme référence pour l'ordre et la construction des sections.

CMS