Help:VisualFileChange.js

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search
This page is a translated version of a page Help:VisualFileChange.js and the translation is 100% complete. Changes to the translation template, respectively the source language can be submitted through Help:VisualFileChange.js and have to be approved by a translation administrator.
Current version: 0.10.0.0

Qu’est-ce que VFC ?

Lien “Perform batch task” dans la boîte à outils

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

VisualFileChange est un outil écrit en JavaScript. Vous n'avez pas activé le JavaScript.

Pour l'installer :

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

La première boîte de dialogue permet de renseigner la cible

É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

Vous voulez juste sélectionner certains fichiers avec ou sans catégories ? Vous souhaitez sélectionner les fichiers téléversés entre deux dates données parce que vous avez reçu les autorisations via OTRS pour ces fichiers ? Pas de problème, cliquez sur le bouton "Advanced Select Files"

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.

VisualFileChange gère des substitutions multiples par expression régulière et propose des méthodes pour conserver certains champs. De plus, vous pouvez prévisualiser les modifications avant de les appliquer.
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/ la première expression entre parenthèses, à | Source = {{MyCoolWebsite|$1}} la seconde expression entre parenthèses, etc. Ainsi, par exemple, l'expression régulière /[|]\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.

La configuration avancée. Vous pouvez jouer ici avec les paramètres par défaut. N'oubliez pas de les enregistrer.

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