Короткі коди

Показуйте числа й блоки BotBlocker на будь-якій сторінці вашого сайту.

BotBlocker будує власні екрани Майстерні й Звітів із коротких кодів, і ви можете розмістити ті самі блоки на звичайному записі чи сторінці. Використовуйте їх для публічної сторінки «активність сайту», приватної сторінки моніторингу для команди або власної цільової сторінки, яка показує, скільки трафіку сайт відвертає.

Короткий код це тег у квадратних дужках, наприклад [bbcs_top_countries]. У блочному редакторі для нього є блок Короткий код. У класичному редакторі ви вводите тег там, де має з’явитися блок. У шаблоні його можна викликати через echo do_shortcode( '[bbcs_top_countries]' );.

Блоки показують числа, які BotBlocker уже зібрав, тож вони підкоряються тим самим правилам, що Майстерня й Звіти: Звітний період:, Режим відображення статистики і термін зберігання. Див. Сповіщення й звіти.

Трафік і статистика

Короткий код Атрибути Що показує
[bbcs_top_ips] limit (5), days (7) Список найактивніших IP-адрес за період
[bbcs_top_countries] limit (5), days (7) Країни з прапорами й кількістю влучань
[bbcs_top_devices] limit (5), days (7) Типи пристроїв, як-от ПК, телефон, планшет
[bbcs_top_browsers] limit (5), days (7) Назви браузерів і кількість влучань
[bbcs_latest_hits] немає Таблиця останніх візитів із часом, IP, країною, мовою, пристроєм і системою
[bbcs_counters_grid] немає Картки з сьогоднішніми й загальними влучаннями та блокуваннями, візитами пошукових систем і часткою заблокованого
[bbcs_blocked_today] немає Одне число: адреси, заблоковані сьогодні
[bbcs_blocked_total] немає Одне число: адреси, заблоковані з моменту встановлення
[bbcs_database_update] немає Скільки нових шкідливих адрес хмара BotBlocker вивчила сьогодні
[bbcs_database_total] немає Скільки шкідливих адрес знає хмара BotBlocker
[bbcs_botblocker_news] count (5) Останні новини BotBlocker з посиланнями

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

Стан системи й правила

Короткий код Атрибути Що показує
[botblocker_generateSiteHealthList] немає Контрольний список безпеки з галочкою або хрестиком для кожного пункту
[bbcs_health_full] cols (3, від 1 до 8) Той самий список у кількох стовпцях
[bbcs_recommendations] немає Дієві поради, як-от увімкнути 2FA або Redis
[botblocker_rules_stats] show_chart (yes), chart_height (200) Кількість ваших правил: IPv4, IPv6, шляхи, довірені боти, загальні правила

Вони виводять готовий HTML, тож працюють на будь-якій сторінці.

Частини інтерфейсу BotBlocker

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

Короткий код Атрибути Що показує
[bbcs_health_gauge] value, max (100), label, decimals, symbol (%) Круговий індикатор для оцінки, яку ви передаєте
[bbcs_statistics_chart] type (pie, donut), data (ip_hits_hosts, cookie_hits_hosts, device_types, browsers, operating_systems), period (today), width, height Один графік вибраних даних
[bbcs_daily_hits_chart] width, height Влучання за годину на сьогодні
[bbcs_hits_and_uniques_chart] days (7, від 1 до 31), width, height Влучання й унікальні відвідувачі за день
[bbcs_visitors_jsvectormap] days (30, від 1 до 365), width, height Карта світу з унікальними відвідувачами за країнами
[bbcs_cron_tasks] немає Дзвіночок завдань, який BotBlocker показує у власному заголовку
[bbcs_lang_options] немає Список мов, які постачаються з BotBlocker

Використовуйте їх на екранах BotBlocker. Для публічної сторінки беріть блоки вище, які виводять готовий HTML. Індикатор теж нічого не обчислює: передайте оцінку самі, наприклад [bbcs_health_gauge value="85"]. Підпис іде за оцінкою: Безпечно від 85, Сильна від 70, Помірний від 50, Слабкий від 25, а нижче Критичний.

Сайт і система

Короткий код Атрибути Що показує
[bbcs_system_status] немає Версії сервера й програмного забезпечення та ліміти PHP
[bbcs_plugins_themes] немає Кожен встановлений плагін і тему з версією та статусом

[bbcs_system_status] спершу перевіряє ваші права. Відвідувач, який не може керувати сайтом, отримує коротке повідомлення замість версій, тож код безпечний на публічній сторінці.

[bbcs_plugins_themes] інший. Він перелічує встановлене, з версіями. Це корисно на приватній сторінці обслуговування й подарунок атакувальнику на публічній. Тримайте сторінку приватною або не додавайте цей короткий код.

Form CAPTCHA

[bbcs_form_captcha] походить з аддона Form CAPTCHA. Він вставляє перевірку відвідувача в будь-яку форму фронтенду й має власну сторінку, зокрема атрибути type, theme і class.

Кешування

Налаштування Кеш інтерфейсу на BotBlocker → Налаштування → Система → Налаштування інтерфейсу охоплює більшість цих блоків. Поки кеш увімкнений, число може відставати на тривалість кешу. Вимкніть кеш, коли блоку потрібно показати найсвіжіше значення, наприклад під час атаки.

Деякі блоки ніколи не кешуються: лічильники блокувань, стан системи й список плагінів. Числа хмарної бази та список новин мають власний короткий кеш.

Перш ніж публікувати

  • Публічна сторінка показує ваш трафік усім. IP-адреси, user agent і списки країн це дані відвідувачів. Прочитайте Приватність і дані, перш ніж публікувати блок із подробицями.
  • Числам потрібна історія. Блок лишається порожнім, коли термін зберігання вже видалив дні, які він рахує. Див. Сповіщення й звіти.
  • Блоки підкоряються вашим перемикачам журналювання. Якщо тип запиту не записується, блок не може його порахувати. Див. Журнали трафіку й аудиту.

Коли чогось бракує

  • Блок порожній? Перевірте перемикачі журналювання, термін зберігання й кеш інтерфейсу. Блокам графіків також потрібен трафік, що потрапляє в період графіка.
  • Графік показує порожню рамку? Скрипти графіків завантажуються з екранами адмінки BotBlocker. Відкрийте той самий графік у Майстерні або на BotBlocker → Звіти, щоб переконатися, що дані є.
  • Список плагінів порожній для відвідувачів? Це очікувано, коли короткий код усередині блоку, який бачать лише адміністратори, або коли кеш сторінок віддає урізану копію. Перевірте сторінку як відвідувач без входу.