Differences

This shows you the differences between two versions of the page.

--- plugin:changes [2017-04-19 23:50] – version upped andi
+++ plugin:changes [2024-02-06 08:06] (current) – [Output renderer] Aleksandr
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: List the most recent changes of the wiki
+description: List the most recently changed pages and media-files of the wiki
 author     : Andreas Gohr
 email      : dokuwiki@cosmocode.de
 type       : syntax
-lastupdate : 2017-04-15
+lastupdate : 2023-12-14
-compatible : 2008-05-05, Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky,Ponder Stibbons, Hrun, Detrius, Elenor Of Tsort
+compatible : Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum
 depends    :
 conflicts  :
@@ Line 18: / Line 18: @@
 ----
-This plugin allows you to embed a list of recent changes as a simple list into any page.
+This plugin allows you to embed the list of recent changes as a simple list into any page.
 ===== Download and Installation =====
-[[http://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
+[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
 Download and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
@@ Line 33: / Line 34: @@
 Optionally you can specify a number of parameters that control the scope of the shown changes and the way the list is rendered.
-==== Whitelist/blacklist by namespace ====
+:!: The plugin always displays only the most recent change for every page / media file!
+==== Allowlist/blocklist by namespace ====
 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:
@@ Line 45: / Line 48: @@
 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.
+You can also exclude specific pages:
+  {{changes>foo&excludedpages=bar}}
 ==== Number of changes displayed ====
@@ Line 60: / Line 66: @@
   {{changes>type = edit, minor}}
+==== Allowlist/blocklist changes by user ====
-==== Whitelist/blacklist changes by user ====
 To show only changes by particular users, the ''user'' parameter takes a comma-separated list of usernames:
@@ Line 73: / Line 79: @@
 ==== Maximum age of change displayed ====
-Filtering by age is possible, too. Just specify the maximum age in seconds (or configure a default in the config).
+Filtering by age is possible, too. Just specify the maximum age in seconds. However, please note that this plugin can not display changes older than [[config:recent_days]].
   {{changes>maxage = 500}}
 ==== Output renderer ====
 The changes can be rendered either as a simple list (default) or using [[:plugin:pagelist|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:
@@ Line 83: / Line 91: @@
   {{changes>render = pagelist}}
-The renderers can have extra parameters (a.k.a. flags), which can be passed within parenthesis as a comma-separated list:
+The renderers can have extra parameters (a.k.a. [[plugin:pagelist#flags]]), which can be passed within parenthesis as a comma-separated list:
   {{changes>render = list(signature)}}
@@ Line 114: / Line 122: @@
 ==== Username fallback ====
-The plugin attempts to describe the user who made each change in the most useful way:
+The plugin attempts to describe the user who made each change in the following order:
   - If possible, the descriptive username is displayed, e.g. ''Joanna Schmidt''
-  - If descriptive username is unavailable((Under certain circumstances, some auth methods may be unable to provide descriptive username)), login ID is displayed, e.g. ''joanna.schmidt''
+  - If descriptive username is unavailable((Under certain circumstances, some auth methods may be unable to provide descriptive username. For instance, authentication against a corporate AD server, where the AD server may return minimal details, and this is outside the control of the wiki administrator.)), login ID is displayed, e.g. ''joanna.schmidt''
   - If no user information is provided to the Changes plugin by auth, the IP address the change was made from is displayed. This will likely be the case for an anonymous edit.
@@ Line 130: / Line 139: @@
 Please report issues in the bug tracker at https://github.com/cosmocode/changes/issues