Адон для BotBlocker Security встановлюється туди, де вже стоїть фаєрвол. Помилка в ньому коштує дорожче, ніж у звичайному плагіні: вона або пропускає те, що мала зупиняти, або блокує платежі й адмінку.
Код: BotBlocker-Add-on-Developer-Kit, ліцензія GPL-3.0.
Тому перевірка адона це три тести, які займають двадцять хвилин і ловлять майже все, що потім коштує ночі.
Тест 1. Валідатор по теці, потім по архіву
validate-addon.php із комплекту перевіряє маніфест, конфлікти імен, відповідність санітайзера та наявність файлів, які маніфест обіцяє.
Запускати треба двічі: спочатку по теці джерел, потім по готовому ZIP. Це різні перевірки. Тека показує помилки коду, архів показує помилки пакування.
Найчастіша знахідка в теці це санітайзер, оголошений у маніфесті, і друга копія логіки, написана в файлі налаштувань пізніше. Обидві працюють, результати різні, і на бойовому сайті зберігається те, що записала друга.
Тест 2. ZIP, який WordPress розпакує
Архів має містити рівно одну кореневу теку з іменем слага. Це не побажання, а вимога інсталятора: він перевіряє структуру до розпакування.
Окремо про Windows. Compress-Archive пише зворотні слеші як роздільники, unzip_file у WordPress їх не нормалізує, і на Linux-хостингу з’являються файли з символом в імені. Інсталяція падає, а повідомлення про помилку не згадує архіви.
Правильні варіанти: package-addon.ps1 із комплекту або zip -r у Linux чи WSL. Після пакування перевірте архів очима: одна тека, всередині маніфест і PHP-файли, без __MACOSX і без .git.
Тест 3. Питання про трафік
Якщо адон не претендує на рішення про трафік, третій тест короткий: переконайтеся, що в маніфесті немає traffic_decision_provider і що весь код виконується після основної перевірки запиту.
Якщо претендує, перевірка стає довшою. Pre-run контракт дозволяє адону впливати на запит раніше за решту плагінів, і погане правило здатне перенаправити живих відвідувачів, зламати колбек оплати, сховати сторінку перевірки або зациклити редиректи.
Мінімум для такого адона: вимкнений стан за замовчуванням, режим пробного прогону без застосування рішень, описаний відкат і вимога ручного підтвердження адміністратора перед бойовими блокуваннями.
Що перевірити в самому коді
Кілька речей, які не ловить жоден валідатор.
Дані про відвідувача беріть з об’єкта ядра, а не з $_SERVER. Ядро нормалізує заголовки проксі й результати перевірок, і пряме читання суперглобала повертає рівно ту проблему підміни, проти якої стоїть фаєрвол.
Налаштування зберігайте одним масивом опцій і читайте через нього ж. Розсипані опції myaddon_option_1..9 потім неможливо ні експортувати, ні прибрати при видаленні плагіна.
Знімайте хуки й очищайте cron у деактивації. Адон, який лишає після себе заплановані події, продовжує писати в базу після видалення.
Перевірте, що адон не ламає сторінку входу. Найпростіший спосіб зробити сайт недоступним для власника це помилка в перевірці, яка спрацьовує й для адміністратора.
Перевірка на стенді
Валідатор не замінює встановлення. Один прогін на копії сайту закриває те, що статичний аналіз не бачить: чи активується адон без помилок, чи з’являється його пункт у меню, чи не ламається сторінка входу після активації.
Послідовність проста. Завантажте ZIP у розділі адонів, активуйте, пройдіть свої сценарії, потім деактивуйте й видаліть. Після видалення перевірте, що опції зникли, а заплановані події більше не виконуються.
Якщо адон пише у власну таблицю, видалення має прибирати і її. Плагін, який лишає по собі таблицю на десять тисяч рядків, помітний не одразу, а через рік.
Куди дивитися далі
Контракт рантайму в комплекті пояснює порядок завантаження і відповідає на більшість питань «чому адон не працює». Довідник API v2 описує маніфест і поля налаштувань.
Комплект відкритий: BotBlocker Add-on Developer Kit, GPL-3.0. Документація продукту є на botblocker.top/docs, а можливості ядра описані на сторінці можливостей.
Про сам продукт і його межі: документація BotBlocker. Про безпеку плагінів у загальному вигляді: Plugin Handbook.
