Custom Fields in WordPress massenhaft bearbeiten – von jedem Plugin oder Theme

Um Custom Fields in WordPress massenhaft zu bearbeiten, die ein anderes Plugin oder Ihr Theme angelegt hat, brauchen Sie zu jedem Feld zwei Angaben: seinen Meta-Schlüssel und das Format des gespeicherten Werts. Toolset-Felder, Angaben in Verzeichnis- und Listing-Plugins, die Optionen eines Themes pro Beitrag: Solange sie in den Metadaten des Beitrags liegen, kann WOLF sie als Spalten anzeigen, danach filtern und für Hunderte Beiträge gleichzeitig ändern. Diese Anleitung zeigt, wie Sie den Schlüssel finden, wie Sie das gespeicherte Format lesen, welche Spalteneinstellungen dazu passen und woran Sie Felder erkennen, die sich auf diesem Weg nicht bearbeiten lassen.

Was ein benutzerdefiniertes Feld ist und was WOLF bearbeiten kann

Ein benutzerdefiniertes Feld (Custom Field) ist eine Zeile in der Tabelle wp_postmeta: eine Beitrags-ID, ein Meta-Schlüssel und ein Wert. Das Plugin, dem das Feld gehört, bestimmt Schlüssel und Format. Auf seinem Bearbeitungsbildschirm zeigt es ein komfortables Eingabeelement, etwa eine Gruppe von Checkboxen, einen Bild-Upload oder eine Datumsauswahl. Gespeichert wird aber nur ein Wert in dieser Zeile: eine Liste von Optionsschlüsseln, eine Anhang-ID, ein Datumstext.

WOLF arbeitet mit diesem gespeicherten Wert, nicht mit dem Eingabeelement des Plugins. Daraus folgen zwei Dinge:

• Jeder Wert in den Beitrags-Metadaten kann zu einer WOLF-Spalte werden, egal welches Plugin ihn geschrieben hat.
• Daten, die das Plugin anderswo ablegt, etwa in eigenen Datenbanktabellen, in Optionen oder in Term-Metadaten, können weder Spalte noch Filter noch Massenoperation sein.

Für Advanced Custom Fields gibt es eine eigene Anleitung mit dem Format jedes Feldtyps: ACF-Felder massenhaft bearbeiten.

Den Meta-Schlüssel eines benutzerdefinierten Feldes finden

Gehen Sie mit diesen drei Methoden in dieser Reihenfolge vor:

1. Die Schlüssel eines Beitrags auflisten. Füllen Sie das Feld bei einem Beitrag mit einem Wert, den Sie wiedererkennen, und speichern Sie. Wählen Sie in WOLF den Beitragstyp, öffnen Sie Metafelder (Meta Fields), geben Sie die Beitrags-ID unter Meta-Schlüssel eines beliebigen Beitrags per ID abrufen (Get meta keys from any post by its ID) ein und klicken Sie auf Abrufen (Get). Schlüssel mit sprechenden Namen erklären sich meist selbst. Um einen Kandidaten zu prüfen, behalten Sie ihn, speichern Sie die Metafelder, aktivieren Sie seine Spalte unter Einstellungen (Settings) und sehen Sie sich den Wert Ihres Testbeitrags an. Schlüssel, die mit einem Unterstrich beginnen, werden im WordPress-Feld für benutzerdefinierte Felder ausgeblendet, doch viele Plugins speichern ihre eigentlichen Daten genau dort. Überspringen Sie sie also nicht.
2. Das Feld auf dem Bearbeitungsbildschirm untersuchen. Klicken Sie mit der rechten Maustaste auf das Eingabefeld im Bearbeitungsbildschirm des Beitrags und wählen Sie Untersuchen (Inspect). Das Attribut name enthält oft den Schlüssel oder einen Teil davon. Toolset etwa stellt dem Feld-Slug das Präfix wpcf- voran, ein Feld listing-amenities liegt also unter wpcf-listing-amenities.
3. Den Autor fragen. Führt keine der beiden Methoden zum Ziel, nennen Ihnen die Dokumentation oder der Support des Plugins Schlüssel und Format.

Die Spalte auf den gespeicherten Wert abstimmen

Sobald die Spalte den Rohwert zeigt, verrät seine Form, wie Sie das Feld unter Metafelder (Meta Fields) einrichten. Die Dokumentation zu den Metafeldern beschreibt jede Ansicht.

Zwei Anmerkungen zur Tabelle. Die Ansicht calendar speichert einen Unix-Zeitstempel. Verwenden Sie sie also nur für Felder, die bereits einen solchen enthalten; bei jedem anderen Datumsformat würde sie das Format ändern, und das Plugin, dem das Feld gehört, könnte das Datum nicht mehr lesen. Und für Textwerte einer Checkbox fügen Sie unter Einstellungen (Settings) → Meta-Checkbox überschreiben (Override meta checkbox) eine Regel hinzu: Eine Regel besteht aus dem Meta-Schlüssel, einem Doppelpunkt und dem Wert. Mit featured:yes schreibt die Checkbox yes, wenn sie aktiviert ist, und mit featured:yes^no zusätzlich no, wenn sie deaktiviert ist. Mehrere Regeln werden durch Kommas getrennt.

Serialisierte und JSON-Werte öffnen sich in einem Schlüssel/Wert-Popup; siehe serialisierte Metadaten massenhaft bearbeiten.

Beispiele aus echten Plugins und Themes

Toolset-Checkboxen und Ja/Nein-Felder

