| É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. |
**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.