Customised templates

Revision as of 18:54, 23 August 2013 by Sfws (talk | contribs) (→‎How Cumulus uses its templates: add cross ref to 'simple website setup')

It is possible to take the standard Cumulus web templates and customise these to your own requirements. A basic understanding of HTML is useful.

How Cumulus uses its templates

Cumulus has a number of template files that it uses if you select to 'Include the standard files' within Internet Configuration:  

The template files are stored in the 'web' folder under your Cumulus installation on your PC. They all have a 'T' (for 'template') in their names. As at version 1.9.2 the following exist:

  • indexT.htm
  • todayT.htm
  • yesterdayT.htm
  • recordT.htm
  • gaugesT.htm
  • trendsT.htm

From v.1.9.3 another was added:

  • monthlyrecordT.htm

When Cumulus is ready to perform a web site update, it will process each of these files, insert the relevant data from the weather station and create local webpages (optionally with temp suffix) for each. Once completed Cumulus will FTP these up to your web space on the internet. The final filenames on your web site will be as above, without the letter T at the end.

The standard website set up is fully described in Simple_Website_setup.

Changing the templates

You can modify any of the template files mentioned above. For example, you may wish to add a link; remove some information; add a page counter; etc

It is best to close down Cumulus while updating the template files. Use windows Notepad or Notepad++ or another text editor to modify the HTML as necessary.

Typically the templates are modified to include additional weather data, or remove it. This is done with Cumulus webtags. There is an example below relating to solar and UV sensors. Your weather station might be a sort that can accept Extra Sensors and so you need to add webtags for those.

Example

  <!-- Solar data. If you don't have a solar sensor, you may wish to delete everything from here to the next comment -->
  <tr class="td_temperature_data">
    <td>Solar Radiation</td>
    <td><#SolarRad> W/m²</td>
    <td>Evapotranspiration Today</td>
    <td><#ET> <#rainunit></td>
  </tr>
  <!-- End of solar data -->

The above code is in indexT.htm, delete all of it if you do not have a solar sensor on your weather station. The <#ET> web tag only applies to Davis weather stations that include a solar sensor, if your solar sensor is another make, you might want to change the code to the following so you can see your ultraviolet observation:

  <!-- Solar data. If you don't have a solar sensor, you may wish to delete everything from here to the next comment -->
  <tr class="td_temperature_data">
    <td>Solar Radiation</td>
    <td><#SolarRad> W/m²</td>
    <td>UV Index</td>
    <td><#UV></td>
  </tr>
  <!-- End of solar data -->

As soon as you edit templates, remember that when you update to a new build of Cumulus you have the option during the install process to decline overwriting your HTML templates if they are in the 'web' subfolder with the standard templates.

Notes of caution

  • Remember to edit the xxxT.htm files, (not the xxx.htm files) and to have 'Include Standard Files' ticked (as shown above) on the Files tab of the Internet screen within the 'Configuration' menu.
  • Try to use a simple text editor to change the files. Many HTML editors will insert additional code, or break the standard Cumulus 'webtags' by replacing the < or > symbols with character codes. Avoid using Word processors, like Word, to edit these files.
  • Keep copies of any xxxT.htm files you modify. It is best to back up the whole Cumulus folder onto a different disc on a regular basis.
  • From version 1.8.9 onwards, the Cumulus installer installs the standard templates in a Cumulus subfolder called 'web/originals' so you can refer to them. The installer offers you the option of either replacing all templates in the 'web' folder, or not replacing them, if you update Cumulus or re-install the current version. If you select to install the templates, your changes will be lost as Cumulus will replace those in the 'web' folder with the standard ones.

Creating Your Own Templates

If you are making anything but minor changes to the template, consider creating your own files with different names (in a separate folder), and list these local files for Cumulus to process them.

  • Remember if you are not using the standard files to unselect 'Include Standard Files' (see image at top of page) on the Files tab of the Internet screen within the 'Configuration' menu.
  • References to the new templates for Local files 0 to 9 can be stored in cumulus.ini by placing the path and filename in left hand column on the Files tab of the Internet screen within the 'Configuration' menu. An easy way to achieve this is by using the appropriate Browse... button.
  • Local files 10 upto (from version 1.9.3) 99 have to be manually inserted (or amended) by editing cumulus.ini, using a ExtraLocalNN= line (note NN is any 1 or 2 digit number) in the existing [FTP site] section and placing the path and filename after the equals sign. An easy way to achieve this is by copying one of the lines with NN set to between '0' and '9', and then replacing the numerical digit with the required 2 digit one and then changing the filename.
  • For template files 0 to 9, leave the Binary column unset (it is only set for image files) on the Files tab of the Internet screen within the 'Configuration' menu; this is achieved by including ExtraBinaryNN=0 for NN values '10' upto '99' in the existing [FTP site] section of cumulus.ini.
  • Leave the 'Realtime?' column unselected for template files 0 to 9 to be processed at the 'Interval' specified in the middle of the Web settings frame on the Sites/Options tab of the Internet screen within the 'Configuration' menu. Select it for processing at the 'Realtime interval'. For NN values '10' upto '99', normal interval processing is achieved by including ExtraRealtimeNN=0, while realtime interval processing is achieved by including ExtraRealtimeNN=1, in the existing [FTP site] section of cumulus.ini.

Assuming that your web server is not local, the host, username, password and initial directory are specified on the Sites/Options tab of the Internet screen within the 'Configuration' menu and you list the remote filenames as follows:

  • For files 0 to 9 enter the directory and required file name in the 'Remote filenames' column on the Files tab of the Internet screen within the 'Configuration' menu; for NN values '10' upto '99' this is achieved by including ExtraRemoteNN= with directory and filename after the equals sign in the existing [FTP site] section of cumulus.ini.
  • As you have listed template files (with Cumulus webtags) these need to be processed; select 'Process?' column for 0 to 9 or for 10 upto 99 add ExtraProcessNN=1 in the existing [FTP site] section of cumulus.ini.
  • Finally, select 'FTP?' column for 0 to 9 or for 10 upto 99 add ExtraFTPNN=1 in the existing [FTP site] section of cumulus.ini.


If your web server is on the same computer (or local network) as Cumulus, then the instructions for remote files are changed slightly:

  • It is rarely needed to specify the host, username, password and initial directory of a local web server on the Sites/Options tab of the Internet screen within the 'Configuration' menu (the exception is if your webpage includes a script requiring loading a local file like 'dayfile.txt').
  • For files 0 to 9 enter the full path and required file name in the 'Remote filenames' column on the Files tab of the Internet screen within the 'Configuration' menu; for NN values '10' upto '99' this is achieved by including ExtraRemoteNN= with full path and filename after the equals sign in the existing [FTP site] section of cumulus.ini.
  • As you have listed template files (with Cumulus webtags) these need to be processed; select 'Process?' column for 0 to 9 or for 10 upto 99 add ExtraProcessNN=1 in the existing [FTP site] section of cumulus.ini.
  • Finally, normally unselect 'FTP?' column for 0 to 9 or for 10 upto 99 add ExtraFTPNN=0 in the existing [FTP site] section of cumulus.ini.

If a particular webpage on a local web server includes a script requiring loading a local file like 'dayfile.txt', then enter its remote directory and name, and select File Transfer Process, as per the previous set of instructions. The remaining pages will simply be copied across locally using the specified full path and so do not require FTP as per instructions directly above.