Today.php README v2.2b - http://mytree.net/tng_today

Include script for use with TNG v7.x

Today.php provides "DataBox" tags that, when included within php pages, produce boxes of data pulled from your TNG database. The purpose is to produce small lists of data to be included in your genealogy home page, or any other TNG genealogy page.

Today.php script *MUST* be included in display page for DataBox Tags to function.
example: <?php include '/gen/today.php'; ?>

 ** !! Changed: Use of args now REQUIRES being wrapped in single quotes !! **

DataBox Tags available:
getBirthToday(), getMarriedToday(), getDeathsToday(), longestLived(), getStats() and diagToday().

Each DataBox Tag can use arguments; if no option is desired, then include a "z" for zero 
(eg: getBirthToday('z') - default is always width = 100% )

You can override the default tree by adding the string "|[mytree]" to the end 
of your arguments list (where mytree = the treeID you want to specify).
example: <?php longestLived('x|jones'); ?>

If you add nothing more than the pipe, then no tree is used and the dataBox will display 
results based on ALL trees. 
example: <?php longestLived('x|'); ?> 

Leaving $myTree undefined within config and NOT using a tree override within the Datatag itself, 
results in including ALL available trees for dataBox.

* ** !! Changed: Use of args now REQUIRES being wrapped in single quotes !! **

Bar Color option in config - color of bar below heading.

R argument within dataTag calls results in Relationship lookup instead of the default individual lookup
for both Birth and Death day DataBox tags.

Editable CSS headers within today.php to allow for easier customization.



* Bug: Not hidding Living - $sPerson not made globel in getBirthToday() - Fixed.


* Added: diagToday() - Tag added to help in tracking down trouble.






See examples of use below.

To install you must copy today.php to your server, then insert the include line pointing to it, in the target web page:

<?php include '/[path2file]/today.php'; ?>

[path2file] = the path to the today.php file

Then where ever, within your php webpage, you want to insert a DataBox, you must insert the desired DataBox Tag:

Like: <?php getMarriedToday(x); ?>

in above example, the argument x has been used, but would be a z if no option is desired. - see how2use.html for examples.

LIVEtest.php is a test php file already using DataBox Tags.  Please edit the include line to point to your today.php file, then use to test your config.

LIVEdiag.php is a test php file with nothing more than the diagToday() tag to help trouble shoot possible problems.

Included IMAGES are only for example and are NOT USED IN ANY OTHER WAY.

Version 2.1
- Fixes error in show living flag.
version 2.15
- $sPerson not made globel in getBirthToday() - Fixed.
- Argument MISSING Error Fixed - Arguments are now required by all tags, z=zero or same as empty.
- Filter all results by tree defined in $myTree - Added.
- diagToday() tag added - to help with troubleshooting.
version 2.16
- Fixed Databoxes opened and not closed due to empty lists.
- Fixed Query in longestLived() function (query not supported by mysql prior to v4.1)
- Fixed Query in getStats() function (averageAge query not supported by mysql prior to v4.1)
- Optimized queries for older MySQL database engines.
- Added: notice if list returns empty. 
version 2.17
- ? 
- never offically released.
version 2.18