MDTF

encode_search_get_params() otrzymuje przez ajax zserializowany formularz, parsuje go i sanityzuje, usuwa wartości '~' (dowolne) i zapisuje resztę jako JSON w base64 przez set_page_mdf_session(). W zależności od ustawienia keep_search_data_in dane trafiają do transient na jedną dobę albo do $_SESSION. Odpowiedź to mdf_cat=...&page_mdf=<key>, z której front buduje link do wyników.

get_search_data_key() haszuje wynik normalize_search_data(), która rekurencyjnie przechodzi po tablicy, sortuje klucze asocjacyjne i zachowuje kolejność list. Kolejność pól z przeglądarki przestaje mieć znaczenie, więc jedno wyszukiwanie odpowiada jednemu transient i jednemu linkowi. Linki ze starszymi kluczami działają, dopóki żyje ich transient.

mdf_encode_search_get_params jest zarejestrowane dla niezalogowanych odwiedzających, a każde odrębne wyszukiwanie zapisuje transient żyjący dobę. Handler sprawdza, że vars jest ciągiem w granicach mdf_search_data_max_length, a w przeciwnym razie odpowiada mdf_cat=-1 bez zapisywania. Podany klucz jest akceptowany tylko wtedy, gdy pasuje do /^[0-9a-f]{32}$/, w przeciwnym razie klucz jest wyprowadzany z danych.

get_page_mdf_data() traktuje wszystko, co nie dekoduje się do tablicy, jako brak wyszukiwania. Scala domyślne opcje widżetu i dla każdego pola medafi_ rzutuje 'from' i 'to' na liczby, więc wartości zakresów i kalendarza trafiają do meta_query jako liczby, cokolwiek wysłał odwiedzający. Zdekodowany wynik jest trzymany w zmiennej statycznej do końca żądania.

Stałe linki to osobny, ukryty typ treści. Jego save_post() zapisuje zakodowane wyszukiwanie w page_mdf_string. get_page_mdf_session() sprawdza klucz: numeryczny oznacza ID wpisu i odczyt zapisanego meta, wszystko inne trafia do magazynu transient lub sesji. Wyniki, liczniki i szablony nie muszą wiedzieć, jakiego rodzaju link został użyty.

W get_meta_query_array() przypadek suwaka porównuje wybrane 'to' z własnym maksimum suwaka; jeśli są równe, górną granicą staje się MetaDataFilterCore::$max_int, więc wpisy z wartościami powyżej skonfigurowanej skali nadal pasują. Listy rozwijane zakresu stosują ten sam pomysł z przyrostkiem 'i' (nieskończoność), jak '1001-i'. Pojedyncze suwaki i listy rozwijane zakresu używają BETWEEN z typem DECIMAL.

Dla suwaków ze slider_range_value = 1 wpis przechowuje dwie wartości, klucz pola i key_to (na przykład przedział ceny lub rozmiaru). Odwiedzający wybiera jedną wartość, a zapytanie wymaga, by mieściła się w przedziale samego wpisu, obie strony typu DECIMAL.

Element kalendarza zapisuje <key>_from i <key>_to. Tylko ustawione 'to' daje _to <= to; tylko 'from' daje _from >= from; równe wartości pasują do elementów, których przedział obejmuje ten dzień; właściwy przedział staje się BETWEEN na _from. Komentarz w kodzie datuje ostatnią gałąź na 08-10-2014.

Element tekstowy może celować we własną wartość meta albo w post_title, post_content, lub oba z OR albo AND. Dla kolumn wpisu warunek jest przekazywany do filtrów MDTF_HELPER na posts_where, które dzielą frazę na słowa (przełączane przez mdf_txtsearch_some_words_behavior) i łączą je przez mdf_txtsearch_some_words_condition, domyślnie AND. Powtórzone spacje są najpierw zwijane.

Pole oznaczone is_reflected niesie reflected_key. Budowniczy zapytań, rozdzielacz OR i publiczne API get_field() używają klucza odzwierciedlonego, więc filtr może działać na meta zapisanym przez motyw lub inną wtyczkę bez kopiowania wartości do kluczy medafi_.

wrap_meta_query() buduje relację AND i zagnieżdża warunki, które można łączyć przez OR, jako jedną grupę relation OR, tylko gdy są co najmniej dwa. mdf_hide_post NOT EXISTS, meta_data_filter_cat, _visibility i _stock_status trafiają na najwyższy poziom i zawsze obowiązują. Ten sam wrapper jest używany przez zapytanie wyników i przez liczniki.

