Hilfe:VisualFileChange.js

Current version: 0.10.0.0

Was ist VFC?

„Perform batch task“-Link in der Seitenleiste unter „Werkzeuge“

VisualFileChange (a.k.a. AjaxMassDelete) fügt einen „Perform batch task“-Link in deinen Werkzeugkasten auf Wikiseiten hinzu. Das Klicken auf den Link ermöglicht es dir, Aktionen für bestimmte oder alle hochgeladenen Dateien eines Benutzers, Dateien in einer Kategorie oder in einer Galerie auszuführen. Zu den Aktionen gehören die Anfrage nach Massenlöschungen, das Einfügen von Tags oder freiem Text und benutzerdefinierten Textersetzungen (reguläre Ausdrücke werden unterstützt).

Dokumentation

See also Help:AjaxQuickDelete für die Grundlagen der automatischen Löschanfragen oder „tag file & notify uploader“ („Datei taggen & Uploader benachrichtigen“)

Schritt 0: Wie es installiert wird

 Probier's einfach ohne Installation aus

VisualFileChange ist ein JavaScript-Werkzeug. Du hast JavaScript nicht eingeschaltet.

Um es zu installieren:

• Manuell: In „Einstellungen“ / „Helferlein“-Tab / „Wartungshelferlein“-Abschnitt: markiere „VisualFileChange“ und klicke „Einstellungen speichern“ ganz unten auf der Seite.
• Automatisch: Hier klicken und den Anweisungen folgen.
• Falls du keine Automatisch bestätigten Rechte hast: Füge mw.loader.load( 'ext.gadget.VisualFileChange' ); zu deiner common.js oder <skin>.js hinzu

Du solltest nun einen Link Perform batch task in der Toolbox finden. Wenn du darauf klickst, wird VisualFileChange gestartet.

Um den Perform batch task-Text zu ändern, füge window.vFC_PortletText = '<your new portlet text>'; zu deiner common.js oder <skin>.js hinzu.

Der Startdialog fragt nach dem Ziel

Schritt 1: Benutzer einfügen

Das Skript fragt nach einem Benutzer, einem Seitennamen, einer Kategorie oder einer Suchanfrage. Stelle sicher, dass Du alles richtig schreibst.

Schritt 2: Wähle die Aktion aus, füge Grund, Ersetzung, Muster, Tags oder freien Text ein

OTRS-Mitglieder: füge erst die ID oder URL ein und wechsle dann zu OTRS- remove tags. Mit OTRS- add kannst Du jedes Template in den Permission-Abschnitt einfügen, ohne Schnelllösch- oder ähnliche Tags zu entfernen.

Markiere Permission-Bereich säubern? um andere Einträge aus der Permission-Abschnitt zu entfernen, wenn er existiert.

Schritt 3: Lade so viele Dateien wie Du ändern möchtest

Nur Dateien, die markiert und im Dialog sichtbar sind, werden geändert. Um mehr Dateien zu erhalten, scrolle nach unten oder klicke auf „mehr“. Crashe Deinen Browser aber nicht, indem Du zu viele Dateien lädst. Stattdessen kannst Du fortfahren wo Du aufgehört hast, indem Du „weitere Optionen“ im Start-Dialog oder automatisch angelegten Profil verwendest.

Schritt 4: Wähle Einträge aus, mit denen die Aktion durchgeführt werden soll

Es werden nur Einträge angezeigt, die ursprünglich vom angegebenen Benutzer hochgeladen wurden. Wenn es gelöschte Bilder gibt, sind die Nummern nicht durchgängig. Das Skript wird viele Poblem- und OTRS-Tags und übliche Lizenztypen erkennen und sie unter jedem Thumbnail anzeigen. Beispiel

Du willst einfach nur ein paar Dateien mit oder ohne Kategorie auswählen? Du willst Dateien auswählen, die zwischen xx und yy hochgeladen wurden, weil Du OTRS-Permissions für diese Dateien erhalten hast? Kein Problem, klicke auf den Auswahllink

Intelligente Dateiwahl – Filtere geladene Dateien

Wenn Du nichts angegeben hast, wird alles passen und alle Checkboxen in den Thumbnail-Dialogen werden die Status der Checkbox in diesem Dialog erhalten. Das erlaubt Dir sowohl auszuwählen, als auch wieder aus der Auswahl zu entfernen.

VisualFileChange unterstützt multiple RegEx-Ersetzungen und biete Methoden, um bestimmte Abschnitte zu erhalten. Zusätzlich kannst Du Dir die Änderungen ansehen, bevor sie gemacht werden.

RegExpr /R/

