 |
Summary | Search Banner puts a search bar along with optional headline and subhead text in a banner above the main topic list navigation. |
 |
Preview | Preview it on theme-creator.discourse.org |
 |
Repository Link | https://github.com/discourse/discourse-search-banner |
 |
New to Discourse Themes? | Beginner’s guide to using Discourse Themes |
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.
This very heavily borrows from @angus’ Header Search Theme Component
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 |
Theme translations
You can customize the text of these elements:
- Heading (search_banner.headline)
- Subheading (search_banner.subhead)
- Button text (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