TableOn

TABLEON_Default::action() повертає профіль: для кожного ключа заголовок, замикання 'action', що рендерить клітинку, а для ключів, які можна фільтрувати, get_filter_query_args і get_filter_draw_data. get_table_data() проходить по запитаних полях і викликає $profile[$field]['action'] лише коли ключ існує, тож невідома назва поля ігнорується. Кожен рядок також несе pid, який використовують дії клітинок на фронтенді.

assemble_meta_for_system() перетворює рядок мета-таблиці на запис профілю. Text використовує LIKE і текстове поле. Number використовує BETWEEN з типом numeric зі значення 'min:max', повзунок діапазону й сортування meta_value_num. Calendar порівнює або як unix-мітку часу (числово), або як DATETIME, на вибір для кожного поля, бо такі плагіни, як ACF, зберігають рядки дат, а інші зберігають мітки часу.

Сортування за post_status виконується замиканням, підключеним до posts_orderby на час одного WP_Query і знятим після нього, тож воно не впливає на інші запити на сторінці. Значення випадного списку сортування, як-от title-desc або <meta_key>-desc, відображаються на orderby/order, з meta_value_num для мета-полів типу number.

Кожна таблиця може зберігати правила: ID записів, виключені ID, автори, терміни для включення чи виключення. get_table_data() застосовує їх перед фільтрами відвідувача, з приведенням ID до цілих чисел. Атрибут шорткоду author=N вбудовується в ті самі правила (коментар у коді датований 16-09-2020).

Стовпці — це рядки з table_id, field_key, pos_num, is_active, show_on_mobile і параметрами в JSON, проіндексовані за table_id та is_active, тож активні стовпці таблиці — це один індексований запит. Уся конфігурація експортується одним JSON-документом; імпорт очищає кожну таблицю й вставляє рядки заново, за перевіркою ролі.

Стовпці для пошуку беруться з атрибута шорткоду tableon_text_search_by, але фільтруються до post_title, post_content і post_excerpt, тож назва стовпця ззовні ніколи не потрапляє в SQL поза цим списком. Пошуковий вираз переводиться в нижній регістр допоміжною функцією з підтримкою багатобайтових символів, екранується через esc_like() і прив'язується через $wpdb->prepare().

get_field_drawing_data() використовує збережені min/max таблиці, коли вони задані; інакше запитує wp_postmeta за ключем із числовим приведенням, тож числа, збережені як текст, порівнюються як числа. Межі кількості коментарів — це MIN/MAX за wp_posts для типу записів таблиці.

draw_filter_form_data() дублює поле calendar як <key>---to з підписами 'From:' і 'To:'. Такого ключа в профілі немає, тож provider() розпізнає суфікс, відсікає його й викликає побудовник запиту початкового поля з is_calendar_dir_to = true, що перевертає >= на <=.

Опція mselect-logic читається з параметрів фільтра таблиці й замінюється на IN, якщо вона не є одним із IN, NOT IN, AND. ID термінів потрапляють у tax_query за term_id.

build_taxonomy_tree() проходить терміни батьківський за батьківським, пропускає виключені ID, залишає лише включені ID, коли цей список задано, і додає до заголовків по одному тире на рівень, щоб плоский select показував ієрархію. Він виконує один виклик get_terms() на кожного батька з hide_empty.

Запит називає провайдера фільтра; get_table_data() передає аргументи запиту, дані фільтра й аргументи шорткоду через відповідний фільтр. Вбудована форма — це провайдер 'default'. Taxonomy Chain Menu використовує клієнтську частину цього, записуючи filter_data у таблицю й просячи її перемалюватися.

Кожен ajax-запит зберігає свій AbortController; новий запит спершу перериває незавершений, тож малюється лише найостанніший стан сторінки, сортування чи фільтра.

У режимі json рядки приходять вбудованими в сторінку. Пошук за заголовком, підрахунок, ORDER BY і LIMIT/OFFSET будуються як SQL-рядки й виконуються AlaSQL над масивом у пам'яті, тож розбиття на сторінки та сортування не потребують запитів.

to_json стартує як ajax із прапорцем перемикання. Після першої відповіді рядки зберігаються як table_data, а режим стає json. На сервері режими json запитують усі відповідні записи (posts_per_page = -1), що код позначає як ризик для пам'яті, тож цей режим підходить для малих і середніх наборів.

set_cache() і get_cache() ключують відповіді за __hash_object(request_data), рядковим хешем над JSON.stringify від усього запиту (сторінка, порядок, фільтри). Повернення на вже бачену сторінку обслуговується з пам'яті. Кеш вимкнено в режимах json, to_json і load-more, де дані й так локальні.

Нижче compact_view_width рядки малюються як складені клітинки, а заголовки приховуються. Обробник зміни розміру перемальовує лише тоді, коли компактний стан справді змінюється, і блокує себе на 999 мс між запусками. Стовпці можна прибрати на мобільних (hide_on_mobile) або приховати нижче ширини в пікселях згенерованими правилами @media. Рядки будуються в DocumentFragment і вставляються один раз.

get_theme_css() спершу завантажує скін з теки tableon-skins теми, потім із плагіна, замінює tid на HTML-ідентифікатор таблиці, прибирає коментарі й пробіли. Стилі окремих стовпців і власний CSS таблиці також мають префікс #<table id>, тож правила однієї таблиці не зачіпають іншу.

Запит із tableon-remote-page і anchor повертає JavaScript замість сторінки: налаштування як змінні плюс remote.js, який створює лінивий iframe у вказаному контейнері. Сторінка всередині використовує порожній шаблон, який реєструє плагін, тож оформлення теми не показується.

Налаштування таблиці та, у режимі json, усі рядки виводяться в сторінку. Кодування <, >, лапок і & як unicode-екранування означає, що заголовки записів чи значення мета-полів не можуть закрити елемент або впровадити розмітку.

TABLEON_Vocabulary читає всю таблицю один раз у статичний масив; get() повертає значення для поточної локалі або початковий рядок. Поточна мова проходить через фільтр tableon_current_lang, який також перемикає WPML, тож ajax-запити рендеряться мовою відвідувача.

Екрани адмінки реєструються лише для користувачів, які проходять can_manage_data(), що приймає адміністраторів і ролі, перелічені в налаштуванні user_roles_can. Обробники збереження, створення й видалення кожен перевіряють nonce 'tableon'.