Установка кода¶
Подробные инструкции по установке кода BotSafe на ваш сайт для разных платформ и CMS.
📋 Общая информация¶
Код BotSafe нужно вставить в <head> вашего сайта, перед закрывающим тегом </head>. Код получается при регистрации сайта в Telegram-боте.
🔧 Прямая вставка HTML-кода¶
Если у вас есть доступ к HTML-коду сайта:
- Откройте файл, который содержит
<head>(обычноindex.htmlилиheader.php) - Найдите закрывающий тег
</head> - Вставьте код BotSafe перед
</head> - Сохраните файл
<head>
<meta charset="UTF-8">
<title>Мой сайт</title>
<!-- Другой код -->
<!-- Код BotSafe -->
<script>
// Ваш код интеграции здесь
</script>
</head>
📝 WordPress¶
Способ 1: Через плагин (рекомендуется)¶
Рекомендуемый способ
Использование плагина — самый безопасный способ, так как изменения не теряются при обновлении темы.
Шаги:
- Установите плагин "Insert Headers and Footers" или аналогичный:
- Перейдите в "Плагины" → "Добавить новый"
- Найдите "Insert Headers and Footers"
-
Установите и активируйте плагин
-
Перейдите в настройки плагина:
- "Настройки" → "Insert Headers and Footers"
-
Или "Внешний вид" → "Insert Headers and Footers"
-
Вставьте код BotSafe:
- В поле "Scripts in Header" вставьте код BotSafe
-
Не вставляйте код в "Scripts in Footer"
-
Сохраните изменения:
- Нажмите "Сохранить изменения"
Пример
После установки плагина откройте раздел "Scripts in Header" и вставьте туда код BotSafe, который вы получили в Telegram-боте.
Способ 2: Через тему¶
Внимание
Изменения в файлах темы могут быть потеряны при обновлении темы. Рекомендуется использовать дочернюю тему или плагин.
Шаги:
- Перейдите в редактор тем:
- "Внешний вид" → "Редактор тем"
-
Или используйте FTP/файловый менеджер хостинга
-
Выберите файл
header.php: - В списке файлов найдите
header.php -
Откройте его для редактирования
-
Найдите закрывающий тег
</head>: - Используйте поиск (Ctrl+F) для быстрого поиска
-
Убедитесь, что вы нашли правильный тег
-
Вставьте код BotSafe:
- Вставьте код перед
</head> -
Не вставляйте код после
</head> -
Сохраните изменения:
- Нажмите "Обновить файл"
Способ 3: Через functions.php¶
Альтернативный способ
Этот способ также может потерять изменения при обновлении темы. Используйте дочернюю тему.
Шаги:
- Откройте файл
functions.phpвашей темы: - "Внешний вид" → "Редактор тем" →
functions.php -
Или используйте FTP/файловый менеджер
-
Добавьте следующий код в конец файла:
function add_botsafe_code() {
?>
<script>
// Ваш код BotSafe здесь
</script>
<?php
}
add_action('wp_head', 'add_botsafe_code');
-
Замените комментарий
// Ваш код BotSafe здесьна реальный код BotSafe -
Сохраните изменения
🎨 Tilda¶
Применение ко всему сайту
Код, вставленный в настройках сайта, будет применён ко всем страницам сайта автоматически.
Шаги:
- Откройте нужную страницу в редакторе Tilda:
- Войдите в аккаунт Tilda
-
Откройте нужную страницу для редактирования
-
Откройте настройки:
- Нажмите на иконку "⚙️ Настройки" в правом верхнем углу
-
Или используйте меню страницы
-
Перейдите в настройки сайта:
- Выберите "Настройки сайта" → "Код сайта"
-
Или найдите раздел "Код" в настройках
-
Вставьте код BotSafe:
- В разделе "Код в " вставьте код BotSafe
-
Не вставляйте код в "Код в
" или "Код перед " -
Сохраните изменения:
- Нажмите "Сохранить" или "Применить"
Проверка
После сохранения код будет применён ко всем страницам сайта. Проверьте работу кода, открыв любую страницу сайта.
🔷 Joomla¶
Способ 1: Через плагин¶
- Установите плагин "Custom Code" или аналогичный
- Перейдите в "Расширения" → "Плагины"
- Найдите установленный плагин и откройте его
- Вставьте код BotSafe в соответствующее поле
- Сохраните изменения
Способ 2: Через шаблон¶
- Перейдите в "Расширения" → "Шаблоны" → "Стили"
- Выберите активный шаблон
- Нажмите "Изменить"
- Найдите файл
index.phpили создайте переопределение - Вставьте код BotSafe перед
</head>
🔵 Drupal¶
- Перейдите в "Структура" → "Блоки"
- Создайте новый блок или отредактируйте существующий
- Вставьте код BotSafe в содержимое блока
- В настройках блока выберите "Тип содержимого" → "PHP код" (если доступно)
- Или используйте модуль "Custom Code" для вставки в
<head>
🟦 Bitrix¶
- Перейдите в "Контент" → "Редактор сайта"
- Откройте файл
header.phpили используйте компонент "Включение области" - Вставьте код BotSafe перед
</head> - Сохраните изменения
Или используйте настройки сайта: 1. Перейдите в "Настройки" → "Настройки продукта" → "Настройки сайта" 2. Найдите раздел "Код в
" 3. Вставьте код BotSafe 4. Сохраните изменения🟢 Wix¶
- Перейдите в редактор сайта
- Нажмите "Настройки" → "Дополнительно" → "Код сайта"
- В разделе "Код в " вставьте код BotSafe
- Сохраните изменения
🔴 Shopify¶
- Перейдите в "Онлайн-магазин" → "Темы"
- Нажмите "Действия" → "Изменить код"
- Откройте файл
theme.liquid - Найдите
</head> - Вставьте код BotSafe перед
</head> - Сохраните изменения
🟡 OpenCart¶
- Перейдите в "Расширения" → "Модификаторы"
- Создайте новый модификатор или отредактируйте существующий
- Найдите файл
common/header.twigили аналогичный - Добавьте код BotSafe перед
</head> - Сохраните изменения
🔍 Проверка установки¶
После установки кода обязательно проверьте, что всё работает правильно.
Шаг 1: Проверка в браузере¶
- Откройте сайт в браузере:
- Откройте любую страницу сайта
-
Убедитесь, что страница загружается нормально
-
Откройте консоль разработчика:
- Нажмите
F12илиCtrl+Shift+I(Windows/Linux) - Или
Cmd+Option+I(Mac) -
Перейдите на вкладку "Console"
-
Проверьте на наличие ошибок:
- Не должно быть ошибок, связанных с BotSafe
- Если есть ошибки, проверьте правильность установки кода
Шаг 2: Проверка сетевых запросов¶
- Откройте вкладку "Network":
- В консоли разработчика перейдите на вкладку "Network"
-
Обновите страницу (F5)
-
Проверьте запросы к BotSafe:
- Должны быть запросы к
botsafe.ruилиtrack.botsafe.ru - Запросы должны быть успешными (статус 200)
Пример успешного запроса
В списке сетевых запросов вы должны увидеть запрос к track.botsafe.ru/bshield.js со статусом 200 (OK).
Шаг 3: Проверка в Яндекс.Метрике¶
- Подождите несколько минут:
- Данные появляются в Метрике с задержкой (обычно 5-10 минут)
-
Не проверяйте сразу после установки
-
Откройте Яндекс.Метрику:
- Войдите в Яндекс.Метрику
-
Выберите нужный счётчик
-
Проверьте параметры визита:
- Перейдите в отчёт "Посетители"
- Откройте конкретное посещение
- В разделе "Параметры визита" должны быть параметры с префиксом
bs_
Если параметры не появились
Если параметры не появились через 10-15 минут, проверьте: - Правильность номера счётчика Яндекс.Метрики - Работу счётчика на сайте - Консоль браузера на наличие ошибок
❓ Частые проблемы¶
Код не работает¶
- Убедитесь, что код вставлен в
<head>, а не в<body> - Проверьте, что код не повреждён при копировании
- Проверьте консоль браузера на наличие ошибок
Параметры не появляются в Яндекс.Метрике¶
- Убедитесь, что номер счётчика Яндекс.Метрики указан правильно
- Подождите несколько минут — данные могут появиться с задержкой
- Проверьте, что счётчик Яндекс.Метрики установлен и работает
Ошибки в консоли¶
- Проверьте, что код установлен полностью
- Убедитесь, что нет конфликтов с другими скриптами
- Обратитесь в поддержку через Telegram-бота
📚 Дополнительная информация¶
- Быстрый старт — общая инструкция по началу работы
- Регистрация в Telegram-боте — как получить код интеграции
- FAQ — ответы на частые вопросы