WOLF

WPBE_SETTINGS::get_fields() зливає статичний список полів з data/fields.php з однією колонкою на кожну таксономію, зареєстровану для поточного типу запису, потім застосовує збережений користувачем порядок і заголовки колонок. Нові поля, що з'являються пізніше (нова таксономія, новий meta-ключ), дописуються, а не губляться.

Визначення полів несуть allow_post_types та prohibit_post_types. wrap_field_val() повертає комірку 'restricted', коли поле не застосовується, наприклад поля статусу й коментарів для вкладень, mime type лише для вкладень, sticky лише для записів. Вкладення запитуються з додатковим статусом 'inherit'.

Таблиця налаштована з serverSide: true і викликає wpbe_get_posts із параметрами пагінації DataTables. WPBE_POSTS::gets() перетворює start/length на paged/posts_per_page і переходить на впорядкування за meta_value_num, коли колонка сортування — числове чи датове meta-поле.

Рядків на сторінку обмежено 100 з коментарем у коді 'to avoid 500 error on weak servers'. Безкоштовна збірка обмежує це 10.

init() спершу виконує перевірку ролі, а потім is_should_init(), який повертає true лише для page=wpbe або AJAX-дії, чиє ім'я містить 'wpbe_'. На інших екранах адмінки реєструються лише пункт меню, кнопка в панелі адміністратора та сповіщення.

Розширення дотримуються угоди про іменування (ext/<slug>/<slug>.php, клас WPBE_<SLUG>) і отримують сховище, налаштування та модель записів через init_vars(). Той самий завантажувач підхоплює й сторонні розширення з wp-content/wpbe_ext.

Налаштування живуть в опції wpbe_options_<user_id>. Коли перемикач 'separate settings' увімкнено, тип запису дописується до ключа, а список зареєстрованих meta-полів так само розділяється на тип запису. Активний тип запису запам'ятовується для кожного користувача в сховищі плагіна.

У безкоштовній збірці перемикач вимкнено.

Коли SitePress присутній, фільтр wpbe_current_language повертає ICL_LANGUAGE_CODE, gets() викликає $sitepress->switch_lang() перед побудовою WP_Query, а опція sticky-записів читається й пишеться під sticky_posts_<lang>.

wpbe_bulk_posts_count зберігає форму масового редагування під 'wpbe_bulk_<key>' (16 випадкових символів, згенерованих у браузері) і повертає ID, що відповідають поточному фільтру, з fields=ids та no_found_rows. Браузер нарізає цей список на пакети по 50 і по черзі надсилає їх на wpbe_bulk_posts, оновлюючи індикатор прогресу та індикатор у панелі адміністратора. Скасування перериває очікуваний XHR; wpbe_bulk_finish повертає підраховану загальну кількість.

Масове видалення використовує той самий шаблон з пакетами по 10 і wp_trash_post(), тож видалені записи можна відновити з кошика.

Після запуску браузер перемальовує лише зачеплені рядки, коли змінено чотири записи чи менше, а в іншому разі перемальовує поточну сторінку.

__process_text_data() читає поточне значення кожного запису й застосовує вибрану поведінку. Значення можуть містити {TITLE}, {ID}, {MENU_ORDER} та {meta:key}, що розв'язуються для кожного запису, і макроси регістру, як-от {DO_STRING_UP} або {DO_STRING_TITLE}, які використовують функції mb_*, тож нелатинські заголовки обробляються коректно.

__process_number_data() підтримує збільшення/зменшення на значення чи відсоток, а потім за бажанням поєднує результат з іншим meta-полем того ж запису (+, -, *, /, з заміною ділення на нуль на 1) і з випадковим числом із діапазону, масштабованим десятковим коефіцієнтом.

Округлення дробової частини до кроків .05 чи .10 або до закінчення на кшталт .99 відбувається в update_page_field() у налаштованій кількості десяткових знаків; копійки перетворюються через цілочисельний крок, бо модуль від дробових чисел дає хибні результати.