Rozdzielacz mapuje każdy klucz wyszukiwania (własny lub odzwierciedlony) na typ jego elementu z sekcji filtrów w wyszukiwaniu. Klauzule elementów checkbox i label mogą być łączone przez OR; suwaki, listy rozwijane, pola tekstowe, kalendarze i listy rozwijane zakresu pozostają wymagane. W trybie AND tablica jest zwracana bez zmian, więc istniejące wyszukiwania AND dają to samo SQL co wcześniej.

Gdy filtry zewnętrzne (mdf_filter_taxonomies, dodatkowe taksonomie, product_visibility) zmodyfikują tax_query, rozdzielacz porównuje każdą klauzulę z listą zbudowaną z formularza za pomocą ścisłego array_search. Dopasowane to warunki odwiedzającego, reszta jest wymagana. Powtórzone klauzule odwiedzającego zebrane przez filtr w żądaniu są odrzucane. wrap_tax_query() zagnieżdża następnie pod OR tylko część odwiedzającego.

encode_search_get_params() zapisuje meta_data_filter_bool i mdf_tax_bool w mdf_widget_options zapisanego wyszukiwania, biorąc wybór odwiedzającego, gdy widżet pozwala na oba. get_meta_data_filter_bool() i get_mdf_tax_bool() czytają najpierw zapisaną wartość i normalizują wszystko, co nie jest 'OR', do 'AND'. Wyniki, liczniki, przeliczanie ajax, paginacja i sortowanie czytają ten sam stan.

Widżety zapisane przez starsze wersje zawsze przeszukiwały taksonomie przez AND, cokolwiek mówiła ich opcja OR. Zastosowanie opcji do nich zmieniłoby wyniki na żywych witrynach bez żadnego działania właściciela. get_widget_tax_bool() respektuje opcję tylko wtedy, gdy ustawione jest taxonomies_options_behaviour_ver, co następuje, gdy widżet zostaje zapisany przez nową wersję.

tax_query domyślnie obejmuje dzieci, więc zaznaczony rodzic pasowałby do każdego wpisu pod nim i czynił wybór dziecka bezsensownym. get_tax_query_array() usuwa zaznaczony termin, jeśli get_term_children() dla niego ma część wspólną z zaznaczonym zbiorem, a następnie przeindeksowuje listę.

get_item_posts_count() zaczyna od bieżącego wyszukiwania. Checkbox dodaje key = 1, jeśli jeszcze go nie ma. Opcja listy rozwijanej najpierw usuwa klauzulę tego samego klucza, bo sąsiednie opcje się wykluczają, a potem dodaje siebie (jako BETWEEN dla opcji zakresu). Dla terminów get_tax_count() wstrzykuje termin do kopii stanu taksonomii z wyłączonym cache taksonomii dla żądania i przywraca go potem.

Zapytania liczące proszą tylko o ID, z wyłączonymi update_post_meta_cache, update_post_term_cache i cache_results. WP_QueryMDFCounterIn rozszerza WP_Query i nadpisuje set_found_posts(), by nie robiło nic, więc WordPress nie wykonuje dodatkowego kroku found-rows; odpowiedzią jest post_count.

WP_QueryMDFCounter haszuje pełną tablicę argumentów i szuka jej w dwukolumnowej tabeli z indeksem na mkey; przy braku trafienia wykonuje zapytanie i wstawia liczbę. Strona ustawień tworzy tabelę, a jeśli użytkownik bazy nie ma uprawnienia, wyłącza opcję i pokazuje instrukcję CREATE. Administrator czyści cache ze strony ustawień, co uruchamia TRUNCATE za manage_options i nonce.

get_terms() ładuje wszystkie terminy taksonomii raz, a assemble_terms_childs() buduje z tej tablicy listy dzieci. Przy włączonym cache_terms_data wynik jest zapisywany pod mdf_terms_cache_<md5 argumentów> jako transient, którego czas życia wynika z ustawienia okresu cache terminów (od godziny do 7 dni; bez wygasania, gdy okres nie jest ustawiony).

