Taxonomy Chain Menu

get_chain_item() liest den Eltern-Begriff aus dem Request und fragt get_categories() nach dessen nicht leeren Kindern. Gibt es Kinder, liefert es ein Select; andernfalls hängt die Antwort vom Blattmodus ab. Das Frontend parst das HTML mit DOMParser und hängt den Knoten an die Kette an.

Im Modus 'posts' liefert das Blatt ein Select der Beiträge des Begriffs mit Permalinks als Werten, mit konfigurierbarem Limit, Sortierung und Sortierung nach Meta-Key. Im Modus 'terms' liefert es die Begriffs-URL, und das Frontend rendert eine Schaltfläche. 'none' beendet die Kette stillschweigend, der Modus, der verwendet wird, wenn die Kette nur einen Filter steuert.

Wenn watch_view 'terms' ist, fügt generate_tax_select() jeder Option data-child-count (wp_count_terms mit dem Begriff als Parent) und data-link hinzu. Das Frontend prüft die Zahl und zeigt bei 0 die Schaltfläche, ohne den Server aufzurufen.

trigger_taxonomy_select() entfernt zuerst jedes Element nach dem geänderten Select und sucht dann in this.cache[term_id]. Ein zwischengespeicherter Knoten wird mit gelöschter Auswahl wieder angehängt; eine zwischengespeicherte Blattantwort erzeugt die Schaltfläche neu. Nur unbekannte Begriffe gehen an den Server, und jedes Ergebnis wird mit seinen Request-Daten gespeichert, sodass Events für zwischengespeicherte und frische Ebenen gleich ausgelöst werden.

ready_chain kommt aus dem Shortcode oder dem GET-Parameter ready_chain als kommagetrennte Liste von Begriffs-IDs; ein Eintrag, der keine einfache Zahl ist, wird als Beitrags-ID gelesen. draw_chain_menu() geht sie durch, rendert jede Ebene mit der nächsten ausgewählten ID und verwendet diese als Parent der folgenden; ein nicht numerischer Eintrag wird zum vorausgewählten Beitrag. Nach dem Laden fügt das Frontend die Schaltfläche für den letzten Wert hinzu und sendet das Change-Event für den tiefsten gewählten Begriff erneut, sodass verbundene Tabellen und Filter den Zustand übernehmen.

Eine Site will vielleicht nur einige Marken oben, aber alle Modelle darunter. get_terms() ersetzt die include-Liste nur bei der Wurzelanfrage durch include_top. Der Shortcode prüft außerdem mit get_object_taxonomies(), dass die Taxonomie zum Post Type gehört, bevor er irgendetwas rendert.

cast_event() sendet die Request-Daten, den Container und den neuen Knoten. Die eingebauten Konnektoren hören auf dieses Event; jedes andere Skript kann das auch. Ketten, die einen generischen Filter anfordern, erhalten zusätzlich 'taxonomy-chain-menu-do-filter' mit term_id, slug und container.

table_connector() findet die Tabelle in DataTable23.tables über connect_table. Wurde eine Ebene auf 'select' zurückgesetzt, geht er die Selects vom Ende her durch, um das tiefste noch gewählte zu finden. Dann ersetzt er das filter_data der Tabelle durch den gewählten Begriff oder entfernt den Taxonomie-Schlüssel, wenn nichts gewählt ist, und ruft redraw_table() auf; den Rest erledigen Ajax und Cache-Logik der Tabelle.

Optionen tragen data-slug vom Server. Mit do_filter='woof' legt der Handler den tiefsten Slug unter dem Taxonomie-Schlüssel von woof_current_values ab und speichert den vollständigen ID-Pfad als ready_chain, damit die WOOF-Ergebnisseite die Kette neu aufbauen kann. Wird alles abgewählt, entfernt er vor dem Absenden beide Schlüssel.

draw_select() fragt den Filter taxonomy-chain-menu-option-data nach Text und Bild jeder Option und übergibt die Begriffs- oder Beitrags-ID, den Parent und chain_id. Eine Beschriftung, die mit call_filter_ beginnt, wird durch Anwenden des genannten Filters aufgelöst, sodass Beschriftungen pro Seite übersetzt oder berechnet werden können.

draw_chain_menu() gibt alle Einstellungen als escapte data-Attribute am Container aus, der Server hält also keinen Zustand pro Kette. prepare_request_data() kopiert das Dataset in den Request und wandelt dabei die camelCase-Namen des Datasets in snake_case um; sanitize_request_data() wandelt Schlüssel in Kleinbuchstaben um und bereinigt jeden Wert.

Mit select_wrapper='selectron23' wird der Container verborgen gerendert, und TCM_Reflector fügt ein Geschwisterelement ein. clone() baut es aus den aktuellen Kindern des Containers neu auf und verpackt jedes geklonte Select in ein Selectron23-Widget, und läuft nach jedem Ebenenwechsel, Cache-Treffer und Loader-Update.

Das onSelect von Selectron23 löst taxonomy-chain-menu-select-changed auf dem ursprünglichen Select mit dem Wert und dem Container aus. append_select_changed_event() prüft den Container, setzt den Wert und das Attribut selected und ruft denselben Handler auf wie bei einem nativen Change, sodass Kette, Cache und Konnektoren einen einzigen Codepfad sehen.

select_width ('300px|250px|20%') und selectron23_max_open_height werden an '|' aufgeteilt und bei jeder hinzugefügten Ebene nach Index angewendet. Die Tiefe der Kette ist vorab nicht bekannt, daher deckt der letzte Wert jede weitere Ebene ab.