WordPress очікує ID для ієрархічних таксономій та назви чи slug для таксономій типу міток. Виконавець масових змін перевіряє is_taxonomy_hierarchical(); для плоских таксономій перетворює кожен ID на slug, а для 'replace' пише перший термін з append=false, а решту з append=true. 'Remove' використовує wp_remove_object_terms().

Хук історії викликається вручну перед змінами термінів, бо цей шлях оминає update_page_field().

Крок підрахунку записує рядок заголовка; кожен пакет дописує рядки через fputcsv() у файл, відкритий у режимі a+. У коді зазначено, що в WP_Filesystem немає дописування по рядках, тому тут використовуються необроблені файлові функції.

Експорт XML будує документ RSS з просторами імен WXR 1.2 (wp:, content:, excerpt:), терміни як <category domain nicename> і meta як wp:postmeta з CDATA, тож файл відповідає формату експортера WordPress. Імена файлів несуть дату й хвилину експорту, а файли старші за два дні видаляються перевіркою, обмеженою transient.

Браузер генерує wpbe_filter_current_key, коли фільтр застосовано, і надсилає його з кожним запитом; коментар у джерелі каже, що це дозволяє масове редагування за фільтром у різних вкладках. wpbe_apply_query_filter_data() читає збережений фільтр і застосовується всередині WPBE_POSTS::gets(), тож список ID для масового редагування будується тим самим кодом, що й видима таблиця.

Для оператора AND кожен вибраний термін стає власною частиною, з'єднаною зовнішнім relation AND — це обхідний шлях, згаданий у коментарі коду. Інші оператори (IN, NOT IN) передають список термінів як є. include_children керується фільтром замість типового значення WordPress.

Коментар у коді описує випадок: з DECIMAL без точності пошук від 100 до 150 повертав також 99.xx. Фільтр використовує DECIMAL(30,20), переходить на >=, коли задано лише 'from', і на =, коли обидві межі рівні. Дата в meta спершу проходить через normalize_calendar_date().

Записи, створені до появи meta-ключа, взагалі не мають рядка, тож однієї перевірки на рівність недостатньо. Поведінка 'empty' видає вкладений meta_query з relation OR.

posts_txt_where() переводить введене в нижній регістр, розбиває за ^ і будує умови LOWER(column) REGEXP / NOT REGEXP з режимами begin, end, exact і not. Кожне значення прив'язується через $wpdb->prepare(), а колонка має входити в білий список із п'яти колонок wp_posts.

Елементи через кому сприймаються як ID; елемент із дефісом розгортається в повний діапазон незалежно від порядку. Діапазони дат і чисел за колонками wp_posts (menu_order, post_parent, дати запису) проходять через окремий фільтр posts_where із білим списком колонок.

write() прикріплений до wpbe_before_update_page_field, який update_page_field() викликає перед кожним записом; шлях масового редагування таксономій, що пише терміни напряму, викликає його вручну. Значення таксономій зберігаються як JSON-список ID термінів, масиви meta — як JSON (з JSON_HEX_QUOT і JSON_HEX_TAG для редактора серіалізованого meta), скаляри — як є. Кожен рядок має user_id і post_type, а також bulk-ключ, коли він є частиною запуску.

start_bulk() вставляє рядок заголовка зі списком відредагованих полів як JSON; кожен пакет додає свій розмір через UPDATE posts_count = posts_count + %d; finish_bulk() позначає запуск завершеним. Запуск, скасований користувачем, зберігає стан за замовчуванням 'terminated', тож список показує його як частковий. Обидві таблиці створюються через dbDelta з кодуванням сайту, індексуються за bulk_key і user_id та видаляються при видаленні плагіна.

Браузер запитує кількість рядків для bulk-ключа, потім багаторазово викликає wpbe_history_revert_bulk_portion з limit 10 та індикатором прогресу. Кожен відкочений рядок видаляється, тож наступна порція підхоплює решту; рядок заголовка видаляється, коли лічильник досягає загальної кількості.

revert() від'єднує записувач історії, декодує збережене значення за типом поля (списки ID термінів, JSON-масиви meta) і записує його назад через той самий update_page_field(), що й для редагування, тож save_post та edit_post спрацьовують при відкаті так само, як при редагуванні.

