MDTF

encode_search_get_params() recebe o formulário serializado por ajax, interpreta-o e sanitiza-o, remove os valores '~' (qualquer) e guarda o resto como JSON em base64 com set_page_mdf_session(). Consoante a definição keep_search_data_in, os dados vão para um transient durante um dia ou para $_SESSION. A resposta é mdf_cat=...&page_mdf=<key>, que o front end converte no link de resultados.

get_search_data_key() calcula o hash da saída de normalize_search_data(), que percorre o array recursivamente, ordena as chaves associativas e mantém a ordem das listas. A ordem dos campos vinda do navegador deixa de importar, pelo que uma pesquisa corresponde a um transient e a um link. Os links com chaves mais antigas continuam a funcionar enquanto o seu transient existir.

mdf_encode_search_get_params está registado para visitantes sem sessão, e cada pesquisa distinta escreve um transient que vive um dia. O handler verifica que vars é uma string dentro de mdf_search_data_max_length e, caso contrário, responde mdf_cat=-1 sem guardar. Uma chave fornecida só é aceite se corresponder a /^[0-9a-f]{32}$/; caso contrário, a chave é derivada dos dados.

get_page_mdf_data() trata tudo o que não descodifica para um array como ausência de pesquisa. Junta as opções predefinidas do widget e, para cada campo medafi_, converte 'from' e 'to' em números, de modo que os valores de intervalo e de calendário chegam a meta_query como números, seja o que for que o visitante tenha enviado. O resultado descodificado é mantido numa variável estática durante o resto do pedido.

Os links constantes são um tipo de conteúdo oculto separado. O seu save_post() guarda a pesquisa codificada em page_mdf_string. get_page_mdf_session() verifica a chave: numérica significa um ID de post e lê o meta guardado, qualquer outra coisa vai para o armazenamento de transient ou de sessão. Os resultados, os contadores e os templates não precisam de saber que tipo de link foi usado.

Em get_meta_query_array(), o caso do slider compara o 'to' selecionado com o máximo do próprio slider; se forem iguais, o limite superior passa a MetaDataFilterCore::$max_int, de modo que os posts com valores acima da escala configurada continuam a corresponder. As listas pendentes de intervalo usam a mesma ideia com um sufixo 'i' (infinito), como '1001-i'. Os sliders simples e as listas pendentes de intervalo usam BETWEEN com o tipo DECIMAL.

Para sliders com slider_range_value = 1, um post guarda dois valores, a chave do campo e key_to (por exemplo uma faixa de preço ou de tamanho). O visitante escolhe um valor, e a consulta exige que ele caia dentro da faixa do próprio post, com ambos os lados do tipo DECIMAL.

O item de calendário guarda <key>_from e <key>_to. Só 'to' definido dá _to <= to; só 'from' dá _from >= from; valores iguais correspondem a itens cuja faixa cobre esse dia; uma faixa completa passa a BETWEEN em _from. Um comentário no código data o último ramo de 08-10-2014.

Um item de texto pode ter como alvo o seu próprio valor meta ou post_title, post_content, ou ambos com OR ou AND. Para as colunas do post, a condição é passada para filtros MDTF_HELPER em posts_where, que dividem a frase em palavras (configurável com mdf_txtsearch_some_words_behavior) e as unem com mdf_txtsearch_some_words_condition, AND por omissão. Os espaços repetidos são primeiro reduzidos a um.

Um campo marcado com is_reflected leva reflected_key. O construtor de consultas, o divisor OR e a API pública get_field() usam todos a chave refletida, de modo que um filtro pode trabalhar sobre meta escrito pelo tema ou por outro plugin sem copiar valores para chaves medafi_.

wrap_meta_query() constrói relation AND e aninha as condições que admitem OR como um único grupo relation OR, apenas quando há duas ou mais. mdf_hide_post NOT EXISTS, meta_data_filter_cat, _visibility e _stock_status ficam no nível superior e aplicam-se sempre. O mesmo wrapper é usado pela consulta de resultados e pelos contadores.

O divisor mapeia cada chave de pesquisa (própria ou refletida) para o tipo do seu item, a partir das secções de filtro na pesquisa. As cláusulas de itens checkbox e etiqueta passam a admitir OR; sliders, listas pendentes, campos de texto, calendários e listas pendentes de intervalo continuam obrigatórios. No modo AND, o array é devolvido sem alteração, pelo que as pesquisas AND existentes produzem o mesmo SQL que antes.

Depois de filtros de terceiros (mdf_filter_taxonomies, taxonomias adicionais, product_visibility) terem modificado a tax_query, o divisor compara cada cláusula com a lista construída a partir do formulário usando array_search estrito. As correspondências são condições do visitante, o resto é obrigatório. As cláusulas repetidas do visitante que o filtro recolheu por pedido são descartadas. wrap_tax_query() aninha então apenas a parte do visitante sob OR.

encode_search_get_params() escreve meta_data_filter_bool e mdf_tax_bool em mdf_widget_options da pesquisa guardada, tomando a escolha do visitante quando o widget permite ambos. get_meta_data_filter_bool() e get_mdf_tax_bool() leem primeiro o valor guardado e normalizam para 'AND' tudo o que não seja 'OR'. Os resultados, os contadores, a recontagem ajax, a paginação e a ordenação leem o mesmo estado.

Os widgets guardados por versões mais antigas sempre pesquisaram taxonomias com AND, fosse o que fosse que a sua opção OR dissesse. Aplicar-lhes a opção alteraria os resultados em sites em produção sem qualquer ação do proprietário. get_widget_tax_bool() só respeita a opção quando taxonomies_options_behaviour_ver está definido, o que acontece quando o widget é guardado pela nova versão.

