Перейти к содержимому

Свой код

Через Код SearchBooster можно запускать на сайте свой JavaScript: счётчик, баннер, правку вёрстки, отправку события. Код хранится в кабинете, а страницы, где он работает, выбираются масками адресов. Править шаблоны сайта не нужно.

Раздел в кабинете: Код SearchBooster → Модули → Свой код (или Интеграция → Свой код в меню проекта).

  1. Добавьте код. Укажите название, JavaScript без тега <script> и страницы (маски). «Сохранить черновик» запоминает изменения, на сайте ничего не меняется.
  2. Проверьте на своём сайте. Кнопка «Проверить на моём браузере» открывает сайт по особой ссылке. Только в этом браузере работают черновики и выключенные кусочки, а в углу страницы — панель отладки. Ссылка действует сутки, неделю или 30 дней — срок выбирается в «Срок и ссылка для отправки», там же ссылку можно скопировать и отправить. Повторная проверка открывает ту же ссылку, а «Новая ссылка» отменяет старую.
  3. Опубликуйте. «Опубликовать» выкатывает черновики на сайт для всех посетителей, изменения появляются в течение нескольких минут. Переключатель «На сайте» включает и выключает кусочек при сохранении.

По маске на строку. Пусто — код работает на всех страницах.

Маска Где сработает
/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 масок в каждом.

Код выполняется только на вашем сайте, в кабинете — никогда. Менять его могут только пользователи с правом редактирования проекта, каждое изменение попадает в историю изменений проекта.