HansR: Created page with "This page is the new ''Recent History'' page. This page is part of a complete rewrite of the ''Webtags'' page. As long as this message exists please refer to Recent History..."

2022-09-29T12:26:12Z

Created page with "This page is the new ''Recent History'' page. This page is part of a complete rewrite of the ''Webtags'' page. As long as this message exists please refer to Recent History..."

New page

This page is the new ''Recent History'' page. This page is part of a complete rewrite of the ''Webtags'' page.
As long as this message exists please refer to [[Recent History (preserving history)]].

This page is Work in Progress until this message is deleted.

If any questions or remarks please send a PM to [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 HansR] on the forum. Do not use the ''discussion'' tab unless accompanied by a PM: there is no automated signal to HansR if you use that page.

This page and its subpages will document the Webtags from the point of view of the CumulusMX software and not the Cumulus 1 legacy software. Cumulus 1 is no longer maintained and will eventually disappear. If you are still using it, please refer to the original [[Webtags_(preserving_history)|Webtags]] page where @sfws has tried to give both packages equal value. That effort is no longer maintained in this page. We hope you will understand this approach.

Please do not edit this page while it is being worked on i.e. while this message is still here.

<hr/>
=Uploading data to a web server outside MX=

<big>Please note this Wiki page applies to releases 3.10.1 onwards.</big> <small>NOTE: Earlier MX releases used [[Cumulus template file|HTML template files]] that created web pages locally for uploading to a web server.</small>

This Wiki category page is the entry point to the documentation describing how the JSON format is used in [[New_Default_Web_Site_Information|optional web site functionality]] for updating data to a web server outside Cumulus MX.

The [[Webfiles folder|webfiles sub-folder]] contains the following web pages that are uploaded just once to your web server (obviously if they get changed in a new release, then the new files are uploaded to replace the old ones as another one-off operation).
*Each of these web pages depends on a number of other files (in '''lib''', ''js'', and '''css''' sub-folders).
*they also depend on one or more files being uploaded to supply data:
{| class="wikitable" border="1"
|-
!style="width:30px" | Web page
!style="width:100px" | Source file
!style="width:30px" | Upload file
!style="width:300px" |Settings
!style="width:300px" | Description
|-
|gauges.htm
|[[realtimegaugesT.txt]] in [[Web folder|web sub-folder]]
|realtimegauges.txt
| Internet settings -->> Web/FTP Settings -->> Realtime Settings -->> realtimegauges.txt -->> Generate
| Please see [[SteelSeries_Gauges]] (although that was written for legacy Cumulus 1)
|-
|historic.htm, trends.htm, selectachart.htm
|Generated in the code
|[[availabledata.json]], [[graphconfig.json]], plus files with data for what to be plotted (e.g. alldailyhumdata.json)
| Internet settings -->> Web/FTP Settings -->> Interval Settings -->>
|'''availabledata.json''' and '''graphconfig.json''' files must be uploaded just once after you select which graphs you want to plot (so if you for example decide to swap from apparent temperature to feels like, upload the first file again)
|-
|index.htm, monthlyrecord.htm, record.htm, thismonth.htm, thisyear.htm, today.htm, yesterday.htm
|[[websitedataT.json]]
|websitedata.json
| Internet settings -->> Web/FTP Settings -->> Standard File Settings -->> websitedata.json -->> Generate
|please see [[New Default Web Site Information]]
|-
|noaareport.htm
|Generated in code
|[[Reports folder|Reports sub-folder]]
|NOAA Settings -->> all sub-sections
| see [[Reports folder|here]]
|}

=Data Transfer Format=

[[Php_webtags#Option_3:_JavaScript_Object_Notation|JavaScript Object Notation (.json) format]] is one of the ways to transfer data with individual items labelled, on that linked page some of the other ways to transfer data are also explained.

Use of this format is introduced in Cumulus MX, and ''none of the files in this category are applicable to the legacy 1.9.4 software''.

=Documentation for [[Cumulus_MX_Local_API|local application programming interface]]=

MX uses JSON format (specified as part of MX internal code) for the pages that show weather information in the [[MX Administrative Interface]], on the web server generated by MX.

The Cumulus Wiki pages that document JSON usage in that interface are linked from the link in the heading above, and are not included in this category.

For example, the page that displays weather for today and yesterday uses the 6 formats described on [[API_Today/Yesterday_Data|this page]].

=Links listed below=

<div style="background: LemonChiffon;padding:5px; margin:2px;">
[[File:Crystal Clear info.png|40px]] Appeal to contributors:

Please work through all linked pages, and ensure Cumulus MX documentation is completed
</div>

MX stores all the '''xxxx.json''' files, linked from this Wiki page, in the [[Web folder|'''web''' sub-folder]] of your MX installation.

Please note if you are using an older release some files may not be available, and MX development may add files that need to be documented here.

[[Category:Cumulus MX]] [[Category:Cumulus Files]]

Category:JSON Files - Revision history

HansR: Created page with "This page is the new ''Recent History'' page. This page is part of a complete rewrite of the ''Webtags'' page. As long as this message exists please refer to Recent History..."