Download PageImage

* ---------------------------
* Snippet: PageImage
* ---------------------------
* Version: 1.3
* Date: 2007-05-26
*
* Returns an image file tag associated with the current document.
* Alternatively, a document can be specified by passing the
* document id as parameter 'id', or alternatively, the
* parameter 'alias' can be used.
*
* Image filename takes the form <alias>.<image type> where
* <alias> is the alias of the page, and <image type> is the
* file extension for acceptable image file types
* (jpg, gif, pnp and jpeg).
*
* NOTE: If user friendly URLs aren't being used, then the snippet
* uses the page id, so the image filename becomes <pageid>.<image type>
*
* If no image is found for the current page, then we look for
* the image associated with the closest ancestor page
* unless recursive is set to [false|0].
*
* Usage: [!PageImage
*
* ?alias=<alias>
*
* &id=<doc id>
*
* &dir=<image directory>
* e.g. &dir=assets/images/pagepics/
* default is assets/images/pagepics/
*
* &class=[false|0] | someclass
* if not specified then img class isn't output
* if false|0 then the img class isn't output
*
* &div=[false|0] | someclass
* if not specified then div isn't output
* if false|0 then the div isn't output
*
* &recursive=[false|0]
* anything else equates to true (default)
*
* !]
*
* History:
* 2007-05-26, 1.3 Lloyd Borrett
* Fixed syntax bug
*
* 2007-03-23, 1.2 Lloyd Borrett
* Added ability to pass a div class wrapper, if div required
* Added ability to pass a CSS class for the img tag, if class required
* Added ability to turn off using an ancestor image
*
* 2007-03-17, 1.1 Lloyd Borrett
* Added ability to pass the image directory as an argument
*
* 2006-07-17, 1.0 Lloyd Borrett, www.borrett.id.au