Use number fields and a list of page properties for the parameters of the page list and tree macros

Several parameters of the macros that list pages take a number or a list of page properties in a plain text field of the Edit Macro dialog, so any text can be typed and a wrong value only shows once the macro renders.

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

• documentTree: DocumentTree.xml.
• documents: DocumentsMacro.xml.
• tree: Tree.xml.

The main problems:

• The numbers are declared as strings: they need an integer type and a minimum, a depth starting at 0 and the other values at 1.
• The columns of documents are page properties typed by hand, with a default that the description gets wrong.

Depends on

Most of these fields cannot be offered before these generic changes, each giving the macro the means to declare the expected value:

• XWIKI-25182, which gives a number input to the parameters of a numeric type.
• XWIKI-25197, which lets a wiki macro parameter declare its minimum and maximum.
• XWIKI-23045, which lets a parameter get its values from a provider, with or without custom values.

KOs covered

Impact found on macro fluidity

These 5 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 and the steps to reproduce. Fixing them means changing the declaration of the parameters in the macro definitions.