Taxonomy Chain Menu

get_chain_item() legge il termine genitore dalla richiesta e chiede a get_categories() i suoi figli non vuoti. Se ci sono figli restituisce un select; altrimenti la risposta dipende dalla modalità della foglia. Il front end analizza l'HTML con DOMParser e aggiunge il nodo alla catena.

Nella modalità 'posts' la foglia restituisce un select degli articoli del termine con i permalink come valori, con limite, ordinamento e ordinamento per chiave meta configurabili. Nella modalità 'terms' restituisce l'URL del termine e il front end genera un pulsante. 'none' chiude la catena in silenzio, ed è la modalità usata quando la catena pilota solo un filtro.

Quando watch_view è 'terms', generate_tax_select() aggiunge a ogni opzione data-child-count (wp_count_terms con il termine come genitore) e data-link. Il front end controlla il conteggio e, se è 0, mostra il pulsante senza chiamare il server.

trigger_taxonomy_select() rimuove prima ogni elemento dopo il select modificato, poi cerca in this.cache[term_id]. Un nodo in cache viene ricollegato con la selezione azzerata; una risposta di foglia in cache ricrea il pulsante. Solo i termini mai visti vanno al server, e ogni risultato viene memorizzato con i propri dati di richiesta così che gli eventi scattino allo stesso modo per i livelli in cache e per quelli nuovi.

ready_chain proviene dallo shortcode o dal parametro GET ready_chain come elenco di ID di termini separati da virgola; un elemento che non è un semplice numero viene letto come ID di un articolo. draw_chain_menu() lo percorre, generando ogni livello con l'ID successivo selezionato e usandolo come genitore del successivo; un elemento non numerico diventa l'articolo preselezionato. Dopo il caricamento il front end aggiunge il pulsante per l'ultimo valore ed emette di nuovo l'evento change per il termine selezionato più profondo, così le tabelle e i filtri collegati recepiscono lo stato.

Un sito può volere solo alcune marche al livello superiore ma tutti i modelli sotto di esse. get_terms() sostituisce l'elenco include con include_top solo per la richiesta della radice. Lo shortcode verifica inoltre con get_object_taxonomies() che la tassonomia appartenga al post type prima di generare qualsiasi cosa.

cast_event() invia i dati della richiesta, il contenitore e il nuovo nodo. I connettori integrati ascoltano questo evento; qualsiasi altro script può fare lo stesso. Le catene che richiedono un filtro generico ricevono anche 'taxonomy-chain-menu-do-filter' con term_id, slug e contenitore.

table_connector() trova la tabella in DataTable23.tables tramite connect_table. Se un livello è stato riportato a 'select', percorre i select dalla fine per trovare il più profondo ancora scelto. Poi sostituisce il filter_data della tabella con il termine selezionato, oppure rimuove la chiave della tassonomia quando non è selezionato nulla, e chiama redraw_table(); il resto lo fanno la logica ajax e di cache della tabella stessa.

Le opzioni portano data-slug dal server. Con do_filter='woof' il gestore inserisce lo slug più profondo sotto la chiave della tassonomia di woof_current_values e memorizza il percorso completo degli ID come ready_chain, così la pagina dei risultati di WOOF può ricostruire la catena. Deselezionare tutto rimuove entrambe le chiavi prima dell'invio.

draw_select() chiede al filtro taxonomy-chain-menu-option-data il testo e l'immagine di ogni opzione, passando l'ID del termine o dell'articolo, il genitore e chain_id. Un'etichetta che inizia con call_filter_ viene risolta applicando il filtro indicato, così le etichette possono essere tradotte o calcolate per pagina.

draw_chain_menu() stampa tutte le impostazioni come attributi data- con escape sul contenitore, quindi il server non conserva alcuno stato per catena. prepare_request_data() copia il dataset nella richiesta, convertendo i nomi camelCase del dataset in snake_case; sanitize_request_data() porta le chiavi in minuscolo e sanifica ogni valore.

Con select_wrapper='selectron23' il contenitore viene generato nascosto e TCM_Reflector inserisce un elemento gemello. clone() lo ricostruisce a partire dai figli correnti del contenitore, avvolgendo ogni select clonato in un widget Selectron23, e viene eseguito dopo ogni cambio di livello, ogni accesso alla cache e ogni aggiornamento del loader.

L'onSelect di Selectron23 scatena taxonomy-chain-menu-select-changed sul select originale con il valore e il contenitore. append_select_changed_event() controlla il contenitore, imposta il valore e l'attributo selected, e chiama lo stesso gestore di un change nativo, così catena, cache e connettori vedono un unico percorso di codice.

select_width ('300px|250px|20%') e selectron23_max_open_height vengono divisi su '|' e applicati per indice ogni volta che si aggiunge un livello. La profondità della catena non è nota in anticipo, quindi l'ultimo valore copre ogni livello successivo.