HomeWiki source code of RecentlyUpdated
Last modified by Ryan C on 2025/03/07 00:46
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | The recently-updated macro is a bridge between Confluence and XWiki. It displays the most recent contributions to the wiki, relative to documents, attachments and comments. | ||
| 2 | |||
| 3 | There are only a few things that are not supported compared to the Confluence macro, due to differences between the two: | ||
| 4 | * some special values of the {{{ spaces }}} parameters are not supported: {{{ @personal }}}, {{{ @favorite }}} / {{{ @favourite }}}, and personal spaces starting with a "~~" | ||
| 5 | |||
| 6 | = Parameters = | ||
| 7 | |||
| 8 | |=Parameter|=Description|=Required|=Default | ||
| 9 | |**types**|Select one or multiple content types. The macro will display only the content of the type you specify here.|No|//all types// | ||
| 10 | |**spaces**|Select one or multiple spaces. The macro will display only the documents present in the selected spaces.|No|{{{@self}}} | ||
| 11 | |**author**|Comma-separated list of authors.|No| | ||
| 12 | |**labels**|Comma-separated list of tags.|No| | ||
| 13 | |**excludedLabels**|Comma-separated list of tags.|No| | ||
| 14 | |**max**|Maximum number of results.|No| {{{ 15 }}} | ||
| 15 | |**theme**|Appearance of the macro ({{{ concise }}}, {{{ social }}}, {{{ sidebar }}}).|No| {{{ concise }}} | ||
| 16 | |**width**|Width of the macro in percentage.|No| {{{ 100% }}} | ||
| 17 | |**hideHeading**|Whether to hide the text "Recently Updated" as title|No| {{{ false }}} | ||
| 18 | |**showProfilePic**|Whether to show the profile picture of users|No| {{{ false }}} | ||
| 19 | |**currentWiki**|If this parameter is selected then the spaces & excluded spaces parameters are ignored and the macro will display the documents from the current wiki.|No| {{{ false}}} | ||
| 20 | |**excludedSpaces**|Select one or multiple spaces. The macro will not display the documents present in the selected spaces.|No| | ||
| 21 | |**global**|If this parameter is selected then spaces, excluded spaces and the current wiki parameters are ignored and the macro will display the documents from the current wiki and subwikis. |No| {{{ false}}} | ||
| 22 | |||
| 23 | = Example Usage = | ||
| 24 | |||
| 25 | {{code}} | ||
| 26 | {{recently-updated | ||
| 27 | spaces="@global" | ||
| 28 | theme="concise" | ||
| 29 | max="5" | ||
| 30 | /}} | ||
| 31 | {{/code}} | ||
| 32 | |||
| 33 | {{recently-updated | ||
| 34 | spaces="@global" | ||
| 35 | theme="concise" | ||
| 36 | max="5" | ||
| 37 | /}} | ||
| 38 | |||
| 39 | == TODO == | ||
| 40 | * add button to fetch more results | ||
| 41 | * test more thoroughly on subwikis |