CHAPITRE 14 — Gérer les articles de blog

Le blog géré par le module repose sur les pages standard du module Website. Aucune table dédiée, aucun système parallèle : un article correspond à une page web. L'ensemble de ce que vous savez déjà s'applique, avec quelques raccourcis ergonomiques supplémentaires.

Comprendre l'architecture du blog

Élément	Description
Article	Une page Dolibarr Website portant le type blogpost .
Page d'index	Une page standard (par exemple « Ressources » ou « Blog ») qui liste les articles publiés.
Multilingue	Un article correspond à une page, qui correspond à un fichier PHP. Les traductions vivent dans les surcharges de slots, comme pour toute page.

Créer un nouvel article

L'assistant de création est contextuel : il s'active automatiquement lorsque vous êtes sur la page d'index du blog désignée par votre administrateur.

Procédure

1. Ouvrez la page d'index du blog (par exemple /ressources).
2. Le bouton de la barre latérale devient + Nouvel article (au lieu de « + Nouvelle page »).
3. Cliquez sur ce bouton.
4. Une fenêtre s'ouvre avec trois champs :
   • Titre : il deviendra le H1 et le titre SEO. Il pré-remplit le slot post_title.
   • Slug : généré automatiquement à partir du titre, préfixé par blog-. Vous pouvez le modifier.
   • Catégorie : la rubrique de l'article (par exemple transformation digitale, juridique). Elle pré-remplit le slot post_category.
5. Cliquez sur Créer l'article.
6. Une nouvelle page blog-mon-titre est créée à partir du gabarit blog du site.
7. Vous êtes automatiquement redirigé vers l'éditeur de cette nouvelle page.

Effet automatique — Le module crée la page Dolibarr, le fichier tpl.php, le wrapper Apache blog-mon-titre.php et pré-remplit les slots post_title et post_category.

Anatomie d'un article

Un article créé depuis le gabarit standard contient les slots suivants :

Slot	Type	Rôle
post_title	texte court	H1 et titre SEO de l'article
post_meta_description	texte court	Meta description SEO (150-160 caractères)
post_category	texte court	Rubrique affichée en pastille au-dessus du titre
post_lead	texte long	Chapeau ou accroche en italique sous le titre
post_hero_image	image	Image principale en pleine largeur en haut de l'article
post_body	texte riche	Le corps de l'article (éditeur visuel complet)
post_secondary_image	image	Image illustrative facultative dans le corps
post_secondary_alt	texte court	Texte alternatif de l'image secondaire

Note — La date d'un article n'est pas un slot. Elle est lue automatiquement depuis la base Dolibarr (date de modification, sinon date de création). Vous n'avez pas à la saisir.

Date et auteur d'un article

La date affichée publiquement suit cette cascade :

1. La date de modification de la page (la plus récente).
2. La date de création si la page n'a jamais été modifiée.

Vous n'avez rien à saisir : à chaque publication d'une modification, la date est mise à jour automatiquement. C'est le comportement standard d'un blog.

Conseil — Pour antidater un article, demandez à votre administrateur Dolibarr de modifier llx_website_page.date_creation en SQL. Aucune interface dédiée n'est prévue, par souci de simplicité.

L'auteur affiché est généralement géré par un slot dans le gabarit du site (par exemple post_author).

La page d'index avec son listing automatique

La page d'index du blog (« Ressources », « Blog », etc.) ne nécessite aucune édition manuelle pour ajouter un nouvel article : la liste se met à jour automatiquement.

Lorsque vous publiez un nouvel article :

1. Le module détecte la nouvelle page de type blogpost au statut publié.
2. Au prochain rendu de la page d'index, l'article apparaît dans la grille.
3. Image principale, titre, catégorie, accroche, date : tout est lu depuis les slots de l'article.

Conséquence — Vous ne touchez jamais à la page d'index. Vous publiez vos articles. Le listing se met à jour de lui-même.

La section « À lire également »

Sous chaque article, une section affiche trois articles aléatoires (autres que celui qui est consulté). Aucune configuration n'est nécessaire : la sélection est effectuée par le module à chaque rendu.

Modifier un article existant

1. Ouvrez l'éditeur Studio.
2. Dans la colonne de gauche, dépliez le groupe blogpost.
3. Cliquez sur l'article à modifier.
4. L'aperçu se charge. Modifiez les slots normalement (clic dans l'aperçu, inspecteur, etc.).
5. Publiez lorsque vous êtes prêt.

Dupliquer un article

Cette fonction est utile pour réutiliser une structure existante :

1. Ouvrez l'article modèle.
2. Cliquez sur Dupliquer dans la barre d'outils.
3. Une fenêtre demande le nouveau slug (préfixé blog-) et le nouveau titre.
4. Confirmez.
5. Le module crée la copie avec tous les slots clonés (canonique et traductions).
6. Vous êtes redirigé vers le nouvel article pour le personnaliser.

Supprimer un article

Réservé aux administrateurs — Le bouton « Supprimer » de la barre d'outils n'est visible qu'avec la permission admin. Une confirmation est demandée. La suppression est irréversible : la page Dolibarr, ses slots, son fichier tpl.php et son wrapper Apache disparaissent définitivement.

Alternative — Plutôt que de supprimer, utilisez Retirer du site. L'article sort du listing public mais reste consultable depuis l'éditeur. Vous pouvez le remettre en ligne plus tard.

Récapitulatif

Vous savez désormais :

• Comprendre qu'un article correspond à une page Dolibarr Website.
• Créer un nouvel article via l'assistant contextuel sur la page d'index.
• Renseigner les huit slots du gabarit blog standard.
• Comprendre la datation automatique de l'article.
• Constater que le listing se met à jour de lui-même.
• Modifier, dupliquer, retirer ou supprimer un article.

Le chapitre suivant présente le catalogue produit dynamique.