Свой код
Через Код SearchBooster можно запускать на сайте свой JavaScript: счётчик, баннер, правку вёрстки, отправку события. Код хранится в кабинете, а страницы, где он работает, выбираются масками адресов. Править шаблоны сайта не нужно.
Раздел в кабинете: Код SearchBooster → Модули → Свой код (или Интеграция → Свой код в меню проекта).
Как это работает
Заголовок раздела «Как это работает»- Добавьте код. Укажите название, JavaScript без тега
<script>и страницы (маски). «Сохранить черновик» запоминает изменения, на сайте ничего не меняется. - Проверьте на своём сайте. Кнопка «Проверить на моём браузере» открывает сайт по особой ссылке. Только в этом браузере работают черновики и выключенные кусочки, а в углу страницы — панель отладки. Ссылка действует сутки, неделю или 30 дней — срок выбирается в «Срок и ссылка для отправки», там же ссылку можно скопировать и отправить. Повторная проверка открывает ту же ссылку, а «Новая ссылка» отменяет старую.
- Опубликуйте. «Опубликовать» выкатывает черновики на сайт для всех посетителей, изменения появляются в течение нескольких минут. Переключатель «На сайте» включает и выключает кусочек при сохранении.
Маски страниц
Заголовок раздела «Маски страниц»По маске на строку. Пусто — код работает на всех страницах.
| Маска | Где сработает |
|---|---|
/cart/* |
/cart, /cart/, /cart/step-2 |
/catalog/* и !/catalog/sale/* |
весь каталог, кроме раздела распродажи |
/ |
только главная |
/search?q=* |
страницы поиска с параметром q |
https://m.shop.ru/* |
только мобильная версия на поддомене |
*— любые символы, включая/.!в начале строки — исключение: если адрес под него подходит, код не запускается, даже если подходит другая маска.- Маска сравнивается с путём страницы без домена. Маска со знаком
?— с путём и параметрами. Маска сhttp://илиhttps://— с полным адресом. - Регистр букв и
/в конце не важны.
Поле Проверить адрес в кабинете показывает, какие кусочки сработают на вставленном адресе.
Панель отладки
Заголовок раздела «Панель отладки»В режиме проверки на странице сайта появляется панель:
- Свой код — по каждому кусочку: выполнен (и за сколько миллисекунд), ошибка с текстом и номером строки, не подошёл адрес (какая маска), выключен, но запущен только в проверке.
- Модули — нашлось ли поле поиска, загружен ли трекер, сколько кнопок «Похожие» вставлено, подключён ли чат.
- Перезапустить — выполнить код ещё раз после правки, Выйти из теста — вернуть сайт к обычному виду.
Обычные посетители панель не видят и её код не скачивают.
Ограничения
Заголовок раздела «Ограничения»- Код выполняется один раз, когда страница загрузилась (
DOMContentLoaded). На сайтах-SPA при переходе без перезагрузки страницы он не запускается заново. - Каждый кусочок выполняется отдельно: ошибка в одном не ломает поиск, другие модули и другой код.
- Если политика безопасности сайта (CSP) запрещает
unsafe-eval, код не выполнится — панель покажет ошибку. - До 20 кусочков, до 20 000 символов кода и до 50 масок в каждом.
Безопасность
Заголовок раздела «Безопасность»Код выполняется только на вашем сайте, в кабинете — никогда. Менять его могут только пользователи с правом редактирования проекта, каждое изменение попадает в историю изменений проекта.