TableOn

TABLEON_Default::action() devuelve el perfil: para cada clave, un título, un closure 'action' que renderiza la celda y, para las claves filtrables, get_filter_query_args y get_filter_draw_data. get_table_data() recorre los campos solicitados y llama a $profile[$field]['action'] solo cuando la clave existe, así que un nombre de campo desconocido se ignora. Cada fila también lleva pid, que usan las acciones de celda en el front-end.

assemble_meta_for_system() convierte una fila de la tabla meta en una entrada del perfil. El texto usa LIKE y un campo de texto. El número usa BETWEEN con tipo numeric a partir de un valor 'min:max', un slider de rango y ordenación por meta_value_num. El calendario compara como marca de tiempo unix (numérica) o como DATETIME, según el campo, porque plugins como ACF almacenan cadenas de fecha mientras que otros almacenan marcas de tiempo.

La ordenación por post_status se hace con un closure enganchado a posts_orderby durante una sola WP_Query y eliminado después, de modo que no se filtra a otras consultas de la página. Los valores del desplegable de ordenación como title-desc o <meta_key>-desc se asignan a orderby/order, con meta_value_num para los campos meta de tipo número.

Cada tabla puede almacenar reglas: IDs de entradas, IDs excluidos, autores, términos a incluir o excluir. get_table_data() las aplica antes de los filtros del visitante, con los IDs convertidos a enteros. Un atributo de shortcode author=N se incorpora a las mismas reglas (comentario del código con fecha 16-09-2020).

Las columnas son filas con table_id, field_key, pos_num, is_active, show_on_mobile y opciones JSON, indexadas por table_id e is_active, de modo que las columnas activas de una tabla se obtienen con una sola consulta indexada. Toda la configuración se exporta como un único documento JSON; la importación vacía cada tabla y reinserta las filas, tras una comprobación de rol.

Las columnas en las que se puede buscar proceden del atributo de shortcode tableon_text_search_by, pero se filtran a post_title, post_content y post_excerpt, de modo que un nombre de columna nunca llega al SQL desde fuera de la lista. El término se pasa a minúsculas con una función auxiliar compatible con multibyte, se escapa con esc_like() y se enlaza con $wpdb->prepare().

get_field_drawing_data() usa el mínimo y el máximo almacenados de la tabla cuando están establecidos; si no, consulta wp_postmeta por la clave con una conversión numérica, de modo que los números almacenados como texto se comparan como números. Los límites del número de comentarios son MIN/MAX sobre wp_posts del tipo de contenido de la tabla.

draw_filter_form_data() duplica un campo de calendario como <key>---to con las etiquetas 'From:' y 'To:'. La clave no existe en el perfil, así que provider() reconoce el sufijo, lo elimina y llama al constructor de consultas del campo original con is_calendar_dir_to = true, que cambia >= por <=.

La opción mselect-logic se lee de las opciones de filtro de la tabla y se sustituye por IN si no es una de IN, NOT IN, AND. Los IDs de término van a tax_query por term_id.

build_taxonomy_tree() recorre los términos padre por padre, omite los IDs excluidos, conserva solo los IDs incluidos cuando esa lista está establecida y antepone a los títulos un guion por nivel para que un select plano muestre la jerarquía. Ejecuta una llamada a get_terms() por padre con hide_empty.

La petición nombra un proveedor de filtros; get_table_data() pasa los argumentos de la consulta, los datos del filtro y los argumentos del shortcode por el filtro correspondiente. El formulario integrado es el proveedor 'default'. Taxonomy Chain Menu usa la parte cliente de esto, escribiendo filter_data en la tabla y pidiéndole que se redibuje.

Cada petición ajax almacena su AbortController; una nueva petición aborta primero la pendiente, así que solo se dibuja el estado más reciente de página, ordenación o filtro.

En el modo json las filas vienen incrustadas en la página. La búsqueda por título, el recuento, ORDER BY y LIMIT/OFFSET se construyen como cadenas SQL y AlaSQL las ejecuta sobre el array en memoria, así que la paginación y la ordenación no necesitan peticiones.

to_json empieza como ajax con una marca de cambio. Tras la primera respuesta, las filas se conservan como table_data y el modo pasa a ser json. En el servidor, los modos json solicitan todas las entradas coincidentes (posts_per_page = -1), lo que el código marca como un riesgo de memoria, así que el modo es adecuado para conjuntos pequeños y medianos.

set_cache() y get_cache() indexan las respuestas por __hash_object(request_data), un hash de cadena sobre JSON.stringify de toda la petición (página, orden, filtros). Volver a una página ya vista se sirve desde la memoria. La caché está desactivada en los modos json, to_json y load-more, donde los datos son locales de todos modos.

Por debajo de compact_view_width, las filas se dibujan como celdas apiladas y se ocultan las cabeceras. El manejador de resize solo redibuja cuando el estado compacto cambia realmente y se bloquea a sí mismo durante 999 ms entre ejecuciones. Las columnas pueden omitirse en móvil (hide_on_mobile) u ocultarse por debajo de un ancho en píxeles mediante reglas @media generadas. Las filas se construyen en un DocumentFragment y se insertan una sola vez.

get_theme_css() carga primero el skin desde la carpeta tableon-skins del tema y después desde el plugin, sustituye tid por el id HTML de la tabla y elimina comentarios y espacios en blanco. Los estilos por columna y el CSS personalizado de la tabla también llevan el prefijo #<table id>, de modo que las reglas de una tabla no afectan a otra.

Una petición con tableon-remote-page y anchor devuelve JavaScript en lugar de una página: ajustes como variables más remote.js, que crea un iframe de carga diferida en el contenedor indicado. La página interior usa una plantilla en blanco que registra el plugin, así que no se muestra el marco del tema.

Los ajustes de la tabla y, en el modo json, todas las filas se imprimen en la página. Codificar <, >, las comillas y & como escapes unicode significa que los títulos de entradas o los valores meta no pueden cerrar el elemento ni inyectar marcado.

TABLEON_Vocabulary lee toda la tabla una vez en un array estático; get() devuelve el valor del idioma actual o la cadena original. El idioma actual pasa por el filtro tableon_current_lang, que también cambia WPML, de modo que las peticiones ajax se renderizan en el idioma del visitante.

Las pantallas de administración se registran solo para los usuarios que pasan can_manage_data(), que acepta administradores y los roles indicados en el ajuste user_roles_can. Los manejadores de guardar, crear y eliminar verifican cada uno el nonce 'tableon'.