WOLF

WPBE_SETTINGS::get_fields() führt die statische Feldliste aus data/fields.php mit je einer Spalte pro für den aktuellen Post-Typ registrierter Taxonomie zusammen und wendet dann die gespeicherte Spaltenreihenfolge und die Titel des Benutzers an. Neue Felder, die später auftauchen (eine neue Taxonomie, ein neuer Meta-Key), werden angehängt, statt verloren zu gehen.

Felddefinitionen tragen allow_post_types und prohibit_post_types. wrap_field_val() liefert eine Zelle „restricted“, wenn ein Feld nicht zutrifft, zum Beispiel Status- und Kommentarfelder bei Anhängen, MIME-Typ nur bei Anhängen, Sticky nur bei Beiträgen. Anhänge werden mit dem zusätzlichen Status 'inherit' abgefragt.

Die Tabelle ist mit serverSide: true konfiguriert und ruft wpbe_get_posts mit den Paginierungsparametern von DataTables auf. WPBE_POSTS::gets() wandelt start/length in paged/posts_per_page um und schaltet auf die Sortierung nach meta_value_num um, wenn die Sortierspalte ein numerisches Meta-Feld oder ein Datums-Meta-Feld ist.

Die Zeilen pro Seite sind auf 100 begrenzt, mit dem Code-Kommentar „to avoid 500 error on weak servers“. Die kostenlose Version begrenzt auf 10.

init() führt zuerst eine Rollenprüfung aus und dann is_should_init(), das nur für page=wpbe oder eine AJAX-Action, deren Name 'wpbe_' enthält, true liefert. Auf anderen Admin-Bildschirmen werden nur der Menüeintrag, der Button in der Admin-Leiste und Hinweise registriert.

Erweiterungen folgen einer Namenskonvention (ext/<slug>/<slug>.php, Klasse WPBE_<SLUG>) und erhalten Storage, Einstellungen und das Posts-Modell über init_vars(). Derselbe Loader findet auch Erweiterungen von Drittanbietern in wp-content/wpbe_ext.

Einstellungen liegen in der Option wpbe_options_<user_id>. Ist der Schalter „separate settings“ an, wird der Post-Typ an den Key angehängt, und die Liste der registrierten Meta-Felder wird auf dieselbe Weise pro Post-Typ aufgeteilt. Der aktive Post-Typ wird pro Benutzer im Plugin-Storage gemerkt.

Der Schalter ist in der kostenlosen Version deaktiviert.

Ist SitePress vorhanden, liefert der Filter wpbe_current_language ICL_LANGUAGE_CODE, gets() ruft vor dem Aufbau von WP_Query $sitepress->switch_lang() auf, und die Option der Sticky-Beiträge wird unter sticky_posts_<lang> gelesen und geschrieben.

wpbe_bulk_posts_count speichert das Bulk-Formular unter 'wpbe_bulk_<key>' (16 im Browser erzeugte Zufallszeichen) und gibt die IDs zurück, die zum aktuellen Filter passen, mit fields=ids und no_found_rows. Der Browser zerlegt diese Liste in Batches zu 50 und sendet sie nacheinander an wpbe_bulk_posts, wobei er eine Fortschrittsanzeige und einen Indikator in der Admin-Leiste aktualisiert. Abbrechen bricht den ausstehenden XHR ab; wpbe_bulk_finish gibt die gezählte Gesamtzahl zurück.

Bulk-Löschen nutzt dasselbe Muster mit Batches zu 10 und wp_trash_post(), sodass gelöschte Beiträge aus dem Papierkorb wiederherstellbar bleiben.

Nach einem Durchlauf zeichnet der Browser nur die berührten Zeilen neu, wenn vier oder weniger Beiträge geändert wurden, andernfalls die aktuelle Seite.

__process_text_data() liest den aktuellen Wert jedes Beitrags und wendet das gewählte Verhalten an. Werte können {TITLE}, {ID}, {MENU_ORDER} und {meta:key} enthalten, pro Beitrag aufgelöst, sowie Groß-/Kleinschreibungs-Makros wie {DO_STRING_UP} oder {DO_STRING_TITLE}, die mb_*-Funktionen nutzen, sodass auch nicht-lateinische Titel verarbeitet werden.

__process_number_data() unterstützt Erhöhen/Verringern um Wert oder Prozent und verknüpft das Ergebnis dann optional mit einem anderen Meta-Feld desselben Beitrags (+, -, *, /, wobei die Division durch null durch 1 ersetzt wird) sowie mit einer Zufallszahl aus einem Bereich, skaliert mit einem Dezimalfaktor.

Das Runden des Bruchteils auf Schritte von .05 oder .10 oder auf eine Endung wie .99 geschieht in update_page_field() in der konfigurierten Zahl von Dezimalstellen; Cent-Werte werden über einen ganzzahligen Schritt umgerechnet, weil Float-Modulo falsche Ergebnisse liefert.

WordPress erwartet IDs für hierarchische Taxonomien und Namen oder Slugs für Tag-artige. Der Bulk-Worker prüft is_taxonomy_hierarchical(); für flache Taxonomien wandelt er jede ID in einen Slug um, und bei „replace“ schreibt er den ersten Term mit append=false und die übrigen mit append=true. „Remove“ nutzt wp_remove_object_terms().

