En los últimos meses, hemos estado trabajando en una función de banner de bienvenida que forma parte del producto principal de Discourse. Este banner de bienvenida principal saluda a los visitantes nuevos y recurrentes de tu comunidad y les permite buscar fácilmente contenido relevante para sus necesidades e intereses. Con esta nueva función de banner en el núcleo, ahora estamos deprecando el componente de tema del Banner de Búsqueda para reducir la complejidad de nuestras ofertas de productos y asegurar que todos los usuarios de Discourse se beneficien de mejoras continuas en la función principal.
En este tema, cubriremos qué significa la deprecación para los usuarios actuales del componente de tema del Banner de Búsqueda.
Si eres un cliente alojado…
Comenzaremos a migrar a los clientes alojados del componente Banner de Búsqueda a la función de banner de bienvenida el 20 de noviembre de 2025. Si actualmente estás utilizando este componente, recibirás un mensaje con los detalles exactos del momento para tu nivel de plan.
Esta migración copiará cualquier texto del sitio que hayas actualizado para el componente de tema (es decir, search_banner.headline, search_banner.subhead, search_banner.search_button_text) y los valores de los ajustes del componente de tema show on, plugin outlet y background image en los ajustes de la función principal.
Nuestro objetivo es minimizar el impacto visible de este cambio, para que el banner creado por la función principal se vea igual que el creado por el componente de tema. Las comunidades con una imagen en su banner podrían notar un ligero cambio en la posición de la imagen, que se puede corregir recortando la imagen para centrar el contenido que deseas que aparezca en el banner.
Después de esta migración, el componente de tema se desactivará y podrá eliminarse de forma segura desde la página Temas y componentes (/admin/config/customize/components).
Si eres un usuario autoalojado…
Debes planificar tu propia migración del componente de tema a la función principal para el 15 de diciembre de 2025. Puedes hacerlo manualmente o utilizando nuestra script proporcionado.
Migración manual
Aquí tienes un mapa de cómo los textos del sitio y ajustes del componente de tema del Banner de Búsqueda se relacionan con las mismas funciones del banner de bienvenida principal:
| Descripción del ajuste | Componente de tema del Banner de Búsqueda | Función principal de banner de bienvenida |
|---|---|---|
| El texto del encabezado mostrado en el banner de bienvenida. | search_banner.headline texto del sitio |
js.welcome_banner.header.anonymous_members y js.welcome_banner.header.logged_in_members textos del sitio |
| El texto del subtítulo mostrado en el banner de bienvenida. | search_banner.subhead texto del sitio |
js.welcome_banner.subheader.anonymous_members y js.welcome_banner.subheader.logged_in_members textos del sitio |
| El texto utilizado para el botón de búsqueda en el banner. \* | search_banner.search_button_text texto del sitio |
js.welcome_banner.search_placeholder texto del sitio |
| Ajuste para determinar en qué páginas se muestra el banner de bienvenida. | show on ajuste del componente de tema |
Ajuste del sitio “Visibilidad de páginas del banner de bienvenida” |
| Ajuste para determinar dónde en la página aparece el banner de bienvenida. | plugin outlet ajuste del componente de tema |
Ajuste del sitio “Ubicación del banner de bienvenida” |
| Imagen de fondo utilizada en el banner de bienvenida. | background image light ajuste del componente de tema |
Ajuste del sitio “Imagen del banner de bienvenida” |
\* Nota: la función principal de banner de bienvenida no admite un botón de búsqueda explícito, por lo tanto, recomendamos asignar este texto al texto del marcador de posición del campo de búsqueda personalizable para obtener un resultado similar.
Migración con script
La migración consiste en tres tareas rake que deben ejecutarse en el siguiente orden:
- Migrar ajustes del componente:
themes:advanced_search_banner:1_migrate_settings_to_welcome_banner - Migrar traducciones del componente:
themes:advanced_search_banner:2_migrate_translations_to_welcome_banner - Habilitar el banner principal, excluir el componente de temas donde se utiliza y deshabilitar el componente:
themes:advanced_search_banner:3_exclude_and_disable
Archivos \u003crandom_name\u003e.sh a ejecutar en el contenedor:
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
Se recomienda ejecutar cada tarea rake individualmente para tener un mejor control sobre el proceso de migración.
También está disponible una tarea de conveniencia themes:advanced_search_banner:migrate_all para ejecutar las tres tareas secuencialmente, pero úsala bajo tu propia responsabilidad.