# CHAPITRE 12 — Brouillon, publication et versions

Tout ce que vous saisissez n'est pas immédiatement visible publiquement. Le module utilise un système de brouillons qui vous permet de préparer plusieurs modifications, de les relire, puis de les publier en une seule opération. Ce chapitre détaille ce mécanisme.

### <span style="color: rgb(35, 111, 161);">La distinction essentielle entre brouillon et publication</span>

<table id="bkmrk-%C3%89tatvisibilit%C3%A9brouil" style="width: 100%; border-collapse: collapse; margin: 1rem 0px; font-size: 0.95em;"><colgroup><col></col><col></col></colgroup><tbody><tr style="background: rgb(25, 5, 45); color: rgb(254, 252, 232);"><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">État

</th><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Visibilité

</th></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Brouillon**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Visible uniquement dans l'éditeur Studio (aperçu central). Les visiteurs du site continuent à voir l'ancienne version.

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Publié**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Visible publiquement. Les visiteurs voient la nouvelle version dès la publication.

</td></tr></tbody></table>

<p class="callout info">**Note —**<span style="white-space: pre-wrap;"> Le module stocke deux valeurs par slot : </span>`<span class="editor-theme-code">value</span>`<span style="white-space: pre-wrap;"> (la valeur publique) et </span>`<span class="editor-theme-code">value_draft</span>`<span style="white-space: pre-wrap;"> (le brouillon). L'aperçu Studio lit en priorité </span>`<span class="editor-theme-code">value_draft</span>`<span style="white-space: pre-wrap;">. Le rendu public lit uniquement </span>`<span class="editor-theme-code">value</span>`.</p>

### <span style="color: rgb(35, 111, 161);">Repérer ses brouillons en attente</span>

Plusieurs indicateurs visuels signalent la présence de brouillons non publiés.

##### **Sur la liste des pages (colonne de gauche)**

Une pastille orange à côté du titre de la page indique qu'elle contient au moins un brouillon non publié.

##### **Sur la barre d'outils de l'éditeur**

<span style="white-space: pre-wrap;">Le bouton </span>**Publier les modifications**<span style="white-space: pre-wrap;"> apparaît avec un compteur numérique précisant le nombre de brouillons :</span>

- Aucun brouillon : le bouton est masqué.
- Un ou plusieurs brouillons : le bouton est visible avec le compteur (par exemple « Publier les modifications (3) »).

##### **Sur l'inspecteur**

Un slot avec un brouillon en cours porte un repère orange « modifié » à côté de son libellé.

##### **Sur l'aperçu central**

<span style="white-space: pre-wrap;">L'aperçu présente toujours la version brouillon. Pour voir exactement ce que verrait un visiteur, cliquez sur </span>**Voir public**<span style="white-space: pre-wrap;"> dans la barre d'outils, ce qui ouvre la page dans un nouvel onglet.</span>

### <span style="color: rgb(35, 111, 161);">Publier les modifications</span>

Lorsque vous êtes satisfait de votre brouillon :

1. <span style="white-space: pre-wrap;">Cliquez sur </span>**Publier les modifications**<span style="white-space: pre-wrap;"> en haut à droite de la barre d'outils.</span>
2. Une boîte de confirmation s'affiche : « Publier les N modifications de cette page ? »
3. <span style="white-space: pre-wrap;">Cliquez sur </span>**Confirmer**.
4. Une notification verte « Modifications publiées » apparaît en bas à droite.
5. L'aperçu reste identique, puisque la version brouillon est devenue la version publique.
6. Le compteur numérique disparaît, ainsi que la pastille orange dans la barre latérale.

<p class="callout success">**Effet immédiat —**<span style="white-space: pre-wrap;"> Les visiteurs qui ouvrent la page après votre publication voient la nouvelle version. Aucun délai, aucun cache à vider.</span></p>

<p class="callout info">**Conseil —**<span style="white-space: pre-wrap;"> Préparez plusieurs modifications avant de publier. Le bouton publie l'ensemble des brouillons en une seule fois, ce qui évite que les visiteurs voient des versions intermédiaires.</span></p>

### <span style="color: rgb(35, 111, 161);">Annuler les modifications en attente</span>

Si vous changez d'avis et souhaitez tout abandonner pour revenir à la version actuelle du site :

1. <span style="white-space: pre-wrap;">Cliquez sur </span>**Annuler les modifications**<span style="white-space: pre-wrap;"> dans la barre d'outils, à côté de « Publier ».</span>
2. Une boîte de confirmation s'affiche : « Annuler les N modifications de cette page ? Cette action est irréversible. »
3. <span style="white-space: pre-wrap;">Cliquez sur </span>**Confirmer**.
4. L'ensemble des brouillons est supprimé.
5. L'aperçu se met à jour avec la version publique.

