show_on: choose to show your banner on the homepage, topic lists, or all pages
banner_links: add 1-4 links with font awesome icons and text (you might also need to add icons that aren’t included in Discourse by default to the svg_icons setting)
max_trust_level: only show the banner to users at specific trust levels
hide_for_staff
hide_on_mobile
layout: text-left (default) or text-top
hide_for_anon: hides the banner from logged-out users
banner_background_image: choose an image to display behind the banner
This is wonderful! You’re truly awesome @awesomerobot!
I do have a question regarding svg_icons. I tried to add the regular and solid ones on the list (e.g. far-user-group and fas-user-group), but whenever I hit preview, it doesn’t seem to appear on the banner. Am I missing a step here? Thanks!
the theme includes a svg_icons setting, if the icon does not appear you may need to add the name here (Discourse doesn’t include every font awesome icon by default, but this setting will add them)
you don’t need to include the prefix for the standard icons, just user-group should work
make sure you’re only looking at free icons (there’s a filter for free on their site), we don’t include pro icons by default because they require a license. Pro icons can be added with a plugin, if you purchase a license: FontAwesome Pro icons
A small point to add onto @awesomerobot’s comments,
FontAwesome recently updated their icon set to version 6.0.0 and as a result there were new icons added and some icons had their names slightly changed.
I believe Discourse is still using version 5.15.4, which is why you may be seeing the issue as the user-group icon does not exist in that version. Perhaps you might want to use user-friends as its a similar icon.
Aha! This did the trick. It’s the version not being compatible. Thanks @keegan!
And of course, thank you again for this theme component @awesomerobot. I was debating on whether to get this or the versatile banner, but ultimately decided to go with the minimalistic view on the former.
Thanks for the feedback! I’ve updated this to be visible to logged out users by default, and I’ve also added a setting to hide it from logged-out users, if desired.
I’ve also added some additional settings for controlling the styles…
If you update the component there’s a new setting called banner_box_background_color
That’s a very well-designed theme component and a great alternative to the “regular” banners (as pinned posts) to welcome new people, whether the forum is new or after a migration. Great theme component. We use it on our migrated forum and are very happy with it.
Note: since it’s in the context of a forum migration, a lot of users are trust level 1, but because the forum engine is very different from phpBB, we decided to downgrade all the existing users to trust level 0 so they see the banner and its information and set the welcome banner to disappear when they reach the trust level 1 (waiting for level 2 would be too long).
Any input on how to modify the placement of this component on a page? For instance, I’d rather have this component located above my footer, as opposed to below the header. Any thoughts here? See example below:
The three links and their icons, I would like the text and icons to be all left-aligned rather than center-aligned, on both desktop and mobile. I have basic knowledge of css/html and couldn’t figure out how to change it using developer tools.