This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-ae765e51-9016-4721-8ce6-b4973ff11e66 XWIKI-25478 Open

Make the name parameter of the Template macro mandatory

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-560e40a2-8c7e-4d34-b338-c27eabc7d186 Charpentier Lucas created this issue on 22/Oct/26 11:58
 
Summary: Make the name parameter of the Template macro mandatory
Issue Type: cid:jira-generated-image-avatar-ae765e51-9016-4721-8ce6-b4973ff11e66 Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Template API
Created: 22/Oct/26 11:58
Priority: cid:jira-generated-image-static-major-c7aef689-2c6e-406d-9e23-2fe37de76dbf Major
Reporter: Charpentier Lucas
Description:

The name parameter of the Template macro is optional in its descriptor, but the macro renders nothing without it, with no message.

KOs covered

Macro Criterion Parameters Problem
template C2 mandatory name Not mandatory in the descriptor, but nothing works without it: no name renders nothing, with no message, and the legacy documentation says it is mandatory. No default would work for the example, so it should be mandatory; the dialog then refuses an empty value, and Quick Actions opens the dialog as for include and uiextension, which also fixes I2. Reproduce: Quick Actions, Template inserts {{template/}}.

Impact found on macro fluidity

These 1 KOs come from the WYSIWYG usability audit of the macros, under the criteria C2 mandatory 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.