Help:VisualFileChange.js
 | Cette page contient la documentation de VisualFileChange, un gadget écrit en JavaScript et destiné à l'édition en masse. Le script proprement dit est situé sur la page MediaWiki:VisualFileChange.js. |
Qu’est-ce que VFC ?
VisualFileChange (aussi appelé AjaxMassDelete), ajoute un lien “Perform batch task” dans votre boîte à outils, sur les pages du wiki. Le fait de cliquer sur ce lien permet d'exécuter des actions sur certains ou sur tous les téléversements d'un utilisateur, les fichiers d'une catégorie, ou les fichiers affichés dans une galerie. Les actions comprennent la création de demandes de suppression en masse, l'ajout de bandeaux ou de texte libre, ainsi que des remplacements de texte ad hoc (l'outil gère les expressions régulières).
Documentation
See also Help:AjaxQuickDelete à propos des fondamentaux sur les demandes de suppression automatiques, ou “marquer le fichier & notifier le téléverseur”.
Étape 0 : Installation
Pour l'installer :
- Manuellement : dans "Préférences" : onglet "gadgets", section "Outils de maintenance tools" : cliquez sur "VisualFileChange" et appuyez sur le bouton "Enregistrer" en bas de la page.
- Automatiquement : cliquez ici et suivez les instructions.
- Si vous ne disposez pas des droits d'autopatrouille : ajoutez
mw.loader.load( 'ext.gadget.VisualFileChange' );dans votre fichier common.js ou dans votre <skin>.js
Vous devriez maintenant avoir un lien Perform batch task dans votre boîte à outils. Cliquez dessus pour lancer VisualFileChange.
Pour modifier le texte Perform batch task, ajoutez
window.vFC_PortletText = '<your new portlet text>'; à votre common.js ou à votre <skin>.js
Étape 1 : spécifier un contributeur
Vous pouvez effectuer une recherche par contributeur, par nom de page, par catégorie, ou effectuer une requête. Assurez-vous de l'écrire correctement.
Étape 2 : sélection d'une action, insertion d'une raison, remplacement et motif, bandeaux ou texte libre
Membres d'OTRS : renseignez d'abord l'identifiant ou l'URL puis basculez sur OTRS- remove tags. Avec OTRS- add, vous pouvez ajouter n'importe quel bandeau dans la section permission, sans retirer les bandeaux de demande de suppression rapide et assimilés.
Cochez la case Clean permission-section? pour supprimer tout le reste de la section permission, le cas échéant.
Étape 3 : chargement de tous les fichiers à modifier
Seuls les fichiers sélectionnés figurant dans la boîte de dialogue seront modifiés. Pour faire apparaître plus de fichiers, descendez dans la page ou cliquez sur le bouton "more". Cependant, ne faites pas planter votre navigateur en affichant trop de fichiers. Sinon, vous pouvez reprendre là où vous vous étiez arrêté en utilisant le bouton "more options" dans la première boîte de dialogue ou un profil créé automatiquement.
Étape 4 : sélection des éléments sur lesquels effectuer les actions
La liste ne contient que des éléments initialement téléversés par l'utilisateur spécifié. Si des images ont été supprimées, les numéros ne se suivent pas. Le script peut reconnaître de nombreux bandeaux signalant un problème, un ticket OTRS ainsi que certains bandeaux de licences courants et les afficher sous chaque vignette. Exemple
Sélection avancée – Filtrer les fichiers affichés
Si vous ne fournissez aucune information, tout correspondra et toutes les cases à cocher des vignettes vont prendre le même état que celle de cette boîte de dialogue. Ceci vous permet aussi bien de sélectionner que de dé-sélectionner.
- Expressions régulières ou RegExpr /R/
Une RegExpr, aussi appelée expression régulière ou regex, est une expression utilisée pour trouver des correspondances avec plusieurs segments de texte (par exemple, le texte de l'image ou un titre). Elles peuvent s'avérer vraiment très utiles un peu partout, donc, si vous ne les connaissez pas, faites l'effort de les étudier ; le plus tôt est le mieux.
Dans la boîte de dialogue de sélection avancée, renseignez l'expression régulière sans marqueurs (flags) (ils ne sont pas encore gérés) (Test.*) ; cependant, lorsque vous effectuez un remplacement personnalisé, fournissez une expression régulière avec marqueurs (/\{\{FlickrView.*\|\d{4}\}\}/ig). N'oubliez pas de rendre littéraux les "caractères spéciaux".
Merci de tester votre expression régulière avant de l'utiliser et de profiter de l'occasion pour vérifier les modifications que le groupe de règles de substitutions actuel va entraîner, afin d'éviter des substitutions non souhaitées. Vous pouvez utiser https://regex101.com/ (ou des outils similaires) pour tester votre expression régulière.
Lors de l'utilisation d'expressions régulières, VFC suit la même convention que Perl, PHP et d'autres qui, pour la chaîne de remplacement $0 font correspondre toute la chaîne trouvée, font correspondre à /[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/| Source = {{MyCoolWebsite|$1}}/[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/, avec la chaîne de remplacement | Source = {{MyCoolWebsite|$1}}, transformerait |source=FOO.BAR on MyCoolWebsite</nowiki> en | Source = {{MyCoolWebsite|FOO.BAR}}.
Référence/exemples : de, en, en
Sélection par lot – Ensemble de fichiers entre deux fichiers
Sélectionnez le fichier A, maintenez enfoncée la touche ⇧ Shift tout en sélectionnant le fichier B. Tous les fichiers entre les deux fichiers sont maintenant dans le même état que le fichier B.
Remplacement personnalisé : marqueurs
- Si
/R/est renseigné, l'expression est traitée comme une expression régulière. Si le fond derrière le bouton est rouge, il est très probable que vous ayez oublié de cocher ce bouton. Si le fond derrière le champ de l'expression est rouge, c'est que vous avez coché ce bouton mais que l'expression n'est pas une expression régulière valide. - Si
%V%est activé, VisualFileChange recherche des variables (par exemple, des champs des métadonnées du fichier comme%GPSLatitude%ou comme le nom du fichier%PAGENAME%) dans le champ "Text to insert instead". Cette option est activée par défaut. Exemples.
Étape 5 : exécution
Le programme va vous montrer ce qu'il est en train de faire. Enfin, il vous montre où aller. Avant l'exécution, le script enregistre vos paramètres dans un profil automatique (auto-profile). Ceci vous permet de reprendre à partir du dernier fichier affiché. Si vous relancez VisualFileChange et que vous indiquez la même cible, une grosse boîte jaune va apparaître. Cliquez simplement sur le lien pour continuer.
Configuration personnalisée
VisualFileChange vous permet de personnaliser de nombreuses fonctionnalités. Il n'est pas recommandé d'augmenter de façon important le nombre de fichiers à charger lorsqu'on fait défiler l'écran, mais cela peut se montrer utile dans certains cas.
Si vous envoyez trop de requêtes à l'API simultanément, des erreurs peuvent se produire. Les utilisateurs qui ne sont pas connectés ne devraient envoyer qu'une seule requête à la fois. En cas d'erreur, positionnez "ask for confirmation after ... edits" à moins de 8 et patientez un peu lorsque la boîte de dialogue vous demande si vous voulez continuer. Nous regrettons cette limitation mais nous ne pouvons pas intervenir car elle provient du côté serveur. Il y a des restrictions bien plus importantes pour les modifications apportées par les utilisateurs non connectés.
Informations supplémentaires
Développement, recherche et correction de bogues
- Veuillez signaler les bogues sur MediaWiki talk:Gadget-VisualFileChange.js
- diagramme des flux (obsolète)