Eine RegExpr, auch bekannt als regulärer Ausruck oder Regex ist ein Muster, das verwendet wird, um mehr als einen „String“ (z.B. den Bildtext oder den Titel) zu treffen. Sie können überall sehr hilfreich sein, das heißt, wenn Du keine Erfahrungen damit hast, sei nicht faul und lerne sie; je eher desto besser.

Füge im „Intelligente Dateiwahl“-Dialog die RegExpr ohne Flags (die werden derzeit noch nicht unterstützt) (Test.*) ein; wenn Du eine eigene Ersetzung ausführst, dann füge die RegExpr mit Flags (/\{\{FlickrView.*\|\d{4}\}\}/ig) ein. Vergiss nicht „Spezialzeichen“ (special characters) zu ersetzen.

Bitte teste Deine RegExpr bevor Du sie anwendest und verwende die Möglichkeit, die Änderungen zu prüfen, die die eingestellten Ersetzungsregeln vornehmen würden, um unerwünschte Ersetzungen zu vermeiden. Du kannst https://regex101.com/ (oder ähnliche Werkzeuge) verwenden, um Deine RegExpr zu testen.

Bei der Verwendung regulärer Ausdrücke folgt VFC der gleichen Konvention wie Perl, PHP und andere, dass in der Ersetzungszeichenfolge $0 der gesamten übereinstimmenden Zeichenfolge entspricht, /[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/ dem ersten geklammerten Ausdruck entspricht, | Source = {{MyCoolWebsite|$1}} dem zweiten geklammerten Ausdruck, usw. So würde z.B. der reguläre Ausdruck /[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/ mit einer Ersetzungszeichenfolge | Source = {{MyCoolWebsite|$1}} |source=FOO.BAR on MyCoolWebsite</nowiki> in | Source = {{MyCoolWebsite|FOO.BAR}} verwandeln.

Referenz/Beispiele: de, en, en

Bereichsauswahl – Mehrere Dateien zwischen zwei ausgewählten Dateien

Wähle Datei A, drücke Taste ⇧ Shift während der Auswahl von Datei B. Alle Dateien zwischen den ausgewählten Dateien haben nun den gleichen Stand wie Datei B.

Ersetzung durch Benutzer: Flags

• Wenn /R/ gesetzt ist, wird die Zeichenfolge als regulärer Ausdruck behandelt. Wenn der Hintergrund hinter dem Knopf rot ist, hast du wahrscheinlich vergessen den Knopf anzuklicken. Wenn der Hintergrund hinter dem Knopf rot ist, obwohl du den Knopf geklickt hast, so ist die Zeichenfolge kein regulärer Ausdruck.
• Wenn %V% gesetzt ist, sucht VisualFileChange nach Variablen (z. B. Metadaten wie %GPSLatitude% oder der Dateiname %PAGENAME%) im Feld "Text to insert instead". Diese Option ist in der Grundeinstellung gesetzt. Beispiele.

Schritt 5: Ausführen

Das Skript zeigt an, was es gerade macht. Am Schluss zeigt es den nächsten Schritt. Vor der Ausführung werden deine Angaben in einem Auto-Profil gespeichert. Dieses erlaubt bei den zuletzt hochgeladenen Dateien weiterzumachen. Wenn du VisualFlieCharge erneut startest und dasselbe Ziel auswählst, erscheint eine große gelbe Box. Klicke einfach auf den Link, um wie bisher weiterzumachen.

In den erweiterten Einstellungen kannst du die Grundeinstellungen verändern. Um die Einstellungen dauerhaft zu behalten musst Du sie speichern.

Benutzereinstellungen

VisualFileChange erlaubt viele Einstellungen durch den Benutzer. Es wird nicht empfohlen die Zahl der zu ladenden Dateien deutlich zu erhöhen wenn man herunterscrollt, aber in manchen Fällen kann es nützlich sein.

Wenn zu viele Aufgaben zugleich an die API gesendet werden, können Fehler geschehen. Nicht angemeldete Benutzer sollten immer nur eine einzelne Anfrage senden. Sollten Fehler auftreten, so setze „ask for confirmation after ... edits“ auf weniger als 8 und warte bis der Dialog dich fragt, ob weitergemacht werden soll. Wir bedauern diese Begrenzung, können sie aber nicht ändern, denn sie liegt auf der Seite der Server. Es gibt außerdem viel mehr Beschränkungen für nicht angemeldete Benutzer.

Weitere Informationen

• Einsatzmöglichkeiten und Beispiele
• Sieh mehr Screenshots von VisualFileChange

Entwicklung, erkannte Fehler und Fehlerbehebung

• Fehler bitte melden auf MediaWiki talk:Gadget-VisualFileChange.js
• Diagramm (veraltet)