品牌标题

:discourse2: Summary Brand Header adds an extra top header for branding with your logo, navigation links, and social icons for both mobile and desktop views. Brand logo can be an image or text.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-brand-header
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

Desktop preview:

Mobile preview:

Settings

Name Description
brand name
website url
mobile logo url
links Text links to be displayed in the header
icons Icon links to be displayed in the header
custom font awesome icons List of FontAwesome 6 icons used in this theme component
show bar on mobile
plugin outlet

Using Font Awesome 6 Icons

To allow the Font Awesome 6 Icons to correctly display in this theme component, you will need to add them to 3 places in Discourse:

  1. The svg icon subset Site Setting
  2. The custom font awesome icons setting in the component
  3. The icons setting in the component

Additionally, for some Font Awesome 6 Icons, you will need to specify a fa or fab prefix with the icon name (Ex: “fab-bluesky”), due to some icons being part of a specific subset of icons. See We’re upgrading our icons to Font Awesome 6! for details about this usage.

Once you’ve added those icons in all three places, you should see them correctly displayed in the brand header theme component.

:discourse2: Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.

Last edited by @SaraDev 2025-01-02T20:46:25Z

Check documentPerform check on document:
85 个赞

@vinothkannans Great component!

One small issue. Currently, if a header link is internal to a site (e.g. to a particular category), if it is tapped in the responsive menu, the responsive menu will stay open. The expected behaviour is that the menu would close.

Screenshot%20at%20Oct%2026%2010-13-03

5 个赞

I am also seeing this issue for internal links, where the header does not disappear on mobile. Instead, the header slides right and leaves the main page opaque (I believe an overlay is being set), even if the header is folded back up.

Is there a fix for this?

In the mobile view, when we click on the hamburger menu, if then we click outside of the menu, the hamburger menu would be expanded even more, instead of closing. and also it has some other glitches. for example when hamburger menu is open and we click on a topic link.

1 个赞

I’m curious, is there some sort of code I can use/edit to move the links to this side of the header?

Ideally with the fa-icons left in place (on the far right). I’d just like to see what it looks like.

Hey there, would you be open to adding an option to display the bar below the header instead of above?

1 个赞

Sure, I will accept it if you can submit it in a PR.

4 个赞

Any hints as to what needs to be changed for that? I never worked with Discourse before.

1 个赞

https://github.com/discourse/discourse-brand-header/blob/master/common/header.html#L192-L194

You should mount the widget in “below-site-header” connector instead of “above-site-header”. It will require few more tweaks too.

6 个赞

Thanks, I got it to work! Will probably PR when I have a bit more time.

4 个赞

I merged your other PR which will add an optional target parameter to links.

https://github.com/discourse/discourse-brand-header/pull/4

8 个赞

This is now done in the commit below

4 个赞

I love this change, but on several sites where I use it personally, and on a hosted site I’m a moderator of (the NaNoWriMo forums) we’ve been seeing some issues. Unlike the regular hamburger menu, if you try to swipe it away it bounces back onto the screen.

I’ve personally seen this on a fully updated Moto (g7) Power on Android 9 and on a fully updated iPhone 8.

There has also been at least one report of the menu opening on touches near the icon and not just on it, but I’ve personally been unable to reproduce that particular behavior.

2 个赞

Thanks! Turns out I did not have time to make a proper PR, do you think you’ll be able to add the below/above site header setting?

1 个赞

Seems like it would be very useful to be able to add attributes to the header links somehow, e.g. for css class, target, etc.

1 个赞

I have had a query as to why the menu is not working on mobile devices. The user pressed on the left burger menu but then on a menu link - and his perception was it wasn’t working as the menu still filled most of the screen.

I’ve had to explain you need to touch somewhere on the right of the screen, to the side of the menu, to close it.

Would it be possible to make it more intuitive, either by:

  • Auto-closing the menu when you click on a menu link on mobile devices?
  • Including a ‘Close Menu’ button on mobile devices?
1 个赞

I’ve been meaning to make a similar request. I often try to dismiss the menu on mobile by swiping it to the left. It appears to be working, but then it pops back into place. The other menus in Discourse it works to swipe them back to the side to dismiss them.

1 个赞

你好!

我们在同一论坛的两个版本(discourse 3.2.0.beta4-dev 和 discourse 3.3.0.beta1-dev)之间尝试了不同的布局。

下面是一个没有自定义 CSS 的示例,只有原始组件。

discourse 的 HTML 布局在两个版本之间是否发生了变化?

另外,“滑入”行为在 v3.3 中已损坏。

2 个赞

我在 Discourse 3.2.2 上遇到了同样的问题。幻灯片效果已损坏。

我想知道,根据以上帖子的日期,brand-header 主题组件是否仍然受支持?

根据之前的两篇帖子,这个问题已经存在至少 5 个月了,而且没有人回应。我将假设这个主题组件已经停止维护,除非有人另有说明。