Custom Hamburger Menu Links

:discourse2: Summary Custom Hamburger Menu Links will allow you to easily add links to the hamburger menu.
:eyeglasses: Preview Preview on theme-creator.discourse.org
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-custom-hamburger-links
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Samples

Desktop

Mobile


Settings

You add links via comma delimited values in this order:

Text,URL,Location,Target

Text
is the name of the link that shows on the menu.

URL
is the path you want the link to have. You can use relative paths like

/tags/funny
or
/t/231

if you prefer.

Location
can have one of two values. Either the letter g or the letter f

Use “g” if you want the link to appear in the generalLinks section:

or use “f” if you want the link to appear in the footerLinks section:

Target (optional)
Use “blank” if you need the link to open in a new tab.

59 Likes

Thats a nice addition, thanks for that. It’s already installed :smiley:

Could you add a target option so that it is possible to open the link in a new tab/window (if no target is given just use “_self”)

Text,URL,Location,Target

10 Likes

Please add an option to place the link at the very top of the dropdown panel :slight_smile:

5 Likes

I might have a go at this myself at some stage (have to learn a wee bit first), but I’m putting my thoughts down here for now:

Feature Requests:

No 1: Allow hover text. This is now used for the core hamburger links, and would be very helpful

No 2: Merge with Rob’s fork, which is clearly a good idea:

No 3: Allow target="_blank" as per Richie (also clearly a great idea):

No 4: Allow more control of link ordering (likely very tricky!)

7 Likes

Is there a way that the custom hamburger menu links can be translated depending on the user interface language?

For example, I could wrap yaml translation files into a custom plugin, but I’m not sure which translation keys I could use.

No practical way to do this?

2 Likes

is there any way on customizing the links in order to place them on a certain order?

6 Likes

So are we got the possibility to open in new tab?

1 Like

I don’t think anyone is working on this anymore @savas :confused:

2 Likes

Seems i have trouble adding this to footer links even i add f on Locations. Does anyone have the same trouble?

1 Like

I got really excited this evening when I saw this!!

I was soooooo much hoping that there was a new feature to open links to a target="_blank" :scream:

Jumped straight on GitHub to see what was new!

Screen Shot 2021-03-06 at 21.18.00

Oh @tshenry I was so disappointed :pensive:

:rofl:

3 Likes

Maybe this will help? :wink:

https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1f

That seemed to be the most requested feature and it wasn’t too hard to add support. That’s it for now though :slight_smile:

18 Likes

My life is now complete :heart_eyes:

Thank you @tshenry this is fantastic news :clap:t2: :bowing_man:t2:

4 Likes

Hey quick question, how does one localize the custom hamburger menu text? I want to fully localize my forum and I can’t seem to find the text anywhere.

2 Likes

This is a useful component. But can we add font awesome icons there? It would be great to show social media profile icons there, so that people can follow our social profiles easily.

2 Likes

That is fantastic, thank you! :wink:
Maybe you can tell me quickly - how to localize the custom hamburger menu text?

3 Likes

I added support for icons, you could try out this fork of the component: GitHub - nolosb/discourse-custom-hamburger-links-with-icons

Two notes on usage:

  • The icon would be the first item in the list:
    Screenshot from 2021-07-01 11-10-15
    If you want a link without icon, just don’t add it, but keep the trailing comma ,
    Screenshot from 2021-07-01 11-10-40

  • If the icon is not included by default, remember to add it to the icon list:
    Screenshot from 2021-07-01 11-11-06

7 Likes

Can you puch these changes to the official Theme component? It’s always better to have the official Theme component installed as it’s going to be maintained with Discourse future updates.

8 Likes

It would be nice to have this merged with the official plugin. I want to add social media buttons in the hamburger menu. But without icons it would not look as nice.

Also, it’s a bit unclear that no space is allowed in the CSV fields.
This works: Footer Link,https://google.com,f
But with spaces the item gets inserted in the general field rather than the footer, because of the missing space: Footer Link, https://google.com, f

2 Likes

Hi!

With the new sidebar, being able to add custom icons to our links would be a nice addition.

image

I can try to work on this and do a PR in the following days…

9 Likes

Quick question…

I’ve installed the theme component on a new Discourse instance, but for some unidentified reason, the default links won’t appear in the more section of the sidebar:

I didn’t modify the code, it’s a fresh theme component install.

However, the theme component, installed two years ago, works on my other forum:

No error is displayed. Any idea why the theme component doesn’t work on my new install? :thinking:

4 Likes