Default Website Development: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
 
(42 intermediate revisions by the same user not shown)
Line 1: Line 1:
==The default CMX website Development==
==The default CMX website Development==


These section of the Wiki will enable you to get the latest information and resources for the new default CMX website shipped with version 3.10.x
These section of the Wiki will enable you to get the latest information and resources for the alternative to the default CumulusMX public website.


===The current default site===
===Alternative public website===
As part of the development process of the CumulusMX Interface, I have generated a new public website (with template pages) as an alternative to the one provided with CumulusMX.
This will always be available to you in the 'websites' folder of your Cumulus MX Installation. However, it is not a published site until you decide to make it so.


This template builds on the development of the AI and introduces a number of features and/or improvements.
To publish the default website you will need a web host and a domain name that you can access.


Full details of the alternative public website, including screenshots can be fond on [https://oaktreewebs.co.uk/wiki/ my wiki] together with comprehensive instructions on how to install, use and modify.
=== Publishing the Default Site ===
To publish the site you need to upload '''ALL''' of the contents of the website folder to a location on your website. Normally this would be to the public_html folder in your control panel for your web host. However, there is nothing to stop you using a sub-folder off the public_html one. If you do this you will need to '''make a note of the folder name''' you use.


Its major change is that all configuration data is held in one place: the CMXConfig object, so you can set the location of your data, your NOAA reports and the menu just by editing one part of one file.
Once you have copied all the above files, you need to configure CumulusMX to upload your data at regular intervals.


The menu has also been enhanced with some additional features while maintaining the single json structure of the original.
==== Configure CumulusMX to upload data ====
This is done on the '''Internet Settings''' Page.
Under the Web/Upload Site' tab check the following:
* Enable Upload Connections
* Select a FTP protocol - Do this in consultation with your web host provider.
* Enter a Host name: - this will usually be your domain name without the http/https prefix.
* FTP and FTPS is usually port 21 but you should select the port in consultation with you web host provider.
* Enter the directory you wish to upload to. This will usually be public_html/ as this is where your pages are. If you have copied your pages to another location then give the path to them.
* Provide a username and password for an account that can FTP to the specified location.*


This site also comes with new themes (unfortunately not compatible with the AI or previous versions) that should be easier to modify for your own needs.
You should not need to change either General or Advanced settings at this stage.


'''Download the [https://www.cumuluswiki.org/images/0/08/PublicWebsite.zip latest version here]''' (Updated: (09:36 11 Feb 2025)) [Corrected missing 'at' on records pages]
Under the '''Interval Configuration''' tab check the option: 'I wish to use the supplied default web site'.
This should make all the configuration changes needed but it is worth while to check:


'''You can view my site using the new default templates on [https://ai2weather.uk Oaktree Weather ].
Under '''Normal Interval Settings''' make sure that everything is selected and that the interval to use is what you want.
Under '''Real time Interval Settings''' make sure that it is enabled, that the interval in seconds is what you want and that ''''Upload'''' is enabled.


====Amendments since last revision====
One final task you need to complete is to enable the load of the moon image. This is on the '''Moon Image''' tab of the '''Internet Settings''' page.
This is a full rebuild of the site.


==Installing==
You can accept the default settings unless you have copied your site to a different location.
Download the current zip file to you local machine and upload it to your web server.
*Unzip it in the same location as your existing site - it will not overwrite the existing pages
*:The new site uses .html pages whereas the existing default site uses .htm
*; If you visit your site without specifying a page you will be taken to the new template pages,
*;Specifying a page such as index.htm will display your old template pages.


*: Please clear your browser cache before viewing.
Your site should now be functioning. However, you may wish to visit the '''Utilities''' page and initiate an FTP upload of everything.


===NOAA Reports===
===Your Own Pages===
CumulusMX can generate NOAA Reports and the default website includes a page to display them.
'''As with previous releases, the public website template also includes a template page'''.


The template.html page is provided to make it easier for you to add your own pages while retaining the look and feel of the website. The template page is called '''template.html'''.
To enable NOAA Reports you need to visit the '''NOAA Settings page'''.


<big>Editing</big>
* Firstly check the box 'Create NOAA files after daily rollover.
The template page shows all the different column layouts that are available. These are:
* Setup your site details on the '''Site Details''' tab.
ax-column1, ax-column2, ax-column3, ax-column4, ax-column5 and ax-column6
* Under '''Report Options''', configure the settings that suit you.
* Under '''Upload Options''' either accept the default location which is Reports/ or specify a location based on where you upload your data. To avoid issues always name this <somewhere>/Reports/


: These will always try to display the indicated number of columns but as the screen becomes small will automatically collapse into fewer columns as appropriate.
Finally you need to dose research to find out the '''Normal Mean Temperatures''' and '''Normal Precipitation''' for your location. These values need to be entered into the appropriate boxes under the respective tabs.
:; If there are more panels than columns they will gracefully split onto additional rows while retaining their column settings.
:; Rows with fewer panels than columns will either stretch the remaining panels across the full width or distribute them centrally - this can be controlled by you.


For full details visit [https://oaktreewebs.co.uk/wiki/ my wiki].
If you decide '''NOT''' to generate NOAA Reports then you need to edit the ''menu.js'' file uploaded to your web host. See below:


==Editing the website menu==
==Editing the website menu==


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full details of the menu and how to edit it.
The website menu is held in the file ''menu.js''. An image of this is shown below:


==Changing the Theme and Other Settings==
Menu configuration file for NEW CuMX template
Last modified: 2022/07/05 11:39:38
menu.js - typical name, you define the one used in setpagedata.js<br>
It is STRONGLY RECOMMENDED that if you customise this file, you create a new file with a different name, e.g. mymenu.js
and change setpagedata.js to use that file. This will avoid your customisations being accidentally overwritten during upgrades<br>
Properties:
.title - This is the text that appears in the menu bar.
.menu - can be 'b' (both menus), 'w' (wide menu ONLY), 'n' (narrow [mobile] menu ONLY)
.new_window:true - forces the link to open in new browser window
.url - This is the address of the page. if it is to an external page on another site it must include the full url
The two entries that are '#' are special and are configured by the website.
.forum:true - flags a forum link menu item, it will use the url provided in CuMX config, if that is blank the menu item will be hidden
.webcam:true - flags a webcam link menu item, it will use the url provided in CuMX config, if that is blank the menu item will be hidden


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full information on configuring and setting up the alternative website.
some text
menuSrc = [
{title: "Now", menu: "b", url: "index.htm"},
{title: "Today:, menu: "b", url: "today.htm"},
{title: "Yesterday", menu: "b", url: "yesterday.htm"},
{title: "Today-Yest", menu: "b", url: "todayyest.htm"},
{title: "Records", menu: "b", submenu: true, items: [
{title: "This Month", menu: "b", url: "thismonth.htm"},
{title: "This Year", menu: "b", url: "thisyear.htm"},
{title: "All Time", menu: "b", url: "record.htm"},
{title: "Monthly", menu: "b". url: "monthmlyrecords.htm"},
]},
{title: "Charts", menu: "b", submenu: true, items: [
{title: "Trends", menu: "b", url: "trends.htm"},
{title: "Select-a-graph", menu: "b", url: "selectchart.htm"},
{title: "Historic", menu: "b", url: "historic.htm"},
]},
{title: "Reports", menu: "b", url: "noaareport.htm"},
{title: "Forum", menu: "b", url: "#", forum: true, new_window: true},
{title: "Webcam", menu: "b", url: "#", webcam: true}
];

* If you want to change the language, simply enter translations for the titles only.
* If you want to add an entry copy the entry above and edit it as required.
* To create a whole new sub-menu, copy and paste either the section that starts with the '''title: "Records"...''' or '''title: "Charts"...''' and then edit as required.

==An Alternative Default Website==

Following on from the development of the current default website, the author of the default website has generated an alternative that is more adaptable and responsive.

It is designed to work on all screen sizes while using exactly the same data that is uploaded to the default website.

It allows your data to be sent to its own sub-folder of the site rather than mixing in with the web pages so makes it easier to manage. It comes with a number of themes or colour schemes that you can implement as required.

To find out more please visit the [[Alternative Public Website]] page.

==An Alternative Interface==

In addition to the existing Interface site used for managing your weather station, an additional Alternative Interface is also available from the author of the default website.

Details of this can be found here: [[Alternative_Interface|Alternative Interface]].

Latest revision as of 09:37, 11 February 2025

The default CMX website Development

These section of the Wiki will enable you to get the latest information and resources for the alternative to the default CumulusMX public website.

Alternative public website

As part of the development process of the CumulusMX Interface, I have generated a new public website (with template pages) as an alternative to the one provided with CumulusMX.

This template builds on the development of the AI and introduces a number of features and/or improvements.

Full details of the alternative public website, including screenshots can be fond on my wiki together with comprehensive instructions on how to install, use and modify.

Its major change is that all configuration data is held in one place: the CMXConfig object, so you can set the location of your data, your NOAA reports and the menu just by editing one part of one file.

The menu has also been enhanced with some additional features while maintaining the single json structure of the original.

This site also comes with new themes (unfortunately not compatible with the AI or previous versions) that should be easier to modify for your own needs. 

Download the latest version here (Updated:  (09:36 11 Feb 2025)) [Corrected missing 'at' on records pages]

You can view my site using the new default templates on Oaktree Weather .

Amendments since last revision

This is a full rebuild of the site.

Installing

Download the current zip file to you local machine and upload it to your web server.

  • Unzip it in the same location as your existing site - it will not overwrite the existing pages
    The new site uses .html pages whereas the existing default site uses .htm
    If you visit your site without specifying a page you will be taken to the new template pages,
    Specifying a page such as index.htm will display your old template pages.
  • Please clear your browser cache before viewing.

Your Own Pages

As with previous releases, the public website template also includes a template page.

The template.html page is provided to make it easier for you to add your own pages while retaining the look and feel of the website. The template page is called template.html.

Editing The template page shows all the different column layouts that are available. These are: 

ax-column1, ax-column2, ax-column3, ax-column4, ax-column5 and ax-column6
These will always try to display the indicated number of columns but as the screen becomes small will automatically collapse into fewer columns as appropriate.
If there are more panels than columns they will gracefully split onto additional rows while retaining their column settings.
Rows with fewer panels than columns will either stretch the remaining panels across the full width or distribute them centrally - this can be controlled by you.

For full details visit my wiki.

Editing the website menu

Please refer to my wiki for full details of the menu and how to edit it.

Changing the Theme and Other Settings

Please refer to my wiki for full information on configuring and setting up the alternative website.

Retrieved from "https://www.cumuluswiki.org/index.php?title=Default_Website_Development&oldid=11995"