This theme component is deprecated and should no longer be used. Its features are now in Discourse Core — see our documentation for details on setting up a welcome banner:
| Summary | Advanced Search Banner 在主帖列表导航上方的横幅中放置一个搜索栏以及可选的标题和副标题文本。 | |
| Preview | 在 Discourse 主题创建器上预览 | |
| Repository Link | https://github.com/discourse/discourse-search-banner | |
| New to Discourse Themes? | Discourse 主题使用入门指南 |
Install this theme component
Features
By default, this banner appears on all top-level topic pages (latest/new/unread/top/categories… anything in the top menu site setting) but it can also be set to only display on a community’s homepage.

Settings
| Name | Description |
|---|---|
| show on | This determines which pages the banner appears |
| plugin outlet | Where on the page the banner will appear |
| background image light | Background image for the banner on light color palettes |
| background image dark | Background image for the banner on dark color palettes |
| tile background image | Repeat the background image |
| show for | Who can see the Search Banner (logged in, logged out, or both) |
| special style | Optional variations that change the appearance of the search banner |
| Translation | Default |
|---|---|
| search_banner.headline | Welcome to our community |
| search_banner.subhead | We’re happy to have you here. If you need help, please search before you post. |
| search_banner.search_button_text |
To omit one from display, leave the field blank.
Custom styling
The HTML element gets a class named .display-search-banner wherever this banner appears, and the banner itself is wrapped with the .custom-search-banner class, so with some CSS you should be able to customize the appearance of this banner however you see fit.
Future enhancements
- Add an option to enable the banner in specific categories
Credits
This very heavily borrows from @angus’ https://meta.discourse.org/t/header-search-theme/67959
Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.