WOLF

WPBE_SETTINGS::get_fields() scala statyczną listę pól z data/fields.php z jedną kolumną na taksonomię zarejestrowaną dla bieżącego typu wpisu, a następnie stosuje zapisaną przez użytkownika kolejność i tytuły kolumn. Nowe pola pojawiające się później (nowa taksonomia, nowy klucz meta) są dopisywane zamiast ginąć.

Definicje pól niosą allow_post_types i prohibit_post_types. wrap_field_val() zwraca komórkę 'restricted', gdy pole nie ma zastosowania, na przykład pola statusu i komentarzy dla załączników, typ mime tylko dla załączników, sticky tylko dla wpisów. Załączniki są odpytywane z dodatkowym statusem 'inherit'.

Tabela jest skonfigurowana z serverSide: true i wywołuje wpbe_get_posts z parametrami stronicowania DataTables. WPBE_POSTS::gets() zamienia start/length na paged/posts_per_page i przełącza się na sortowanie meta_value_num, gdy kolumną sortowania jest liczbowe lub datowe pole meta.

Wiersze na stronę są ograniczone do 100 z komentarzem w kodzie 'to avoid 500 error on weak servers'. Wersja darmowa ogranicza je do 10.

init() najpierw wykonuje sprawdzenie roli, a potem is_should_init(), które zwraca true tylko dla page=wpbe lub akcji AJAX, której nazwa zawiera 'wpbe_'. Na innych ekranach administracyjnych rejestrowane są tylko pozycja menu, przycisk na pasku administracyjnym i powiadomienia.

Rozszerzenia podążają za konwencją nazewniczą (ext/<slug>/<slug>.php, klasa WPBE_<SLUG>) i dostają magazyn, ustawienia oraz model wpisów przez init_vars(). Ten sam loader podejmuje też rozszerzenia zewnętrzne z wp-content/wpbe_ext.

Ustawienia żyją w opcji wpbe_options_<user_id>. Gdy przełącznik 'separate settings' jest włączony, do klucza dopisywany jest typ wpisu, a lista zarejestrowanych pól meta jest dzielona według typu wpisu w ten sam sposób. Aktywny typ wpisu jest zapamiętywany dla użytkownika w magazynie wtyczki.

Przełącznik jest wyłączony w wersji darmowej.

Gdy obecny jest SitePress, filtr wpbe_current_language zwraca ICL_LANGUAGE_CODE, gets() wywołuje $sitepress->switch_lang() przed zbudowaniem WP_Query, a opcja przypiętych wpisów jest czytana i zapisywana pod sticky_posts_<lang>.

wpbe_bulk_posts_count zapisuje formularz masowy pod 'wpbe_bulk_<key>' (16 losowych znaków generowanych w przeglądarce) i zwraca ID pasujące do bieżącego filtra, używając fields=ids i no_found_rows. Przeglądarka tnie tę listę na partie po 50 i wysyła je jedna po drugiej do wpbe_bulk_posts, aktualizując pasek postępu i wskaźnik na pasku administracyjnym. Anulowanie przerywa oczekujące XHR; wpbe_bulk_finish zwraca policzoną sumę.

Masowe usuwanie używa tego samego wzorca z partiami po 10 i wp_trash_post(), więc usunięte wpisy pozostają do odzyskania z kosza.

Po przebiegu przeglądarka przerysowuje tylko dotknięte wiersze, gdy zmieniono cztery wpisy lub mniej, a w przeciwnym razie przerysowuje bieżącą stronę.

__process_text_data() czyta bieżącą wartość każdego wpisu i stosuje wybrane zachowanie. Wartości mogą zawierać {TITLE}, {ID}, {MENU_ORDER} i {meta:key}, rozwiązywane dla wpisu, oraz makra wielkości liter, takie jak {DO_STRING_UP} lub {DO_STRING_TITLE}, które używają funkcji mb_*, więc tytuły nielacińskie są obsługiwane.

__process_number_data() obsługuje zwiększenie/zmniejszenie o wartość lub procent, a następnie opcjonalnie łączy wynik z innym polem meta tego samego wpisu (+, -, *, /, z dzieleniem przez zero zastąpionym przez 1) oraz z liczbą losową z zakresu skalowaną współczynnikiem dziesiętnym.

Zaokrąglanie ułamka do kroków .05 lub .10, albo do końcówki takiej jak .99, odbywa się w update_page_field() w skonfigurowanej liczbie miejsc dziesiętnych; grosze są przeliczane przez całkowity krok, ponieważ modulo na liczbach zmiennoprzecinkowych daje błędne wyniki.

