TableOn

TABLEON_Default::action() liefert das Profil: für jeden Schlüssel einen Titel, eine 'action'-Closure, die die Zelle rendert, und für filterbare Schlüssel get_filter_query_args und get_filter_draw_data. get_table_data() geht die angeforderten Felder durch und ruft $profile[$field]['action'] nur auf, wenn der Schlüssel existiert, sodass ein unbekannter Feldname ignoriert wird. Jede Zeile trägt außerdem pid, das die Zellaktionen im Frontend verwenden.

assemble_meta_for_system() macht aus einer Zeile der Meta-Tabelle einen Profileintrag. Text verwendet LIKE und ein Textfeld. Zahl verwendet BETWEEN mit dem Typ numeric aus einem Wert 'min:max', einen Bereichsregler und die Sortierung meta_value_num. Kalender vergleicht entweder als Unix-Zeitstempel (numerisch) oder als DATETIME, je Feld gewählt, weil Plugins wie ACF Datumsstrings speichern, andere dagegen Zeitstempel.

Die Sortierung nach post_status geschieht mit einer an posts_orderby gehängten Closure für die Dauer einer WP_Query und wird danach entfernt, sodass sie nicht in andere Abfragen auf der Seite durchsickert. Werte des Sortier-Dropdowns wie title-desc oder <meta_key>-desc werden auf orderby/order abgebildet, mit meta_value_num für als Zahl typisierte Meta-Felder.

Jede Tabelle kann Regeln speichern: Beitrags-IDs, ausgeschlossene IDs, Autoren, ein- oder auszuschließende Begriffe. get_table_data() wendet sie vor den Filtern des Besuchers an, wobei IDs in Ganzzahlen umgewandelt werden. Ein Shortcode-Attribut author=N wird in dieselben Regeln eingefaltet (Code-Kommentar vom 16-09-2020).

Spalten sind Zeilen mit table_id, field_key, pos_num, is_active, show_on_mobile und JSON-Optionen, indiziert auf table_id und is_active, sodass die aktiven Spalten einer Tabelle eine einzige indizierte Abfrage sind. Die gesamte Konfiguration wird als ein JSON-Dokument exportiert; der Import leert jede Tabelle und fügt Zeilen neu ein, hinter einer Rollenprüfung.

Die durchsuchbaren Spalten kommen aus dem Shortcode-Attribut tableon_text_search_by, werden aber auf post_title, post_content und post_excerpt gefiltert, sodass ein Spaltenname nie von außerhalb der Liste in SQL gelangt. Der Suchbegriff wird mit einem Multibyte-fähigen Helfer in Kleinbuchstaben umgewandelt, mit esc_like() escapt und mit $wpdb->prepare() gebunden.

get_field_drawing_data() verwendet das gespeicherte Min/Max der Tabelle, wenn gesetzt; andernfalls fragt es wp_postmeta für den Schlüssel mit einem numerischen Cast ab, sodass als Text gespeicherte Zahlen als Zahlen verglichen werden. Die Grenzen der Kommentaranzahl sind MIN/MAX über wp_posts des Post Types der Tabelle.

draw_filter_form_data() dupliziert ein Kalenderfeld als <key>---to mit den Beschriftungen 'From:' und 'To:'. Der Schlüssel existiert nicht im Profil, daher erkennt provider() das Suffix, entfernt es und ruft den Query-Builder des ursprünglichen Felds mit is_calendar_dir_to = true auf, was >= zu <= umkehrt.

Die Option mselect-logic wird aus den Filteroptionen der Tabelle gelesen und durch IN ersetzt, wenn sie nicht IN, NOT IN oder AND ist. Begriffs-IDs gehen per term_id in tax_query.

build_taxonomy_tree() geht die Begriffe Parent für Parent durch, überspringt ausgeschlossene IDs, behält nur eingeschlossene IDs, wenn diese Liste gesetzt ist, und stellt den Titeln pro Ebene einen Bindestrich voran, sodass ein flaches Select die Hierarchie zeigt. Es führt pro Parent einen get_terms()-Aufruf mit hide_empty aus.

