BETA webtags

From Cumulus Wiki
Revision as of 22:12, 23 January 2011 by Mcrossley (talk | contribs) (Added 1.9.1 webtags to build 974)
Jump to navigationJump to search

Additional webtags available in the BETA version of Cumulus 1.9.1

These are special markers placed in a file which Cumulus can then process and replace with the actual values. Typically you would use this to build your own website by having an HTML template file with your layout, static text and graphics. In the position on the page you wish Cumulus to insert the relevant data place a webtag in the form:

<#tagname>

Assuming you have asked Cumulus to process the file, it will replace the tag with the current value of the item the tag represents just before the file is uploaded to the internet.

Note: When you put a tag into your HTML, be careful that whatever program you are using to develop your web pages doesn't change the angle brackets to slightly different symbols -- this is a common cause of failure!


The Tags

Below is a list of the additional webtags available in this beta version. These webtags will be transferred to the main page when the beta version becomes 'live'

Time/Date 'format' Parameter

From 1.9.1 b969 most time webtags will accept an option 'format' parameter, e.g: <#YearTempHT format=hh:nn>. This allows you to override the default display format for that item, using the format specifiers in the table below. Note that if your format has any spaces in it, you must enclose it in double quotes, thus: <#YearTempHT format="hh nn">. Note also that you can specify date formatting to times and vice versa, but this will not always yield a sensible result.

Specifier Displays
c Displays the date using the format given by the Windows Short Date format, followed by the time using the format given by the Windows Long Time format. The time is not displayed if the date-time value indicates midnight precisely.
d Displays the day as a number without a leading zero (1-31).
dd Displays the day as a number with a leading zero (01-31).
ddd Displays the day as an abbreviation (Sun-Sat) using the strings appropriate to the Windows Locale.
dddd Displays the day as a full name (Sunday-Saturday) using the strings appropriate to the Windows Locale.
ddddd Displays the date using the format given by the Windows Short Date format.
dddddd Displays the date using the format given by the Windows Long Date format.
m Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.
mm Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.
mmm Displays the month as an abbreviation (Jan-Dec) using the strings appropriate to the Windows Locale.
mmmm Displays the month as a full name (January-December) using the strings appropriate to the Windows Locale.
yy Displays the year as a two-digit number (00-99).
yyyy Displays the year as a four-digit number (0000-9999).
h Displays the hour without a leading zero (0-23).
hh Displays the hour with a leading zero (00-23).
n Displays the minute without a leading zero (0-59).
nn Displays the minute with a leading zero (00-59).
s Displays the second without a leading zero (0-59).
ss Displays the second with a leading zero (00-59).
z Displays the millisecond without a leading zero (0-999).
zzz Displays the millisecond with a leading zero (000-999).
t Displays the time using the format given by the Windows Short Time format.
tt\ Displays the time using the format given by the Windows Long Time format.
am/pm Uses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
a/p Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
ampm Uses the 12-hour clock for the preceding h or hh specifier, and displays the contents of the Windows AM string for any hour before noon, and the contents of the Windows PM string for any hour after noon.
/ Displays the date separator character given by the Windows Date Separator.
: Displays the time separator character given by the Windows Time Separator.
'xx' Characters enclosed in single quotation marks are displayed as such, and do not affect formatting.

Time

webtag Function
<#ThumTH> Time of today's high humidity
<#ThumTL> Time of today's low humidity
<#ThumYH> Time of yesterday's high humidity
<#ThumYL> Time of yesterday's low humidity
<#ThumH> Date/time of all time high humidity
<#ThumL> Date/time of all time low humidity
<#TapptempTH> Time of today's high apparent temperature
<#TapptempTL> Time of today's low apparent temperature
<#TapptempYH> Time of yesterday's high apparent temperature
<#TapptempYL> Time of yesterday's low apparent temperature
<#TapptempH> Date/time of all time high apparent temperature
<#TapptempL> Date/time of all time low apparent temperature
<#TheatindexTH> Time of today's high heat index
<#TheatindexYH> Time of yesterday's high heat index
<#TheatindexH> Date/time of all time high heat index
<#TdewpointTL> Time of today's lowest dew point
<#TdewpointTH> Time of today's highest dew point
<#TdewpointYL> Time of yesterday's lowest dew point
<#TdewpointYH> Time of yesterday's highest dew point
<#TdewpointH> Time of all time high dew point
<#TdewpointL> Time of all time low dew point
<#TwchillTL> Time of today's low wind chill
<#TwchillYL> Time of yesterday's low wind chill
<#ThourlyrainTH> Time of today's high rainfall rate
<#ThourlyrainYH> Time of yesterday's high rainfall rate

Temperature

webtag Function
<#apptemp> The apparent temperature
<#apptempTH> Today's high apparent temperature
<#apptempTL> Today's low apparent temperature
<#apptempYH> Yesterday's high apparent temperature
<#apptempYL> Yesterday's low apparent temperature
<#apptempH> All time high apparent temperature
<#apptempL> All time low apparent temperature
<#heatindexTH> Today's high heat index
<#heatindexYH> Yesterday's high heat index
<#heatindexH> All time high heat index
<#humTH> Today's highest humidity
<#humTL> Today's lowest humidity
<#humYH> High humidity yesterday
<#humYL> Low humidity yesterday
<#humH> All time high humidity
<#humL> All time low humidity
<#wchillTL> Today's lowest wind chill
<#wchillYL> Yesterday's lowest wind chill
<#dewpointTL> Today's lowest dew point
<#dewpointTH> Today's highest dew point
<#dewpointYL> Yesterday's lowest dew point
<#dewpointYH> Yesterday's highest dew point
<#dewpointH> All time high dew point
<#dewpointL> All time low dew point

