Php webtags

Name:	PHP Webtags
Type:	Web templates, PHP
Author:	David Jamieson
Contact:	'DAJ' via the forum
Last update:	29 Dec 2011
Version:	1.18

Cumulus automatically processes a number of template pages into HTML web pages. These template files contain webtags which Cumulus replaces with actual values from your weather station.

If you adopt PHP Hypertext Processing on your web site, you could customise those standard template pages by simply using PHP script to add extra content after the template has been processed by Cumulus.

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. In this case your customised pages would replace any reference to a Cumulus web tag <#xxyyzz> by a PHP variable $xxyyzz.

The PHP file contains all current webtags produced by Cumulus v 1.9.4 b.1099.

A similar project is available for XML webtags (Current unmaintained)

Installation

Download cumuluswebtags.txt link;

1. 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;
2. On the 'Cumulus main screen', in the Configuration menu, select the Internet option;
3. On the 'Internet Settings' screen, select the Files tab;
   
   
4. Edit the screen columns as indicated by red in the figure:
   • in one of the local side boxes (under the 'Local filenames' header), enter the path (directory\file) to where you have stored the template:
     e.g. your_customised_template_location\cumuluswebtags.txt
     (you can use the 'Browse' button to find and select the exact location of the file);
     
     
   • in one of the remote side boxes (under the 'Remote filenames' header), enter the name cumuluswebtags.php:
     • -- if you are uploading the Cumulus files to a different server directory (to that specified on the Sites/Options tab), add the relative server path (from either the FTP default or the directory specified on Sites/Options) before the file name;
     • (-- if you are using a local server, and want Cumulus to do a 'copy' instead of using 'FTP' then specify the full path to the file here);
     • -- notice that the file extension has been changed from txt (on the left side) to php (on the right side) as the remote file needs to be recognised by the PHP processor on the web server;
   • place a check mark in the box under the 'Process?' header:
     • -- this tells Cumulus that the file cumuluswebtags.txt contains tags which need to be replaced by actual values when it processes the template into a web page;
   • place a check mark in the box under the 'FTP?' header:
     • -- this tells Cumulus that the processed file must be uploaded by file transfer to the remote Web server with all the other files;
     • (if you use a local web server, you can leave this un-checked and Cumulus will copy across the processed file to the location specified in the right hand box, but for this you need to specify the full path there);
   • place a check mark in the box under the 'UTF-8?' header:
     • -- this tells Cumulus to output the web page using the standard UTF-8 encoding as used by its standard files;
5. Finally, click on the lower-right OK button to save the newly entered settings.

Usage

Use the PHP include/require command to include the Cumulus webtags into your PHP file.

All PHP variable names are identical to their webtags equivalent. For example, the Cumulus webtag <#forecast> would be referred to as $forecast in your PHP file.

See Sensor_Contact_PHP for an example script that uses this file.

Example

A simple PHP file:

<?php 
 require_once("cumuluswebtags.php");
 echo $time;
 echo "<br/>";
 Echo "The current forecast is " . $forecast;
?>

The results:

20:31 on 02 September 2009
The current forecast is Precipitation, very unsettled

Debugging

If you wish to view all the values contained within the cumulswebtags.php file, append the parameter ?source=view to the end of the URL.

Example

www.myweathersite.com/cumuluswebtags.php?source=view

This will display the source code of the file, listing all the variable names, the values Cumulus has assigned to the webtags during it's processing cycle, and a brief description of the variables/webtags.