MDTF

encode_search_get_params() riceve il modulo serializzato via ajax, lo analizza e lo sanifica, rimuove i valori '~' (qualsiasi) e salva il resto come JSON in base64 con set_page_mdf_session(). A seconda dell'impostazione keep_search_data_in i dati vanno in un transient per un giorno o in $_SESSION. La risposta è mdf_cat=...&page_mdf=<key>, che il front end trasforma nel link dei risultati.

get_search_data_key() calcola l'hash dell'output di normalize_search_data(), che percorre l'array ricorsivamente, ordina le chiavi associative e mantiene l'ordine delle liste. L'ordine dei campi dal browser non conta più, quindi una ricerca corrisponde a un transient e a un link. I link con chiavi più vecchie continuano a funzionare finché vive il loro transient.

mdf_encode_search_get_params è registrato per i visitatori non autenticati, e ogni ricerca distinta scrive un transient che vive un giorno. Il gestore verifica che vars sia una stringa entro mdf_search_data_max_length e altrimenti risponde mdf_cat=-1 senza salvare. Una chiave fornita viene accettata solo se corrisponde a /^[0-9a-f]{32}$/, altrimenti la chiave è ricavata dai dati.

get_page_mdf_data() tratta come nessuna ricerca tutto ciò che non si decodifica in un array. Unisce le opzioni predefinite del widget e, per ogni campo medafi_, converte 'from' e 'to' in numeri, così i valori di intervallo e calendario raggiungono meta_query come numeri qualunque cosa abbia inviato il visitatore. Il risultato decodificato è mantenuto in una variabile statica per il resto della richiesta.

I link costanti sono un post type nascosto separato. Il suo save_post() salva la ricerca codificata in page_mdf_string. get_page_mdf_session() controlla la chiave: numerica significa un ID di post e legge il meta salvato, qualsiasi altra cosa va all'archivio dei transient o delle sessioni. Risultati, contatori e template non hanno bisogno di sapere quale tipo di link sia stato usato.

In get_meta_query_array() il caso dello slider confronta il 'to' selezionato con il massimo dello slider stesso; se sono uguali, il limite superiore diventa MetaDataFilterCore::$max_int, così i post con valori oltre la scala configurata corrispondono ancora. I menu a discesa di intervallo usano la stessa idea con un suffisso 'i' (infinito) come '1001-i'. Gli slider singoli e i menu a discesa di intervallo usano BETWEEN con tipo DECIMAL.

Per gli slider con slider_range_value = 1 un post salva due valori, la chiave del campo e key_to (per esempio un intervallo di prezzo o di dimensione). Il visitatore sceglie un valore, e la query richiede che cada dentro l'intervallo proprio del post, con entrambi i lati di tipo DECIMAL.

L'elemento calendario salva <key>_from e <key>_to. Solo 'to' impostato dà _to <= to; solo 'from' dà _from >= from; valori uguali corrispondono agli elementi il cui intervallo copre quel giorno; un intervallo vero e proprio diventa BETWEEN su _from. Un commento nel codice data l'ultimo ramo al 08-10-2014.

Un elemento di testo può puntare al proprio valore meta o a post_title, post_content, o a entrambi con OR o AND. Per le colonne del post la condizione viene passata ai filtri MDTF_HELPER su posts_where, che dividono la frase in parole (commutabile con mdf_txtsearch_some_words_behavior) e le uniscono con mdf_txtsearch_some_words_condition, AND per impostazione predefinita. Gli spazi ripetuti vengono prima ridotti a uno.

Un campo marcato is_reflected porta reflected_key. Il costruttore delle query, lo splitter OR e la API pubblica get_field() usano tutti la chiave riflessa, così un filtro può lavorare su meta scritti dal tema o da un altro plugin senza copiare i valori nelle chiavi medafi_.

wrap_meta_query() costruisce una relazione AND e annida le condizioni ORabili come un solo gruppo con relazione OR, solo quando sono due o più. mdf_hide_post NOT EXISTS, meta_data_filter_cat, _visibility e _stock_status vanno al livello superiore e si applicano sempre. Lo stesso wrapper è usato dalla query dei risultati e dai contatori.