Pressure

webtag Function

Rain

webtag Function
<#hourlyrainTH> Today's highest rainfall rate
<#hourlyrainYH> Yesterday's highest rainfall rate

Wind

webtag Function

Monthly

webtag Function Time Date
<#MonthTempH> This months high temperature <#MonthTempHT> <#MonthTempHD>
<#MonthTempL> This months low temperature <#MonthTempLT> <#MonthTempLD>
<#MonthHeatIndexH> This months high heat index <#MonthHeatIndexHT> <#MonthHeatIndexHD>
<#MonthWChillL> This months low wind chill <#MonthWChillLT> <#MonthWChillLD>
<#MonthAppTempH> This months high apparent temperature <#MonthAppTempHT> <#MonthAppTempHD>
<#MonthAppTempL> This months low apparent temperature <#MonthAppTempLT> <#MonthAppTempLD>
<#MonthDewPointH> This months high dew point <#MonthDewPointHT> <#MonthDewPointHD>
<#MonthDewPointL> This months low dew point <#MonthDewPointpLT> <#MonthDewPointLD>
<#MonthMinTempH> This months highest daily minimum temperature N/A <#MonthMinTempHD>
<#MonthMaxTempL> This months lowest daily minimum temperature N/A <#MonthMaxTempLD>
<#MonthPressH> This months highest pressure <#MonthPressHT> <#MonthPressHD>
<#MonthPressL> This months lowest pressure <#MonthPressLT> <#MonthPressLD>
<#MonthHumH> This months highest humidty <#MonthHumHT> <#MonthHumHD>
<#MonthHumL> This months lowest humidty <#MonthHumLT> <#MonthHumLD>
<#MonthGustH> This months highest wind gust <#MonthGustHT> <#MonthGustHD>
<#MonthWindH> This months highest wind speed <#MonthWindHT> <#MonthWindHD>
<#MonthRainRateH> This months highest rainfall rate <#MonthRainRateHT> <#MonthRainRateHD>
<#MonthHourlyRainH> This months highest hourly rain <#MonthHourlyRainHT> <#MonthHourlyRainHD>
<#MonthDailyRainH> This months greatest daily rain N/A <#MonthDailyRainHD>

Yearly

webtag Function Time Date
<#YearTempH> This years highest temperature <#YearTempHT> <#YearTempHD>
<#YearTempL> This years lowest temperature <#YearTempLT> <#YearTempLD>
<#YearHeatIndexH> This years highest heat index <#YearHeatIndexHT> <#YearHeatIndexHD>
<#YearWChillL> This years lowest wind chill <#YearWChillLT> <#YearWChillLD>
<#YearAppTempH> This years highest apparent temperature <#YearAppTempHT> <#YearAppTempHD>
<#YearAppTempL> This years lowest apparent temperature <#YearAppTempLT> <#YearAppTempLD>
<#YearDewPointH> This years highest dew point <#YearDewPointHT> <#YearDewPointHD>
<#YearDewPointL> This years lowest dew point <#YearDewPointLT> <#YearDewPointLD>
<#YearMinTempH> This years highest daily minimum temperature N/A <#YearMinTempHD>
<#YearMaxTempL> This years lowest daily minimum temperature N/A <#YearMaxTempLD>
<#YearPressH> This years high pressure <#YearPressHT> <#YearPressHD>
<#YearPressL> This years low pressure <#YearPressLT> <#YearPressLD>
<#YearHumH> This years high humidty <#YearHumHT> <#YearHumHD>
<#YearHumL> This years low humidty <#YearHumLT> <#YearHumLD>
<#YearGustH> This years high wind gust <#YearGustHT> <#YearGustHD>
<#YearWindH> This years high wind speed <#YearWindHT> <#YearWindHD>
<#YearRainRateH> This years high rainfall rate <#YearRainRateHT> <#YearRainRateHD>
<#YearHourlyRainH> This years high hourly rain <#YearHourlyRainHT> <#YearHourlyRainHD>
<#YearDailyRainH> This years high daily rain N/A <#YearDailyRainHD>
<#YearMonthlyRainH> This years high monthly rain N/A <#YearMonthlyRainHD>

Miscellaneous

webtag Function
<#LatestError> Displays the last error from the Cumulus error log
<#LatestErrorDate> The date of the latest error logged to the error log window, using the system short date format. Gives dashes when latest error is reset
<#LatestErrorTime> The time of the latest error logged to the error log window, using the system short time format. Gives dashes when latest error is reset
<#ErrorLight> 1 if the 'error' light is flashing, 0 if not

Day/Night/Sun/Moon

webtag Function
<#SunshineHours> Hours of sunshine so far today
<#YSunshineHours> Total hours of sunshine yesterday
<#CurrentSolarMax> Current theoretical maximum solar radiation
<#IsSunny> Returns 1 if the sun is shining, otherwise 0
<#MoonPercent> Current percentage of moon visible (negative value indicates 'waning')
<#MoonPercentAbs> Current percentage of moon visible (always positive)

Alarms

There are a set of tags for the Cumulus alarm states. They give a value of '1' if the alarm has been set and the alarm condition is currently met; otherwise '0'.

webtag Function

Special tags

WMR928

There are a set of tags for the WMR928 extra sensors:

webtag Function


No Commas

There are a set of tags where the decimal comma has been replaced with a full stop, where necessary, for use with gauges etc which don't like the commas. They all correspond to the same tag with 'RC' removed.