Default Website Development: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
 
(78 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===
Please visit the [[AlternativePublicWebsite|Alternative Public Website]]
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.
Please note. This is NOT part of the CumulusMX Distribution package and is provided only for those interested in having a public site that uses similar structures to the Alternative Interface.


Although it should function at the date of release, no guarantees are given that it will continue to do so with subsequent releases of CumulusMX. Users should take time to investigate how it reacts and uses the library and data files uploaded by CumulusMX so that you are able to do some troubleshooting for yourself.
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.


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.
Once you have copied all the above files, you need to configure CumulusMX to upload your data at regular intervals.


==Editing the website menu==
==== 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.*


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full details of the menu and how to edit it.
You should not need to change either General or Advanced settings at this stage.


==Changing the Theme and Other Settings==
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:


Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full information on configuring and setting up the alternative website.
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.

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.

You can accept the default settings unless you have copied your site to a different location.

Your site should now be functioning. However, you may wish to visit the '''Utilities''' page and initiate an FTP upload of everything.

===NOAA Reports===
CumulusMX can generate NOAA Reports and the default website includes a page to display them.

To enable NOAA Reports you need to visit the '''NOAA Settings page'''.

* Firstly check the box 'Create NOAA files after daily rollover.
* Setup your site details on the '''Site Details''' tab.
* 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/

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 you decide '''NOT''' to generate NOAA Reports then you need to edit the ''menu.js'' file uploaded to your web host. See below:

===Complete ready to run alternative website pack===
We now have a complete [[ResponsiveSite.zip | alternative 'website']] ready for use. It is very similar to the current supplied website but with the following changes:

* There are two (2) gauges pages - gauges.htm and gaugesII.htm. They are both full width. The first removes the radio buttons from all gauges making is easy to see all gauges without scrolling. The options are provided in a dropdown page menu along with units. The second shows individual gauges in panels with their radio buttons.
* There is also a 'today v yesterday' page (todayYest.htm), for those that want to be able to compare readings.
* The layout of the sidebar is slightly different - it starts at the top of the right hand panel.
The menu has NOT been included in the zip and consequently you will need to adjust it to use the chosen pages listed above.
The zip file does contain the three css stylesheets; colours.css, mx-templates.css and gauges.css which will need to be copied to the correct location on your waebserver.

'''Please backup your site before uploading and extracting this alternative website'''

===Colour Themes===
The website and templates use colour themes to make it easier to change the colour throughout the site. By downloading the colour theme pack, you can simply rename the chosen colour as 'colours.css' and it will be applied throughout your site. All colour themes have now been updated to use ''css variables'' for the available theme colours. This makes it much easier to add your theme colours to your custom pages, or style sheets. It is also possible to apply theme colours to the gauges tooltips in this way.

For example, to add a coloured border to an element you can add the style like so:
<nowiki><span style="border-color: var(--d2);">**</span></nowiki> or <nowiki><span style="w3-theme-d2-bdr w3-border">**</span></nowiki>.

Visit the new '''[https://weather.oaktreewebs.co.uk/ATThemes.htm Theme Viewer]''' to preview any of these themes on a basic template page. You can download individual themes directly from that page. Alternatively you can download all themes (plus a 'readme.txt' file explaining the styles) [[File:ColourSchemes.zip | here]]
.

Additional themes have now been added. The download includes a reworked default 'colours.css' stylesheet to also use css variables and a ReadMe file to explain the styles used.

The current list is:
{| class="wikitable"
|-
! Theme !! Theme !! Theme !! Theme !! Theme !! Theme
|-
| AlmondBuff || AlmostMauve || Arcadia || BasicGrey || CherryTomato || ChiliOil
|-
| colours || CrocusPetal || CylonYellow || Emporador || GreyBlue (new) || GreyGreen (new)
|-
| GreyRed (new) || HarbourMist || Limelight || LimePunch || Marsala || MartiniOlive
|-
| MeerKat || NebulasBlue || QuietGrey || ReadPear || RussetOrange || SailorBlue
|-
| SargassoSea || SlateGrey || SpringCrocus || Tofu || Ultraviolet || ValiantPoppy
|-
| WarmSand || - || - || - || - || -
|}

Use this link [https://cumuluswiki.org/images/4/43/ColourSchemes.zip Additional colour schemes] to down load the schemes. Updated: 24th Jun 2023.

===An Alternate Default Website===
====Available 30th November 2023====
As an alternative to the supplied website, you can now download a reworked alternative [https://www.cumuluswiki.org/images/4/4c/DefaultWebSiteV3.zip Alternative Default Site]. (Updated 12:36 22nd November 2023).

This update almost completely uses flex boxes instead of tables and is very flexible to change. Just change the order style number to re-arrange the panes on the screen without any copy-n-paste required.

'''Important Note''' the system is configured to collect data from a sub-folder called 'data'. You need to edit the ws-extra.js file variable 'dataPath' on line 13. It should either be empty or contain a valid folder name followed by '/' to access your data. The gauges.js file has also been configured to use this variable.

To change the them you need to edit the 'page-manager.js file.
The object 'CMXConfig' holds all the options available. Full details are included in the readme.txt file included in the zip.

To see it in action visit: [https://weather.oaktreewebs.co.uk Oaktree Weather]

===An Alternative Interface===
A new addition to the existing Interface site used for managing your weather station is now available. You can find out about it here: [[Alternative_Interface|Alternative Interface]].

Latest revision as of 09:52, 26 October 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

Please visit the Alternative Public Website 

 Please note.  This is NOT part of the CumulusMX Distribution package and is provided only for those interested in having a public site that uses similar structures to the Alternative Interface.

Although it should function at the date of release, no guarantees are given that it will continue to do so with subsequent releases of CumulusMX. Users should take time to investigate how it reacts and uses the library and data files uploaded by CumulusMX so that you are able to do some troubleshooting for yourself.

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.

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.

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=12227"