This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-61f74264-0372-4925-bbba-28b450fe5f45 XWIKI-25491 Open

Mark the rarely used parameters of the Office and Translation macros as advanced

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-7d87340d-d14e-4347-a048-820460c7ed78 Charpentier Lucas created this issue on 22/Oct/26 11:59
 
Summary: Mark the rarely used parameters of the Office and Translation macros as advanced
Issue Type: cid:jira-generated-image-avatar-61f74264-0372-4925-bbba-28b450fe5f45 Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Localization, Office
Created: 22/Oct/26 11:59
Priority: cid:jira-generated-image-static-major-78809cb0-af67-4d0b-afe2-d868007e3b4c Major
Reporter: Charpentier Lucas
Description:

Rarely used parameters of the Office and Translation macros are shown with the main options of the Edit Macro dialog instead of as advanced parameters.

The macros to change, with the file where most of the fix is done:

KOs covered

Macro Criterion Parameters Problem
office C8 advanced filterStyles Not advanced, while it does not change what the macro does, only how the result is styled, and the calls of XWiki itself keep the default. Every example of the documentation sets it, to false, which the documentation should do less often, see L2.
translation C8 advanced locale Not marked as advanced, although displaying a text in a fixed language is rare: no XWiki page sets it, only one example of the documentation.
translation C8 advanced scriptParameters Not marked as advanced, although it only works inside a script macro and needs script right: it is for developers writing sheets.

Impact found on macro fluidity

These 3 KOs come from the WYSIWYG usability audit of the macros, under the criteria C8 advanced of its usability criteria. The page of each macro, linked in the table, has the full notes and the steps to reproduce. Fixing them means changing the parameter declarations of the macros: their groups, order, default values, mandatory and advanced flags.