The {version-history} macro allows you to display a table detailing the changes that have been made to the page...
Although this information is already available elsewhere, it is often useful to display it on the page itself. The macro is ideal for formal documentation as it allows you to quickly add a self-updating version history of the page that will be present in printouts. Furthermore, the table displays edit comments alognside each version.
The name of the page whose version history you wish to display, if none is given then the current page is assumed. (@self and @parent are also valid)
dateFormat
Allows setting the display format for the date and time displayed, when do dat is to be displayed this parameter has no effect. Details of the pattern syntax may be found Date Formats
reverse
Whether to reverse the list (sorted in revision order)
first
Only display the first x entries
This plug-in is available without cost for both commercial and non-commercial purposes. However, if you have found it to be useful, particularly within a commercial environment, please consider making a donation to the author. This will encourage continued development of this and other plug-ins, as well as speeding up the response for your latest maintenance request.
If you wish to donate, it can be done easily with a credit card or bank transfer using PayPal. No account sign-up is required for credit or debit card payments.
On pages that are frequently edited there may be far too many entries in the version history to conveniently display all of them, you can limit the number of entries displayed using the first parameter
{version-history:first=3}
Which produces a table containing limited to displaying three entries
By default the versions listed are sorted into oldest to newest version (first revision to most recent revision), often you may wish to reverse this order, especially when using the first parameter since this can give you a list of the most recent changes to a page
{version-history:first=3|reverse=true}
Which displays a table containing the three most recent modifications to their page.
You may also wish to set the format that the date appears in, this can be done using the format parameter. Details of the syntax for the format definition can be found Date Formats.
this is a great plugin.. we are using it now... one of the things that we are hearing is that it would be great to provide a method where a link to a rev (rev 1 in our case) to some text.. i.e.:
where you could have text such as..
"View Rev. 1" and have that text link to the first rev..
Added by
comment from
sruiz at redredesign dot com:
this is a great plugin.. we are using it now... one of the things that we are hearing is that it would be great to provide a method where a link to a rev (rev 1 in our case) to some text.. i.e.:
where you could have text such as..
"View Rev. 1" and have that text link to the first rev..
thanks for all your great work...
A useful feature would be to only show one revision per day - because otherwise the table becomes huge when there are several saves per day.