Der History-Hook wird vor Term-Änderungen von Hand ausgelöst, weil dieser Pfad update_page_field() umgeht.

Der Zählschritt schreibt die Kopfzeile; jeder Batch hängt Zeilen mit fputcsv() an eine im Modus a+ geöffnete Datei an. Der Code merkt an, dass WP_Filesystem kein zeilenweises Anhängen kennt, weshalb hier rohe Dateifunktionen verwendet werden.

Der XML-Export baut ein RSS-Dokument mit den WXR-1.2-Namespaces (wp:, content:, excerpt:), Terms als <category domain nicename> und Meta als wp:postmeta mit CDATA, sodass die Datei dem Format des WordPress-Exporters folgt. Dateinamen tragen Exportdatum und Minute, und Dateien, die älter als zwei Tage sind, werden durch eine mit einem Transient gedrosselte Prüfung gelöscht.

Der Browser erzeugt wpbe_filter_current_key, wenn ein Filter angewendet wird, und sendet ihn mit jedem Request; der Kommentar im Quelltext sagt, dass dies Bulk-nach-Filter in verschiedenen Tabs erlaubt. wpbe_apply_query_filter_data() liest den gespeicherten Filter und wird innerhalb von WPBE_POSTS::gets() angewendet, sodass die Bulk-ID-Liste vom selben Code aufgebaut wird wie die sichtbare Tabelle.

Beim Operator AND wird jeder gewählte Term zu einer eigenen Klausel, verbunden durch die äußere Relation AND, was der im Code-Kommentar genannte Workaround ist. Andere Operatoren (IN, NOT IN) reichen die Term-Liste unverändert durch. include_children wird über einen Filter gesteuert statt über den WordPress-Standard.

Der Code-Kommentar nennt den Fall: Bei DECIMAL ohne Genauigkeit lieferte eine Suche von 100 bis 150 auch 99.xx. Der Filter verwendet DECIMAL(30,20), schaltet auf >= um, wenn nur „von“ gesetzt ist, und auf =, wenn beide Grenzen gleich sind. Datums-Meta läuft zuerst durch normalize_calendar_date().

Beiträge, die vor der Einführung eines Meta-Keys erstellt wurden, haben gar keine Zeile, sodass eine reine Gleichheitsprüfung sie verfehlt. Das Verhalten „empty“ erzeugt eine verschachtelte meta_query mit Relation OR.

posts_txt_where() wandelt die Eingabe in Kleinbuchstaben um, teilt an ^ und baut LOWER(column) REGEXP / NOT REGEXP-Bedingungen mit den Modi begin, end, exact und not. Jeder Wert wird über $wpdb->prepare() gebunden, und die Spalte muss in einer Allowlist von fünf wp_posts-Spalten stehen.

Kommagetrennte Einträge gelten als IDs; ein Eintrag mit Bindestrich wird unabhängig von der Reihenfolge zum vollständigen Bereich expandiert. Datums- und Zahlenbereiche auf wp_posts-Spalten (menu_order, post_parent, Beitragsdaten) laufen über einen separaten posts_where-Filter mit einer Spalten-Allowlist.

write() hängt an wpbe_before_update_page_field, das update_page_field() vor jedem Schreiben auslöst; der Bulk-Taxonomie-Pfad, der Terms direkt schreibt, löst es von Hand aus. Taxonomiewerte werden als JSON-Liste von Term-IDs gespeichert, Array-Meta als JSON (mit JSON_HEX_QUOT und JSON_HEX_TAG für den Editor serialisierter Metadaten), Skalare unverändert. Jede Zeile hat user_id und post_type sowie den Bulk-Key, wenn sie Teil eines Durchlaufs ist.

start_bulk() fügt die Kopfzeile mit der Liste der bearbeiteten Felder als JSON ein; jeder Batch addiert seine Größe über UPDATE posts_count = posts_count + %d; finish_bulk() markiert den Durchlauf als completed. Ein vom Benutzer abgebrochener Durchlauf behält den Standardstatus 'terminated', sodass die Liste ihn als unvollständig zeigt. Beide Tabellen werden mit dbDelta und dem Zeichensatz der Website angelegt, auf bulk_key und user_id indiziert und bei der Deinstallation gelöscht.

Der Browser fragt die Zeilenanzahl des Bulk-Keys ab und ruft dann wpbe_history_revert_bulk_portion wiederholt mit limit 10 und einer Fortschrittsanzeige auf. Jede zurückgesetzte Zeile wird gelöscht, sodass die nächste Portion die übrigen aufnimmt; die Kopfzeile wird gelöscht, wenn der Zähler die Gesamtzahl erreicht.

revert() koppelt den History-Writer ab, dekodiert den gespeicherten Wert nach Feldtyp (Term-ID-Listen, JSON-Meta-Arrays) und schreibt ihn über dasselbe update_page_field() zurück, das für Änderungen genutzt wird, sodass save_post und edit_post bei einer Rücknahme genauso feuern wie bei einer Änderung.

