This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-de03c83a-5936-46be-b818-670090a65c1a XWIKI-25511 Open

Provide a tag picker for macro parameters

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-6aa232b3-e8b5-4ca8-a328-25843c736241 Charpentier Lucas created this issue on 22/Oct/26 16:55
 
Summary: Provide a tag picker for macro parameters
Issue Type: cid:jira-generated-image-avatar-de03c83a-5936-46be-b818-670090a65c1a Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Display, Tag
Created: 22/Oct/26 16:55
Priority: cid:jira-generated-image-static-major-7cd8dc35-fb7b-45bf-a0ff-5da6f2325e9e Major
Reporter: Charpentier Lucas
Description:

Some macros take a list of tags, and the Edit Macro dialog shows it as a plain text field: the user has to type each tag exactly, case included, and a tag that no page carries is accepted silently. The tags of a page are already entered with suggestions of the existing tags, but no displayer offers them to a macro parameter.

Where it is needed

Macro Parameter Value Ticket
activity tags tags, several values none
notifications tags tags, several values XWIKI-23834

Proposal

  • Add a Tag type, with its converter, so that the macro editor can tell a list of tags apart from a plain list of strings.
  • Add a #tagPicker Velocity macro, which suggests the existing tags and takes several values, and an HTML displayer edit template for List<Tag> that uses it.
  • Declare List<Tag> as the type of the two parameters above, so that the Edit Macro dialog shows the picker, and turn the typed value back into the comma-separated list that the macro expects.

An implementation is proposed in PR #5999 of XWIKI-23834, for the notifications macro. The activity macro would then only need the type of its parameter.

Impact found on macro fluidity

These 2 KOs come from the WYSIWYG usability audit of the macros, under the criterion C4 input-assistance of its usability criteria. The page of each macro, linked in the table, has the full notes.