Offer pickers for the reference, root, openTo and exclusions of the tree macro

The tree macro shows either a static tree, written as a bulleted list in its content, or a dynamic tree, loaded from the page or the URL set in its reference parameter. Its reference, root, openTo and exclusions are plain text fields of the Edit Macro dialog: the user has to type a page reference, or a URL with the path: prefix that only the documentation gives, and node ids whose format depends on the source of the tree, like document:xwiki:Main.WebHome for a tree of pages.

The parameters are declared in Tree.xml.

The main problems:

• The reference is a page or a URL that provides the tree, not a node: it needs a page picker that also accepts a path: URL.
• The root, openTo and exclusions are nodes of the tree that the reference provides, so a node picker has to load that tree, which depends on the value of the reference field. A format that changes with the use case also hints that the static and dynamic trees could be two macros.

Depends on

• XWIKI-25565, which provides the tree node picker, taking several values.
• XWIKI-25180, which lets a parameter depend on another one, here the nodes on the source of the tree.

KOs covered

Impact found on macro fluidity

These 4 KOs come from the WYSIWYG usability audit of the macros, under the criterion C4 input-assistance of its usability criteria. The page of the macro, linked in the table, has the full notes. Fixing them means declaring the types of the parameters in the macro definition, once the tickets above provide the pickers.