tax_query inclui os filhos por omissão, pelo que um pai marcado corresponderia a todos os posts sob ele e tornaria a seleção do filho sem sentido. get_tax_query_array() remove um termo marcado se get_term_children() desse termo intersetar o conjunto marcado, e depois reindexa a lista.

get_item_posts_count() parte da pesquisa atual. Uma checkbox acrescenta key = 1 se ainda não estiver lá. Uma opção de lista pendente começa por remover a cláusula da mesma chave, porque as opções irmãs se excluem mutuamente, e depois acrescenta-se a si própria (como BETWEEN para opções de intervalo). Para termos, get_tax_count() injeta o termo numa cópia do estado da taxonomia, com a cache de taxonomias por pedido desligada, e restaura-a depois.

As consultas dos contadores pedem apenas IDs, com update_post_meta_cache, update_post_term_cache e cache_results desligados. WP_QueryMDFCounterIn estende WP_Query e substitui set_found_posts() para não fazer nada, de modo que o WordPress não executa o passo extra de found-rows; post_count é a resposta.

WP_QueryMDFCounter calcula o hash do array completo de argumentos e procura-o numa tabela de duas colunas com um índice em mkey; numa falha, executa a consulta e insere a contagem. A página de definições cria a tabela e desliga a opção, mostrando a instrução CREATE, se o utilizador da base de dados não tiver o privilégio. Um administrador limpa a cache a partir da página de definições, o que executa um TRUNCATE protegido por manage_options e um nonce.

get_terms() carrega todos os termos da taxonomia de uma vez e assemble_terms_childs() constrói as listas de filhos a partir desse array. Com cache_terms_data ativo, o resultado é guardado sob mdf_terms_cache_<md5 dos argumentos> como um transient cuja duração vem da definição do período da cache de termos (de hora a hora até 7 dias; sem expiração quando não há período definido).

is_should_init() corre antes de o plugin registar os seus tipos de conteúdo e hooks. Se init_on_pages_only estiver definido, normaliza o URL atual (query string e /page/N removidos) e retorna cedo quando o URL não está na lista. Os pedidos de administração inicializam sempre.

save_post() escreve page_meta_data_filter como um único array, que o ecrã de edição lê de volta, e depois escreve cada campo medafi_ com update_post_meta(), que meta_query consegue usar. As secções de filtro e os seus itens são guardados como meta html_items do post oculto do tipo meta_data_filter.

Os campos da categoria de filtro antiga ficariam de outro modo em wp_postmeta e corresponderiam a pesquisas dessa categoria. save_post() compara a categoria enviada com a guardada e remove todas as linhas medafi_% do post quando mudou.

change_meta_key() exige o prefixo medafi_, rejeita uma chave já usada nesta ou em qualquer outra secção de filtro e indica a secção em conflito. Depois renomeia a chave dentro de html_items, reescreve os arrays page_meta_data_filter dos posts afetados e executa UPDATE postmeta SET meta_key. Precisa de um nonce, edit_post e edit_others_posts porque toca em todos os posts.

parse_query() marca a consulta principal como uma pesquisa do tipo de conteúdo pedido. pre_get_posts() apresenta [meta_data_filter_results] sem template; essa vista declara global $wp_query e atribui uma nova WP_Query construída a partir da pesquisa. Um indicador de pedido impede a reentrada, porque a nova consulta dispara pre_get_posts outra vez. O filtro mdtf_prohibited_post_types mantém fora as consultas internas do ACF e do Contact Form 7.

Os resultados, os contadores de itens e os contadores de termos ramificam todos em WOOCOMMERCE_VERSION: a partir da 3.0 acrescentam uma tax_query que exclui exclude-from-catalog, e as versões anteriores recebem uma cláusula meta _visibility IN (catalog, visible). Uma cláusula opcional _stock_status esconde os produtos sem stock. Com o WPML ativo, cada consulta recebe também o idioma atual.

As opções de listas pendentes guardadas por versões mais antigas do construtor têm uma chave vazia, enquanto a meta box do post guarda o título da opção como valor. Em vez de uma migração, fill_select_keys() corre dentro de get_html_items() e ao guardar, preenchendo as chaves vazias com o título aparado e deixando intactas as chaves explícitas, incluindo '0'. Os valores existentes nos posts correspondem sem ser preciso voltar a guardar os posts.

Um Legacy Widget dentro de um bloco não tem barra lateral onde a recontagem o possa encontrar por ID, pelo que o seu formulário leva a classe e as opções do widget. get_widget_redraw_data() assina-as com wp_hash(); get_widget_from_redraw_data() verifica com hash_equals() e aceita apenas MetaDataFilter_Search e MetaDataFilter_TaxSearch antes de chamar the_widget().

sanitize_template_path() normaliza as barras, filtra cada segmento para um conjunto seguro de caracteres e descarta os vazios, de modo que um valor não pode sair da pasta de templates enquanto subpastas como any/my_posts continuam a funcionar.

save_post() remove do array enviado todas as chaves sem o prefixo medafi_ antes de o guardar e verifica o prefixo de novo antes de cada chamada a update_post_meta(), pelo que o formulário não pode definir _edit_lock, _price ou chaves semelhantes. Guardar valores exige current_user_can('edit_post').

Limpar a cache exige manage_options e mdtf_ajax_nonce. Renomear chaves exige o seu próprio nonce, edit_post e edit_others_posts. As ações sobre campos de widgets exigem edit_theme_options. Os visitantes sem sessão só chegam às ações de pesquisa do front end (filhos de termos, codificação da pesquisa, recontagem, painel de pesquisa, conteúdo do botão de pesquisa). Os outros handlers registados para eles verificam o acesso por si: as ações de subscrição do messenger exigem sessão iniciada e um nonce, o auxiliar de estatísticas exige manage_options.