[[PageOutline(2-5,Contents,pullout)]]

= Show last modification date of wiki page

== Description

Shows the last modification date of the specified page, or the page the macro appears in if not specified. An optional argument, {{{delta}}}, can be given to show the time elapsed since the last modification. The output is placed in a {{{<span>}}} with a title that gives the exact modification date and the author of the change.

This plugin retrieves information from the database and adds it to a wiki page. Currently supported keywords: `author`, `version`, `changed_by`, `comment`, `changed_ts`.

== Bugs/Feature Requests

Existing bugs and feature requests for LastModifiedMacro are 
[report:9?COMPONENT=LastModifiedMacro here].

If you have any issues, create a 
[/newticket?component=LastModifiedMacro new ticket]. 

[[TicketQuery(component=LastModifiedMacro&group=type,format=progress)]]

== Download

Download the zipped source from [download:lastmodifiedmacro here].

== Source

You can check out LastModifiedMacro from [http://trac-hacks.org/svn/lastmodifiedmacro here] using Subversion, or [source:lastmodifiedmacro browse the source] with Trac.

== Example

Basic usage:
{{{
[[LastModified]]
[[LastModified(delta)]]
[[LastModified(MacroBazaar)]]
[[LastModified(MacroBazaar,delta)]]
}}}

For example, {{{ [[LastModified(CustomMacros)]] }}} produces:
{{{
<span class="last-modified" title="Wed Oct  6
    20:34:51 2004 by username">2004-10-06</span>
}}}

Alternatively, {{{ [[LastModified(CustomMacros,delta)]] }}} produces:
{{{
<span class="last-modified" title="Wed Oct  6
    20:34:51 2004 by username">7 weeks</span>
}}}

This is a CSS style to apply that will make it about 3.14% slicker:
{{{
span.last-modified
{
    border-bottom: 1px dotted gray;
    cursor: help;
}
}}}

Building off the above style, I did the following to match the colour of the [wiki:TocMacro].
(To apply this to all projects, append the below text to this file: /usr/share/trac/htdocs/css/wiki.css)
{{{
/* Styles for the LastModified wikimacro */
span.last-modified
{
    border-bottom: 1px dotted gray;
    border-top: 1px dotted gray;
    background: #FFFFDD;
    cursor: help;
}
}}}

== Recent Changes

[[ChangeLog(lastmodifiedmacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:HorsePunchKid] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' Nathan Kidd, Bill Coffman [[BR]]