Lo splitter associa ogni chiave di ricerca (propria o riflessa) al tipo del suo elemento dalle sezioni del filtro nella ricerca. Le clausole degli elementi checkbox e etichetta diventano ORabili; slider, menu a discesa, campi di testo, calendari e menu a discesa di intervallo restano obbligatori. In modalità AND l'array viene restituito invariato, così le ricerche AND esistenti producono lo stesso SQL di prima.

Dopo che i filtri di terze parti (mdf_filter_taxonomies, tassonomie aggiuntive, product_visibility) hanno modificato la tax_query, lo splitter confronta ogni clausola con l'elenco costruito dal modulo usando array_search rigoroso. Le corrispondenze sono condizioni del visitatore, il resto è obbligatorio. Le clausole del visitatore ripetute che il filtro ha raccolto per richiesta vengono scartate. wrap_tax_query() annida poi sotto OR solo la parte del visitatore.

encode_search_get_params() scrive meta_data_filter_bool e mdf_tax_bool in mdf_widget_options della ricerca salvata, prendendo la scelta del visitatore quando il widget le consente entrambe. get_meta_data_filter_bool() e get_mdf_tax_bool() leggono prima il valore salvato e normalizzano ad 'AND' tutto ciò che non è 'OR'. Risultati, contatori, conteggio ajax, paginazione e ordinamento leggono lo stesso stato.

I widget salvati dalle versioni precedenti hanno sempre cercato nelle tassonomie con AND, qualunque cosa dicesse la loro opzione OR. Applicare l'opzione a loro cambierebbe i risultati nei siti in produzione senza alcuna azione del proprietario. get_widget_tax_bool() rispetta l'opzione solo quando taxonomies_options_behaviour_ver è impostato, il che avviene quando il widget viene salvato dalla nuova versione.

tax_query include i figli per impostazione predefinita, perciò un genitore selezionato corrisponderebbe a ogni post sotto di lui e renderebbe priva di senso la selezione del figlio. get_tax_query_array() rimuove un termine selezionato se get_term_children() di quel termine ha intersezione con l'insieme dei selezionati, poi reindicizza l'elenco.

get_item_posts_count() parte dalla ricerca corrente. Un checkbox aggiunge key = 1 se non è già presente. Un'opzione di menu a discesa rimuove prima la clausola della stessa chiave, perché le opzioni sorelle si escludono a vicenda, poi aggiunge sé stessa (come BETWEEN per le opzioni di intervallo). Per i termini, get_tax_count() inietta il termine in una copia dello stato delle tassonomie con la cache delle tassonomie per richiesta disattivata e la ripristina dopo.

Le query dei contatori chiedono solo gli ID con update_post_meta_cache, update_post_term_cache e cache_results disattivati. WP_QueryMDFCounterIn estende WP_Query e sovrascrive set_found_posts() perché non faccia nulla, così WordPress non esegue il passaggio extra di found-rows; post_count è la risposta.

WP_QueryMDFCounter calcola l'hash dell'intero array di argomenti e lo cerca in una tabella a due colonne con un indice su mkey; in caso di mancato riscontro esegue la query e inserisce il conteggio. La pagina delle impostazioni crea la tabella e disattiva l'opzione mostrando l'istruzione CREATE se l'utente del database non ha il privilegio. Un amministratore svuota la cache dalla pagina delle impostazioni, che esegue un TRUNCATE dietro manage_options e un nonce.

