Attention: This snippet is depricated. The same effect can now
           be achieved with the [[subweblog]] tag. See 
           http://forum.pivotlog.net/viewtopic.php?p=66045#66045



==================================================================
Snippet-title:		backlog v1.3
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		25 August 2005, London, UK
==================================================================

Content of zipped file:
-----------------------
snippet_backlog.php
readme_backlog.txt (this file)


Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[backlog]] tag, with the appropriate parameters, in any of your template files, whereever you want the backlog to appear (side bar, page top or bottom, etc)
Syntax:  [[backlog:<weblog>:<category>:<numFullEntries>:<separator>:<date format string>]] 

Example: [[backlog:.:*:8:<br>More entries...<br><br>:d M Y]] 



3) change your FrontPage template, where you have 

[[subweblog:standard]]

to have 

<?php  ob_start(); ?>
 [[subweblog:standard]]
<?php    ob_end_clean();  ?>

(Technical explanation - Pivot will not generate the FrontPage if it does not see a [[subweblog:standard]], but we need to use the ob_start(); and ob_end_clean() to suppress output from [[subweblog:standard]], since we do not want to show it - only the output of [[backlog]].

4) rebuild the FrontPage(s).
   
Description:
------------
* A snippet which lists a subweblog in reverse chronologocal order, oldest
* first, rather than newest to oldest as [[subweblog]] does.
*
* Visit http://www.keellings.com/blog/_demos/backlog.php to see it
* in action


Parameters:
-----------
* @param  string  weblog         - pass '.'for the current blog, or a blog
*                                  title like 'my_blog'
* @param  string  category       - consider only entries of the given
*                                  category, or all categories if omitted or
*                                  set to * (default).
* @param  int     numFullEntries - the number of entries which should be
*                                  shown in their entirity; others will be
*                                  shown as URLS.
*                                  Note: I really ought to read this from
*                                  the administration options for the
*                                  frontpage, but I can't figure out how to :-(
* @param  string  separator      - this string will be printed between any
*                                  full entries (as per param numFullEntries)
*                                  and any URLs which are generated.
* @param  string  formatString   - each line will be preceded by the entry
*                                  date formatted by this string (passed to
*                                  the PHPdate() function. e.g. y-m-d
*                                  Leave blank for none.




* History:
* 
* v 1.3 2006/03/16  Singapore
*   - local variable $db clashed with global variable
*
* v 1.2 2006/02/07 Molde, Norway
*   fixed major problems on frontpage / non-live pages:
*     - $Current_weblog isn't set, needs to use (global) $weblog
*     - $Paths wrongly set, needs to use (global) $log_url and $pivot_url
*   This fix isn't tested on archive pages and probably breaks, but at
*   least it works on the frontpage.
*   NumFullEntries param now defaults to number of frontpage entries defined 
*   in admin.
*
* v 1.1 2005/10/21  London, UK
*   fixed a problem pointed out by Matthias D in another snippet, which was
*   based on this one. If parameter $weblog is '*', we need to use a real
*   weblog when calling some Pivot functions or accessing some Pivot data.'
*
* v 1.0 2005/08/25  London, UK
*   initial version
*