This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-dea9c358-1b25-4a78-8a99-e2174e285ca2 XWIKI-25488 Open

Reorganize the Edit Macro dialog of the mention and useravatar macros

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-6ed61074-682d-40b4-9146-81fee2f0a50b Charpentier Lucas created this issue on 22/Oct/26 11:59
 
Summary: Reorganize the Edit Macro dialog of the mention and useravatar macros
Issue Type: cid:jira-generated-image-avatar-dea9c358-1b25-4a78-8a99-e2174e285ca2 Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Mentions, User
Created: 22/Oct/26 11:59
Priority: cid:jira-generated-image-static-major-9f194487-dd09-4fd2-93e3-d74b37200a0f Major
Reporter: Charpentier Lucas
Description:

The Edit Macro dialog of the mention and useravatar macros opens fields empty without showing the default they stand for, and shows the generated anchor and the type of mention with the main options.

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

KOs covered

Macro Criterion Parameters Problem
mention C3 defaults anchor The field opens empty, and the examples set a different value for each mention, like xwiki-XWiki.Admin-123456, so no single default exists. The dedicated "Mention" entry generates one, like XWiki-Admin-quqyis, which the dialog could preselect. An empty anchor gives the id $escapetool.xml($anchor) unexpanded, see E2.
mention C8 advanced anchor Set in the most common example, but a value that the editor generates and that users do not choose, so rarely edited and not marked as advanced.
mention C3 defaults type The field opens empty, which stands for "user", the value of every use in XWiki Standard. Nothing in the dialog shows it.
mention C8 advanced type Not advanced, while its only value in XWiki Standard is the default one and extensions are the only reason to change it.
useravatar C3 defaults height The field opens empty, which stands for the height of the uploaded picture, a value the dialog does not show and that depends on each user's upload: an avatar of 300 by 200 pixels shows at that size. Every use sets a size, 40 in the documentation examples and a width of 100 in the release sheet of XWiki Standard, but no single value is used in most cases.
useravatar C3 defaults width The field opens empty, which stands for the width of the uploaded picture, a value the dialog does not show and that depends on each user's upload: an avatar of 300 by 200 pixels shows at that size. Every use sets a size, 40 in the documentation examples and a width of 100 in the release sheet of XWiki Standard, but no single value is used in most cases.

Impact found on macro fluidity

These 6 KOs come from the WYSIWYG usability audit of the macros, under the criteria C3 defaults, 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.