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: GitHub - nolosb/discourse-custom-hamburger-links-with-icons

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]

Seria bom ter isso mesclado com o plugin oficial. Quero adicionar botões de mídia social no menu hambúrguer. Mas sem ícones, não ficaria tão bom.

Além disso, não está muito claro que não é permitido espaço nos campos CSV.
Isso funciona: Footer Link,https://google.com,f
Mas com espaços, o item é inserido no campo geral em vez do rodapé, por causa da falta de espaço: Footer Link, https://google.com, f

[Canapin (Coin-coin le Canapin)]

Olá!

Com a nova barra lateral, a capacidade de adicionar ícones personalizados aos nossos links seria uma adição interessante.

Posso tentar trabalhar nisso e fazer um PR nos próximos dias…

[Canapin (Coin-coin le Canapin)]

Pergunta rápida…

Instalei o componente de tema em uma nova instância do Discourse, mas por um motivo não identificado, os links padrão não aparecem na seção mais da barra lateral:

Não modifiquei o código, é uma instalação nova do componente de tema.

No entanto, o componente de tema, instalado há dois anos, funciona em meu outro fórum:

Nenhum erro é exibido. Alguma ideia do porquê o componente de tema não funciona em minha nova instalação?