TableOn

TABLEON_Default::action() zwraca profil: dla każdego klucza tytuł, closure 'action' renderujące komórkę, a dla kluczy filtrowalnych get_filter_query_args i get_filter_draw_data. get_table_data() przechodzi po żądanych polach i wywołuje $profile[$field]['action'] tylko wtedy, gdy klucz istnieje, więc nieznana nazwa pola jest ignorowana. Każdy wiersz niesie też pid, z którego korzystają akcje komórek na front-endzie.

assemble_meta_for_system() zamienia wiersz tabeli meta we wpis profilu. Tekst używa LIKE i pola tekstowego. Liczba używa BETWEEN z typem numeric z wartości 'min:max', suwaka zakresu i sortowania meta_value_num. Kalendarz porównuje albo jako uniksowy znacznik czasu (numerycznie), albo jako DATETIME, wybierane per pole, ponieważ wtyczki takie jak ACF przechowują daty jako ciągi znaków, a inne przechowują znaczniki czasu.

Sortowanie po post_status odbywa się przez closure podpięte do posts_orderby na czas jednego WP_Query i usuwane potem, więc nie wycieka do innych zapytań na stronie. Wartości listy rozwijanej sortowania, takie jak title-desc lub <meta_key>-desc, są mapowane na orderby/order, z meta_value_num dla pól meta typu liczba.

Każda tabela może przechowywać reguły: ID wpisów, wykluczone ID, autorów, terminy do włączenia lub wykluczenia. get_table_data() stosuje je przed filtrami odwiedzającego, z ID rzutowanymi na liczby całkowite. Atrybut shortcode'u author=N jest włączany do tych samych reguł (komentarz w kodzie z datą 16-09-2020).

Kolumny to wiersze z table_id, field_key, pos_num, is_active, show_on_mobile i opcjami JSON, indeksowane po table_id i is_active, więc aktywne kolumny tabeli to jedno zapytanie po indeksie. Cała konfiguracja eksportuje się jako jeden dokument JSON; import opróżnia każdą tabelę i wstawia wiersze na nowo, za kontrolą roli.

Przeszukiwane kolumny pochodzą z atrybutu shortcode'u tableon_text_search_by, ale są filtrowane do post_title, post_content i post_excerpt, więc nazwa kolumny z zewnątrz nigdy nie trafia do SQL spoza listy. Fraza jest zamieniana na małe litery pomocnikiem obsługującym znaki wielobajtowe, escapowana przez esc_like() i wiązana przez $wpdb->prepare().

get_field_drawing_data() używa zapisanych min/max tabeli, gdy są ustawione; w przeciwnym razie odpytuje wp_postmeta o klucz z rzutowaniem numerycznym, więc liczby zapisane jako tekst są porównywane jako liczby. Granice liczby komentarzy to MIN/MAX z wp_posts dla typu wpisu tabeli.

draw_filter_form_data() powiela pole kalendarza jako <key>---to z etykietami 'From:' i 'To:'. Klucz nie istnieje w profilu, więc provider() rozpoznaje sufiks, obcina go i wywołuje konstruktor zapytania oryginalnego pola z is_calendar_dir_to = true, co zamienia >= na <=.

Opcja mselect-logic jest odczytywana z opcji filtra tabeli i zastępowana przez IN, jeśli nie jest jednym z IN, NOT IN, AND. ID terminów trafiają do tax_query po term_id.

build_taxonomy_tree() przechodzi po terminach rodzic po rodzicu, pomija wykluczone ID, zachowuje tylko włączone ID, gdy ta lista jest ustawiona, i poprzedza tytuły jedną kreską na poziom, by płaski select pokazywał hierarchię. Wykonuje jedno wywołanie get_terms() na rodzica z hide_empty.

Żądanie nazywa providera filtra; get_table_data() przekazuje argumenty zapytania, dane filtra i argumenty shortcode'u przez pasujący filtr. Wbudowany formularz jest providerem 'default'. Taxonomy Chain Menu korzysta ze strony klienckiej tego mechanizmu, zapisując filter_data w tabeli i prosząc ją o przerysowanie.

Każde żądanie ajax zapisuje swój AbortController; nowe żądanie najpierw przerywa oczekujące, więc rysowany jest tylko najnowszy stan strony, sortowania lub filtra.

W trybie json wiersze są osadzone na stronie. Wyszukiwanie po tytule, liczność, ORDER BY i LIMIT/OFFSET są budowane jako ciągi SQL i wykonywane przez AlaSQL na tablicy w pamięci, więc stronicowanie i sortowanie nie wymagają żądań.

to_json startuje jako ajax z flagą przełączenia. Po pierwszej odpowiedzi wiersze są trzymane jako table_data, a tryb staje się json. Na serwerze tryby json żądają wszystkich pasujących wpisów (posts_per_page = -1), co kod oznacza jako ryzyko pamięciowe, więc tryb nadaje się do małych i średnich zbiorów.

set_cache() i get_cache() kluczują odpowiedzi przez __hash_object(request_data), hash ciągu z JSON.stringify całego żądania (strona, kolejność, filtry). Powrót do już widzianej strony jest obsługiwany z pamięci. Cache jest wyłączony w trybach json, to_json i load-more, gdzie dane i tak są lokalne.

Poniżej compact_view_width wiersze są rysowane jako ułożone komórki, a nagłówki są ukryte. Handler resize przerysowuje tylko wtedy, gdy stan kompaktowy faktycznie się zmienia, i blokuje się na 999 ms między uruchomieniami. Kolumny można pominąć na mobile (hide_on_mobile) lub ukryć poniżej szerokości w pikselach wygenerowanymi regułami @media. Wiersze są budowane w DocumentFragment i wstawiane raz.

get_theme_css() wczytuje skórkę najpierw z folderu tableon-skins motywu, potem z wtyczki, zastępuje tid przez HTML id tabeli, usuwa komentarze i białe znaki. Style per kolumna i własny CSS tabeli są również poprzedzane #<table id>, więc reguły jednej tabeli nie dotykają innej.

Żądanie z tableon-remote-page i anchor zwraca JavaScript zamiast strony: ustawienia jako zmienne plus remote.js, który tworzy leniwie ładowany iframe w podanym kontenerze. Strona wewnątrz używa pustego szablonu rejestrowanego przez wtyczkę, więc oprawa motywu nie jest pokazywana.

Ustawienia tabeli i, w trybie json, wszystkie wiersze są drukowane na stronie. Kodowanie <, >, cudzysłowów i & jako sekwencji unicode sprawia, że tytuły wpisów lub wartości meta nie mogą zamknąć elementu ani wstrzyknąć znaczników.

TABLEON_Vocabulary wczytuje całą tabelę raz do statycznej tablicy; get() zwraca wartość dla bieżącej lokalizacji lub oryginalny ciąg. Bieżący język przechodzi przez filtr tableon_current_lang, który przełącza też WPML, więc żądania ajax renderują się w języku odwiedzającego.

Ekrany administracyjne rejestrują się tylko dla użytkowników, którzy przechodzą can_manage_data(), co akceptuje administratorów i role wymienione w ustawieniu user_roles_can. Handlery zapisu, tworzenia i usuwania weryfikują nonce 'tableon'.