Manual:Reverts/fr

Une annulation est (généralement parlant) une modification qui inverse les actions des autres éditeur. Dans ce processus une nouvelle version de la page est créée.

Cette page présente les différents types d'annulations pris en charge et reconnus par MediaWiki, principalement pour les développeurs. Elle décrit également la manière d'intégrer les extensions dotées de mécanismes liés à l'annulation et présents dans le noyau de MediaWiki.

Types d'annulation
Trois méthodes pour réaliser des annulations sont reconnues par MediaWiki.

Interface utilisateur
Les undo sont réalisés en utilisant le lien undo qui apparait dans l'historique des pages, l'affichage du diff, les listes des modifications récentes et autres.

Les liens undo pointent vers  avec les paramètres   et   précisant les modifications à annuler.


 * – ID de la dernière version à annuler.
 * – ID de la dernière version valide. La version suivante sera la première à être annulée.

Voir aussi :

API
Les annulations peuvent être réalisées en utilisant l'API ainsi :  avec les paramètres   et. Leur comportement est le même que dans.

Principe
Toutes les versions de  (exclue) à   (incluse) sont annulées. essaie de fusionner l'inverse de ces modifications avec toutes les modifications qui suivent Si cela n'est pas possible, le formulaire d'éditon usuel est affiché et la modification n'est pas comptée comme une annulation.

Ensuite, le formulaire de modification est affiché à l'utilisateur, où le contenu résultant peut ensuite être modifié.

Depuis la version 1.36, si l'utilisateur réalise une modification quelconque du contenu avant de le sauvegarder, la modification n'est pas marquée comme annulation. Ceci est fait pour empêcher les utilisateurs de marquer les modifications arbiraires en tant qu'annulations.

Autres types de contenu
Si votre extension implémente un nouveau ContentHandler, celui-ci peut supplanter la méthode  pour adapter la façon dont les annulations sont gérées par le type de votre contenu.

Interface utilisateur
Le rollback peut être réalisé en utilisant le lien rollback apparaissant dans l'historique de page, dans l'affichage du diff, dans les listes des modifications récentes et autres.

Les liens de rollback pointent vers  avec les paramètres additionnels permettant de définir l'ensemble correct des modifications à annuler.

Voir aussi : les paramètres de index.php concernant le rollback

API
Le rollback peut être fait via l'API en utilisant. Leur comportement est le même que dans.

Principe
Le rollback annule les dernières éditions faites par le dernier contributeur de la page. C'est un scénario communément utilisé dans les cas de vandalisme, car habituellement il s'agit d'annuler toutes les modifications faites récemment par un même utilisateur.

Annulation manuelle
L'annulation manuelle n'utilise aucun interface utilisateur particulier ni aucune API, car elle est réalisée automatiquement par le logiciel. A chaque fois qu'une modification est faite, MediaWiki regarde le nombre de modifications les plus récentes de la page (spécifié par, 15 par défaut) et recherche la version la plus récente correspondant au contenu. Si une telle version est trouvée, la modification est marquée en tant que annulation manuelle (manual revert), par exemple une modification concernant la restauration exacte de la page dans un état antérieur.

La fonctionnalité peut être complètement désactivée en mettant  à zéro.

Balises d'annulation
Par défaut chaque version considérée comme une annulation par MediaWiki est marquée avec une balise de modification appropriée. Chacune de ces balises peut être désactivée individuellement en utilisant la variable de configuration.


 * Undo:
 * Rollback:
 * Annulation manuelle :

Depuis la version 1.36 les données supplémentaires de l'annulation sont sauvegardées avec chaque balise dans le champ  de la table. Les données sont l'objet EditResult associé à la modification (voir la section suivante), encodé au format JSON.

Accès à l'information annulée dans les extensions
Version 1.35 introduced the class that is constructed when saving an edit. This object encapsulates information about the effects of the edit in the context of its page's history, most importantly:


 * whether the edit was a revert,
 * which revert method was used,
 * what is the "base" revision for this revert,
 * which revisions were reverted.

This object is passed to extensions using the PageSaveComplete hook.

Balise d'annulation
In version 1.36 a new change tag is introduced –  that is used to mark reverted edits.

Planification et exécution
The tag is applied in a job named  scheduled using the job queue. The job is added to the queue by DerivedPageDataUpdater after the edit is saved.

If your wiki has a busy job queue and you encounter significant delays between making reverts and the tag being applied, you may want to execute the job in a separate queue or prioritize it, depending on your setup. See Manual:Job queue for details.

Conditions d'exécution
La mise à jour sera planifiée après l'enregistrement d'une modification si toutes les conditions suivantes sont satisfaites :


 * La modification est une annnulation de type quelconque reconnue par MediaWiki. Voir la section Types d'annulation.
 * Le nombre de modifications annulées est inférieur ou égal à.
 * La version correspondant à l’action d’annuler n’est pas marquée elle-même comme annulée ou supprimée.
 * La modification est considérée auto-approuvée, ce qui peut avoir différentes significations selon votre configuration :
 * Si le patrouillage est activé sur votre wiki avec la variable de configuration, l'auto-approbation est équivalente à la modification devant être auto-patrouillée. Ainsi, seuls les utilisateurs avec les droits   auront leur balise d'annulation appliquée automatiquement.
 * Si vous avez installé une extension de gestion du contenu telle que FlaggedRevs, elle peut indiquer à MediaWiki que la modification est auto-approuvée. La manière dont cela est exactement déterminé dépend de l'extension. (voir la section Intégration des extensions.)

Si la mise à jour de la balise d'annulation est bloquée par le sous-système de patrouillage ou par une extension, elle peut-être replanifiée ultérieurement, lorsque la modification sera approuvée par un utilisateur différent. En cas de patrouillage, cela se produit quand la modification est patrouillée. Voir la section suivante pour les détails sur la manière d'intégrer cette fonctionnalité avec les extensions.

Intégration d'extensions
Les extensions qui touchent à certains types de mécanismes d'approbation des versions peuvent s'accrocher à la fonctionnalité des balises d'annulation pour faire connaître à MediaWiki pour qu'il fasse la mise à jour des balises d'annulation.

La première partie de ceci relève de l'accroche BeforeRevertedTagUpdate. Il est appelé avant que la mise à jour soit planifiée et que les extensions puissent utiliser cette accroche afin d'empêcher d'exécuter les mises à jour si la modification n'est pas considérée auto-approuvée et a besoin d'une relecture ultérieure.

Si la mise à jour a été interrompue, elle peut être reprogrammée ultérieurement par l'extension en utilisant le service.


 * Approuver une version :

FlaggedRevs
Si vous avez installé l'extension FlaggedRevs, l'annulation sera considérée si soit :


 * FlaggedRevs est paramétré pour ne pas être utilisé sur la page.
 * L'utilisateur possède le droit utilisateur.
 * La modification est une auto-annulation.
 * La modification est sinon candidate pour être auto-contrôlée.

Si l'annulation n'a pas été auto-approuvée, elle peut l'être ultérieurement, simplement en relisant la modification.

Voir aussi

 * Révocation (le manuel)
 * Révocation (sur Meta)