• View
• Edit
• History
• Attach
• Print
• Backlinks

MoreCustomPageVariables

Questions answered by this recipe

• How to print the current date?
• How to include a page or a section depending on the current date? For example
  • (:include Birthdays.{$CurrentMonthName}#{$CurrentDay}:)
  • or (:include ToDo.{$CurrentWeek}:)
  • or [[Blog.{$Today} | Today's articles]]

Description

You can add to a local customisation (config.php) those sample commands :

• $FmtPV['$CurrentYear'] = 'date("Y")'; // 2006
• $FmtPV['$CurrentDay'] = 'date("d")'; // 02 (for April 2), 20 (for April 20)
• $FmtPV['$CurrentWeek'] = 'date("W")'; // ISO-8601 week number of the year
• $FmtPV['$CurrentMonth'] = 'date("m")'; // 04 (for April), 12 (for December)
• $FmtPV['$Today'] = 'date("Y-m-d")'; // 2006-03-29
• $FmtPV['$Tomorrow'] = 'date("Y-m-d", time()+60*60*24 )'; // {$Tomorrow} will output something like '2006-03-29'
• $FmtPV['$CurrentTime'] = 'date("H:i:s")'; // 14:29:32
• $FmtPV['$CurrentTimeC'] = 'date("h:i:s A")'; // 02:29:32 PM
• $FmtPV['$CurrentDayLong'] = 'date("l")'; // Monday through Sunday
• $FmtPV['$CurrentDayShort'] = 'date("D.")'; // Mon. through Sun.
• $FmtPV['$CurrentMonthLong'] = 'date("F")'; // April, December, etc.
• $FmtPV['$TodayLong'] = 'date("F d, Y")'; // June 25, 2010
• $FmtPV['$TodayLongAlt'] = 'date("d F Y")'; // 25 June 2010
• $FmtPV['$TodayShort'] = 'date("Ymd")'; // 20060329
• $FmtPV['$VisitorIP'] = '$_SERVER["REMOTE_ADDR"]'; // may be used in forms or cond. markup;
  on Mac OS X you should replace the latter by $_SERVER["HTTP_PC_REMOTE_ADDR"]. Cf. http://trac.wordpress.org/ticket/1443
• $FmtPV['$CurrentSkin'] = '$GLOBALS["Skin"]';
• $FmtPV['$WikiTitle'] = '$GLOBALS["WikiTitle"]';
• $FmtPV['$RevCount'] = '$page["rev"]';// to get the revision number of a page ; use {$RevCount} in any page you want the rev number to be displayed.

and then use e.g. {$Today} in a page markup.

Please contribute here with some interesting implementations that you have, may be useful for other users.

Date related variables

Here is a set of date related variables I add to all my PmWiki's config.php

## set up custom page variables      
$FmtPV['$ThisYear'] = 'date("Y")'; # 2006
$FmtPV['$ThisDay'] = 'date("d")'; # 02 (for April 2), 20 (for April 20)
$FmtPV['$ThisWeek'] = 'date("W")'; # ISO-8601 week number of the year
$FmtPV['$ThisMonth'] = 'date("m")'; # 04 (for April), 12 (for December)
$FmtPV['$ThisMonthName'] = 'date("F")'; # January to December

$FmtPV['$Today'] = 'date("Y-m-d")'; # 2006-03-29
$FmtPV['$Tomorrow'] = 'date("Y-m-d", time()+60*60*24)'; # {$Tomorrow} will output '2006-03-29'
$FmtPV['$Yesterday'] = 'date("Y-m-d", time()-60*60*24)'; # {$Yesterday} will output '2006-03-29'

$FmtPV['$LastYear'] = 'date("Y")-1'; # 2006
$FmtPV['$LastDay'] = 'date("d", time()-60*60*24)'; # 02 (for April 2), 20 (for April 20)
$FmtPV['$LastWeek'] = 'date("W", time()-60*60*24*7)'; # ISO-8601 week number of the year
$FmtPV['$LastMonth'] = 'date("m", time()-60*60*24*date("d"))'; # 04 (for April), 12 (for December)
$FmtPV['$LastMonthName'] = 'date("F", time()-60*60*24*date("d"))'; # January to December

$FmtPV['$NextYear'] = 'date("Y")+1'; # 2006
$FmtPV['$NextDay'] = 'date("d", time()+60*60*24)'; # 02 (for April 2), 20 (for April 20)
$FmtPV['$NextWeek'] = 'date("W", time()+60*60*24*7)'; # ISO-8601 week number of the year
$FmtPV['$NextMonth'] = 'date("m", time()+60*60*24*(32-date("d")))'; # 04 (for April), 12 (for December)
$FmtPV['$NextMonthName'] = 'date("F", time()+60*60*24*(32-date("d")))'; # January to December

Simon

Page creation date

To create a variable which shows the page creation time

## add page variable {$PageCreationDate} in format yyyy-mm-dd
$FmtPV['$PageCreationDate'] = 'strftime("%Y-%m-%d", $page["ctime"])';
## to use the same format that you define in config.php with $TimeFmt use
$FmtPV['$Created'] = "strftime(\$GLOBALS['TimeFmt'], \$page['ctime'])";

For pagelist ordering

$FmtPV['$TitleNoArticle'] = 
   'preg_replace("/^ *(?:The|An?) /i", "", (@$page["title"] ? $page["title"] : $AsSpacedFunction($name)), 1)';

(:pagelist ... order=$TitleNoArticle ...:)

$FmtPV['$TitleLastFirst'] =
   'preg_replace("/^(.*?)([A-Z][a-z0-9_]*)$/", "\\\\2, \\\\1", (@$page["title"] ? $page["title"] : $AsSpacedFunction($name)))';

(:pagelist ... order=$TitleLastFirst ...:)

$ProfileLinksCount and $ProfileTargets

This page variable is used in the Cookbook listings here on PmWiki.org, to count the number of profile links in a recipe or in a talk page. This number could be an indication for the popularity of the recipe.

$FmtPV['$ProfileLinksCount'] = 'ProfileLinksCount($page["targets"])';
function ProfileLinksCount($targets) {
  $cnt = substr_count($targets, "Profiles.")-1; # without the maintainer
  return $cnt>0? "+$cnt" : '';
}

Note that newer recipes usually have fewer comments than older ones, and this number does not generally depend on the Quality, the Stability, and the Ease of use of a recipe.

New version (2009-09-01)

function ProfileTargets($targets) {
  return implode(' ', str_replace("Profiles.","",
      preg_grep('/Profiles\\./',explode(',',$targets))));
}
$FmtPV['$ProfileTargets'] = 'ProfileTargets($page["targets"])';
$MarkupExpr['unique_count'] = 'count(array_unique($args))';

Notes

• Note that concerning times and dates, now it is better and much more flexible to use ftime from the new Markup expressions: for the blog example, try [[Blog.{(ftime fmt="%Y-%m-%d")} | Today's articles]]. See Markup expressions. (This page was written when Markup Expressions didn't exist yet.)
• For invariable strings, use the format $FmtPV['$MyVariable'] = "'some text'"; (quotes and inside, nested apostrophes).
• For PmWiki variables, i.e. defined in config.php, use the format $FmtPV['$MyVariable'] = '$GLOBALS["PmwikiVariable"]';.
• For some kind of arithmetics or other more complicated output, use
  quote-apostrophe-quote-dot something dot-quote-apostrophe-quote, i.e.
  $FmtPV['$MyVariable'] = "'". complicated_function() ."'"; //i.e.
  $FmtPV['$NextMonth'] = "'". date("n", mktime(0, 0, 0, date("m")+1, date("d"), date("Y")) ) ."'";

Release Notes

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

Comments

You can write all the FmtPV definitions using the php date function a bit simpler like

Using the php date function you are restricted to dates in English. To make your dates international use the php strftime function, for instance

You can write a SpecialFunction function and call it like

HansB

Thank you Hans for the simplification tip - I changed it above. About the localized dates, one should probably first call something like

As I've never had luck with these (really), eventually suggested $[April] and PmWiki's Internationalizations capabilities. --Petko April 02, 2006, at 07:51 AM

See Also

• PmWiki.OtherVariables#FmtPV details on how $FmtPV works
• PHP's date function

Contributors

• All users listed on the page

Comments

See discussion at MoreCustomPageVariables-Talk