Ein Toolset-Checkbox-Feld wie wpcf-listing-amenities speichert eine serialisierte Liste der gewählten Optionen, gekennzeichnet durch die internen Optionsschlüssel von Toolset und nicht durch ihre Titel. Stellen Sie es auf array ein: Das Popup zeigt nur die gewählten Optionen unter diesen Schlüsseln. Solche Schlüssel von Hand einzutippen ist fehleranfällig, kopieren Sie daher lieber eine Auswahl: Legen Sie sie bei einem Beitrag im Toolset-Editor fest, wählen Sie in WOLF diesen Beitrag und die Beiträge aus, die dieselbe Auswahl erhalten sollen, schalten Sie die Gebundene Bearbeitung (binded editing) ein, öffnen Sie das Array-Popup des Beispielbeitrags und klicken Sie auf Übernehmen (Apply). Der Wert wird in alle ausgewählten Beiträge geschrieben, wie unter denselben Wert für mehrere Beiträge setzen beschrieben. Ein einzelnes Ja/Nein-Feld wie wpcf-featured-listing speichert 1, wenn es angehakt ist; die Ansicht checkbox kommt damit zurecht.

Seitenvorlagen und Theme-Optionen pro Beitrag

WordPress speichert die für eine Seite oder einen Beitrag gewählte Vorlage in _wp_page_template. Fügen Sie das Feld als String hinzu, kopieren Sie den exakten Wert von einem Beitrag, der die Vorlage bereits verwendet, und bearbeiten Sie die übrigen massenhaft auf diesen Wert; mit default kehren sie zur Standardvorlage zurück. Themes mit eigenen Optionen pro Beitrag halten diese oft in einem einzigen serialisierten Feld zusammen, so auch die Beitragsvorlage des Themes Newspaper. Fügen Sie diesen Schlüssel als array hinzu, ändern Sie die Einstellung bei einem Beitrag und kopieren Sie sie wie oben mit der gebundenen Bearbeitung auf die anderen.

Bilder in Listing- und Verzeichnis-Plugins

Bildfelder speichern meist Anhang-IDs und keine URLs; eine in die Spalte getippte URL bewirkt daher nichts. Geben Sie die ID des Bildes aus der Mediathek ein. Enthält das Feld das Hauptbild des Beitrags, prüfen Sie, ob es schlicht das Beitragsbild ist: Dafür gibt es in WOLF die eingebaute Spalte Beitragsbild (Thumbnail). Manche Plugins speichern ihre Bildlisten in einem eigenen Format; ist der Wert weder eine ID noch eine Kommaliste noch eine serialisierte Liste, überlassen Sie ihn dem Editor des Plugins.

Wann sich ein benutzerdefiniertes Feld nicht massenhaft bearbeiten lässt

• Die Daten liegen nicht in den Beitrags-Metadaten. Manche Verzeichnis- und Listing-Plugins, darunter GeoDirectory, halten die Angaben zu einem Eintrag in eigenen Datenbanktabellen. Erscheint ein Feld nie unter Meta-Schlüssel eines beliebigen Beitrags per ID abrufen (Get meta keys from any post by its ID), auch bei einem Beitrag, in dem es ausgefüllt ist, gibt es keine Meta-Zeile zum Bearbeiten. Bei solchen Feldern helfen nur die eigenen Werkzeuge des Plugins oder sein Support.
• Mehrere Zeilen teilen sich einen Schlüssel. Einige Plugins speichern ein Feld mit mehreren Werten als mehrere Meta-Zeilen mit demselben Schlüssel, eine pro Wert. WOLF behandelt ein Metafeld als einen einzigen Wert: Die Spalte zeigt die erste Zeile, und beim Speichern werden alle Zeilen dieses Schlüssels durch den einen Wert ersetzt. Bearbeiten Sie solche Felder nicht massenhaft.
• Der Wert ist keine echte Liste. Werte wie red|blue oder red, blue sind einfacher Text. Bearbeiten Sie sie als String; die Ansicht array kann ihnen nichts anhängen.

Eine Wirkung überrascht viele: Wenn Sie nur Metafelder ändern, bleibt das Zuletzt geändert (Date modified) des Beitrags unverändert. WOLF speichert Metadaten mit update_post_meta() und löst die Aktionen save_post und edit_post aus, damit andere Plugins reagieren können, speichert aber die Beitragszeile nicht. Ist das Änderungsdatum wichtig, etwa für Sitemaps oder „Zuletzt aktualisiert“-Hinweise, nehmen Sie die Spalte Zuletzt geändert (Date modified) in dieselbe Massenoperation auf: WordPress setzt bei jedem gespeicherten Beitrag die aktuelle Uhrzeit, unabhängig vom gewählten Datum.

Erst an einem Beitrag testen, dann die benutzerdefinierten Felder massenhaft bearbeiten

1. Ändern Sie das Feld bei einem Beitrag in der WOLF-Tabelle.
2. Öffnen Sie diesen Beitrag im Bearbeitungsbildschirm des zuständigen Plugins und im Frontend und prüfen Sie, ob der neue Wert korrekt angezeigt wird.
3. Filtern Sie die zu ändernden Beiträge im Reiter Filter (Filters) und führen Sie die Operation im Reiter Massenbearbeitung (Bulk Edit) aus.
4. Ist das Ergebnis falsch, machen Sie die gesamte Operation im Reiter Verlauf (History) rückgängig.

Wenn ein Feld in den Beitrags-Metadaten liegt und sich trotzdem nicht wie hier beschrieben verhält, eröffnen Sie im WOLF-Supportforum ein Thema mit dem Meta-Schlüssel, einem Beispiel für den gespeicherten Wert und dem Plugin, das das Feld erzeugt.