WOOT

get_table_data() зареєстровано для авторизованих і анонімних користувачів. Вона проходить $_REQUEST через switch і зберігає лише відомі ключі: post_type, per_page, orderby, order, current_page, table_id, wp_columns_actions, filter_data, filter_provider, fields, lang, predefinition і shortcode_args_set. Числа проходять через intval, ключі — через sanitize_key, JSON-дані — через json_decode і рекурсивний санітайзер.

Два з цих ключів — імена хуків. wp_columns_actions передається в apply_filters(), щоб завантажити профіль колонок, а filter_provider вибирає фільтр woot_filter_provider_{name}, що додає умови фільтра. Обидва санітизуються як текст, але не звіряються зі списком зареєстрованих імен.

Ту саму функцію викликають із PHP з масивом для таблиць, що рендеряться при завантаженні сторінки, тож серверний шлях і шлях AJAX мають одну реалізацію. Кожен рядок створюється викликом render-замикання кожної запитаної колонки, а ID товару зберігається як pid для дій комірок.

Запис колонки, як-от price, несе 'orderby' => 'meta_value_num' і 'meta_key' => '_price'. get_table_data() шукає запитаний ключ сортування в профілі колонок і переписує за ним аргументи запиту.

Випадний список сортування використовує власні ключі (price-desc, sku, stock-desc, sales тощо), які перекладаються у фільтрі woot_wp_query_args. Сортування за залишком і загальними продажами виключає згруповані та зовнішні товари умовою product_type NOT IN, бо в цих типів немає власного залишку чи продажів. Для сортувань зі списку плагін також викликає WC()->query->get_catalog_ordering_args(), що підключає власні умови впорядкування WooCommerce за популярністю, рейтингом і ціною, тож ці сортування збігаються зі сторінкою магазину.

Для orderby=post_status замикання додається до posts_orderby перед WP_Query і знімається після нього, тож інші запити того самого запиту сторінки зберігають власне впорядкування.

Пресет бестселерів впорядковує за total_sales, а пресет новинок — за post_date, обидва з posts_per_page, рівним N. WP_Query повідомляє found_posts для всіх відповідних товарів, тож після запиту found_posts встановлюється в ліміт пресета, і пейджер показує лише топ N.

Правило пресета зберігається як рядок на кшталт product_cat:25,26|pa_color:19|rel:AND. get_by_taxonomy() перетворює його на одну вкладену групу tax_query і пропускає таксономії, яких уже не існує.

Для варіанта виключення кожна умова використовує NOT IN, а relation міняється (AND стає OR і навпаки) — це закон де Моргана: виключити товари, що збігаються з A і B, означає залишити ті, що поза A або поза B. Пресети SKU зіставляють SKU варіації з ID її батьківського товару, бо таблиця перелічує батьківські товари.

admin-ajax.php виконується поза контекстом мови фронтенду. draw_table_data() записує get_locale() у JSON таблиці, браузер надсилає її назад як lang, а get_table_data() пропускає її через фільтр woot_current_lang.

Клас словника підключається до цього фільтра й викликає $sitepress->switch_lang(), тож WP_Query повертає товари потрібною мовою. Заголовки колонок і підписи перекладає WOOT_Vocabulary::get() з власної таблиці плагіна, що завантажується один раз на запит і індексується за локаллю.

WOOT_WooCommerce::action() повертає профіль. Кожен ключ — це поле із заголовком, замиканням action, що відображає комірку для ID товару, даними сортування (order, orderby, meta_key) і, для полів з фільтром, замиканнями get_filter_query_args та get_filter_draw_data. Індекс 0 тримає налаштування рівня таблиці: тип запису, дозволені статуси, провайдер фільтра.

Профілі реєструються за іменем і розв'язуються через apply_filters на дії таблиці. Кошик, варіації, вигляд окремого товару і навіть власні екрани адмінки плагіна (список таблиць, meta-ключі, словник) працюють на тому самому рушії зі своїми профілями.

product_type, product_visibility, product_shipping_class і translation_priority від WPML видаляються зі списку. Комірка показує власні терміни товару через build_taxonomy_tree(), обмежене призначеними ID термінів, як посилання або звичайний текст залежно від опції колонки.

Сторона фільтра додає умову tax_query, чий оператор (IN, NOT IN, AND) береться з налаштувань таблиці й перевіряється за цим білим списком.

Meta-ключі зберігаються на таблицю в woot_tables_meta із типом. assemble_meta_for_system() перетворює кожен на поле профілю: text сортується за meta_value і фільтрується через LIKE; number сортується за meta_value_num і фільтрується числовим BETWEEN на повзунку діапазону; calendar фільтрується як DATETIME або як числова мітка unix, що обирається для кожного поля, бо плагіни на кшталт ACF зберігають дати в різних форматах.

