Published
Wiki source code of Fix the Drawer Menu, Switch to Another Language and Wikis pages
Last modified by Eleni Cojocariu on 2026/08/11 19:33
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Review of [[Drawer Menu>>documentation.xs.user.base.drawer-menu.WebHome]], [[Switch to Another Language>>documentation.xs.user.base.read-wiki-language.WebHome]] and [[Wikis>>documentation.xs.user.base.wikis.WebHome]] against the XWiki sources (##drawer.vm##, ##menus_language.vm##, the six drawer UI extensions and ##XWiki.getLocalePreference##) and a running XWiki 18.6.0, following the Documentation Guide. | ||
| 2 | |||
| 3 | **Wrong information corrected:** | ||
| 4 | |||
| 5 | * **The FAQ of "Switch to Another Language" gave the wrong cause** for seeing a single language. It blamed the administrator for not configuring more supported languages; in fact ##menus_language.vm## builds the list from the translations **of the Page you are on**. Verified on 18.6.0 with two languages configured: a Page with no translation still offers a single "Default Language" entry, so the old answer sent readers to their administrator over a setting that was already correct. | ||
| 6 | * **"Switch to Another Language" claimed to switch //your wiki//.** It switches the language **you** read the wiki in — ##getLocalePreference## stores the choice in a cookie for that browser. Switching the whole wiki is a separate administrator task, now linked from Related links. | ||
| 7 | * **"Drawer Menu" was missing "Administer Wiki"**, contributed to the Drawer by the Administration application (##AdminUIX##, order 20000) for users with administration rights. | ||
| 8 | * **"Drawer Menu" presented the Drawer as a flat list** and put "Log-out" last. The Drawer has three parts: the account header, a part headed by the current Wiki's name, and a "Global" part. The table now follows that structure, and a FAQ entry explains that the Drawer is assembled from the installed extensions and the reader's rights, which is why two readers do not see the same entries. | ||
| 9 | |||
| 10 | **Links leaving the new tree although an equivalent page exists in it:** | ||
| 11 | |||
| 12 | * "Drawer Menu" sent "Switch to another language" to the legacy ##Documentation.UserGuide.Features.I18N## page while its own sibling documents it, and "multilingual wikis" to the same legacy page instead of "Enable (or disable) the Multilingual Setting". | ||
| 13 | * "Wikis" pointed Related links at the legacy "Wiki vs Nested Pages" although [[Wikis vs Nested Pages>>documentation.xs.admin.base.content-organization.wikis-nested-pages.WebHome]] exists in the new tree — and links back to "Wikis". | ||
| 14 | * "Switch to Another Language" pointed Related links at legacy ##Documentation.AdminGuide.Configuration## instead of "Set the Default Language for the Entire Wiki". | ||
| 15 | |||
| 16 | Those three legacy links also carried an ##anchor## parameter that xwiki.org silently drops on same-wiki links, so the reader landed at the top of a long legacy page with no indication of what to look for. The remaining ##extensions:## links keep their anchors, which do survive, because the Wiki Index and wiki creation have no page in the new tree yet. | ||
| 17 | |||
| 18 | **Documentation Guide fixes:** | ||
| 19 | |||
| 20 | * **A result step** closes "Switch to Another Language", which stopped on an action ("Navigate to Pages to see them…"). It now shows the wiki displayed in French. | ||
| 21 | * **The two Drawer screenshots were in a Gallery**, which is for variations of one thing; these are sequential (where to click, then what opens), so they are two ~{~{image}}## macros. They were also inserted with the ##[[image:…]]## link syntax, which carries no ##size##, mandatory in the ##documentation## space. The first one's ##alt## described "the expanded Drawer menu" while the image shows the collapsed top bar.## | ||
| 22 | * **All four screenshots are re-captured on XWiki 18.6.0** at exactly the pixel width of the ##size## they are shown at (650 for ##large##, 350 for ##medium##, 960 for ##extra##); the previous ones were 513, 312 and 335 pixels wide, so they were rescaled by the browser. They are attached to this change request. | ||
| 23 | * Empty FAQ and Related links fields filled on "Drawer Menu"; the "Switch to Another Language" FAQ stays at five entries by folding "What happens after I select a language?" into the new result step, and gains that ##language=default## resets to the wiki default. | ||
| 24 | * A self-anchor link in the "Wikis" intro, whose target was generated from its own FAQ question wording, is dropped — rewording the FAQ would have broken it silently. | ||
| 25 | |||
| 26 | **Left alone, on purpose:** | ||
| 27 | |||
| 28 | * **The Technical IDs**, although unprefixed. On xwiki.org the unprefixed ##org.xwiki.platform:…## form is what resolves: it redirects to the extension page, while the ##xwiki:##-prefixed form does not. | ||
| 29 | * **"Wikis" still has no illustration.** What would help is the Wiki Index on a farm of several wikis, which needs a farm to capture honestly. A PlantUML diagram was considered and rejected: no page on xwiki.org renders that macro and ##Macros.PlantUML## does not exist, so it would have shown an error box. |
