Custom Hamburger Menu Links

[Johani (Joe)]

	Summary	Custom Hamburger Menu Links will allow you to easily add links to the hamburger menu.
	Preview	Preview on theme-creator.discourse.org
	Repository Link	https://github.com/discourse/discourse-custom-hamburger-links
	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.

[NemesisRE (Steven)]

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

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

[ngets]

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

[nathank (Nathan Kershaw)]

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:

@merefield

Just add an additional ,N if you want the link to appear for anon users (aka Not Private), or ,Y if you don’t (Yes to Private).

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

@Richie

This is a great component but I’d also love to be able to target links to a new window

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

[mentalstring (Paulo)]

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?

[rolando]

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

[savas (Mindaugas Bartusevičius)]

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

[Richie (Richie Rich)]

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

[mognet]

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

[Richie (Richie Rich)]

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"

Jumped straight on GitHub to see what was new!

Oh @tshenry I was so disappointed

[tshenry (Taylor)]

@Richie

I was so disappointed

Maybe this will help?

Add link target option

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

[Richie (Richie Rich)]

My life is now complete

Thank you @tshenry this is fantastic news

[Krunnie]

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.

[thegurjyot (Gurjyot Singh)]

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.

[gomezcarsonk (Gomez)]

@tshenry

Maybe this will help?

https://github.com/discourse/discourse-custom-hamburger-links/commit/d7eacfd7019bd48b939ac4b482986061d4207f1femployee time tracking

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

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

[manuel (Manuel Kostka)]

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

Two notes on usage:

• The icon would be the first item in the list:
  
  If you want a link without icon, just don’t add it, but keep the trailing comma ,
  

• If the icon is not included by default, remember to add it to the icon list:
  

[thegurjyot (Gurjyot Singh)]

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.

[AquaL1te]

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

[Canapin (Coin-coin le Canapin)]

Hi!

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

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

[Canapin (Coin-coin le Canapin)]

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?