AlternativePublicWebsite: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
 
(18 intermediate revisions by the same user not shown)
Line 8: Line 8:


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.
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 2026-02-16 at 10.56.03.png|500px|thumb|center|alt=Alternative Public Website|The latest Alternative Public Website as on ai2weather.uk]]
=== Download ===

You can download the file from [https://www.oaktreewebs.co.uk/wiki/doku.php?id=wiki:aw:altwebsite my Wiki] Version 5.01 16/02/2026 10:11

It extracts to its own folder - apw, so you can extract to wherever without overwriting other content.

It comes with one template file 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 ===
=== Configuration ===


This version of the Alternative Public Website comes with a remodelled version of cmxConfig. This is now in its own file - config.js. You will need to edit this file to make it point to your data.
{| class="wikitable"

==== Heading text ====
{| style="margin-right: 50px;"
|-
|-
| style="width: 60em;"|
| This is slightly different in this version although it still uses the same cmxConfig object.
As can be seen, the object is now separated into sections with one or two extra entries in '''''Custom'''''.


<nowiki>cmxConfig = {
You will need to make sure that the Data and NOAAReportsPath entries point to your data and reports respectively.
// Edit this to set your required configuration
"Custom": {
"StandardMenu": false, // Set to true or false
"Dropdown": true, // set to true or false
"Theme": "", // Set to the name of an existing theme WITHOUT 'css'
"Logo": "", // Set to the absolute or relative path and name of the image to use OR 'None'
"BannerImage": "", // As above or leave blank
"BannerPosition":"center center", // Use allowable css values including units
},
"DataPath": "", // Set to the absolute or relative path of your data
"Geometry": {
"StaticHead": true, // true or false accepted
"StaticFoot": true, // true or false accepted
"PaddingTop": 2, // Numeric value only (real numbers accepted but ignored if using px as unit)
"PaddingBottom": 1, // Numeric value only ( ditto )
"Units": "em", // Accepts any valid css unit
},
"Gull": {
"Animation": "", // Blank, Expand, 'Enter left', 'Enter right' or Drop only
"Speed": 5, // Positive numeric values only (can be real)
"OnTop": true, // true or false
},
"Panels": {
"Shadows": "", // Blank, Basic or Enhanced only
"VariableHeights": false,// true or false
},
"Menu": "json/ows-menu.js", // Relative path and name of menu script.
"NOAAPath": "Reports", // Absolute or relative path to your NOAA Reports
}
// You are advised to leave these blank.
cmxSession = {
"Records": {
"Monthly": "", // Numeric integer representing to month to show - zero based
"All": "" // As above and 'ThisYear', 'ThisMonth' or 'Alltime'
},
"Charts": { // ONLY CHOOSE CHARTS FOR WHICH YOU HAVE DATA OR LEAVE BLANK.
"Trends": "", // One of: temp, press, wind, windDir, rain, dailyrain, humidity, solar, sunhours, and sensor dependant
"Historic":"" // One of: Temp. Press, Wind, WindDir, Rain, Humidity, Solar, DegDays, TempSum, ChillHrs, Snow
}
}</nowiki>
|style="padding-left: 1em;"|
===== Explanation =====
The object is organised alphabetically as this is how it is stored. There are both root level entries and sections, The sections are:- '''Custom''', '''Geometry''', '''Gull''' and '''Panels'''.


The root level entries are:- '''DataPath''', '''Menu''' and '''NOAAPath'''.
Based on some feedback, if you want to use the standard menu format you need to set 'StandardMenu' to true.


Of these you will need to check, and probably edit just the root level entries - '''DataPath''' and '''NOAAPath''' as these two provide the path to your data, wherever you have uploaded it.
This will than use a bar menu across the top of the page.


* '''DataPath''': 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.
I will be providing more detailed information here and on my Wiki soon.
** If you upload your data to the same folder as the pages, '''this option should be empty'''.
** If you upload your data to another location, then this entry can be an absolute or relative path to that location. Absolute paths always start with a '/' character; any other character implies relative path.
* '''NOAAPath''': 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 ====
The other entries in the cmxConfig structure allow you to customise the various options available in this template.
===== Custom =====
This section focuses on colours, the logo and banner images and the menu.
===== Geometry =====
Allows you to adjust the spacing around the page content and whether or not the banner and/or footer are fixed in position. The Gull now positions correctly based on the fixed status of the footer.
===== Gull =====
Primarily concerned with the animation of the gull at the bottom of the page and whether or not it is above or below page content.
===== Panels =====
A new feature that allows you to add one of two variations of shadow to the panels displayed on each page. Some panels will not display shadows regardless of these settings.
==== the cmxSession Object ====
This is used dynamically by visitors to your site. It records the last chart / record set viewed so that when re-visiting the page (in the correct session), the same chart/record set is displayed.

|}
'''''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 ====

'''Version 5.01''' ''dated: 16/02/2026''

This is a complete re-write of the '''Alternative Public Website''' BUT that re-write only affects the header and footer areas and the top and tail of the main content area.

It should be possible to copy any personal additional page content into the template.htm file provided.

==== To do this ====
* Locate the '''<nowiki><div id="siteContent_Inner"></nowiki>''' in the current version of your page.
* Select ALL code '''inside''' this div and copy it to your clipboard.
* Locate the '''<nowiki><div id="subContent"></nowiki>''' in the template file provided with this update.
* Paste your old code inside this area, overwriting anything that is in the template down to its corresponding '''<nowiki></div></nowiki>'''
* Do make sure that you don't add any extra '''<nowiki><div></nowiki>'''s or remove any that close of the '''<nowiki><div id="subContent></nowiki>''' area
* Rename the template.html page appropriately.


'''Update: 11/10/2025 Version 5.0.1'''
'''Update: 11/10/2025 Version 5.0.1'''
Line 69: Line 165:
'''Changes'''
'''Changes'''
* Corrected the build number to b:005. This is the latest release. The only page that has changed is '''page-control.js'''.
* Corrected the build number to b:005. This is the latest release. 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 04/11/2025 - Version 4 build:006'''
=== Download ===


'''Changes'''
You can download the file [[File:PublicWebsiteV2.zip|thumb|alt=Version 5 b005|here]] Version. 5 b:005 25/10/2025 10:00
* 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.
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.

Latest revision as of 17:08, 16 February 2026

The Alternative Public Website

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 

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.
Alternative Public Website
The latest Alternative Public Website as on ai2weather.uk

Download

You can download the file from my Wiki Version 5.01 16/02/2026 10:11

It extracts to its own folder - apw, so you can extract to wherever without overwriting other content.

It comes with one template file for those of you that will need to generate your own pages to fit in with the theme / styles.

I have now fully updated 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 now in its own file - config.js. You will need to edit this file to make it point to your data.

Heading text

 cmxConfig = {
    //  Edit this to set your required configuration
    "Custom": {
        "StandardMenu": false,   // Set to true or false
        "Dropdown": true,       // set to true or false
        "Theme": "",            // Set to the name of an existing theme WITHOUT 'css'
        "Logo": "",             // Set to the absolute or relative path and name of the image to use OR 'None'
        "BannerImage": "",      //  As above or leave blank
        "BannerPosition":"center center",   // Use allowable css values including units
    },
    "DataPath": "",             // Set to the absolute or relative path of your data
    "Geometry": {
        "StaticHead": true,     // true or false accepted
        "StaticFoot": true,     // true or false accepted
        "PaddingTop": 2,        // Numeric value only (real numbers accepted but ignored if using px as unit)
        "PaddingBottom": 1,     // Numeric value only ( ditto )
        "Units": "em",          // Accepts any valid css unit 
    },
    "Gull": {
        "Animation": "",        // Blank, Expand, 'Enter left', 'Enter right' or Drop only
        "Speed": 5,             // Positive numeric values only (can be real)
        "OnTop": true,          // true or false
    },
    "Panels": {
        "Shadows": "",          // Blank, Basic or Enhanced only
        "VariableHeights": false,// true or false
    },
    "Menu": "json/ows-menu.js", // Relative path and name of menu script.
    "NOAAPath": "Reports",      // Absolute or relative path to your NOAA Reports
}
  //  You are advised to leave these blank.
cmxSession = {
    "Records": {
        "Monthly": "",  // Numeric integer representing to month to show - zero based
        "All": ""       // As above and 'ThisYear', 'ThisMonth' or 'Alltime'
    },
    "Charts": {         // ONLY CHOOSE CHARTS FOR WHICH YOU HAVE DATA OR LEAVE BLANK.
        "Trends": "",   // One of: temp, press, wind, windDir, rain, dailyrain, humidity, solar, sunhours, and sensor dependant
        "Historic":""   // One of: Temp. Press, Wind, WindDir, Rain, Humidity, Solar, DegDays, TempSum, ChillHrs, Snow
    }
}
Explanation

The object is organised alphabetically as this is how it is stored. There are both root level entries and sections, The sections are:- Custom, Geometry, Gull and Panels.

The root level entries are:- DataPath, Menu and NOAAPath.

Of these you will need to check, and probably edit just the root level entries - DataPath and NOAAPath as these two provide the path to your data, wherever you have uploaded it.

  • DataPath: 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.
    • If you upload your data to the same folder as the pages, this option should be empty.
    • If you upload your data to another location, then this entry can be an absolute or relative path to that location. Absolute paths always start with a '/' character; any other character implies relative path.
  • NOAAPath: 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 my Wiki for a detailed explanation and details on how to create your own menu.

Other entries

The other entries in the cmxConfig structure allow you to customise the various options available in this template.

Custom

This section focuses on colours, the logo and banner images and the menu.

Geometry

Allows you to adjust the spacing around the page content and whether or not the banner and/or footer are fixed in position. The Gull now positions correctly based on the fixed status of the footer.

Gull

Primarily concerned with the animation of the gull at the bottom of the page and whether or not it is above or below page content.

Panels

A new feature that allows you to add one of two variations of shadow to the panels displayed on each page. Some panels will not display shadows regardless of these settings.

the cmxSession Object

This is used dynamically by visitors to your site. It records the last chart / record set viewed so that when re-visiting the page (in the correct session), the same chart/record set is displayed.

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 my Wiki

Change Log

Version 5.01 dated: 16/02/2026

This is a complete re-write of the Alternative Public Website BUT that re-write only affects the header and footer areas and the top and tail of the main content area.

It should be possible to copy any personal additional page content into the template.htm file provided.

To do this

  • Locate the <div id="siteContent_Inner"> in the current version of your page.
  • Select ALL code inside this div and copy it to your clipboard.
  • Locate the <div id="subContent"> in the template file provided with this update.
  • Paste your old code inside this area, overwriting anything that is in the template down to its corresponding </div>
  • Do make sure that you don't add any extra <div>s or remove any that close of the <div id="subContent> area
  • Rename the template.html page appropriately.

Update: 11/10/2025 Version 5.0.1

Fixes:

  • The Soil Moisture chart now works as expected - rogue line in code.

Changes:

  • You can now opt to not have a logo if you are using a banner image. Make the logo 'None'.
  • The line above the menu has been removed.
  • You can now add your own text to the Information panel by editing the file index-info.html (supplied). The content of this file will replace anything that I have hard coded into the block.

Update 16/10/2025 Version 5.0.2

Fixed

  • The tooltip on the Wind Direction chart now uses the same styles as others.

Changed

  • All Trends charts now have improved accessibility descriptions
  • The index-info.html file can now start with paragraph tags meaning the index.html page has changed.

Update 17/10/2025 - Version 5 b:003 Please note the addition of a build number.

Fixed

  • Historic charts now show the correct timezone
  • Spaces added to units on Dashboard, Today, Yesterday and Today v Yesterday pages.

Corrections

  • Version and build numbers added to template

Added

  • Two new theme colours and their corresponding dark versions - Field Green and Meadow Green.

Update 23/10/2025 - Version 5 b:003

Fixed

  • Incorrect data being displayed on 'Today', 'Yesterday' and Today v Yesterday'. pages.

Changed

  • Hidden the information panels on all records pages.
  • Changed to ID used for the Almanac popup so that 'Almanac' can be added to the menu.


Update 25/10/2025 - version 5 b:004

Fixed

  • cmxConfig not being loaded correctly on page change. The only page that has changed is page-control.js

Update 25/10/2025 - Version 5 b:005

Changes

  • 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

Changes

  • 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.
Retrieved from "https://www.cumuluswiki.org/index.php?title=AlternativePublicWebsite&oldid=12349"