WordPress oczekuje ID dla taksonomii hierarchicznych i nazw lub slugów dla typu tagów. Worker masowy sprawdza is_taxonomy_hierarchical(); dla taksonomii płaskich zamienia każde ID na slug, a dla 'replace' zapisuje pierwszy termin z append=false i resztę z append=true. 'Remove' używa wp_remove_object_terms().

Hook historii jest wywoływany ręcznie przed zmianami terminów, ponieważ ta ścieżka omija update_page_field().

Krok liczenia zapisuje wiersz nagłówka; każda partia dopisuje wiersze przez fputcsv() do pliku otwartego w trybie a+. Kod zaznacza, że WP_Filesystem nie ma dopisywania linia po linii, dlatego tu używane są surowe funkcje plikowe.

Eksport XML buduje dokument RSS z przestrzeniami nazw WXR 1.2 (wp:, content:, excerpt:), terminy jako <category domain nicename> i meta jako wp:postmeta z CDATA, więc plik podąża za formatem eksportera WordPressa. Nazwy plików niosą datę i minutę eksportu, a pliki starsze niż dwa dni są usuwane przez sprawdzenie ograniczone transientem.

Przeglądarka generuje wpbe_filter_current_key przy zastosowaniu filtra i wysyła go z każdym żądaniem; komentarz w źródle mówi, że pozwala to na edycję masową według filtra w różnych kartach. wpbe_apply_query_filter_data() czyta zapisany filtr i jest stosowana wewnątrz WPBE_POSTS::gets(), więc lista ID do edycji masowej jest budowana tym samym kodem co widoczna tabela.

Dla operatora AND każdy wybrany termin staje się własną klauzulą łączoną zewnętrzną relacją AND, co jest obejściem, do którego odwołuje się komentarz w kodzie. Inne operatory (IN, NOT IN) przekazują listę terminów bez zmian. include_children jest sterowane filtrem zamiast domyślnym zachowaniem WordPressa.

Komentarz w kodzie podaje przypadek: przy DECIMAL bez precyzji wyszukiwanie od 100 do 150 zwracało też 99.xx. Filtr używa DECIMAL(30,20), przełącza się na >=, gdy ustawione jest tylko 'od', i na =, gdy obie granice są równe. Meta z datą przechodzi najpierw przez normalize_calendar_date().

Wpisy utworzone przed wprowadzeniem klucza meta nie mają żadnego wiersza, więc samo sprawdzenie równości je pomija. Zachowanie 'empty' emituje zagnieżdżone meta_query z relacją OR.

posts_txt_where() zamienia dane wejściowe na małe litery, dzieli po ^ i buduje warunki LOWER(column) REGEXP / NOT REGEXP z trybami begin, end, exact i not. Każda wartość jest wiązana przez $wpdb->prepare(), a kolumna musi być na liście dozwolonych pięciu kolumn wp_posts.

Elementy rozdzielone przecinkami są traktowane jako ID; element z myślnikiem jest rozwijany do pełnego zakresu niezależnie od kolejności. Zakresy dat i liczb na kolumnach wp_posts (menu_order, post_parent, daty wpisu) przechodzą przez osobny filtr posts_where z listą dozwolonych kolumn.

write() jest podpięte do wpbe_before_update_page_field, które update_page_field() wywołuje przed każdym zapisem; masowa ścieżka taksonomii, która zapisuje terminy bezpośrednio, wywołuje je ręcznie. Wartości taksonomii są zapisywane jako lista JSON ID terminów, meta tablicowe jako JSON (z JSON_HEX_QUOT i JSON_HEX_TAG dla edytora zserializowanego meta), skalary bez zmian. Każdy wiersz ma user_id i post_type, oraz klucz masowy, gdy należy do przebiegu.

start_bulk() wstawia wiersz nagłówka z listą edytowanych pól jako JSON; każda partia dodaje swój rozmiar przez UPDATE posts_count = posts_count + %d; finish_bulk() oznacza przebieg jako completed. Przebieg anulowany przez użytkownika zachowuje domyślny stan 'terminated', więc lista pokazuje go jako częściowy. Obie tabele są tworzone przez dbDelta z zestawem znaków witryny, indeksowane po bulk_key i user_id oraz usuwane przy odinstalowaniu.

Przeglądarka pyta o liczbę wierszy dla klucza masowego, a następnie wielokrotnie wywołuje wpbe_history_revert_bulk_portion z limitem 10 i paskiem postępu. Każdy cofnięty wiersz jest usuwany, więc następna porcja podejmuje pozostałe; wiersz nagłówka jest usuwany, gdy licznik osiągnie sumę.

revert() odpina zapisującego historię, dekoduje zapisaną wartość według typu pola (listy ID terminów, tablice meta JSON) i zapisuje ją z powrotem tym samym update_page_field() używanym przy edycjach, więc save_post i edit_post odpalają przy cofnięciu tak jak przy edycji.

