Результаты поиска

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Страница результатов поиска работает вместе с блоками Формы поиска. Поисковая форма передает запрос на отдельную страницу сайта, а эта страница выводит найденные страницы сайта через динамические карточки.

Что нужно для работы страницы результатов

Чтобы страница результатов поиска работала, настройте два элемента:

  • блок формы поиска с subtype: search и subtype_params.type: form
  • страницу результата, где включены динамические карточки и выбран источник Страницы сайта

Для штатных блоков формы система сама подставляет страницу результата в атрибут action формы. Для этого в манифесте блока должен быть описан URL-атрибут с attribute: action. В штатных блоках ссылка записывается в формате #landing<ID>. Для атрибута action также заданы ограничения: можно выбрать только страницу сайта, без произвольного URL и без привязки к блоку.

Как система подставляет страницу результата

Подтип поиска работает только для блоков, у которых в subtype_params указан type: form.

После добавления такого блока на страницу система:

  • берет код шаблона страницы результата из subtype_params.resultPage
  • ищет страницу результата на текущем сайте по коду шаблона
  • если страница найдена, использует ее
  • если страницы нет, создает ее по шаблону
  • записывает ссылку на найденную или созданную страницу в action формы

Подстановка выполняется в колбэке afterAdd. Во время переноса через AppConfiguration::inProcess() эта подготовка не запускается.

Что важно учитывать

  • автоподстановка работает только для поисковых форм, а не для страницы результатов
  • если в subtype_params нет resultPage, система не подставит страницу результата автоматически
  • если на странице результата не включить динамические карточки и не выбрать источник Страницы сайта, поиск не покажет страницы сайта

Штатные шаблоны и блоки

В исходном коде есть штатные шаблоны страниц результата:

  • search-result
  • search-result2
  • search-result3-dark

Штатные блоки поисковой формы, которые используют эти шаблоны:

  • 59.1.search → search-result
  • 59.2.search_sidebar → search-result
  • 59.3.search_dark → search-result3-dark

Эти блоки предназначены для сайтов типов knowledge и group. Блоки 59.2.search_sidebar и 59.3.search_dark дополнительно относятся к сайдбарным вариантам.

Шаблон search-result2 есть в штатных шаблонах страниц результата, но в этом наборе штатных поисковых форм он не используется.

Продолжите изучение

Предыдущая
Навигация и заголовок
Следующая
Формы поиска