CreditsBlock

Summary: Create a "last edited by" block that includes everybody who had a hand in developing a page
Version: 0.3 - 3 January 2005
Prerequisites: last tested with PmWiki 2.0.beta14
Status:
Discussion: CreditsBlock-Talk
Categories: Administration

Purpose

What I would like to see is a "last edited by" block that includes everybody who had a hand in developing the page. It would be nice to show who originally started the page. Maybe add a block of text to PmWiki pages showing the last editor and all previous editors, such as:

Last edited by AliceFakename. Based on work by BobNotaperson, CharlieDoesntexist and anonymous users of SomeWiki.

Solution

v0.3

v0.2

Credits Block is a script that provides a customizable block that can include only the last author, or every contributer who had a hand in a page. This script creates a variable $CreditBlock that can be used in Cookbook/PmWikiTemplates. The configuration variables below help customize the credits block.

This useful script was originally developed for the PmWiki 1.0 series. Version 0.3 was coded and tested using PmWiki 2.0.beta14.

Installation Instructions

To install the software, unpack the zip file, and copy its contents to your pmwiki directory:

  1. unzip pmwiki-credits-0.3.zip (or) tar xvfz pmwiki-credits-0.3.tar.gz
  2. cp -R pmwiki-credits-0.3/* /path/to/pmwiki/
  3. Activate this script by adding the following line to your local/config.php file:
include_once('cookbook/credits.php');

This will create a variable, $CreditBlock, that you can put into your PmWiki templates however you like. I put mine at the bottom at the page, right after the "last edited" stuff.

Configuration Variables:

This module uses the following configuration variables:

$CreditAnd (Default "and ")
This provides the conjunction to join the last contributer to the "CreditOthersFormat" list.
$CreditAnonymous (Default "an anonymous user of $WikiTitle")
A string meaning a single anonymous user.
$CreditAnonymousPlural (Default "anonymous users of $WikiTitle")
A string meaning a multiple anonymous users.
$CreditAuthorLinks (Default 1)
Determines if the author name links to the author page
  • 0 -- no link
  • 1 -- link
$CreditComma (Default
", "): The mortar that joins the contributers in the "CreditOthersFormat" list.
$CreditFirstFmt (Default "Originally by \$first.")
A pattern for the credit block, showing the original person to edit the page. The substitution variable "$first" shows where to put the name.
$CreditLangauge (Default "EN")
The two-letter language code (based on ISO 639-2) for the target language. When used with the language.php file, allows for more flexible joining of names for the other contributers.
$CreditLastFmt (Default "Last edited by \$last.")
A pattern for the credit block, showing the last person to edit the page. The substitution variable "$last" shows where to put the name.
$CreditLimit (Default 2)
Maximum number of credits to list. And, yes, it's a pun.
  • 0 -- omit the credit block
  • 1 -- Show the original author and the latest editor only
  • 2 -- Show all contributers.
$CreditOthersFormat (Defaults "Based on work by \$others.")
A pattern for the credit block, showing the other people who've edited the page. The substitution variable "$others" shows where to put the list of other contributors.

Packing List

This list is incorrect - there are two credits.php files in the downloaded arvive: one at the root of the archive and one in cookbook. The copy in the cookbook directory has a bug. See Bugs below.

pmwiki-credits-0.3/
COPYING.credits
README.credits
cookbook/
credits.php
credits/
language.php
wikilib.d/
CreditBlock.HomePage

History

2004 May 28 -- 0.1.
First version, probably pretty buggy.
2004 July 20 -- 0.2.
Change to comply with the ComplexRecipes layout.
2005 January 3 --0.3
Recoded.
  1. Added ability to have the credit block provide links to the profile pages for each contributer.
  2. Will space names in accordance with SpaceWikiWords
  3. Added "language.php" that allows user to define the language for the other contributers listing. Presently there is only English (EN), Esperanto (EO), and German (DE). If you add a language, please share.

Contributors

Comments

See discussion at CreditsBlock-Talk

Copyright

Copyright 2004, Evan Prodromou. Made available to you through the General Public License (GPL), which is in the zip file.

User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.