|
==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 CMXCumulusMX public website shipped with version 3.10.x
'''This page is under development at the moment'''
===Alternative public website===
As part of the development process, aof newthe publicCumulusMX websiteInterface, templateI ishave availablegenerated whicha cannew eitherpublic sitwebsite on(with toptemplate ofpages) ofas totallyan replacealternative to the templateone suppliedprovided 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 [https://oaktreewebs.co.uk/wiki/ my wiki] together with comprehensive instructions on how to install, use and modify.
*It is significantly more responsive - adaptable to different viewing devices
*;All the fonts correctly scale on all browsers
*;All tables have been removed and replaced with more flexible elements
*;Panels correctly redistribute themselves on all screens.
*Panels can be rearranged with minimal coding skills
*Different colour schemes can be applied, again with minimal coding required
*It has the facility to specify a separate location for your data files
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.
==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,
*;Specifying a page such as index.htm will display your old template.
The menu has also been enhanced with some additional features while maintaining the single json structure of the original.
==Editing the website menu==
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.
The website menu is held in the file ''my-menu.js''. This ensures that it does not conflict with the existing menu.
'''Download the [https://www.cumuluswiki.org/images/0/08/PublicWebsite.zip latest version here]''' (Updated: (12:15 1st Apr 2025)) [This version accommodates HTML formatted NOAA reports and corrects the use of 'on' in all-time reports. Note that if you opt to use these formatted NOAA reports you will need to re-generate '''ALL''' existing reports '''and upload them'''.]
It is now possible to add dividing bars to sub-menus as well as extra menu items. The menu is shown below:
'''You can view my site using the new default templates on [https://ai2weather.uk Oaktree Weather ].
<nowiki>
menuSrc = [
{title: "Dashboard", menu: "b", url: "index.html"},
{title: "Today", menu: "b", url: "today.html"},
{title: "Yesterday", menu: "b", url: "yesterday.html"},
{title: "Today-Yest", menu: "b", url: "todayVyest.html"},
{title: "Gauges", menu: "b", url: "gauges.html"},
{title: "Records", menu: "b", submenu: true, items: [
{title: "This Month<i class=\"fa-solid fa-rectangle-list\"></i>", menu: "b", url: "recordsthismonth.html"},
{title: "This Year<i class=\"fa-solid fa-rectangle-list\"></i>", menu: "b", url: "recordsthisyear.html"},
{title: "All Time<i class=\"fa-solid fa-rectangle-list\"></i>", menu: "b", url: "recordsalltime.html"},
{title: "Monthly<i class=\"fa-solid fa-rectangle-list\"></i>", menu: "b", url: "recordsmonthly.html"},
{title: "", menu: "b", url: "#"},
{title: "All records<i class=\"fa-solid fa-rectangle-list\"></i>", menu: "b", url: "records.html"}
]},
{title: "Charts", menu: "b", submenu: true, items: [
{title: "Trends<i class='fa-solid fa-chart-line'></i>", menu: "b", url: "chartstrends.html"},
{title: "Select-a-graph<i class='fa-solid fa-chart-line'></i>", menu: "b", url: "chartsselect.html"},
{title: "Historic<i class='fa-solid fa-chart-line'></i>", menu: "b", url: "chartshistoric.html"}
]},
{title: "Reports", menu: "b", url: "noaareports.html"},
{title: "Forum", menu: "b", url: "#", forum: true, new_window: true},
{title: "Webcam<i class='fa-solid fa-camera'></i>", menu: "b", url: "#", webcam: true}
];
</nowiki>
'''Things to note'''
* It is possible to use ''Font-Awsome'' icons in the menu
*; You don't need to add sub-menu indicator icons as this is embedded in the code.
* You can add menu dividers to the sub-menus by adding an entry as shown below:
'''{title: "", menu: "b", url: "#"}'''
*; It can be placed in both menus, only the full screen menu or the mobile menu as required.
====OtherAmendments changessince last revision====
This is a full rebuild of the site.
The mobile menu now collapses correctly if you select a different sub-menu - you don't have to close a submenu manually before you open another one.
==Installing==
==Changing the Theme and Other Settings==
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.
This template comes with 33 themes to enable you to personalise the public website. Sixteen of these are light, 16 are dark and one is a high contrast theme. They are all located in the /themes folder.
===Your Own Pages===
To change the theme you will need to edit the page-manager.js file located in the 'js folder. The pertinent section is shown below:
'''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'''.
<nowiki>
let CMXConfig = {
'Theme': 'Nebulas-Blue',
'StaticHead': true,
'StaticFoot': true,
'Units': 'vh',
'PaddingTop': 2,
'PaddingBottom': 1,
'Seagull': {
'Animation': '',
'Duration': 5,
'OnTop': true
},
'Version': 3.0
}</nowiki>
<big>Editing</big>
This is located at the start of the file between lines 9 and 22. Do '''not''' edit anything else as you will in all likelihood break the site.
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.
===Theme===
:; If there are more panels than columns they will gracefully split onto additional rows while retaining their column settings.
The available themes are:
:; 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.
<nowiki>
Arcadia, Arcadia-Dark, Cherry-Tomato, Cherry-Tomato-Dark,
Chili-Oil, Chili-Oil-Dark, Crocus-Petal, Crocus-Petal-Dark,
Cylon-Yellow, Cylon-Yellow-Dark, Dark-Grey, Dark-Grey,
Emporador, Emporador-Dark, High-Contrast,
Lime-Punch, Lime-Punch-Dark, Marsala, Marsala-Dark,
Martini-Olive, Martini-Olive-Dark, MeerKat, MeerKat-Dark,
Nebulas-Blue, Nebulas-Blue-Dark, Red-Pear, Red-Pear-Dark,
Russet-Orange, Russet-Orange-Dark, Spring-Crocus, Spring-Crocus-Dark,
Valiant-Poppy, Valiant-Poppy-Dark</nowiki>
For full details visit [https://oaktreewebs.co.uk/wiki/ my wiki].
Any of these can be used but be careful not to disrupt the formatting - It must be in quotation marks and the whole entry must be followed by a comma.
==Editing the website menu==
===Other Settings===
====Layout====
The next '''FIVE''' options affect the overall layout of the pages.
* Static Header
*; By default the header will stay at the top of the page when long pages are scrolled.
*; If you prefer to have it scroll, then set '''StaticHead''': false,
* Static Footer
*; By default the footer will always stay at the bottom of your screen regardless of the length of the page.
*; If you want it to scroll then set '''StaticFoot''': false,
* Units to use for gaps
*; By default the site uses responsive units to adjust the gap between the header content and footer.
** You can use '''vh''' which ties the gap units to a percentage of the screen height
** You can use '''em''' which ties the gap to the height of the font (which is responsive), or
** You can use '''px''' which is a fixed height based on the resolution of your browser/screen.
* Gap between header and page content
*; Any positive value can be used but if using pixels, it must be an integer.
* Gap between page content and footer
*; As for above.
Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full details of the menu and how to edit it.
====The Seagull====
The seagull is a fixture on your screen. By default it fades in over two seconds. However, you can use a different animation if you prefer. The available animations are:
==Changing the Theme and Other Settings==
==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.
Please refer to my [https://oaktreewebs.co.uk/wiki/ wiki] for full information on configuring and setting up the alternative website.
Details of this can be found here: [[Alternative_Interface|Alternative Interface]].
| 