get_terms() carica una volta tutti i termini della tassonomia e assemble_terms_childs() costruisce gli elenchi dei figli da quell'array. Con cache_terms_data attivo, il risultato è salvato sotto mdf_terms_cache_<md5 degli argomenti> come transient la cui durata proviene dall'impostazione del periodo della cache dei termini (da un'ora a 7 giorni; nessuna scadenza se non è impostato alcun periodo).

is_should_init() viene eseguita prima che il plugin registri i suoi post type e hook. Se init_on_pages_only è impostato, normalizza l'URL corrente (query string e /page/N rimossi) e termina subito quando l'URL non è nell'elenco. Le richieste di amministrazione si inizializzano sempre.

save_post() scrive page_meta_data_filter come un unico array, che la schermata di modifica rilegge, e poi scrive ogni campo medafi_ con update_post_meta(), utilizzabile da meta_query. Le sezioni del filtro e i loro elementi sono salvati come meta html_items del post type nascosto meta_data_filter.

I campi della vecchia categoria del filtro resterebbero altrimenti in wp_postmeta e corrisponderebbero alle ricerche di quella categoria. save_post() confronta la categoria inviata con quella salvata e rimuove tutte le righe medafi_% del post quando è cambiata.

change_meta_key() richiede il prefisso medafi_, rifiuta una chiave già usata in questa o in qualsiasi altra sezione del filtro e indica la sezione in conflitto. Poi rinomina la chiave dentro html_items, riscrive gli array page_meta_data_filter dei post interessati ed esegue UPDATE postmeta SET meta_key. Richiede un nonce, edit_post e edit_others_posts perché tocca tutti i post.

parse_query() marca la query principale come ricerca del post type richiesto. pre_get_posts() renderizza [meta_data_filter_results] senza un template; quella vista dichiara global $wp_query e assegna un nuovo WP_Query costruito dalla ricerca. Un flag di richiesta impedisce la rientranza, perché la nuova query fa scattare di nuovo pre_get_posts. Il filtro mdtf_prohibited_post_types tiene fuori le query interne di ACF e Contact Form 7.

Risultati, contatori degli elementi e contatori dei termini si ramificano tutti su WOOCOMMERCE_VERSION: dalla 3.0 aggiungono una tax_query che esclude exclude-from-catalog, le versioni precedenti ricevono una clausola meta _visibility IN (catalog, visible). Una clausola opzionale _stock_status nasconde i prodotti esauriti. Con WPML attivo, ogni query riceve anche la lingua corrente.

Le opzioni dei menu a discesa salvate dalle versioni precedenti del costruttore hanno una chiave vuota, mentre il meta box del post salva il titolo dell'opzione come valore. Invece di una migrazione, fill_select_keys() gira dentro get_html_items() e al salvataggio, riempiendo le chiavi vuote con il titolo senza spazi ai margini e lasciando intatte le chiavi esplicite, inclusa '0'. I valori esistenti dei post corrispondono senza dover salvare di nuovo i post.

Un Legacy Widget dentro un blocco non ha una sidebar in cui il conteggio possa trovarlo per ID, perciò il suo modulo porta la classe del widget e le opzioni. get_widget_redraw_data() le firma con wp_hash(); get_widget_from_redraw_data() verifica con hash_equals() e accetta solo MetaDataFilter_Search e MetaDataFilter_TaxSearch prima di chiamare the_widget().

sanitize_template_path() normalizza gli slash, filtra ogni segmento a un set di caratteri sicuro e scarta quelli vuoti, così un valore non può uscire dalla cartella dei template mentre sottocartelle come any/my_posts continuano a funzionare.

save_post() rimuove dall'array inviato ogni chiave senza il prefisso medafi_ prima di salvarlo e ricontrolla il prefisso prima di ogni chiamata a update_post_meta(), così il modulo non può impostare _edit_lock, _price o chiavi simili. Salvare i valori richiede current_user_can('edit_post').

Lo svuotamento della cache richiede manage_options e mdtf_ajax_nonce. La rinomina delle chiavi richiede un proprio nonce, edit_post e edit_others_posts. Le azioni sui campi dei widget richiedono edit_theme_options. I visitatori non autenticati raggiungono solo le azioni di ricerca del front end (figli dei termini, codifica della ricerca, conteggio, pannello di ricerca, contenuto del pulsante di ricerca). Gli altri gestori registrati per loro controllano da sé l'accesso: le azioni di sottoscrizione del messenger richiedono login e un nonce, l'helper delle statistiche richiede manage_options.