This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-ad5278af-d3db-4593-b4e5-b2ecca6dd1d0 XWIKI-25510 Open

Provide a wiki picker for macro parameters

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-bb1f0d6e-92ef-4ec6-a589-ee5b1b2dd965 Charpentier Lucas created this issue on 22/Oct/26 16:55
 
Summary: Provide a wiki picker for macro parameters
Issue Type: cid:jira-generated-image-avatar-ad5278af-d3db-4593-b4e5-b2ecca6dd1d0 Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Display, Wiki
Created: 22/Oct/26 16:55
Priority: cid:jira-generated-image-static-major-76ea6880-e9d4-4d2c-8d3d-b494663f7df2 Major
Reporter: Charpentier Lucas
Description:

Some macros take a list of wikis, and the Edit Macro dialog shows it as a plain text field: the user has to know the identifier of each wiki, which the UI rarely shows, and a typo is accepted silently. XWiki has pickers for a page, an attachment and a user, but none for a wiki.

Where it is needed

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

Proposal

  • Add a #wikiPicker Velocity macro, which suggests the wikis of the farm and takes several values, and an HTML displayer edit template for List<WikiReference> that uses it.
  • Declare List<WikiReference> 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.