Webtag Applicability (preserving history)

From Cumulus Wiki
Revision as of 21:14, 7 April 2021 by Sfws (talk | contribs) (Text moved from Webtags page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Full information about Web tags can be seen on the linked page. The list of web tags there attempts to identify which web tags can be used whatever release of Cumulus you are running.

The following text used to be on that page, but to simplify that page has now been moved here.

A note of caution

Given how often a new release alters either what web tags are available or what parameters can be used with particular web tags, it is possible the tables on the linked page do not list all web tags at any version, and the tables can't say which modifiers are available at your version.


Cumulus MX

Badge vMx.pngThis badge is used to highlight text that applies to Cumulus 3 (MX) for any release with version numbers 3.0.0 to 3.9.7 ONLY.

  • In many cases, it highlights web tags that are not available in Cumulus 1
  • Use of this badge does not mean that all builds of MX are able to use this web tag
    • Web tags can only be used with template files (Steve Loft names these files in format "xxxxxxT.htm") and none are provided in MX release 3.10.1 or later.
    • Some attempt has been made to indicate either which MX build introduced individual tags, or from which build the web tag started giving the correct response (where earlier builds reported incorrect values for that web tag in some cases).
  • You can, even with latest MX release, create a template file using web tags, as mentioned elsewhere on this page, and fully described on the Customised templates page.
  • MX will raise an error:
    • for any web tag it does not recognise at the version you are running
    • for any input parameter that the token parser is unable to recognise
  • MX treats output parameters differently:
    • any output parameter that it does not recognise at all, is ignored
    • any output parameter in a web tag that does not accept output parameters is also ignored
    • any output parameter in a web tag that does accept output parameters, where the supplied parameter is inconsistent with the content of the web tag, is reported as an error by the token parser
    • an output parameter that specifies only part of the standard output may be reported as an error because of single character rules (for example a tag that reports a time cannot understand format=H, amongst the acceptable formats are format=%H for just hour and format=H:mm for hour and minutes but not seconds.
    • any output parameter that contains incorrectly formatted characters in that output parameter will be treated as an error by the token parser (a common mistake is forgetting spaces are expected to be included with other literal characters by the MX token parser)
    • if you use valid parameters but the wrong parameters, you are likely to be confused by the output (the most common cases result in seeing minutes where a month is wanted, or there is a misunderstanding of the concept where the same character has different meanings when on its own and when with other characters).

Cumulus 2

Cumulus 2 is no longer available, it never did any web page generation, so even if you happen to have installed Cumulus 2 from when it was available, there are no web tags it supports.


Original (legacy) Cumulus software

Badge v1.pngThis badge is used to highlight text that applies to Cumulus 1.

  • Use of this badge does NOT mean that all builds of Cumulus 1 are able to use the web tag.
  • There are gaps in the Cumulus 1 documentation, and so it is not usual for the table entry to indicate when a particular web tags started to be available
  • If you are using the final version of Cumulus 1, then the text highlighted by that badge does apply to you.
  • In general, Cumulus 1 will silently ignore any web tag it does not recognise. This means that you might see the raw

web tag remaining after processing, or you might see nothing where the web tag was prior to processing. It also means that if you try to do a numeric calculation on a web tag that Cumulus 1 does not recognise, the calculation will fail, but you might not see an error message.