<br />
<a href="http://www.adaptavist.com/display/Plugins/Try+or+Buy" border="0"><img src="http://www.adaptavist.com/download/attachments/36012320/freeTrial.png" alt="Our plugins can be trialled for free, no credit card details required" />
<br /><br />
<a href="http://twitter.com/weloveplugins" target="_new" border="0"><img src="http://www.adaptavist.com/download/attachments/36012320/followPlugins.png" alt="For updates on Plugins, follow @weloveplugins" />
<br /><br />
<a href="http://twitter.com/share" class="twitter-share-button" data-url="http://www.adaptavist.com/display/Plugins/Page+Information" data-text="Check out the Page Information plugin for Atlassian's #Confluence by @adaptavist" data-count="vertical" data-via="weloveplugins">Tweet</a><script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> <iframe src="http://www.facebook.com/plugins/like.php?href=http%3A%2F%2Fwww.adaptavist.com/display/Plugins/Page+Information&layout=box_count&show_faces=false&width=50&action=like&font=arial&colorscheme=light&height=65" scrolling="no" frameborder="0" style="border:none; overflow:hidden; width:50px; height:65px; position: relative; top: 4px;" allowTransparency="true"></iframe>
</a>
This plugin puts a page under the microscope and displays various information such as version history, participants lists, labels and more.
Information that's usually hidden away, or placed somewhere you don't want it to be, can be made more visible or removed - this is particularly useful when working with custom themes (such as Theme Builder) or when working with formal documents (such as contracts, specifications, etc).
The Page Information Tools plugin displays various information about wiki pages (also works on blog posts):
Author(s) Display name of page author and/or editors. Commentators List everyone who has commented on a page. Participants List everyone who's been involved with a page. Dates Display dates of creation, last edit, etc. Versions Current version, all versions, revision tables. Diffs Display links to "diffs" showing changes between versions. Title & ID Display page title or database ID. Tiny URL Display hyperlinked TinyURL for pages.
The default "displaytype" parameter is the name of the piece of information you wish to see displayed, this may be one of the following:
created-user - displays the user who created the page
created-date - displays the date the page was created
modified-user - displays the user who last modified the page
modified-users - displays a comma separated list of all the users who have modified the page
modified-date - displays the date the page was last modified
participants - displays a comma separated list of the users who have modified or commented on the page
commenters - displays a comma separated list of the users who have commented on the page
current-version - displays the most recent version number for the page
versions - displays a comma separated list of version numbers, clickable to take you to view that version
diffs - displays a comma separated list of version numbers, clickable to take you to view the differences between that version and the next version
labels - displays a comma separated list of labels, clickable to allow you to view other pages which posess that label
tinyurl - displays a tinyurl link to the specified page
title - displays the title of the specified page
pageId - displays the Id of the current page
page
current page
The name of the page whose information you wish to display, if none is given then the current page is assumed. You can also use @self to refer to the current page and @parent to use the parent page.
dateFormat
Default Date Format
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].
type
flat
For those display types that produce a list of information, you can specify:
flat - display a comma separeated list (default)
list - display a bullet list
prefix
When displaying a version numbers you may use this parameter to insert a prefix before the version number. Has no effect with those display types which do not display a version number.
reverse
false
When displaying a list of items, you can set this parameter to true to reverse the order of those items.
count
show all
If you want to limit the number of items shown in a list (eg. versions and diffs) define the number of items to be shown with this parameter.
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 you to override the format used to display dates. Details of the pattern syntax may be found [Date Formats]. If omitted, the date format defined in Confluence General Configuration will be used.
reverse
Whether to reverse the list (sorted in revision order)
Displaying the date that the current page was last modified
{page-info:modified-date}
Which looks like:
Mar 31, 2011 13:22
Displaying last modifier and modification date
This page was modified by {page-info:modified-user} on {page-info:modified-date}
Which looks like:
This page was modified by Gareth Wilson on Mar 31, 2011 13:22
Formatting dates
By default, dates and times are shown using the format defined in Confluence's [General Configuration]. However, you can alter this format by using the [Date Formats] syntax as shown in some of the examples below:
It may at some time be useful to be able to display a list of all of the labels present on the page, this may be achieved using the labels display type
On occasion it may also be useful to specify a different page to the current one to be the page whose information is being displayed:
{page-info:participants|page=Home}
page-info: unable to locate page
This page parameter may be set to @parent which refers to the parent of the current page. For example, you can display a link to the parent page with the "tinyurl" setting like this:
{page-info:tinyurl|page=@parent}
page-info: unable to locate page
Showing Edits and the accompanying comment
You can use the showComment parameter to list the comment along with edit like this.
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.
At times it may be useful to display the version history for a different page
{version-history:page=Home|first=3|reverse=true}
The following table details the three most recent revisions made to the Home page in this space
version-history: unable to locate page
Setting the date format
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].
Adaptavist are global experts in consultancy, plugin development, training, support services and Enterprise solutions for Atlassian's Confluence, JIRA and Dev Tools.
We're a Platinum Expert whose creations have been included in Confluence itself. With 6 years experience, we've helped over 5000 customers to integrate and collaborate, including over half of the Fortune 50.
Try for Free
You can try our Plugin Packs for free, no credit card required. Then keep the essentials pack for free too!
You are viewing an old version (v. 11) of this page.