get_history() читає одиночні рядки та масові заголовки поточного користувача і типу запису, зливає їх і сортує за часом, найновіші першими, тож один список показує обидва види змін.

Безкоштовна збірка показує два останні записи й видаляє старіші одиночні рядки та масові заголовки, коли список відкривається.

wpbe_meta_get_keys повертає meta-ключі запису з ID, який ввів адміністратор. Зареєстрований ключ впроваджується через хуки wpbe_extend_fields, wpbe_filter_* і wpbe_bulk_*, тож з'являється одразу в таблиці, панелі фільтрів і панелі масового редагування. Ключі обрізаються по пробілах, але не приводяться до нижнього регістру, бо ключі на кшталт _woocs_sale_price_USD чутливі до регістру.

Безкоштовна збірка використовує лише перші два зареєстровані meta-поля.

Спливне вікно надсилає keys[]/values[] для пласких і вкладених масивів та keys2[][]/values2[][] для списків об'єктів. __process_jsoned_meta_data() перебудовує масив PHP, декодує значення, що є коректним JSON, і для звичайних рядків повертається до сирого значення. Потім update_post_meta() зберігає його серіалізованим, як очікує WordPress. Той самий шлях використовує виконавець масових змін.

over_switcher_swicher_to_val() та over_switcher_val_to_swicher() читають рядок налаштувань на кшталт 'dist:yes,stest:true' і перетворюють в обидва боки, тож інтерфейс перемикача працює зі значеннями, записаними іншими плагінами.

Спливне вікно галереї надсилає URL-кодовану форму; обробник визначає кодування, розбирає її через parse_str(), санітизує і зберігає ID як рядок через кому. Виконавець масових змін приймає той самий формат.

Опція 'Use gutenberg'. Для типів записів, що використовують блоковий редактор, спливне вікно завантажує post.php з wpbe_popup_editor=1; wp_editor_compatibility() приховує в цьому фреймі елементи публікації та бічної панелі й надає функцію, що повертає wp.data.select('core/editor').getEditedPostContent(). Батьківська сторінка читає його й зберігає через звичайне оновлення поля.

can_manage_data() дозволяє адміністраторам, редакторам і ролям, доданим через фільтр wpbe_author_area_roles. Якщо вона не проходить, init() повертається до завантаження розширень, тож AJAX-дій для цього користувача не існує. Оновлення полів, масове редагування й масове видалення, панель інструментів (створення, дублювання, видалення, терміни), налаштування meta, форма опцій, список історії та одиничні відкати також перевіряють nonce.

Для ролей, що не є адміністраторами, get_fields() відкидає приховані колонки, тож вони не пропонуються ні в таблиці, ні в панелі масового редагування; update_page_field() перевіряє is_current_user_can_edit_field() і повертає 'forbidden' для прихованого поля; filter_post_types() звужує вибір типу запису, а конструктор налаштувань переносить користувача на дозволений тип запису. У безкоштовній збірці прапорці видимості відображаються вимкненими.

Для ролей, доданих через фільтр wpbe_author_area_roles, WPBE_AUTHOR_AREA додає 'author' => ID поточного користувача через фільтр запиту, який використовують таблиця, список ID для масового редагування та експорт, тож ці списки показують лише власні записи користувача. Його callback wpbe_user_can_edit блокує post_author для цих ролей.

Текстові фільтри та фільтри діапазонів приймають лише перелічені колонки wp_posts і прив'язують значення через prepare(). Запити історії прив'язують користувача, тип запису та bulk-ключ і будують списки NOT IN із плейсхолдерів array_fill().

Дублювання копіює терміни за slug і всі postmeta, крім _wp_old_slug, одним оператором INSERT ... SELECT %d, %s, %s UNION ALL, кожен рядок будується через prepare(), потім переводить копію в статус чернетки.

wpbe_update_page_field() рекурсивно санітизує масиви через wp_kses та білий список запису. Для вмісту, уривка й полів із розширеним текстом він додає iframe з фіксованим набором атрибутів, щоб вбудовування відео вціліли. Фільтр може перемкнути на sanitize_text_field() для суворіших сайтів.