Taxonomy Chain Menu

get_chain_item() читає батьківський термін із запиту й просить get_categories() його непорожні дочірні терміни. Якщо дочірні є, повертає список; інакше відповідь залежить від режиму кінцевого вузла. Фронтенд розбирає HTML через DOMParser і додає вузол до ланцюжка.

У режимі 'posts' кінцевий вузол повертає список записів терміна з постійними посиланнями як значеннями, з налаштовуваними лімітом, порядком і сортуванням за мета-ключем. У режимі 'terms' він повертає URL терміна, і фронтенд рендерить кнопку. 'none' закінчує ланцюжок мовчки, і це режим, що використовується, коли ланцюжок лише керує фільтром.

Коли watch_view дорівнює 'terms', generate_tax_select() додає до кожної опції data-child-count (wp_count_terms із цим терміном як батьківським) і data-link. Фронтенд перевіряє кількість і для 0 показує кнопку без звернення до сервера.

trigger_taxonomy_select() спершу видаляє всі елементи після зміненого списку, потім шукає в this.cache[term_id]. Кешований вузол повторно прикріплюється зі скинутим вибором; кешована відповідь для кінцевого вузла заново створює кнопку. На сервер ідуть лише невідомі раніше терміни, і кожен результат зберігається разом із даними свого запиту, тож події спрацьовують однаково для кешованих і нових рівнів.

ready_chain надходить із шорткоду або GET-параметра ready_chain як список ID термінів через кому; елемент, що не є простим числом, читається як ID запису. draw_chain_menu() проходить по ньому, рендерячи кожен рівень із вибраним наступним ID і використовуючи його як батьківський для наступного; нечисловий елемент стає попередньо вибраним записом. Після завантаження фронтенд додає кнопку для останнього значення й повторно випромінює подію change для найглибшого вибраного терміна, тож підключені таблиці та фільтри підхоплюють стан.

Сайт може хотіти лише деякі бренди нагорі, але всі моделі під ними. get_terms() замінює список include на include_top лише для запиту кореня. Шорткод також перевіряє через get_object_taxonomies(), що таксономія належить до типу записів, перш ніж щось рендерити.

cast_event() надсилає дані запиту, контейнер і новий вузол. Вбудовані конектори слухають цю подію; будь-який інший скрипт може робити те саме. Ланцюжки, що просять загальний фільтр, також отримують 'taxonomy-chain-menu-do-filter' з term_id, slug і контейнером.

table_connector() знаходить таблицю в DataTable23.tables за connect_table. Якщо рівень скинули на 'select', він проходить списки з кінця, щоб знайти найглибший, що досі вибраний. Потім замінює filter_data таблиці на вибраний термін або видаляє ключ таксономії, коли нічого не вибрано, і викликає redraw_table(); решту робить власна ajax-логіка та кеш таблиці.

Опції несуть data-slug із сервера. З do_filter='woof' обробник кладе слаг найглибшого рівня під ключ таксономії в woof_current_values і зберігає повний шлях ID як ready_chain, щоб сторінка результатів WOOF могла відновити ланцюжок. Скасування всього вибору видаляє обидва ключі перед надсиланням.

draw_select() запитує у фільтра taxonomy-chain-menu-option-data текст і зображення кожної опції, передаючи ID терміна чи запису, батьківський і chain_id. Підпис, що починається з call_filter_, розв'язується застосуванням названого фільтра, тож підписи можна перекладати або обчислювати для кожної сторінки.

draw_chain_menu() виводить усі налаштування як екрановані атрибути data- на контейнері, тож сервер не зберігає стан окремого ланцюжка. prepare_request_data() копіює dataset у запит, перетворюючи імена dataset з camelCase на snake_case; sanitize_request_data() переводить ключі в нижній регістр і санітизує кожне значення.

З select_wrapper='selectron23' контейнер рендериться прихованим, а TCM_Reflector вставляє сусідній елемент. clone() перебудовує його з поточних дочірніх елементів контейнера, обгортаючи кожен клонований select у віджет Selectron23, і запускається після кожної зміни рівня, влучання в кеш і оновлення завантажувача.

onSelect у Selectron23 відправляє taxonomy-chain-menu-select-changed на оригінальний select зі значенням і контейнером. append_select_changed_event() перевіряє контейнер, встановлює значення й атрибут selected і викликає той самий обробник, що й для рідної зміни, тож ланцюжок, кеш і конектори бачать один шлях коду.

select_width ('300px|250px|20%') і selectron23_max_open_height розбиваються за '|' та застосовуються за індексом щоразу, коли додається рівень. Глибина ланцюжка наперед невідома, тож останнє значення покриває кожен подальший рівень.