<p class="callout warning">**Avertissement —**<span style="white-space: pre-wrap;"> Une fois confirmée, l'annulation efface définitivement vos brouillons. Aucune récupération n'est possible.</span></p>

### <span style="color: rgb(35, 111, 161);">Mettre en ligne ou retirer du site (statut de la page)</span>

Cette fonction ne doit pas être confondue avec « Publier les modifications ». Le bouton agit ici sur la visibilité de la page elle-même, non sur ses contenus.

<table id="bkmrk-boutoneffetpublier-l" style="width: 100%; border-collapse: collapse; margin: 1rem 0px; font-size: 0.95em;"><colgroup><col></col><col></col></colgroup><tbody><tr style="background: rgb(25, 5, 45); color: rgb(254, 252, 232);"><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Bouton

</th><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Effet

</th></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Publier les modifications**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Bascule les brouillons des slots vers les valeurs publiques. Concerne le contenu de la page.

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Mettre en ligne ou Retirer du site**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Bascule la visibilité de la page. Une page « Retirée du site » renvoie une erreur 404 ; le wrapper Apache est supprimé.

</td></tr></tbody></table>

##### **Cas d'usage de « Retirer du site »**

- Vous préparez une nouvelle page qui ne doit pas être publique tant que tous ses contenus ne sont pas finalisés.
- Vous souhaitez désactiver une promotion expirée tout en conservant la page pour une réactivation future.
- Une ancienne page que vous ne voulez plus rendre accessible mais que vous préférez conserver dans la base.

<p class="callout success">**Effet de « Mettre en ligne » —**<span style="white-space: pre-wrap;"> Le wrapper Apache </span>`<span class="editor-theme-code"><alias>.php</span>`<span style="white-space: pre-wrap;"> est régénéré et la page redevient accessible. La page canonique et ses pages sœurs (autres langues) basculent simultanément.</span></p>

### <span style="color: rgb(35, 111, 161);">L'historique des modifications</span>

Toutes vos publications sont consignées dans un journal interne (`<span class="editor-theme-code">llx_infrasstudio_revision</span>`). Pour les consulter :

1. Sélectionnez un slot dans l'inspecteur.
2. <span style="white-space: pre-wrap;">Dépliez la section </span>**Historique**<span style="white-space: pre-wrap;"> en bas du panneau.</span>
3. Vous y voyez la chronologie des modifications, avec :
    - la date et l'heure,
    - l'auteur (utilisateur Dolibarr),
    - l'action effectuée (création, mise à jour, publication, annulation).

<p class="callout info">**Note —**<span style="white-space: pre-wrap;"> L'historique vous permet de consulter qui a fait quoi. Une fonction de restauration directe d'une version antérieure n'est pas encore disponible : si vous avez besoin de revenir en arrière, contactez votre administrateur Dolibarr, qui peut récupérer la valeur depuis la base de données.</span></p>

### <span style="color: rgb(35, 111, 161);">Workflow recommandé pour une équipe</span>

Pour les sites édités par plusieurs personnes :

1. Le rédacteur ouvre la page et procède aux modifications. Toutes restent à l'état de brouillon.
2. Le rédacteur partage le lien de l'éditeur avec un relecteur (chef de projet, marketing, juriste, etc.).
3. Le relecteur ouvre la même page dans le Studio. L'aperçu lui présente la version brouillon.
4. Le relecteur valide ou demande des ajustements via un canal externe (Slack, courriel, etc.).
5. Le rédacteur applique les ajustements (toujours en brouillon).
6. Une fois la version validée, le rédacteur ou un publicateur dédié, selon les permissions configurées, clique sur « Publier les modifications ».

<p class="callout info">**À retenir —**<span style="white-space: pre-wrap;"> Le système de brouillon n'est pas un confort optionnel. Il évite les publications accidentelles en cours de rédaction et permet une véritable validation à plusieurs avant que les visiteurs voient le résultat.</span></p>

### <span style="color: rgb(35, 111, 161);">Récapitulatif</span>

**Vous savez désormais :**

- Distinguer un brouillon (privé à l'éditeur) d'une publication (visible publiquement).
- Reconnaître les indicateurs visuels (pastille orange, compteur numérique, repère slot).
- Publier les modifications d'une page en un clic.
- Annuler les brouillons en cas de changement d'avis.
- Distinguer « Publier les modifications » (contenu) et « Mettre en ligne ou Retirer » (visibilité).
- Consulter l'historique d'un slot.
- Mettre en place un processus de relecture collective.

Le chapitre suivant aborde la gestion du multilingue.