get_history() czyta pojedyncze wiersze i nagłówki masowe bieżącego użytkownika i typu wpisu, scala je i sortuje według czasu, od najnowszych, więc jedna lista pokazuje oba rodzaje zmian.

Wersja darmowa pokazuje dwa najnowsze wpisy i przycina starsze pojedyncze wiersze oraz nagłówki masowe po otwarciu listy.

wpbe_meta_get_keys zwraca klucze meta wpisu o ID podanym przez administratora. Zarejestrowany klucz jest wstrzykiwany przez wpbe_extend_fields oraz hooki wpbe_filter_* i wpbe_bulk_*, więc pojawia się w tabeli, panelu filtrów i panelu edycji masowej naraz. Klucze są przycinane, ale nie zamieniane na małe litery, ponieważ klucze takie jak _woocs_sale_price_USD rozróżniają wielkość liter.

Wersja darmowa używa tylko dwóch pierwszych zarejestrowanych pól meta.

Okno wysyła keys[]/values[] dla tablic płaskich i zagnieżdżonych oraz keys2[][]/values2[][] dla list obiektów. __process_jsoned_meta_data() odbudowuje tablicę PHP, dekoduje wartości będące poprawnym JSON i dla zwykłych ciągów wraca do surowej wartości. update_post_meta() zapisuje ją potem zserializowaną, jak oczekuje WordPress. Ta sama ścieżka jest używana przez worker masowy.

over_switcher_swicher_to_val() i over_switcher_val_to_swicher() czytają ciąg ustawień taki jak 'dist:yes,stest:true' i konwertują w obu kierunkach, więc interfejs przełącznika działa z wartościami zapisanymi przez inne wtyczki.

Okno galerii wysyła formularz zakodowany w URL; handler wykrywa kodowanie, parsuje go przez parse_str(), sanityzuje i zapisuje ID jako ciąg rozdzielony przecinkami. Worker masowy akceptuje ten sam format.

Opcja 'Use gutenberg'. Dla typów wpisów używających edytora blokowego okno ładuje post.php z wpbe_popup_editor=1; wp_editor_compatibility() ukrywa w tej ramce kontrolki publikacji i panelu bocznego oraz udostępnia funkcję zwracającą wp.data.select('core/editor').getEditedPostContent(). Strona nadrzędna ją czyta i zapisuje zwykłą aktualizacją pola.

can_manage_data() dopuszcza administratorów, redaktorów i role dodane przez filtr wpbe_author_area_roles. Jeśli sprawdzenie się nie powiedzie, init() wraca przed załadowaniem rozszerzeń, więc akcje AJAX nie istnieją dla tego użytkownika. Aktualizacje pól, edycja i usuwanie masowe, panel narzędzi (tworzenie, duplikowanie, usuwanie, terminy), ustawienia meta, formularz opcji, lista historii i pojedyncze cofnięcia również sprawdzają nonce.

Dla ról innych niż administrator get_fields() odrzuca ukryte kolumny, więc nie są oferowane w tabeli ani panelu edycji masowej; update_page_field() sprawdza is_current_user_can_edit_field() i zwraca 'forbidden' dla ukrytego pola; filter_post_types() zawęża selektor typu wpisu, a konstruktor ustawień przenosi użytkownika na dozwolony typ wpisu. W wersji darmowej checkboxy widoczności są renderowane jako wyłączone.

Dla ról dodanych przez filtr wpbe_author_area_roles WPBE_AUTHOR_AREA dodaje 'author' => ID bieżącego użytkownika przez filtr zapytania używany przez tabelę, listę ID do edycji masowej i eksport, więc te listy pokazują tylko własne wpisy użytkownika. Jej callback wpbe_user_can_edit blokuje post_author dla tych ról.

Filtry tekstu i zakresów akceptują tylko wymienione kolumny wp_posts i wiążą wartości przez prepare(). Zapytania historii wiążą użytkownika, typ wpisu i klucz masowy oraz budują listy NOT IN z symboli zastępczych array_fill().

Duplikowanie kopiuje terminy według sluga i wszystkie postmeta poza _wp_old_slug jedną instrukcją INSERT ... SELECT %d, %s, %s UNION ALL, z każdym wierszem zbudowanym przez prepare(), a następnie ustawia kopię jako wersję roboczą.

wpbe_update_page_field() sanityzuje tablice rekurencyjnie przez wp_kses i listę dozwolonych dla wpisu. Dla treści, zajawki i pól tekstu sformatowanego dodaje iframe ze stałym zestawem atrybutów, aby osadzenia wideo przetrwały. Filtr może przełączyć na sanitize_text_field() dla bardziej rygorystycznych witryn.