This is an old revision of the document!
Table of Contents
Changes Plugin
Compatible with DokuWiki
2008-05-05, Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky,Ponder Stibbons, Hrun, Detrius
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to querychangelog, recent
Needed for flat, tr-twitter
This plugin allows you to embed a list of recent changes as a simple list into any page.
Download and Installation
Download and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Syntax and Usage
The list is created using the following syntax:
{{changes>}}
Optionally you can specify a number of parameters that control the scope of the shown changes and the way the list is rendered. By default plugin shows the changes in the entire wiki. To restrict the list of changes to a given namespace and its sub-namespaces you can specify its name either directly or using ns
parameter:
{{changes>foo}} {{changes>ns=foo}}
The ns
parameter supports both inclusion and exclusion of the namespaces. If a namespace name starts with a minus sign that namespace will be excluded. Also you can assign a number of namespaces as a comma separated list:
{{changes>ns = -foo}} {{changes>ns = foo, bar, -bar:baz}}
The first example will show the changes in all namespaces except of “foo”, the second one will include “foo” and “bar” namespaces except of “bar:baz” sub-namespace.
The number of changes that are presented in the list is controlled with count
parameter (defaults to 10). The count can also be specified as just a number:
{{changes>15}} {{changes>count=15}}
It is also possible to control the type of changes shown in the list. By default all types are shown but with type
parameter you can restrict the shown changes to a given type. The supported types are create
, edit
, minor
and delete
. Multiple types can be specified separated by a comma:
{{changes>type = create}} {{changes>type = edit, minor}}
You can also filter by user. Multiple users are also separated by comma:
{{changes>user = rauschen}} {{changes>user = rauschen, andi}}
Filtering by age is possible, too. Just specify the maximum age in seconds (or configure a default in the config).
{{changes>maxage = 500}}
The changes can be rendered either as a simple list (default) or using Pagelist plugin. You have to install the Pagelist plugin separately, if it's not available the simple list is used instead. The renderer is selected with the “render” parameter:
{{changes>render = list}} {{changes>render = pagelist}}
The renderers can have extra parameters (a.k.a. flags), which can be passed within parenthesis as a comma-separated list:
{{changes>render = list(signature)}} {{changes>render = pagelist(header, nouser)}} {{changes>ns = foo, bar, -bar:baz&render = pagelist}} {{changes>type = create&render = list(dayheaders, signature, nocomments, nouser)}}
The built-in list renderer supports the following parameters:
summary
,nosummary
— show/hide the change summary.signature
,nosignature
— show/hide user name and time of the change.dayheaders
— Group changes by a heading (date of the change).nocomments
— desable show nr. of comments if you have Discussion plugin.nouser
— do not show user column in the list.nodesc
— nodescription (if you have Pagelist plugin)
By default only the summary is shown. For the list of parameters supported by Pagelist plugin refer to its documentation.
If you want to pass a number of parameters to the plugin they should be separated with an ampersand, for example:
{{changes>foo&15&type=create&user=rauschen}}
The above syntax would display the last 15 pages created by user rauschen inside the “foo” namespace.
Note: The plugin respects ACL permissions but output is cached with the page it is in until a new change was made. If you're listing ACL dependent changes use the ~~NOCACHE~~ macro in the page you're using this plugin.
Development
A public git repository is available at https://github.com/cosmocode/changes
Changelog
- Version upped (2023-12-14 23:50)
- fix cache handling. fix #71 (2023-12-14 10:41)
- replace deprecated function calls, adjust signatures (2023-12-14 10:31)
- automatic code style fixes (2023-12-14 10:17)
- added default files (2023-12-14 10:16)
- Merge pull request #70 from dokuwiki-translate/lang_update_606_168011… (2023-04-12 08:54)
- translation update (2023-03-29 20:35)
- Merge pull request #69 from dokuwiki-translate/lang_update_548_167458… (2023-01-24 19:28)
Bugs and feature request
Please report issues in the bug tracker at https://github.com/cosmocode/changes/issues