TableOn

TABLEON_Default::action() devolve o perfil: para cada chave, um título, uma closure 'action' que renderiza a célula e, para as chaves filtráveis, get_filter_query_args e get_filter_draw_data. get_table_data() percorre os campos pedidos e chama $profile[$field]['action'] apenas quando a chave existe, pelo que um nome de campo desconhecido é ignorado. Cada linha transporta também pid, que as ações de célula no front-end utilizam.

assemble_meta_for_system() transforma uma linha da tabela de meta numa entrada do perfil. O texto usa LIKE e um campo de texto. O número usa BETWEEN com tipo numérico a partir de um valor 'min:max', um slider de intervalo e ordenação por meta_value_num. O calendário compara como timestamp unix (numérico) ou como DATETIME, escolhido por campo, porque plugins como o ACF guardam strings de data enquanto outros guardam timestamps.

A ordenação por post_status é feita com uma closure ligada a posts_orderby durante uma única WP_Query e removida depois, para que não passe para outras consultas na página. Os valores da lista pendente de ordenação, como title-desc ou <meta_key>-desc, são mapeados para orderby/order, com meta_value_num para campos meta tipados como número.

Cada tabela pode guardar regras: IDs de artigos, IDs excluídos, autores, termos a incluir ou excluir. get_table_data() aplica-as antes dos filtros do visitante, com os IDs convertidos para inteiros. Um atributo de shortcode author=N é incorporado nas mesmas regras (comentário no código datado de 16-09-2020).

As colunas são linhas com table_id, field_key, pos_num, is_active, show_on_mobile e opções em JSON, indexadas em table_id e is_active, pelo que as colunas ativas de uma tabela são uma única consulta indexada. A configuração inteira exporta-se como um documento JSON; a importação esvazia cada tabela e volta a inserir as linhas, atrás de uma verificação de função.

As colunas pesquisáveis vêm do atributo de shortcode tableon_text_search_by mas são filtradas para post_title, post_content e post_excerpt, pelo que um nome de coluna nunca chega ao SQL a partir de fora da lista. O termo é convertido para minúsculas com um auxiliar compatível com multibyte, escapado com esc_like() e ligado com $wpdb->prepare().

get_field_drawing_data() usa o mínimo/máximo guardado da tabela quando definido; caso contrário, consulta wp_postmeta pela chave com uma conversão numérica, para que números guardados como texto se comparem como números. Os limites do número de comentários são MIN/MAX sobre wp_posts do tipo de conteúdo da tabela.

draw_filter_form_data() duplica um campo de calendário como <key>---to com os rótulos 'From:' e 'To:'. A chave não existe no perfil, pelo que provider() reconhece o sufixo, remove-o e chama o construtor de consultas do campo original com is_calendar_dir_to = true, o que inverte >= para <=.

A opção mselect-logic é lida das opções de filtro da tabela e substituída por IN se não for uma de IN, NOT IN, AND. Os IDs de termos entram em tax_query por term_id.

build_taxonomy_tree() percorre os termos pai a pai, ignora os IDs excluídos, mantém apenas os IDs incluídos quando essa lista está definida, e prefixa os títulos com um traço por nível, para que um select simples mostre a hierarquia. Executa uma chamada get_terms() por pai com hide_empty.

O pedido indica um filter provider; get_table_data() passa os argumentos da consulta, os dados do filtro e os argumentos do shortcode pelo filtro correspondente. O formulário incorporado é o provider 'default'. O Taxonomy Chain Menu usa o lado do cliente disto, escrevendo filter_data na tabela e pedindo-lhe que redesenhe.

Cada pedido ajax guarda o seu AbortController; um novo pedido aborta primeiro o pendente, pelo que só o estado mais recente de página, ordenação ou filtro é desenhado.

No modo json, as linhas vêm embebidas na página. A pesquisa por título, a contagem, ORDER BY e LIMIT/OFFSET são construídos como strings SQL e executados pelo AlaSQL sobre o array em memória, pelo que paginar e ordenar não precisam de pedidos.

to_json começa como ajax com uma flag de mudança. Após a primeira resposta, as linhas são mantidas como table_data e o modo passa a json. No servidor, os modos json pedem todos os artigos correspondentes (posts_per_page = -1), o que o código assinala como risco de memória, pelo que o modo se adequa a conjuntos pequenos e médios.

set_cache() e get_cache() indexam as respostas por __hash_object(request_data), um hash de string sobre JSON.stringify do pedido inteiro (página, ordem, filtros). Voltar a uma página já vista é servido a partir da memória. A cache está desligada nos modos json, to_json e load-more, onde os dados são locais de qualquer forma.

Abaixo de compact_view_width, as linhas são desenhadas como células empilhadas e os cabeçalhos ficam ocultos. O handler de redimensionamento só redesenha quando o estado compacto realmente muda e bloqueia-se durante 999 ms entre execuções. As colunas podem ser retiradas em dispositivos móveis (hide_on_mobile) ou ocultadas abaixo de uma largura em píxeis por regras @media geradas. As linhas são construídas num DocumentFragment e inseridas de uma só vez.

get_theme_css() carrega a skin primeiro da pasta tableon-skins do tema e depois do plugin, substitui tid pelo id HTML da tabela, remove comentários e espaços em branco. Os estilos por coluna e o CSS personalizado da tabela também são prefixados com #<table id>, para que as regras de uma tabela não toquem noutra.

Um pedido com tableon-remote-page e anchor devolve JavaScript em vez de uma página: as definições como variáveis mais remote.js, que cria um iframe de carregamento lazy no contentor indicado. A página lá dentro usa um template em branco que o plugin regista, pelo que a estrutura do tema não é mostrada.

As definições da tabela e, no modo json, todas as linhas são impressas na página. Codificar <, >, aspas e & como escapes unicode significa que títulos de artigos ou valores meta não podem fechar o elemento nem injetar markup.

TABLEON_Vocabulary lê a tabela inteira uma vez para um array estático; get() devolve o valor para o locale atual ou a string original. O idioma atual passa pelo filtro tableon_current_lang, que também muda o WPML, pelo que os pedidos ajax são renderizados no idioma do visitante.

Os ecrãs de administração só são registados para utilizadores que passam can_manage_data(), que aceita administradores e as funções listadas na definição user_roles_can. Os handlers de gravação, criação e eliminação verificam cada um o nonce 'tableon'.