Taxonomy Chain Menu

get_chain_item() odczytuje termin nadrzędny z żądania i prosi get_categories() o jego niepuste dzieci. Jeśli dzieci są, zwraca select; w przeciwnym razie odpowiedź zależy od trybu liścia. Front-end parsuje HTML przez DOMParser i dołącza węzeł do łańcucha.

W trybie 'posts' liść zwraca select wpisów terminu z permalinkami jako wartościami, z konfigurowalnym limitem, kolejnością i sortowaniem po kluczu meta. W trybie 'terms' zwraca URL terminu, a front-end renderuje przycisk. 'none' kończy łańcuch po cichu, co jest trybem używanym, gdy łańcuch tylko steruje filtrem.

Gdy watch_view to 'terms', generate_tax_select() dodaje do każdej opcji data-child-count (wp_count_terms z terminem jako rodzicem) i data-link. Front-end sprawdza liczbę i dla 0 pokazuje przycisk bez wywoływania serwera.

trigger_taxonomy_select() najpierw usuwa każdy element po zmienionym select, potem szuka w this.cache[term_id]. Węzeł z cache jest dołączany ponownie z wyczyszczonym wyborem; odpowiedź liścia z cache odtwarza przycisk. Do serwera trafiają tylko niewidziane dotąd terminy, a każdy wynik jest zapisywany razem z danymi żądania, więc zdarzenia odpalają się tak samo dla poziomów z cache i świeżych.

ready_chain pochodzi z shortcode'u lub parametru GET ready_chain jako lista ID terminów rozdzielona przecinkami; element, który nie jest zwykłą liczbą, jest odczytywany jako ID wpisu. draw_chain_menu() przechodzi po niej, renderując każdy poziom z zaznaczonym następnym ID i używając go jako rodzica kolejnego; element nienumeryczny staje się zaznaczonym wpisem. Po załadowaniu front-end dodaje przycisk dla ostatniej wartości i ponownie emituje zdarzenie change dla najgłębiej wybranego terminu, aby podłączone tabele i filtry przejęły stan.

Strona może chcieć tylko niektórych marek na górze, ale wszystkie modele pod nimi. get_terms() zastępuje listę include przez include_top tylko dla żądania korzenia. Shortcode sprawdza też przez get_object_taxonomies(), że taksonomia należy do typu wpisu, zanim cokolwiek wyrenderuje.

cast_event() wysyła dane żądania, kontener i nowy węzeł. Wbudowane konektory nasłuchują tego zdarzenia; każdy inny skrypt może zrobić to samo. Łańcuchy, które proszą o ogólny filtr, dostają też 'taxonomy-chain-menu-do-filter' z term_id, slug i container.

table_connector() znajduje tabelę w DataTable23.tables według connect_table. Jeśli poziom został zresetowany do 'select', przechodzi po selectach od końca, by znaleźć najgłębszy wciąż wybrany. Następnie zastępuje filter_data tabeli wybranym terminem albo usuwa klucz taksonomii, gdy nic nie jest wybrane, i wywołuje redraw_table(); resztę robi własna logika ajax i cache tabeli.

Opcje niosą data-slug z serwera. Przy do_filter='woof' handler wstawia najgłębszy slug pod kluczem taksonomii w woof_current_values i zapisuje pełną ścieżkę ID jako ready_chain, aby strona wyników WOOF mogła odbudować łańcuch. Odznaczenie wszystkiego usuwa oba klucze przed wysłaniem.

draw_select() prosi filtr taxonomy-chain-menu-option-data o tekst i obraz każdej opcji, przekazując ID terminu lub wpisu, rodzica i chain_id. Etykieta zaczynająca się od call_filter_ jest rozwiązywana przez zastosowanie filtra o tej nazwie, więc etykiety mogą być tłumaczone lub obliczane dla każdej strony.

draw_chain_menu() drukuje wszystkie ustawienia jako escapowane atrybuty data- na kontenerze, więc serwer nie trzyma stanu dla poszczególnych łańcuchów. prepare_request_data() kopiuje dataset do żądania, zamieniając nazwy camelCase z datasetu na snake_case; sanitize_request_data() zamienia klucze na małe litery i sanityzuje każdą wartość.

Przy select_wrapper='selectron23' kontener jest renderowany jako ukryty, a TCM_Reflector wstawia element-rodzeństwo. clone() odbudowuje go z bieżących dzieci kontenera, opakowując każdy sklonowany select w widżet Selectron23, i uruchamia się po każdej zmianie poziomu, trafieniu w cache i aktualizacji loadera.

onSelect w Selectron23 odpala taxonomy-chain-menu-select-changed na oryginalnym selecie z wartością i kontenerem. append_select_changed_event() sprawdza kontener, ustawia wartość i atrybut selected oraz wywołuje ten sam handler co natywny change, więc łańcuch, cache i konektory widzą jedną ścieżkę kodu.

select_width ('300px|250px|20%') i selectron23_max_open_height są dzielone po '|' i stosowane według indeksu przy dodawaniu każdego poziomu. Głębokość łańcucha nie jest znana z góry, więc ostatnia wartość obejmuje każdy dalszy poziom.