PmWiki | Cookbook / Limit Diffs per page

Summary: Paginate the "diff" output (when viewing a page history, limit the number of displayed revisions at once)

Version: 20081115

Prerequisites: PmWiki post-March 2006.

Status: Stable

Maintainer: Petko

Categories: Administration Editing

See the bottom line.

Questions answered by this recipe

Is there a possibility to display a smaller number of revisions, on a number of sub-pages?

Description

A page history can become quite big, as seen on pmwiki.org. When you then take a look at the history, it takes quite some time. This recipe displays a smaller number of revisions, on a number of sub-pages.

This is a conversion of my fix, supplied at PITS.00544, into an independent recipe. The distribution file scripts/pagerev.php is replaced on the fly by the provided patched script.

Installation

Copy the file limitdiffsperpage.php Δ to your /cookbook/ directory.
Set in your (farm)config.php the following code:

if ($action=='diff')
{
   $DiffCountPerPage = 10; # Optional
   include_once("$FarmD/cookbook/limitdiffsperpage.php");
}

Note. From version 20081115, the recipe will automaticaly incorporate InlineDiff if it exists on the server. To make it work, copy the InlineDiff dirs and files in the /cookbook/pagerevinline/ directory, and include_once only the LimitDiffsPerPage recipe in config.php.

To enable inline diffs on the wiki markup by default, you can place this code in config.php, right before the "include_once()" line:

   if(!isset($_GET['source']))
      $_GET['source'] = $_REQUEST['source'] = 'y';

Otherwise you will need to follow the "Show changes to markup" link, as explained in the InlineDiff recipe.

Configuration

The one and only configuration variable is $DiffCountPerPage. You can set it to the number of revisions that will be displayed on every page:

   $DiffCountPerPage = 4;  # show 4 revisions
   $DiffCountPerPage = 10; # show 10 revisions (recipe default)
   $DiffCountPerPage = 0;  # show all revisions, like PmWiki

Notes

Using this recipe to display diffs is never slower than the original pagerev.php, but it can be drastically faster, especially on pages with long revision history.

The patched file was submitted in March 2006.

The script has been tested for a long time and should work fine.

Release Notes

20081115 : Added automatic integration with InlineDiff if installed. Fixed ampersands in older PmWiki versions.
2007-11-20 : Changed to work with 2.2.beta64 and newer. Renamed all functions just in case a field loads another diff recipe than the wikifarm.

Contributors

Pm is the author of the original scripts/pagerev.php
Petko proposed the patch and is maintaining this recipe.

Limit Diffs per page