is_should_init() działa, zanim wtyczka zarejestruje swoje typy treści i hooki. Jeśli ustawione jest init_on_pages_only, normalizuje bieżący URL (bez query string i /page/N) i kończy działanie wcześniej, gdy URL nie ma na liście. Żądania administracyjne zawsze się inicjalizują.

save_post() zapisuje page_meta_data_filter jako pojedynczą tablicę, którą ekran edycji odczytuje z powrotem, a potem zapisuje każde pole medafi_ przez update_post_meta(), z którego może korzystać meta_query. Sekcje filtra i ich elementy są przechowywane jako meta html_items ukrytego typu treści meta_data_filter.

Pola starej kategorii filtra zostałyby w wp_postmeta i pasowałyby do wyszukiwań tej kategorii. save_post() porównuje przesłaną kategorię z zapisaną i usuwa wszystkie wiersze medafi_% dla wpisu, gdy się zmieniła.

change_meta_key() wymaga prefiksu medafi_, odrzuca klucz już użyty w tej lub innej sekcji filtra i wskazuje sekcję, z którą jest konflikt. Następnie zmienia nazwę klucza w html_items, przepisuje tablice page_meta_data_filter dotkniętych wpisów i uruchamia UPDATE postmeta SET meta_key. Wymaga nonce, edit_post i edit_others_posts, bo dotyka wszystkich wpisów.

parse_query() oznacza główne zapytanie jako wyszukiwanie żądanego typu treści. pre_get_posts() renderuje [meta_data_filter_results] bez szablonu; ten widok deklaruje global $wp_query i przypisuje nowe WP_Query zbudowane z wyszukiwania. Flaga żądania zapobiega ponownemu wejściu, bo nowe zapytanie ponownie wywołuje pre_get_posts. Filtr mdtf_prohibited_post_types trzyma poza zasięgiem wewnętrzne zapytania ACF i Contact Form 7.

Wyniki, liczniki elementów i liczniki terminów rozgałęziają się według WOOCOMMERCE_VERSION: od 3.0 dodają tax_query wykluczające exclude-from-catalog, wcześniejsze wersje dostają klauzulę meta _visibility IN (catalog, visible). Opcjonalna klauzula _stock_status ukrywa produkty niedostępne. Przy aktywnym WPML każde zapytanie dostaje też bieżący język.

Opcje listy rozwijanej zapisane przez starsze wersje konstruktora mają pusty klucz, podczas gdy meta box wpisu zapisuje tytuł opcji jako wartość. Zamiast migracji fill_select_keys() działa wewnątrz get_html_items() i przy zapisie, uzupełniając puste klucze przyciętym tytułem i zostawiając jawne klucze, w tym '0', nietknięte. Istniejące wartości wpisów pasują bez ponownego zapisywania wpisów.

Legacy Widget wewnątrz bloku nie ma paska bocznego, w którym przeliczanie mogłoby go znaleźć po ID, więc jego formularz niesie klasę widżetu i opcje. get_widget_redraw_data() podpisuje je przez wp_hash(); get_widget_from_redraw_data() weryfikuje przez hash_equals() i przed wywołaniem the_widget() akceptuje tylko MetaDataFilter_Search i MetaDataFilter_TaxSearch.

sanitize_template_path() normalizuje ukośniki, filtruje każdy segment do bezpiecznego zestawu znaków i odrzuca puste, więc wartość nie może wyjść poza folder szablonów, a podfoldery takie jak any/my_posts nadal działają.

save_post() usuwa z przesłanej tablicy każdy klucz bez prefiksu medafi_, zanim ją zapisze, i sprawdza prefiks ponownie przed każdym wywołaniem update_post_meta(), więc formularz nie może ustawić _edit_lock, _price ani podobnych kluczy. Zapis wartości wymaga current_user_can('edit_post').

Czyszczenie cache wymaga manage_options i mdtf_ajax_nonce. Zmiana nazwy klucza wymaga własnego nonce, edit_post i edit_others_posts. Akcje pól widżetu wymagają edit_theme_options. Niezalogowani odwiedzający docierają tylko do akcji wyszukiwania frontu (dzieci terminów, kodowanie wyszukiwania, przeliczanie, panel wyszukiwania, treść przycisku wyszukiwania). Pozostałe handlery zarejestrowane dla nich same sprawdzają dostęp: akcje subskrypcji messengera wymagają logowania i nonce, pomocnik statystyk wymaga manage_options.