Поля зливаються з профілем через фільтр ext_{action}, а кожен ключ також з'являється в списку сортування із записами за зростанням і спаданням.

Кожне замикання колонки потребує об'єкта WC_Product, тому get_product() тримає статичну мапу результатів wc_get_product(). Опції таблиць декодуються з JSON один раз на таблицю, рядки meta кешуються за md5 рядка SQL, а побудовник фільтра розв'язує профіль один раз, а не для кожного поля.

install.php створює woot_tables, woot_tables_columns (індексована за table_id та is_active, впорядкована за pos_num), woot_tables_meta і woot_vocabulary. Порядок колонок, змінений перетягуванням, приходить як список ID і записується назад як pos_num.

clone() копіює рядок таблиці, потім її колонки та meta-ключі під новим ID таблиці. Експорт вивантажує всі чотири таблиці й опції як JSON; імпорт очищає кожну таблицю й вставляє рядки після перевірки capability та nonce.

Коли будується форма фільтра, поле calendar дублюється під ключем ---to з підписами From і To. На зворотному шляху provider() бачить невідомий ключ, що закінчується на ---to, зрізає суфікс і викликає те саме замикання колонки з прапорцем, тож замикання порівнює через <= замість >=.

Якщо в поля діапазону немає налаштованого min чи max (-1), get_field_drawing_data() виконує SELECT MIN або MAX(cast(meta_value as UNSIGNED)) по postmeta для meta-ключа поля через $wpdb->prepare. Ім'я функції береться із внутрішнього білого списку, а не із запиту. Повзунок кількості коментарів бере межі з таблиці posts.

Поля для пошуку приходять із шорткоду, але фільтруються до post_title, post_content і post_excerpt. Кожне стає LOWER(field) LIKE %s зі значенням, екранованим esc_like і прив'язаним через prepare.

У браузері пошук спрацьовує на Enter лише тоді, коли поле досягає свого minlength, а порожній Enter або Escape прибирає термін, що не дає коротким уривкам слів потрапляти на сервер.

З filter_provider=woof шорткод захоплює дані запиту WOOF у JSON таблиці. При кожному AJAX-виклику провайдер відновлює з нього $_GET, запитує всі результати, викликає woof_products_ids_prediction() і читає woof_wp_query_ids, приймаючи масив або рядок через кому й залишаючи лише додатні цілі. Відсутність ID дає post__in = [0].

Параметр page_mdf декодується, а MDTF запускається з mdf_get_query_args_only, щоб повертати аргументи WP_Query замість HTML. Умова meta mdf_hide_post та умова product_visibility видаляються (WOOT додає власні), впорядкування відкидається, а запит виконується з fields=ids. Список ID подорожує як дані фільтра й стає post__in.

add_to_cart.php перевіряє is_purchasable() та is_in_stock() і, коли залишок ведеться, вимагає ненульову кількість. Для простих товарів дескриптор несе ID, залишок і SKU; клієнт будує числове поле з max, рівним залишку, лише для читання для товарів, що продаються поштучно, плюс прапорець для масового додавання.

Змінні та згруповані товари отримують кнопку, що відкриває спливну таблицю їхніх дочірніх. Зовнішні товари посилаються на зовнішній URL. Невідомі типи проходять через фільтр woot_woocommerce_add_to_cart, щоб інші плагіни могли надати розмітку.

URL точки береться з wc_add_to_cart_params, коли WooCommerce його виводить, тож власні AJAX-точки продовжують працювати. Кількість перевіряється щодо max перед надсиланням. Після успіху плагін запускає wc_fragment_refresh, оновлює власну інформацію про кошик і, залежно від опції таблиці, перенаправляє до кошика чи оформлення.

Прапорець у заголовку колонки кошика вибирає всі рядки. add_to_cart_some() проходить по надісланих позиціях. Для варіації вона відновлює мапу attribute_* з get_attributes('edit') і викликає WC()->cart->add_to_cart() з ID батька, кількістю, ID варіації та цією мапою — у формі, якої очікує кошик WooCommerce.

WOOT_WooCommerceVariations::filter_provider() встановлює post_type у product_variation, а post__in — у дочірні батька, перевіривши, що батько видимий відвідувачеві. Таблиці upsell, cross-sell, згрупованих і схожих товарів ділять базовий клас WOOT_WooCommerceUniversal і відрізняються лише джерелом ID.

У рядках варіацій до заголовка дописуються назви термінів атрибутів, а колонки таксономій читають власний slug атрибута варіації замість термінів, призначених запису.

