AlternativePublicWebsite: Difference between revisions

m
 
(19 intermediate revisions by the same user not shown)
This page is targeted at my Alternative Public Website and not the default website supplied with CumulusMX. This alternative is designed to work with the existing data that is uploaded by CumulusMX and supports some additional data not shown on the default site.
 
You can view this site at [https://ai2weather.uk
You can view this site at [https://ai2weather.uk/apw/ ai2weather.uk/apw/] and at [https://ai2weather.uk/cmxAs2/ ai2weather.uk/cmxAs2/]. Both these sites use the same template but are configured differently showing some of the features you can use.
 
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.
 
[[File:Screenshot 2025-10-26 at 11.36.35.png|500px|thumb|center|alt=Image of the Alternative Public Website|Screenshot of aiweather.uk]]
 
=== Download ===
 
You can download the file from [https://www.oaktreewebs.co.uk/wiki/doku.php?id=wiki:aw:altwebsite my Wiki] Version. 4 b:006 04/11/2025 10:43
 
It extracts to its own folder - apw, so you can extract to wherever without overwriting other content.
 
It comes with two template files for those of you that will need to generate your own pages to fit in with the theme / styles.
 
I have now fully updated [https://www.oaktreewebs.co.uk/wiki/doku.php?id=wiki:aw:start my Wiki] to provide an alternative upload option and provide more detailed information about using this version of the Alternative Public Website.
 
=== Configuration ===
 
This version of the Alternative Public Website comes with a remodelled version of cmxConfig. This is currently in the page-control.js file. You will need to edit this file to make it point to your data.
{| class="wikitable"
 
|+ Caption text
==== Heading text ====
{| style="margin-right: 50px;"
|-
| style="width: 20em;"|
| This is slightly different in this version although it still uses the same cmxConfig object.
cmxConfig = {
As can be seen, the object is now separated into sections with one or two extra entries in '''''Custom'''''.
Charts: {
Trends: "",
Historic: "",
},
Custom: {
StandardMenu: false,
Dropdown: true,
Theme: "",
Logo: "",
BannerImage: "",
StaticHead: true,
StaticFoot: true,
PaddingTop: '2',
PaddingBottom: '1',
PaddingUnits: 'em',
},
Data: "",
Menu: 'js/ows-menu.js',
NOAAReportPath: 'Reports/',
Gull: {
Animation: "",
Speed: 5,
OnTop: false,
},
Records: {
All: "",
Monthly: "",
}
};
 
|style="padding-left: 1em;"|
You will need to make sure that the Data and NOAAReportsPath entries point to your data and reports respectively.
===== Explanation =====
There are now 4 sections:- '''Charts''', '''Custom''', '''Gull''' and '''Records''' as well as three primary settings:- '''Data''', '''Menu''' and '''NOAAReportPath'''.
 
Of these you will need to check, and probably edit, '''Data''' and '''NOAAReportPath''' as these two provide the path to your data, wherever you have uploaded it.
Based on some feedback, if you want to use the standard menu format you need to set 'StandardMenu' to true.
 
* '''Data''': This must be set to point to the folder to which you upload your data. By default CumulusMX uploads its data to the same location as the html pages but you may have changed this.
This will than use a bar menu across the top of the page.
** If you upload your data to the same folder as the pages, this option should be empty.
** If you upload your data to a folder below the pages folder, i.e., to a folder inside the folder containing your pages e.g., '''data''', then this entry can contain a '''relative''' path; i.e. 'data/', './data/'. It could also be an absolute path from the root of your website; i.e. '/<pages>/data/' where <pages> is the folder name containing your website.
** If you upload to a folder, for example called '''data''', above the pages folder, then this entry can be a relative path such as '../data/'. You can also use an absolute path if you prefer.
* '''NOAAReportPath''': This must point to your NOAA Reports. The default installation of CumulusMX places these in a sub-folder of the html pages location. If you have changed this then you will also need to edit this entry.
** The same formats are accepted; relative or absolute paths.
===== The Menu entry =====
This points to the location of the supplied menu structure which is similar the original supplied with the default website. '''Note''' It is '''NOT''' the same so you cannot use the default menu supplied with CumulusMX.
Please refer to [https://www.oaktreewebs.co.uk/wiki/doku.php?id=start my Wiki] for a detailed explanation and details on how to create your own menu.
 
===== Other entries =====
I will be providing more detailed information here and on my Wiki soon.
The other entries in the cmxConfig structure allow you to customise the various options available in this template with the '''Custom''' section being the primary area for such customisation. '''''Charts and Records''''' These two option areas are probably best left as is. They record the last chart (Trends and Summary) and records sets (Monthly and All), viewed in the current browsing session and are changed dynamically.
 
|}
'''''Note'''''
This Wiki is difficult to format as I want. This is why I will now only be putting full information and the download link on [https://www.oaktreewebs.co.uk/wiki/doku.php?id=start my Wiki]
 
==== Change Log ====
 
'''Update: 11/10/2025 Version 5.0.1'''
'''Fixed'''
* cmxConfig not being loaded correctly on page change. The only page that has changed is '''page-control.js'''
|| <code>
cmxConfig = {
Charts: {
Trends: "",
Historic: "",
},
Custom: {
StandardMenu: false,
Dropdown: true,
Theme: "",
Logo: "",
BannerImage: "",
StaticHead: true,
StaticFoot: true,
PaddingTop: '2',
PaddingBottom: '1',
PaddingUnits: 'em',
},
Data: "",
Menu: 'js/ows-menu.js',
NOAAReportPath: 'Reports/',
Gull: {
Animation: "",
Speed: 5,
OnTop: false,
},
Records: {
All: "",
Monthly: "",
}
};
</code>
|}
 
'''Update 25/10/2025 - Version 5 b:005'''
=== Download ===
 
'''Changes'''
You can download the file [[File:PublicWebsiteV2.zip|thumb|alt=Version 5 b004|here]] Version. 5.0.3 25/10/2025 10:00
* Corrected the build number to b:005. This is the latest release. The only page that has changed is '''page-control.js'''.
 
'''Update 04/11/2025 - Version 4 build:006'''
It extracts to its own folder - apw, so you can extract to wherever without overwriting other content.
 
'''Changes'''
It comes with two template files for those of you that will need to generate your own pages to fit in with the theme / styles.
* Added 'menu' to the hamburger menu on the template1.html page only for those that want this feature. You will need to copy it to other pages as required.
 
* Verified that the historic charts work as required.
I have now fully updated [https://www.oaktreewebs.co.uk/wiki/doku.php?id=wiki:aw:start my Wiki] to provide an alternative upload option and provide more detailed information about using this version of the Alternative Public Website.
445

edits