This issue has been created
 
 
XWiki Platform / cid:jira-generated-image-avatar-32cf7bff-4df4-499b-a612-c3751b394a8f XWIKI-25480 Open

Mark the rarely used parameters of the Async and Cache macros as advanced

 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-00984c18-0063-409e-8e01-cc9d46388c34 Charpentier Lucas created this issue on 22/Oct/26 11:58
 
Summary: Mark the rarely used parameters of the Async and Cache macros as advanced
Issue Type: cid:jira-generated-image-avatar-32cf7bff-4df4-499b-a612-c3751b394a8f Improvement
Affects Versions: 17.10.14, 18.8.0
Assignee: Unassigned
Components: Rendering - Async, Rendering - Cache Macro
Created: 22/Oct/26 11:58
Priority: cid:jira-generated-image-static-major-79c65a5e-da9b-4bfd-a37c-06f32507852a Major
Reporter: Charpentier Lucas
Description:

Two rarely used parameters of the Async and Cache 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
async C8 advanced id The parameter shares one cached result between several pages, a rare need, and no call of the macro in XWiki Standard sets it, but it is shown with the main options instead of as an advanced parameter.
cache C8 advanced maxEntries No example of the documentation sets it, and the cache it sizes is shared by every call with the same time to live and the same size, so it is a rare tuning, shown with the main options instead of as an advanced parameter.

Impact found on macro fluidity

These 2 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.