Шорткоды
Выводите числа и блоки 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 → Отчёты, чтобы убедиться, что данные есть.
- Список плагинов пуст для посетителей? Так и должно быть, когда шорткод стоит в блоке, видимом только администраторам, или когда кеш страниц отдаёт урезанную копию. Проверьте страницу как посетитель без входа.