Also, should I report this as a bug, because the CMS UI reports a link that does not actually work? Where is the exact, technical documentation for the configuration settings I mentioned above?
If you want to access your items in the style like /test, /fr/test etc you need quite opposite settings: umbracoHideTopLevelNodeFromPath = false, useDomainPrefixes = false (actually, afaik, both are default).
Your current settings suggest that nodes are accessible by URLs like www.yourdomain.com/, fr.yourdomain.com/, de.yourdomain.com/ and so on.
I haven't seen them in some sort of official documentation in existance (i.e. wiki), but in general it can be discovered in the source code and actually can be guessed from the names as well.
As far as I understand (probably there's someone who has better knowledge on it and can correct me if i'm wrong) these settings control how node URLs are generated (for instance with niceUrl(...)):
It's a lot of work to have to look in the source to understand these options, although I now do have a working copy here (and even fixed a bug in the URL generation).
Two problems I faced for understanding these options were:
Though the names mau be clear, it's not clear where Umbraco uses these options. Generating a URL is different than routing a request. So while your explanation focusses on generating URLs, I encountered problems when requestin pages (page not found). So I think these settings also influence the xpath queries used for routing requests to pages.
Combining these two options gives strange results. With both set to true the first node doesn't use the top level node in URLs, but any extra root node do.
Page not found, but why does the xpath query skip one level of nodes?
I have multiple root nodes like this:
If you want to access your items in the style like /test, /fr/test etc you need quite opposite settings: umbracoHideTopLevelNodeFromPath = false, useDomainPrefixes = false (actually, afaik, both are default).
Your current settings suggest that nodes are accessible by URLs like www.yourdomain.com/, fr.yourdomain.com/, de.yourdomain.com/ and so on.
I'm confused. Where are these settings described?
I haven't seen them in some sort of official documentation in existance (i.e. wiki), but in general it can be discovered in the source code and actually can be guessed from the names as well.
As far as I understand (probably there's someone who has better knowledge on it and can correct me if i'm wrong) these settings control how node URLs are generated (for instance with niceUrl(...)):
1) umbracoHideTopLevelNodeFromPath ( = true/false)
If you have such a structure, for example:
Home
Contact
About
then the relative URLs in one case (true) will be /, /contact.aspx, /about.aspx (or /, /contact, /about if you turn 'folder urls' on)
and in the other case (false): /home.aspx, /home/contact.aspx, /home/about.aspx
2) useDomainPrefixes (= true/false)
means whether a domain will be added to the url, i.e. www.mydomain.com/about.aspx vs /about.aspx and so on.
Cool, thanks for the info.
It's a lot of work to have to look in the source to understand these options, although I now do have a working copy here (and even fixed a bug in the URL generation).
Two problems I faced for understanding these options were:
So I think these settings also influence the xpath queries used for routing requests to pages.
is working on a reply...