Der Request nennt einen Filter-Provider; get_table_data() reicht die Query-Argumente, Filterdaten und Shortcode-Argumente durch den passenden Filter. Das eingebaute Formular ist der Provider 'default'. Taxonomy Chain Menu nutzt die Clientseite davon, schreibt filter_data in die Tabelle und fordert sie zum Neuzeichnen auf.

Jede Ajax-Anfrage speichert ihren AbortController; eine neue Anfrage bricht zuerst die ausstehende ab, sodass nur der jeweils neueste Zustand von Seite, Sortierung oder Filter gezeichnet wird.

Im Modus json sind die Zeilen in die Seite eingebettet. Titelsuche, Zählung, ORDER BY und LIMIT/OFFSET werden als SQL-Strings gebaut und von AlaSQL über das Array im Speicher ausgeführt, sodass Blättern und Sortieren keine Anfragen brauchen.

to_json startet als ajax mit einem Umschalt-Flag. Nach der ersten Antwort werden die Zeilen als table_data behalten und der Modus wird json. Auf dem Server fordern die json-Modi alle passenden Beiträge an (posts_per_page = -1), was der Code als Speicherrisiko markiert, sodass der Modus für kleine und mittlere Mengen geeignet ist.

set_cache() und get_cache() schlüsseln Antworten über __hash_object(request_data), einen String-Hash über JSON.stringify des gesamten Requests (Seite, Sortierung, Filter). Das Zurückgehen auf eine bereits gesehene Seite wird aus dem Speicher bedient. Der Cache ist in den Modi json, to_json und load-more aus, in denen die Daten ohnehin lokal sind.

Unterhalb von compact_view_width werden Zeilen als gestapelte Zellen gezeichnet und Kopfzeilen ausgeblendet. Der Resize-Handler zeichnet nur neu, wenn sich der kompakte Zustand tatsächlich ändert, und sperrt sich zwischen den Läufen für 999 ms. Spalten können auf Mobilgeräten entfallen (hide_on_mobile) oder unterhalb einer Pixelbreite durch erzeugte @media-Regeln ausgeblendet werden. Zeilen werden in einem DocumentFragment gebaut und einmal eingefügt.

get_theme_css() lädt den Skin zuerst aus dem Ordner tableon-skins des Themes, dann aus dem Plugin, ersetzt tid durch die HTML-ID der Tabelle und entfernt Kommentare und Leerraum. Spaltenstile und das eigene CSS der Tabelle werden ebenfalls mit #<table id> präfixiert, sodass die Regeln einer Tabelle eine andere nicht berühren.

Ein Request mit tableon-remote-page und anchor liefert JavaScript statt einer Seite: Einstellungen als Variablen plus remote.js, das im angegebenen Container ein Lazy-Load-iframe erzeugt. Die Seite darin verwendet ein leeres Template, das das Plugin registriert, sodass die Oberfläche des Themes nicht angezeigt wird.

Tabelleneinstellungen und, im Modus json, alle Zeilen werden in die Seite ausgegeben. Weil <, >, Anführungszeichen und & als Unicode-Escapes kodiert werden, können Beitragstitel oder Meta-Werte das Element nicht schließen oder Markup einschleusen.

TABLEON_Vocabulary liest die ganze Tabelle einmal in ein statisches Array; get() liefert den Wert für die aktuelle Locale oder den Originalstring. Die aktuelle Sprache läuft durch den Filter tableon_current_lang, der auch WPML umschaltet, sodass Ajax-Requests in der Sprache des Besuchers gerendert werden.

Admin-Bildschirme werden nur für Nutzer registriert, die can_manage_data() bestehen, was Administratoren und die in der Einstellung user_roles_can aufgeführten Rollen akzeptiert. Die Handler zum Speichern, Erstellen und Löschen prüfen jeweils den Nonce 'tableon'.