TableOn

TABLEON_Default::action() restituisce il profilo: per ogni chiave un titolo, una closure 'action' che genera la cella e, per le chiavi filtrabili, get_filter_query_args e get_filter_draw_data. get_table_data() scorre i campi richiesti e chiama $profile[$field]['action'] solo quando la chiave esiste, quindi un nome di campo sconosciuto viene ignorato. Ogni riga porta inoltre pid, che le azioni di cella sul front usano.

assemble_meta_for_system() trasforma una riga della tabella dei meta in una voce del profilo. Il testo usa LIKE e un campo di testo. Il numero usa BETWEEN con tipo numeric da un valore 'min:max', un cursore a intervallo e l'ordinamento meta_value_num. Il calendario confronta come timestamp unix (numerico) o come DATETIME, scelto per campo, perché plugin come ACF memorizzano stringhe di data mentre altri memorizzano timestamp.

L'ordinamento per post_status viene eseguito con una closure agganciata a posts_orderby per la durata di una WP_Query e rimossa subito dopo, così non si propaga ad altre query della pagina. I valori del menu a discesa di ordinamento come title-desc o <meta_key>-desc sono mappati su orderby/order, con meta_value_num per i campi meta tipizzati come numero.

Ogni tabella può memorizzare regole: ID degli articoli, ID esclusi, autori, termini da includere o escludere. get_table_data() le applica prima dei filtri del visitatore, con gli ID convertiti in interi. Un attributo dello shortcode author=N viene inglobato nelle stesse regole (commento nel codice datato 16-09-2020).

Le colonne sono righe con table_id, field_key, pos_num, is_active, show_on_mobile e opzioni JSON, indicizzate su table_id e is_active, così le colonne attive di una tabella richiedono una sola query indicizzata. L'intera configurazione si esporta come un unico documento JSON; l'importazione svuota ogni tabella e reinserisce le righe, dietro un controllo del ruolo.

Le colonne ricercabili provengono dall'attributo dello shortcode tableon_text_search_by ma vengono filtrate su post_title, post_content e post_excerpt, quindi un nome di colonna non raggiunge mai l'SQL dall'esterno dell'elenco. Il termine viene portato in minuscolo con un helper compatibile con i caratteri multibyte, sottoposto a escape con esc_like() e associato con $wpdb->prepare().

get_field_drawing_data() usa i valori min/max memorizzati della tabella quando sono impostati; altrimenti interroga wp_postmeta per la chiave con un cast numerico, così i numeri memorizzati come testo vengono confrontati come numeri. I limiti del numero di commenti sono MIN/MAX su wp_posts per il post type della tabella.

draw_filter_form_data() duplica un campo calendario come <key>---to con le etichette 'From:' e 'To:'. La chiave non esiste nel profilo, quindi provider() riconosce il suffisso, lo rimuove e chiama il costruttore di query del campo originale con is_calendar_dir_to = true, che inverte >= in <=.

L'opzione mselect-logic viene letta dalle opzioni di filtro della tabella e sostituita con IN se non è uno tra IN, NOT IN, AND. Gli ID dei termini entrano in tax_query tramite term_id.

build_taxonomy_tree() percorre i termini genitore per genitore, salta gli ID esclusi, mantiene solo gli ID inclusi quando quell'elenco è impostato e antepone ai titoli un trattino per livello, così un select piatto mostra la gerarchia. Esegue una chiamata get_terms() per genitore con hide_empty.

La richiesta indica un provider di filtro; get_table_data() fa passare gli argomenti della query, i dati del filtro e gli argomenti dello shortcode attraverso il filtro corrispondente. Il modulo integrato è il provider 'default'. Taxonomy Chain Menu usa il lato client di questo meccanismo, scrivendo filter_data nella tabella e chiedendole di ridisegnarsi.

Ogni richiesta ajax memorizza il proprio AbortController; una nuova richiesta annulla prima quella in sospeso, così viene disegnato solo l'ultimo stato di pagina, ordinamento o filtro.

Nella modalità json le righe arrivano incorporate nella pagina. Ricerca per titolo, conteggio, ORDER BY e LIMIT/OFFSET vengono costruiti come stringhe SQL ed eseguiti da AlaSQL sull'array in memoria, quindi paginazione e ordinamento non richiedono richieste.

to_json parte come ajax con un flag di passaggio. Dopo la prima risposta le righe vengono conservate come table_data e la modalità diventa json. Sul server le modalità json richiedono tutti gli articoli corrispondenti (posts_per_page = -1), cosa che il codice segnala come rischio di memoria, quindi la modalità si adatta a insiemi piccoli e medi.

set_cache() e get_cache() indicizzano le risposte con __hash_object(request_data), un hash di stringa su JSON.stringify dell'intera richiesta (pagina, ordinamento, filtri). Tornare a una pagina già vista viene servito dalla memoria. La cache è disattivata nelle modalità json, to_json e load-more, dove i dati sono comunque locali.

Sotto compact_view_width le righe vengono disegnate come celle impilate e le intestazioni sono nascoste. Il gestore del resize ridisegna solo quando lo stato compatto cambia davvero e si blocca per 999 ms tra un'esecuzione e l'altra. Le colonne possono essere eliminate su mobile (hide_on_mobile) o nascoste sotto una larghezza in pixel da regole @media generate. Le righe sono costruite in un DocumentFragment e inserite una sola volta.

get_theme_css() carica la skin prima dalla cartella tableon-skins del tema, poi dal plugin, sostituisce tid con l'id HTML della tabella, elimina commenti e spazi. Anche gli stili per colonna e il CSS personalizzato della tabella sono preceduti da #<table id>, così le regole di una tabella non toccano le altre.

Una richiesta con tableon-remote-page e anchor restituisce JavaScript invece di una pagina: le impostazioni come variabili più remote.js, che crea un iframe a caricamento lazy nel contenitore indicato. La pagina al suo interno usa un template vuoto registrato dal plugin, quindi l'impalcatura del tema non viene mostrata.

Le impostazioni della tabella e, nella modalità json, tutte le righe vengono stampate nella pagina. Codificare <, >, virgolette e & come escape unicode fa sì che titoli degli articoli o valori meta non possano chiudere l'elemento né iniettare markup.

TABLEON_Vocabulary legge l'intera tabella una sola volta in un array statico; get() restituisce il valore per la lingua corrente o la stringa originale. La lingua corrente passa dal filtro tableon_current_lang, che cambia anche WPML, così le richieste ajax vengono generate nella lingua del visitatore.

Le schermate di amministrazione si registrano solo per gli utenti che superano can_manage_data(), che accetta gli amministratori e i ruoli elencati nell'impostazione user_roles_can. I gestori di salvataggio, creazione ed eliminazione verificano ciascuno il nonce 'tableon'.