TableOn

TABLEON_Default::action() retourne le profil : pour chaque clé un titre, une closure 'action' qui rend la cellule, et pour les clés filtrables get_filter_query_args et get_filter_draw_data. get_table_data() parcourt les champs demandés et n'appelle $profile[$field]['action'] que si la clé existe, de sorte qu'un nom de champ inconnu est ignoré. Chaque ligne porte aussi pid, que les actions de cellule du front utilisent.

assemble_meta_for_system() transforme une ligne de la table meta en entrée de profil. Le texte utilise LIKE et un champ de saisie texte. Le nombre utilise BETWEEN avec le type numeric à partir d'une valeur 'min:max', un curseur de plage et un tri par meta_value_num. Le calendrier compare soit comme un horodatage unix (numérique), soit comme DATETIME, au choix par champ, car des extensions comme ACF stockent des chaînes de date tandis que d'autres stockent des horodatages.

Le tri par post_status se fait avec une closure accrochée à posts_orderby pendant la durée d'une WP_Query puis retirée, de sorte qu'elle ne déborde pas sur les autres requêtes de la page. Les valeurs de la liste Trier par, comme title-desc ou <meta_key>-desc, sont converties en orderby/order, avec meta_value_num pour les champs meta typés nombre.

Chaque tableau peut stocker des règles : ID d'articles, ID exclus, auteurs, termes à inclure ou exclure. get_table_data() les applique avant les filtres du visiteur, avec les ID convertis en entiers. Un attribut de shortcode author=N est intégré aux mêmes règles (commentaire de code daté du 16-09-2020).

Les colonnes sont des lignes avec table_id, field_key, pos_num, is_active, show_on_mobile et des options JSON, indexées sur table_id et is_active, de sorte que les colonnes actives d'un tableau tiennent en une requête indexée. Toute la configuration s'exporte comme un seul document JSON ; l'import vide chaque table et réinsère les lignes, derrière un contrôle de rôle.

Les colonnes de recherche viennent de l'attribut de shortcode tableon_text_search_by mais sont filtrées sur post_title, post_content et post_excerpt, de sorte qu'un nom de colonne n'atteint jamais le SQL depuis l'extérieur de la liste. Le terme est mis en minuscules avec un utilitaire gérant le multioctet, échappé avec esc_like() et lié avec $wpdb->prepare().

get_field_drawing_data() utilise le min/max stocké du tableau s'il est défini ; sinon il interroge wp_postmeta pour la clé avec une conversion numérique, de sorte que les nombres stockés en texte se comparent comme des nombres. Les bornes du nombre de commentaires sont MIN/MAX sur wp_posts pour le type de contenu du tableau.

draw_filter_form_data() duplique un champ calendrier en <key>---to avec les libellés 'From:' et 'To:'. La clé n'existe pas dans le profil, donc provider() reconnaît le suffixe, le retire et appelle le constructeur de requête du champ d'origine avec is_calendar_dir_to = true, ce qui change >= en <=.

L'option mselect-logic est lue dans les options de filtre du tableau et remplacée par IN si elle n'est pas l'une de IN, NOT IN, AND. Les ID de termes vont dans tax_query par term_id.

build_taxonomy_tree() parcourt les termes parent par parent, ignore les ID exclus, ne garde que les ID inclus lorsque cette liste est définie, et préfixe les titres d'un tiret par niveau pour qu'un select à plat montre la hiérarchie. Il exécute un appel get_terms() par parent avec hide_empty.

La requête nomme un provider de filtre ; get_table_data() fait passer les arguments de requête, les données de filtre et les arguments du shortcode par le filtre correspondant. Le formulaire intégré est le provider 'default'. Taxonomy Chain Menu utilise le côté client de ce mécanisme, en écrivant filter_data dans le tableau et en lui demandant de se redessiner.

Chaque requête ajax stocke son AbortController ; une nouvelle requête interrompt d'abord celle en attente, de sorte que seul l'état le plus récent de page, de tri ou de filtre est dessiné.

En mode json, les lignes sont intégrées à la page. La recherche dans le titre, le comptage, ORDER BY et LIMIT/OFFSET sont construits comme des chaînes SQL et exécutés par AlaSQL sur le tableau en mémoire, de sorte que la pagination et le tri ne demandent aucune requête.

to_json démarre comme ajax avec un drapeau de bascule. Après la première réponse, les lignes sont conservées comme table_data et le mode devient json. Côté serveur, les modes json demandent tous les articles correspondants (posts_per_page = -1), ce que le code signale comme un risque mémoire, de sorte que ce mode convient aux ensembles petits et moyens.

set_cache() et get_cache() indexent les réponses par __hash_object(request_data), un hachage de chaîne sur JSON.stringify de toute la requête (page, ordre, filtres). Revenir à une page déjà vue est servi depuis la mémoire. Le cache est désactivé dans les modes json, to_json et load-more, où les données sont de toute façon locales.

En dessous de compact_view_width, les lignes sont dessinées sous forme de cellules empilées et les en-têtes sont masqués. Le gestionnaire de resize ne redessine que lorsque l'état compact change réellement et se verrouille lui-même pendant 999 ms entre deux exécutions. Les colonnes peuvent être supprimées sur mobile (hide_on_mobile) ou masquées sous une largeur en pixels par des règles @media générées. Les lignes sont construites dans un DocumentFragment et insérées en une seule fois.

get_theme_css() charge le thème d'abord depuis le dossier tableon-skins du thème WordPress, puis depuis l'extension, remplace tid par l'id HTML du tableau, supprime les commentaires et les espaces. Les styles par colonne et le CSS personnalisé du tableau sont eux aussi préfixés par #<table id>, de sorte que les règles d'un tableau ne touchent pas un autre.

Une requête avec tableon-remote-page et anchor retourne du JavaScript au lieu d'une page : les réglages sous forme de variables plus remote.js, qui crée une iframe à chargement différé dans le conteneur indiqué. La page à l'intérieur utilise un modèle vierge que l'extension enregistre, de sorte que l'habillage du thème n'est pas affiché.

Les réglages du tableau et, en mode json, toutes les lignes sont imprimés dans la page. Encoder <, >, les guillemets et & en échappements unicode empêche les titres d'articles ou les valeurs meta de fermer l'élément ou d'injecter du balisage.

TABLEON_Vocabulary lit toute la table une fois dans un tableau statique ; get() retourne la valeur pour la locale courante ou la chaîne d'origine. La langue courante passe par le filtre tableon_current_lang, qui bascule aussi WPML, de sorte que les requêtes ajax sont rendues dans la langue du visiteur.

Les écrans d'administration ne s'enregistrent que pour les utilisateurs qui passent can_manage_data(), qui accepte les administrateurs et les rôles listés dans le réglage user_roles_can. Les gestionnaires d'enregistrement, de création et de suppression vérifient chacun le nonce 'tableon'.