Php webtags: Difference between revisions

179 bytes added ,  07:56, 9 January 2015
m
Line 5: Line 5:
It is more efficient  for those using PHP on their website to have Cumulus process one single file and place all the [[webtags]] values into a file of PHP variables.  You can include this file in all your PHP web files and use the variables as you would in PHP.
It is more efficient  for those using PHP on their website to have Cumulus process one single file and place all the [[webtags]] values into a file of PHP variables.  You can include this file in all your PHP web files and use the variables as you would in PHP.
=Options available=
=Options available=
# One approach is to create an array '''$WX''' and within it have elements for all the Cumulus web tags.  A file to do this is called ''CUtags.txt'' and can be downloaded from [http://saratoga-weather.org/wxtemplates/install.php Saratoga-Weather.org].  That approach includes elements for the recent history tags at 5, 10, 15, 20, 30, 45, 60, 75, 90, 105 and 120 minutes.  In this case your customised pages would replace any reference to a Cumulus web tag <#xxyyzz> by a PHP array element $WX[xxyyzz].
# One approach is to create an array '''$WX''' and within it have elements for all the Cumulus web tags.  A file to do this is called ''CUtags.txt'' and can be downloaded from [http://saratoga-weather.org/wxtemplates/install.php Saratoga-Weather.org].  That approach includes elements for the recent history tags at 5, 10, 15, 20, 30, 45, 60, 75, 90, 105 and 120 minutes.  In this case your customised pages would replace any reference to a Cumulus web tag <#xxyyzz> by a PHP array element $WX[xxyyzz] (some elements include the m=10 type selector).
# Another approach is to create a PHP variable for each Cumulus web tag. In this case your customised pages would replace any reference to a Cumulus web tag <#xxyyzz> by a PHP variable $xxyyzz. This is done by the file cumuluswebtags.tx, and this PHP file (download link below) contains all current [[webtags]] produced by Cumulus v 1.9.4 b.1099, but as supplied the recent history tags are commented out and if you want to use them you need to put in the necessary time selectors yourself.
# Another approach is to create a PHP variable for each Cumulus web tag. In this case your customised pages would replace any reference to a Cumulus web tag <#xxyyzz> by a PHP variable $xxyyzz. This is done by the file cumuluswebtags.tx, and this PHP file (download [http://sandaysoft.com/forum/viewtopic.php?f=6&t=10424 cumuluswebtags.txt  link]) contains all current [[webtags]] produced by Cumulus v 1.9.4, but as supplied the recent history tags are commented out and if you want to use them you need to put in the necessary time selectors yourself.
# There was another project [[xml webtags|XML webtags]] but that is now obsolete.
# There was another project [[xml webtags|XML webtags]] but that is now obsolete.
# Yet another approach would be to use JSON for transferring the variables in a portable way. That has been proposed, but no standard approach has yet been developed.
# Yet another approach is to use JSON for transferring the variables in a portable way. Cumulus MX has one array per weather variable each element being a sub-array containing a time-stamp and the value at that time.
 
The installation, usage, and example sections below apply to option 2, but are similar for the other options.
==Installation ==
==Installation ==
Download [http://sandaysoft.com/forum/viewtopic.php?f=6&t=10424 cumuluswebtags.txt  link];
[[File:ScreenShot-PHPWebtags-ConfigSetup.png|right|'Screenshot top and bottom extracts Cumulus v1.9.4']]
[[File:ScreenShot-PHPWebtags-ConfigSetup.png|right|'Screenshot top and bottom extracts Cumulus v1.9.4']]
# Choose a local directory (that Cumulus can read) where you store your customised templates as the destination for this download, or copy the file there after download;
# Choose a local directory (that Cumulus can read) where you store your customised templates as the destination for this download, or copy the file there after download;
5,838

edits