New Default Web Site Information - Revision history

Sfws: /* The New Default Web Site in v3.10 */ add note about needing to use defaults

2021-07-20T09:27:45Z

The New Default Web Site in v3.10: add note about needing to use defaults

← Older revision		Revision as of 09:27, 20 July 2021
Line 1:		Line 1:
	== The New Default Web Site in v3.10 ==		== The New Default Web Site in v3.10 ==

			Please note that for this suite to work, every configurable setting in any way related to web sites, must be set to defaults (unless there are no defaults, e.g. passwords). Most, but not all, these defaults are set correctly when you go to '''Settings menu''' → ''Internet settings'' → '''web/FTP settings''' and then select '''I want to use the supplied default web site'''. However, there are other settings elsewhere, (e.g. '''Settings menu''' → ''NOAA settings'' → '''Output files''' and '''Settings menu''' → ''NOAA settings'' → '''FTP options''') that must also be kept at defaults. Quoted setting navigation paths are correct for 3.10.x releases, but might change in future.

	=== Changes to the Cumulus MX default web site in v3.10 ===		=== Changes to the Cumulus MX default web site in v3.10 ===

Sfws: /* I want to keep the old web site look and feel, but also update to MX v3.10+ */ Improve styling

2021-05-02T12:35:50Z

I want to keep the old web site look and feel, but also update to MX v3.10+: Improve styling

← Older revision		Revision as of 12:35, 2 May 2021
Line 171:		Line 171:
	== FAQ ==		== FAQ ==
	==== I want to keep the old web site look and feel, but also update to MX v3.10+ ====		==== I want to keep the old web site look and feel, but also update to MX v3.10+ ====

	Well, good news (for now). The distribution zip file contains a folder named /webfiles-legacy.		Well, good news (for now). The distribution zip file contains a folder named <code>/webfiles-legacy</code>.

	This folder contains a "new" version of the original web site that uses the same data-driven approach of the new template. So you can enjoy the efficiency of the new single data file upload with the old look and feel.		This folder contains a "new" version of the original web site that uses the same data-driven approach of the new template. So you can enjoy the efficiency of the new single data file upload with the old look and feel.
⚫	Be aware though that these legacy files will no longer be maintained or updated, and at some stage will be removed from the distribution file.

		⚫	Be aware though that these legacy files will no longer be maintained or updated, and at some stage will be removed from the distribution file.

	==== I want to keep the old web site completely, but also update to MX v3.10+ ====		==== I want to keep the old web site completely, but also update to MX v3.10+ ====

Sfws: /* I want to keep the old web site completely, but also update to MX v3.10+ */ add link

2021-05-02T12:34:48Z

I want to keep the old web site completely, but also update to MX v3.10+: add link

← Older revision		Revision as of 12:34, 2 May 2021
Line 177:		Line 177:

	==== I want to keep the old web site completely, but also update to MX v3.10+ ====		==== I want to keep the old web site completely, but also update to MX v3.10+ ====
	It that case you will have to keep the indexT.htm, gaugesT.htm etc. files from a previous release and make sure they are still in your local /web folder.		It that case you will have to keep the ''indexT.htm'', ''gaugesT.htm'', etc. files from a previous release, and make sure they are still in your local /web folder.

