Quantcast
Channel: XWiki Forum - Latest topics
Viewing all articles
Browse latest Browse all 1373

Improve the Children macro's default display

$
0
0

Hi devs,

I’d like to propose that we change the behavior of the {{children/}} macro to not display attachments and translations by default . See also Loading...

Example:

The rationale is simple: the children macro’s main use case is to display children pages. Wanting to display attachments and translations is an edge case and thus shouldn’t be the default.

Note that the only place I’ve found where we use that macro in XS is on http://localhost:8080/xwiki/bin/view/XWiki/Notifications (and it’s only used to have something to display on that technical home page).

So yes, it’s a breaking change (hence the proposal) but hopefully for the best.

WDYT?

An alternative is to introduce 2 new macros (and deprecate the {{children}} macro, which is badly named in the end since it could as well display children docs in a table and not as a tree):

  • {{childrenTree}}: display a tree of children documents
  • {{childrenTable}}: display a LD of children documents. Right now the {{documents}} macro is not meant to display children docs, and using the location param is awkward at best (and more complex than it should be).

WDYT?

Related issues:

Thx

6 posts - 4 participants

Read full topic


Viewing all articles
Browse latest Browse all 1373

Trending Articles