Taxonomy Chain Menu

get_chain_item() lee el término padre de la petición y pide a get_categories() sus hijos no vacíos. Si hay hijos, devuelve un select; si no, la respuesta depende del modo de hoja. El front-end analiza el HTML con DOMParser y añade el nodo a la cadena.

En el modo 'posts', la hoja devuelve un select con las entradas del término con los permalinks como valores, con límite, orden y ordenación por clave meta configurables. En el modo 'terms', devuelve la URL del término y el front-end renderiza un botón. 'none' termina la cadena en silencio, que es el modo usado cuando la cadena solo controla un filtro.

Cuando watch_view es 'terms', generate_tax_select() añade data-child-count (wp_count_terms con el término como padre) y data-link a cada opción. El front-end comprueba el recuento y, si es 0, muestra el botón sin llamar al servidor.

trigger_taxonomy_select() primero elimina todos los elementos posteriores al select cambiado y después busca en this.cache[term_id]. Un nodo en caché se vuelve a adjuntar con su selección borrada; una respuesta de hoja en caché recrea el botón. Solo los términos no vistos van al servidor, y cada resultado se almacena con sus datos de petición para que los eventos se disparen igual en los niveles en caché y en los nuevos.

ready_chain viene del shortcode o del parámetro GET ready_chain como una lista de IDs de término separados por comas; un elemento que no es un número simple se lee como un ID de entrada. draw_chain_menu() la recorre, renderizando cada nivel con el siguiente ID seleccionado y usándolo como padre del siguiente; un elemento no numérico pasa a ser la entrada preseleccionada. Tras la carga, el front-end añade el botón para el último valor y vuelve a emitir el evento change para el término seleccionado más profundo, de modo que las tablas y los filtros conectados recojan el estado.

Un sitio puede querer solo algunas marcas en el nivel superior pero todos los modelos bajo ellas. get_terms() sustituye la lista include por include_top solo en la petición raíz. El shortcode también comprueba con get_object_taxonomies() que la taxonomía pertenece al tipo de contenido antes de renderizar nada.

cast_event() envía los datos de la petición, el contenedor y el nuevo nodo. Los conectores integrados escuchan este evento; cualquier otro script puede hacer lo mismo. Las cadenas que piden un filtro genérico también reciben 'taxonomy-chain-menu-do-filter' con term_id, slug y container.

table_connector() encuentra la tabla en DataTable23.tables mediante connect_table. Si un nivel se restableció a 'select', recorre los selects desde el final para encontrar el más profundo que sigue elegido. Después sustituye el filter_data de la tabla por el término seleccionado, o elimina la clave de taxonomía cuando no hay nada seleccionado, y llama a redraw_table(); la propia lógica de ajax y caché de la tabla hace el resto.

Las opciones llevan data-slug desde el servidor. Con do_filter='woof', el manejador coloca el slug más profundo bajo la clave de taxonomía de woof_current_values y almacena la ruta completa de IDs como ready_chain, para que la página de resultados de WOOF pueda reconstruir la cadena. Deseleccionar todo elimina ambas claves antes del envío.

draw_select() pide al filtro taxonomy-chain-menu-option-data el texto y la imagen de cada opción, pasando el ID del término o de la entrada, el padre y chain_id. Una etiqueta que empieza por call_filter_ se resuelve aplicando el filtro indicado, de modo que las etiquetas pueden traducirse o calcularse por página.

draw_chain_menu() imprime todos los ajustes como atributos data- escapados en el contenedor, así que el servidor no guarda estado por cadena. prepare_request_data() copia el dataset en la petición, convirtiendo los nombres camelCase del dataset a snake_case; sanitize_request_data() pasa las claves a minúsculas y sanea cada valor.

Con select_wrapper='selectron23', el contenedor se renderiza oculto y TCM_Reflector inserta un elemento hermano. clone() lo reconstruye a partir de los hijos actuales del contenedor, envolviendo cada select clonado en un widget Selectron23, y se ejecuta tras cada cambio de nivel, acierto de caché y actualización del cargador.

El onSelect de Selectron23 dispara taxonomy-chain-menu-select-changed en el select original con el valor y el contenedor. append_select_changed_event() comprueba el contenedor, establece el valor y el atributo selected, y llama al mismo manejador que un change nativo, de modo que la cadena, la caché y los conectores ven un único camino de código.

select_width ('300px|250px|20%') y selectron23_max_open_height se dividen por '|' y se aplican por índice cada vez que se añade un nivel. La profundidad de la cadena no se conoce de antemano, así que el último valor cubre todos los niveles posteriores.