get_history() liest die Einzelzeilen und die Bulk-Köpfe des aktuellen Benutzers und Post-Typs, führt sie zusammen und sortiert sie nach Zeit, neueste zuerst, sodass eine Liste beide Arten von Änderungen zeigt.

Die kostenlose Version zeigt die zwei neuesten Einträge und bereinigt ältere Einzelzeilen und Bulk-Köpfe, wenn die Liste geöffnet wird.

wpbe_meta_get_keys gibt die Meta-Keys einer vom Admin eingegebenen Beitrags-ID zurück. Ein registrierter Key wird über die Hooks wpbe_extend_fields, wpbe_filter_* und wpbe_bulk_* eingespeist, sodass er gleichzeitig in der Tabelle, im Filter-Panel und im Bulk-Panel erscheint. Keys werden getrimmt, aber nicht in Kleinbuchstaben umgewandelt, weil Keys wie _woocs_sale_price_USD zwischen Groß- und Kleinschreibung unterscheiden.

Die kostenlose Version nutzt nur die ersten zwei registrierten Meta-Felder.

Das Popup sendet keys[]/values[] für flache und verschachtelte Arrays und keys2[][]/values2[][] für Listen von Objekten. __process_jsoned_meta_data() baut das PHP-Array neu auf, dekodiert Werte, die gültiges JSON sind, und greift bei einfachen Strings auf den Rohwert zurück. update_post_meta() speichert es dann serialisiert, wie WordPress es erwartet. Derselbe Pfad wird vom Bulk-Worker genutzt.

over_switcher_swicher_to_val() und over_switcher_val_to_swicher() lesen einen Einstellungsstring wie 'dist:yes,stest:true' und wandeln in beide Richtungen um, sodass die Switcher-Oberfläche mit Werten funktioniert, die andere Plugins geschrieben haben.

Das Galerie-Popup sendet ein URL-kodiertes Formular; der Handler erkennt die Kodierung, parst es mit parse_str(), bereinigt es und speichert die IDs als kommagetrennten String. Der Bulk-Worker akzeptiert dasselbe Format.

Option „Use gutenberg“. Für Post-Typen, die den Block-Editor nutzen, lädt das Popup post.php mit wpbe_popup_editor=1; wp_editor_compatibility() blendet in diesem Frame die Steuerelemente zum Veröffentlichen und die Seitenleiste aus und stellt eine Funktion bereit, die wp.data.select('core/editor').getEditedPostContent() zurückgibt. Die übergeordnete Seite liest sie aus und speichert über das normale Feld-Update.

can_manage_data() erlaubt Administratoren, Redakteure und Rollen, die über den Filter wpbe_author_area_roles hinzugefügt wurden. Schlägt es fehl, kehrt init() zurück, bevor Erweiterungen laden, sodass die AJAX-Actions für diesen Benutzer nicht existieren. Feld-Updates, Bulk-Bearbeiten und Bulk-Löschen, das Werkzeug-Panel (erstellen, duplizieren, löschen, Terms), Meta-Einstellungen, das Optionsformular, die History-Liste und einzelne Rücknahmen prüfen zusätzlich eine Nonce.

Für Nicht-Admin-Rollen entfernt get_fields() versteckte Spalten, sodass sie weder in der Tabelle noch im Bulk-Panel angeboten werden; update_page_field() prüft is_current_user_can_edit_field() und gibt für ein verstecktes Feld „forbidden“ zurück; filter_post_types() schränkt die Post-Typ-Auswahl ein, und der Konstruktor der Einstellungen verschiebt den Benutzer auf einen erlaubten Post-Typ. In der kostenlosen Version werden die Sichtbarkeits-Checkboxen deaktiviert dargestellt.

Für Rollen, die über den Filter wpbe_author_area_roles hinzugefügt wurden, ergänzt WPBE_AUTHOR_AREA 'author' => aktuelle Benutzer-ID über den Abfragefilter, den die Tabelle, die Bulk-ID-Liste und der Export nutzen, sodass diese Listen nur die eigenen Beiträge des Benutzers zeigen. Sein Callback wpbe_user_can_edit blockiert post_author für diese Rollen.

Text- und Bereichsfilter akzeptieren nur gelistete wp_posts-Spalten und binden Werte über prepare(). History-Abfragen binden Benutzer, Post-Typ und Bulk-Key und bauen NOT-IN-Listen aus array_fill()-Platzhaltern.

Das Duplizieren kopiert Terms per Slug und alle postmeta außer _wp_old_slug in einer einzigen Anweisung INSERT ... SELECT %d, %s, %s UNION ALL, jede Zeile mit prepare() gebaut, und setzt die Kopie dann auf Entwurf.

wpbe_update_page_field() bereinigt Arrays rekursiv mit wp_kses und der Post-Allowlist. Für Inhalt, Auszug und Rich-Text-Felder fügt es iframe mit einer festen Menge an Attributen hinzu, damit Video-Einbettungen erhalten bleiben. Ein Filter kann für strengere Websites auf sanitize_text_field() umschalten.