Профіль woot_cart поєднує налаштовані колонки товарів з кількістю, проміжною сумою (WC_Cart::get_product_subtotal) та видаленням. Кожна зміна кошика відповідає свіжою таблицею кошика, кількістю позицій і проміжною сумою. Видалення й оновлення знаходять рядок кошика за product_id або variation_id.

Спливний кошик перебирає скін таблиці, що його відкрила: блок стилів батька копіюється, а його ID таблиці замінюється на ID спливної таблиці. Опція таблиці також може приховувати товари, що вже в кошику, через post__not_in.

__hash_object() серіалізує request_data у JSON і згортає його в 32-бітний хеш, що править за ключ кешу. У режимах JSON та load-more кеш вимкнено, бо дані вже локальні. Розширення на кшталт порівняння та обраного надсилають table23-reset-cache, коли їхні дані змінюються.

У режимі to_json сервер повертає кожен рядок (posts_per_page -1). Після першої відповіді таблиця сама переходить у режим json, а draw_data() будує SELECT ... WHERE ... ORDER BY ... LIMIT ... OFFSET і виконує його через AlaSQL над масивом. Односторінкова таблиця, знайдена в кеші, шукається й сортується так само.

Кожна таблиця тримає свій поточний AbortController. Новий запит сторінки, сортування чи фільтра перериває той, що очікує, тож повільна попередня відповідь більше не може перезаписати новішу сторінку.

Кожна таблиця має власну compact_view_width. Слухач зміни розміру порівнює новий стан із попереднім і перемальовує лише при зміні; прапорець блокування не дає йому спрацювати знову протягом 999 мс. Колонки, позначені hide-on-mobile, пропускаються при побудові заголовків, плаваючий заголовок вимикається в компактному режимі, а правила media-hide для колонок генеруються як CSS для HTML ID таблиці.

get_theme_css() спершу читає скін з теки woot-skins теми, потім з теки skins плагіна, замінює плейсхолдер tid на HTML ID таблиці та прибирає коментарі й зайві пробіли. Кожне правило обмежене однією таблицею, тож скіни не просочуються між таблицями на тій самій сторінці.

draw_table_data() кодує конфігурацію з JSON_HEX_QUOT та JSON_HEX_TAG, щоб вона могла сидіти в HTML, не виривалася з елемента. Після малювання рядків do_after_draw() знаходить таблиці в комірках і створює для кожної екземпляр WOOT_GeneratedTables без горизонтальної смуги прокручування.

Безпосередньо перед виконанням WP_Query post_status скидається в publish для будь-кого без read_private_posts, що б не просили запит, шорткод чи налаштування таблиці. Статус з аргументів шорткоду враховується лише для таких користувачів.

Типи записів, які не можна переглядати (купони, замовлення, шаблони), відхиляються для користувачів без edit_posts, якщо збережену таблицю не було створено для цього типу запису адміністратором.

Одна функція вирішує, чи може відвідувач бачити дані запису: опубліковані записи публічних типів відкриті, непублічні типи потребують прав редагування, інші статуси потребують read_post, а варіація видима лише тоді, коли видимий її батько. Таблиці окремого товару, варіацій, upsell та інші спливні таблиці, шорткод галереї й розширення викликають її перед рендером.

Скін може прийти з ?woot_skin=, шорткодів, розширень чи налаштувань таблиці, і всі вони проходять через get_theme_css(). Там ім'я зводиться через basename() і фільтр символів, що видаляє крапки та слеші, тож воно не може вказати за межі тек скінів. HTML ID таблиці, який записується у виведений CSS, фільтрується так само, щоб фігурні чи кутові дужки не могли вирватися з блоку style.

get_smth() публічна. Її загальна гілка викликає apply_filters для імені із запиту лише тоді, коли ім'я починається з woot_, а супутній call_id зводиться до літер, цифр, підкреслення й дефіса, перш ніж його побачить будь-який подальший запит. Гілка shortcodes_set видаляє кожен шорткод, якого немає в білому списку плагіна, перед do_shortcode(). Гілки експорту й імпорту вимагають manage_woocommerce.

Обробники таблиць, колонок, meta і словника перед записом перевіряють manage_woocommerce та woot_settings_nonce. Розширення вкладень додає перевірку входу та перевірки edit_post на рівні об'єкта.

Імена колонок, поля ORDER BY і ключі WHERE не можна прив'язати через prepare(), тому get_rows() зводить їх до безпечного набору символів, обмежує порядок значеннями ASC чи DESC, а логіку — AND чи OR, і прив'язує лише значення.