==================================================================
Snippet-title:		stardate v1.0
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		15 July 2005, Hvalstad, Norway
==================================================================

Content of zipped file:
-----------------------
snippet_stardate.php
readme_stardate.txt (this file)


Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[stardate]] tag, with the appropriate parameters, in any of your template files, whereever you want the output to appear.
   e.g [[stardate:2005-04-18-12-00]] or just [[stardate]] for the current time.
3) rebuild the FrontPage(s).
   

Description:
------------
* Returns the 'Stardate' (whatever that is :-) corresponding to a given date.



Parameters:
-----------
* @param	string	date - pass 'now' for the current time, or a date in
*                        standard Pivot date format: yyyy-mm-dd-hh-mm
* @param	string	url  - if not '-', the date returned will be a URL and
*                        will point to this link (default is
*                        http://en.wikipedia.org/wiki/stardate, which explains
*                        about stardates); additionally, there will be a tooltip
*                        if the cursor hovers over the link, giving the
*                        non-trekkie date.
*                        If set to '-', only a textual representation will be
*                        returned, no URL or tooltip.
* @return  the requested HTML of the Stardate, as specified by the parameters.