⚫	Then you will have to add every web page template file (indexT.htm, gaugesT.htm etc) to your Cumulus MX Extra Files list; the remote filenames should all drop the 'T' - indexT.htm becomes index.htm. Ensure you tick process, FTP and add your web site FTP folder in remote files.

		⚫	Then you will have to add every web page template file (indexT.htm, gaugesT.htm etc) to your Cumulus MX [[MX_Administrative_Interface#Extra_Web_Files\|Extra Files]] list; the remote filenames should all drop the 'T' - indexT.htm becomes index.htm. Ensure you tick '''process''', ''FTP'' and add '''your web site FTP folder''' in remote files.

	==== I want to customise/localise the data Cumulus MX uploads in the JSON data file ====		==== I want to customise/localise the data Cumulus MX uploads in the JSON data file ====

Sfws: /* I want to customise/localise the data Cumulus MX uploads in the JSON data file */ add links to related pages

2021-05-02T12:31:38Z

I want to customise/localise the data Cumulus MX uploads in the JSON data file: add links to related pages

← Older revision		Revision as of 12:31, 2 May 2021
Line 183:		Line 183:

	==== I want to customise/localise the data Cumulus MX uploads in the JSON data file ====		==== I want to customise/localise the data Cumulus MX uploads in the JSON data file ====
⚫	The uploaded data file is created from a template file /web/websitedataT.json using web tags.

		⚫	The uploaded data file is created from a [[Cumulus_template_file\|template]] file called [[WebsitedataT.json\|/web/websitedataT.json]] using web tags.
⚫	You can create a copy of this file and customise the tags as you wish.

		⚫	It is ''not recommended'' to edit supplied <code>/web/websitedataT.json</code> file directly, you risk losing any changes you make with every update.
⚫	Then add your new template JSON file to the Cumulus Extra Files list, with process and FTP enabled, for the remote filename use the default websitedata.json so that the template scripts will pick it up without alteration.

		⚫	You can create a copy of this file, in a new folder with a slightly modified file-name, and customise the tags as you wish.
⚫	You also need to change the Internet Settings/Interval file list to not process or upload the standard websitedata.json file.

		⚫	Then add the path to your new template JSON file to the Cumulus [[MX_Administrative_Interface#Extra_Web_Files\|Extra Files]] list, with process and FTP enabled, for the remote filename use the default '''websitedata.json''' (so that the template scripts will pick it up without alteration).
⚫	It is not recommended to edit supplied /web/websitedataT.json file directly, you risk losing any changes you make with every update.

		⚫	You also need to change the '''Internet Settings > Interval''' file list to not process, nor upload, the standard ''websitedata.json'' file.

	==== I want to change the colour theme ====		==== I want to change the colour theme ====

Sfws: /* Adding Data from the websitedata.json File */ add link

2021-05-02T12:17:55Z

Adding Data from the websitedata.json File: add link

← Older revision		Revision as of 12:17, 2 May 2021
Line 159:		Line 159:

	=== Adding Data from the websitedata.json File ===		=== Adding Data from the websitedata.json File ===

	If you wish to insert data from the websitedata.json file, then all you need to do is add a <nowiki><span></nowiki> element with the "data-cmxdata" attribute set to the data item you wish to display.		If you wish to insert data from the [[WebsitedataT.json\|websitedata.json]] file, then all you need to do is add a <nowiki><span></nowiki> element with the "data-cmxdata" attribute set to the data item you wish to display.

	For example to add the current temperature and unit to your page, you would add the following spans...		For example to add the current temperature and unit to your page, you would add the following spans...

Sfws: /* Migrating from the old template */

2021-04-16T20:58:05Z

Migrating from the old template

← Older revision		Revision as of 20:58, 16 April 2021
Line 19:		Line 19:

	=== Migrating from the old template ===		=== Migrating from the old template ===
⚫	Essentially the same as installing the new template for new users. I recommend deleting the current contents of your web site (it would be prudent to make a backup first), then uploading the contents of the new /webfiles folder.
⚫	As housekeeping, you will also need to clear out your existing Cumulus MX local /web folder and replace it with the contents of the distribution zip /web folder.
⚫	After migrating it is best to flush the browser cache for your web site before loading it again.

		⚫	Essentially the same as installing the new template for new users. I recommend deleting the current contents of your web site (it would be prudent to make a backup first), then uploading the contents of the new '''/webfiles''' folder.

		⚫	As housekeeping, you will also need to clear out your ''existing'' Cumulus MX local '''/web''' folder and replace it with the contents of the ''distribution zip'' '''/web''' folder.
		⚫	After migrating it is best to flush the browser cache for your web site before loading it again.

	== Editing the Template Files ==		== Editing the Template Files ==

Sfws: /* Installing the new template for new users */

2021-04-16T20:56:58Z

Installing the new template for new users

← Older revision		Revision as of 20:56, 16 April 2021
Line 13:		Line 13:

	=== Installing the new template for new users ===		=== Installing the new template for new users ===
⚫	~~The installation process for the new template is exactly the same as the old one.~~ You just copy the entire contents of the /webfiles folder from the distribution zip to the root folder of your web server.

			The installation process for the new template is exactly the same as the old one.

		⚫	You just copy the entire contents of the '''/webfiles''' folder from the distribution zip to the root folder (or a sub-folder of your choice if you also have non-weather content) of your web server.

	=== Migrating from the old template ===		=== Migrating from the old template ===

Mcrossley: /* Adding new pages to the new site menus */

2021-03-29T09:05:29Z

Adding new pages to the new site menus

@@ Line 25: / Line 25: @@
 === Adding new pages to the new site menus ===
 Unlike the old site where you had the edit the menu on every existing page in order to add a new one, the new site has the menus defined once.
-You will find them (one for large screens, one for mobile) in the /js/setpagedata.js file defined as two long strings.
+You will find it in the /js/menu.js file defined as a single object.
 Here is the full menu...
  <nowiki>
 You can see each page is defined in this format...
  <nowiki>
  <nowiki>
 So it becomes...
  <nowiki>
 </nowiki>
-Where I have inserted the new NOAA page between "This Year" and "Records"
+Where I have inserted the new Custom page between "Now" and "Yesterday"
 === Making changes to the pages===
 Although looking at the new template pages makes the idea of editing them daunting, it really is not that hard.  There are just a few classes that are really useful.

NeilThomas: /* Creating New Pages */

2021-03-13T19:42:50Z

Creating New Pages

← Older revision		Revision as of 19:42, 13 March 2021
Line 131:		Line 131:
	The new template is based on the w3schools template. You can read all about this template here: [https://www.w3schools.com/html/html_responsive.asp HTML Responsive Web Design].		The new template is based on the w3schools template. You can read all about this template here: [https://www.w3schools.com/html/html_responsive.asp HTML Responsive Web Design].

	You should also visit the page [Default_Website_Development\|Default Website Development] for up to date resources and information about developments that we are making to the default system.		You should also visit the page [[Default_Website_Development\|Default Website Development]] for up to date resources and information about developments that we are making to the default system.

	=== Blank Template Pages ===		=== Blank Template Pages ===

NeilThomas: /* Creating New Pages */

2021-03-13T19:42:03Z

Creating New Pages

← Older revision		Revision as of 19:42, 13 March 2021
Line 131:		Line 131:
	The new template is based on the w3schools template. You can read all about this template here: [https://www.w3schools.com/html/html_responsive.asp HTML Responsive Web Design].		The new template is based on the w3schools template. You can read all about this template here: [https://www.w3schools.com/html/html_responsive.asp HTML Responsive Web Design].

	You should also visit the page [[Default_Website_Development\|Default Website Development]] for up to date resources and information about developments that we are making to the default system.		You should also visit the page [Default_Website_Development\|Default Website Development] for up to date resources and information about developments that we are making to the default system.

	=== Blank Template Pages ===		=== Blank Template Pages ===