I just want to clarify if this behaviour is correct: Renaming a page from the Page Edit Mode doesn’t change its reference. To change the title AND the reference, a page needs to be renamed via Page Menu, Move/Rename.
Is this behaviour wanted?
I think this is weird, and changing the title in the Page Edit Mode should change the reference as well.
In my case my users changes the Title, and then they can’t include pages because the reference is different than the title.
You can only change the title when editing a page, not its reference.
The reference is the location of the page in the page hierarchy and the only way to change the location of a page is to move it. Yes that’s a wanted behavior
We have 2 concepts that we want to keep separate FTM:
page title (used as the title displayed when the page is rendered)
page reference (used in the URL, for SEO, for bookmark, etc)
It’s true than when you create a page, if you don’t click on advanced details, we create a page which has a reference equal to the title that the users enters, for simplicity. Clicking on advanced allows you to have a reference different than the title.
Actually this is the opposite! We don’t break any include or any reference when you change the title so your pages continue to work. If we were to modify the reference, all your includes or links to the page would get broken (except if we do the same as what is done by the move/rename which tries to rename all backlinks but usages in macros are not modified!).
So I don’t understand what you mean by “they can’t include pages because the reference is different than the title.”.
If you are referring to the title and not the page name (but yes the title is often what is displayed, in the document tree for example) then yes it does not have any impact on the page reference and URL. This is not a rename in any way, you just change the display title.
thanks you for your reply, it all makes sense to me.
My problem is, my users don’t want to know how xwiki works, they just want to use it and it should be as simple as possible, one can say “idiot proof”
The typical problem will be:
User 1 creates a page with a Title (= Reference)
User 2 change the Title via Page Edit Mode
User 3 doesn’t know the reference, just the title, and tries to include it by typing the title… and this will just not work.
I think my only solution is to forbid my users to change the title via Page Edit Mode. If they want to change the title, they should do it via Advanced Details, so the title will always be the same as the reference, and User 3 will not be upset
