TYPO3: Using URL Alias in HMENU

Question

I have a page tree structure in my TYPO3 project with a page called 'main' which has three subpages. In addition to it's unique pageID I gave the page 'main' a unique URL Alias 'mainalias'.

I can use the alias to add a link to the page 'main' eg in using

<f:link.page pageUid="mainalias">some text</f:link.page>

in a template.html or in TypoScript eg to add a link to an IMAGE with

stdWrap.typolink.parameter = mainalias

But when I use the alias to define the starting point of a HMENU the menu will contain no data (I simply get in empty menu but no error message in the logs):

special = directory
special.value = mainalias

The menu itself works and when in the code above I use the pageID of the page 'main' instead of it's alias 'mainalias' I get a menu with the three subpages as expected.

Can you tell me how to use the URL Alias to define the starting point of a HMENU?

Answer 1

The simplest and most possible answer is: It is not implemented in HMENU to use an alias. :)

Answer 2

Common way to use HMENU is

10 = HMENU
10.special = directory
10.special.value = 35, 56

A alias is not a valid value. But value is from data type stdWrap . This should work:

10 = HMENU
10.special = directory
10.special.stdWrap.typolink.parameter = mainalias

See https://docs.typo3.org/typo3cms/TyposcriptReference/ContentObjects/Hmenu/Index.html#special-directory