Les révisions

Description

Le système de révision de WordPress stocke un enregistrement de chaque brouillon enregistré et de chaque mise à jour de publication déjà en ligne. Ce système de révision vous permet de visualiser les modifications faites sur chaque révision en utilisant une glissière (ou en utilisant les boutons précédent/suivant). L’affichage indique ce qui a changé sur chaque révision : ce qui a été ajouté, ce qui n’a pas été modifié et ce qui a été supprimé. Les lignes ajoutées ou supprimées sont surlignées et les caractères qui ont été modifiés ont un surlignement supplémentaire. Cliquez sur le bouton « Rétablir cette révision » pour rétablir une révision spécifique d’une publication.

La page de gestion des révisions inclut également un mode « Comparer n’importe quelles révisions » qui permet de comparer n’importe quelles révisions. En cochant ce mode (voir capture d’écran ci-dessous), la glissière dispose de deux sélecteurs permettant de sélectionner les deux révisions à comparer. Utilisez ces glissières pour visualiser les différences entre deux révisions spécifiques.

Note : le bouton « Rétablir cette révision » rétablit toujours la seconde révision sélectionnée, celle qui est affichée à droite de l’écran.

Pour revenir sur l’écran de modification de votre publication, cliquez sur le titre de la publication en haut de la page.

Enregistrements automatiques

Il y a une limite de une révision automatique maximum par utilisateur ou utilisatrice, pour une publication donnée. Les nouveaux enregistrements automatiques écrasent les plus anciens. Cela signifie que non, vos tables de bases de données ne vont pas grossir à chaque minute. Cela vaut aussi pour les installations multisites.

Les enregistrements automatiques sont actifs pour toute publication mais ne surchargent pas le contenu déjà publié. Les enregistrements automatiques sont enregistrés comme un type spécifique de révision qui ne peut pas surcharger la publication en cours. En fait, si vous avez une coupure de courant, si votre navigateur plante ou si vous perdez votre connexion internet, WordPress affichera un message vous proposant de rétablir le dernier enregistrement automatique lorsque vous reviendrez sur l’édition de votre publication. Vous pourrez visualiser les différences entre le contenu de votre publication et le contenu de l’enregistrement automatique et choisir quelle version utiliser.

Options concernant les révisions

Vous pouvez limiter le nombre de révisions stockées en base de données.

Le filtre wp_revisions_to_keep permet aux développeuses et aux développeurs de modifier facilement le nombre de révisions à conserver pour chaque publication.

Vous pouvez aussi utiliser la constante suivante dans votre fichier wp-config.php :

define( 'WP_POST_REVISIONS', 3 );

Voici les valeurs possibles pour la constante WP_POST_REVISIONS :

• true (par défaut) ou -1 : conserver toutes les révisions de chaque publication
• false ou 0 : ne conserver aucune révision (à part un enregistrement automatique par publication)
• N’importe quel nombre entier supérieur à zéro : autoriser WordPress à enregistrer au maximum ce nombre de révisions (plus un enregistrement automatique) par publication. Les révisions plus anciennes seront supprimées automatiquement.

Méthode de stockage des révisions

Les révisions sont stockées dans la table wp_posts.

Elles sont stockées en tant qu’enfant de la publication à laquelle elles sont associées (c’est la même chose que pour les fichiers attachés). Leur post_status porte la valeur inherit, leur post_type porte la valeur revision et leur post_name est construit de la façon suivante :

• {ID de la publication}-revision-#{numéro de la révision} pour les révisions normales
• {ID de la publication}-autosave pour les enregistrements automatiques

Par défaut, WordPress garde une trace des modifications sur le titre de la publication, son auteur, son contenu et son extrait.

Gestion des révisions

Suppression : il y a une fonction d’API pour supprimer les révisions mais il n’y a pas encore d’interface. Cela pourra potentiellement être ajouté à l’avenir.

Afficher les révisions

Actuellement, les diff (différences) entre deux révisions sont affichées en version HTML ou texte. À l’avenir, des filtres permettront aux auteurs d’extensions de personnaliser l’encodage et l’affichage des diff (voir le ticket Trac #24908, en anglais).

Traduit par Jb Audras
Relu par Marie Comet & Jenny Dupuy
Dernière mise à jour le 22 mars 2020