За последние несколько месяцев мы работали над функцией баннера приветствия, которая является частью основного продукта Discourse. Этот базовый баннер приветствия обращается к новым и возвращающимся посетителям вашего сообщества и облегчает им поиск контента, соответствующего их потребностям и интересам. С появлением этого нового базового баннера мы теперь отказываемся от компонента темы «Баннер поиска», чтобы упростить наши предложения продуктов и обеспечить всем пользователям Discourse выгоду от непрерывных улучшений базовой функции.
В этой теме мы рассмотрим, что означает отказ от поддержки для текущих пользователей компонента темы «Баннер поиска».
Если вы клиент с хостингом…
Мы начнем миграцию клиентов с хостингом с компонента «Баннер поиска» на функцию «Баннер приветствия» 20 ноября 2025 года. Если вы в настоящее время используете этот компонент, вы получите сообщение с точными деталями времени для вашего тарифного плана.
Эта миграция перенесет все тексты сайта, которые вы обновили для компонента темы (то есть search_banner.headline, search_banner.subhead, search_banner.search_button_text), а также значения настроек компонента темы «показывать на», «плагиновый выход» и «фоновое изображение» в настройки базовой функции.
Наша цель — минимизировать видимое влияние этого перехода, чтобы баннер, созданный базовой функцией, выглядел так же, как баннер, созданный компонентом темы. Сообщества с изображением на баннере могут заметить незначительное смещение его позиции, которое можно исправить, обрезав изображение так, чтобы контент, который вы хотите отобразить на баннере, был по центру.
После этой миграции компонент темы будет отключен и его можно будет безопасно удалить со страницы Темы и компоненты (/admin/config/customize/components).
Если вы пользователь с самостоятельным размещением…
Вам следует запланировать самостоятельную миграцию с компонента темы на базовую функцию к 15 декабря 2025 года. Вы можете сделать это вручную или с помощью предоставленного нами скрипта.
Ручная миграция
Ниже приведена карта того, как тексты сайта и настройки компонента темы «Баннер поиска» соотносятся с аналогичными функциями базового баннера приветствия:
| Описание настройки | Компонент темы «Баннер поиска» | Базовая функция «Баннер приветствия» |
|---|---|---|
| Текст заголовка, отображаемый на баннере приветствия. | Текст сайта search_banner.headline |
Тексты сайта js.welcome_banner.header.anonymous_members и js.welcome_banner.header.logged_in_members |
| Текст подзаголовка, отображаемый на баннере приветствия. | Текст сайта search_banner.subhead |
Тексты сайта js.welcome_banner.subheader.anonymous_members и js.welcome_banner.subheader.logged_in_members |
| Текст, используемый для кнопки поиска на баннере. * | Текст сайта search_banner.search_button_text |
Текст сайта js.welcome_banner.search_placeholder |
| Настройка для определения страниц, на которых отображается баннер приветствия. | Настройка компонента темы «показывать на» | Настройка сайта «Видимость баннера приветствия» |
| Настройка для определения места на странице, где появляется баннер приветствия. | Настройка компонента темы «плагиновый выход» | Настройка сайта «Расположение баннера приветствия» |
| Фоновое изображение, используемое на баннере приветствия. | Настройка компонента темы «фоновое изображение light» | Настройка сайта «Изображение баннера приветствия» |
* Обратите внимание, что базовая функция «Баннер приветствия» не поддерживает явную кнопку поиска, поэтому мы рекомендуем сопоставить этот текст с настраиваемым текстом-заполнителем поля поиска для получения похожего результата.
Миграция с помощью скрипта
Миграция состоит из трех задач rake, которые должны быть выполнены в следующем порядке:
- Миграция настроек компонента:
themes:advanced_search_banner:1_migrate_settings_to_welcome_banner - Миграция переводов компонента:
themes:advanced_search_banner:2_migrate_translations_to_welcome_banner - Включение базового баннера, исключение компонента из тем, где он используется, и отключение компонента:
themes:advanced_search_banner:3_exclude_and_disable
Файлы <random_name>.sh для запуска в контейнере:
task_1.sh:
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:1_migrate_settings_to_welcome_banner
task_2.sh:
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:2_migrate_translations_to_welcome_banner
task_3.sh
#!/bin/bash
cd /var/www/discourse && rake themes:advanced_search_banner:3_exclude_and_disable
Рекомендуется запускать каждую задачу rake отдельно для лучшего контроля над процессом миграции.
Также доступна вспомогательная задача themes:advanced_search_banner:migrate_all для последовательного выполнения всех трех задач, но используйте её на своё усмотрение.
Но почему я вижу немецкие тексты в компоненте темы? Это стандартные переводы, которые были добавлены более года назад.