Taxonomy Chain Menu

get_chain_item() lit le terme parent dans la requête et demande à get_categories() ses enfants non vides. S'il y a des enfants, il retourne une liste ; sinon la réponse dépend du mode de feuille. Le front-end analyse le HTML avec DOMParser et ajoute le nœud à la chaîne.

En mode 'posts', la feuille retourne une liste des articles du terme avec les permaliens comme valeurs, avec limite, ordre et tri par clé meta configurables. En mode 'terms', elle retourne l'URL du terme et le front-end affiche un bouton. 'none' termine la chaîne silencieusement, c'est le mode utilisé lorsque la chaîne ne fait que piloter un filtre.

Lorsque watch_view vaut 'terms', generate_tax_select() ajoute data-child-count (wp_count_terms avec le terme comme parent) et data-link à chaque option. Le front-end vérifie le nombre et, pour 0, affiche le bouton sans appeler le serveur.

trigger_taxonomy_select() supprime d'abord tous les éléments après la liste modifiée, puis consulte this.cache[term_id]. Un nœud en cache est rattaché avec sa sélection effacée ; une réponse de feuille en cache recrée le bouton. Seuls les termes jamais vus vont au serveur, et chaque résultat est stocké avec ses données de requête afin que les événements se déclenchent de la même façon pour les niveaux en cache et les niveaux frais.

ready_chain provient du shortcode ou du paramètre GET ready_chain sous forme de liste d'ID de termes séparés par des virgules ; un élément qui n'est pas un simple nombre est lu comme un ID d'article. draw_chain_menu() la parcourt, rendant chaque niveau avec l'ID suivant sélectionné et l'utilisant comme parent du niveau suivant ; un élément non numérique devient l'article présélectionné. Après le chargement, le front-end ajoute le bouton pour la dernière valeur et réémet l'événement de changement pour le terme sélectionné le plus profond, de sorte que les tableaux et filtres connectés reprennent l'état.

Un site peut ne vouloir que certaines marques au sommet mais tous les modèles en dessous. get_terms() remplace la liste include par include_top uniquement pour la requête racine. Le shortcode vérifie aussi avec get_object_taxonomies() que la taxonomie appartient au type de contenu avant de rendre quoi que ce soit.

cast_event() envoie les données de la requête, le conteneur et le nouveau nœud. Les connecteurs intégrés écoutent cet événement ; tout autre script peut faire de même. Les chaînes qui demandent un filtre générique reçoivent aussi 'taxonomy-chain-menu-do-filter' avec term_id, slug et container.

table_connector() trouve le tableau dans DataTable23.tables grâce à connect_table. Si un niveau a été remis sur 'select', il parcourt les listes depuis la fin pour trouver la plus profonde encore choisie. Il remplace alors le filter_data du tableau par le terme sélectionné, ou supprime la clé de taxonomie quand rien n'est sélectionné, et appelle redraw_table() ; la logique ajax et de cache propre au tableau fait le reste.

Les options portent data-slug depuis le serveur. Avec do_filter='woof', le gestionnaire place le slug le plus profond sous la clé de taxonomie de woof_current_values et stocke le chemin complet des ID comme ready_chain, afin que la page de résultats WOOF puisse reconstruire la chaîne. Tout désélectionner supprime les deux clés avant la soumission.

draw_select() demande au filtre taxonomy-chain-menu-option-data le texte et l'image de chaque option, en lui passant l'ID du terme ou de l'article, le parent et chain_id. Un libellé qui commence par call_filter_ est résolu en appliquant le filtre nommé, de sorte que les libellés peuvent être traduits ou calculés par page.

draw_chain_menu() imprime tous les réglages sous forme d'attributs data- échappés sur le conteneur, de sorte que le serveur ne garde aucun état par chaîne. prepare_request_data() copie le dataset dans la requête, en convertissant les noms camelCase du dataset en snake_case ; sanitize_request_data() met les clés en minuscules et assainit chaque valeur.

Avec select_wrapper='selectron23', le conteneur est rendu masqué et TCM_Reflector insère un élément frère. clone() le reconstruit à partir des enfants actuels du conteneur, en enveloppant chaque select cloné dans un widget Selectron23, et s'exécute après chaque changement de niveau, chaque succès de cache et chaque mise à jour du chargeur.

L'onSelect de Selectron23 déclenche taxonomy-chain-menu-select-changed sur le select d'origine avec la valeur et le conteneur. append_select_changed_event() vérifie le conteneur, définit la valeur et l'attribut selected, et appelle le même gestionnaire qu'un change natif, de sorte que la chaîne, le cache et les connecteurs voient un seul chemin de code.

select_width ('300px|250px|20%') et selectron23_max_open_height sont découpés sur '|' et appliqués par index à chaque ajout d'un niveau. La profondeur de la chaîne n'est pas connue à l'avance, la dernière valeur couvre donc chaque niveau supplémentaire.