The Alternative Interface (ai.cmx): Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m
 
(30 intermediate revisions by the same user not shown)
{{TOCright}}
== The Alternative Interface ==
[[Category:Cumulus MX]]
 
==IMPORTANT NOTICEOverview ==
 
The Alternative Interface (AI) is currently provided as an '''addition''' to the existing Interface for CumulusMX. At the current time, it should '''NOT''' be used as an alternative. In the near future this may be possible.
Due to issues with Alpaca Forms and the AI please DO NOT use any of the following AI pages to configure your station:
Configuration Wizard, Program Setup, Station Setup, Internet Setup,
Third Party Settings, Extra Sensor Settings, Calibration Settings, NOAA Settings,
MySQL Settings, Custom Logs, Custom Alarms, Display Options or
Locale Settings.
This issue has been resolved for an upcoming release of CumulusMX.
 
The existing Interface is maintained by Mark and will always provide all the tools needed to manage your installation of your weather station, The '''AI''' can be used as an alternative except immediately after an upgrade that has added new features to the interface as these may not yet be implemented on the AI (although every effort is made to do this).
== Overview ==
 
In the near future it may replace the existing Interface but this is still under discussion.
The Alternative Interface (AI) is currently provided as an '''addition''' to the existing Interface for CumulusMX. At the current time, it should '''NOT''' be used as an alternative. In the near future this may be possible.
 
The AI is built using the same technology as the alternative public website and is intended to be flexible and responsive on all screen resolutions. It is modular and designed so that end users can make changes to the way page content is displayed without too much knowledge of html coding. It comes with themes that allow its colour to be changed to suit your personal preferences and a configuration page so that you can do this easily.
 
====The AI for CumulusMX Version 4+====
The current version is for CumulusMX 3.28.1 and can be downloaded form [https://www.cumuluswiki.org/images/d/d7/AI2.zip AI2 for v3.28.01 build 32693]. Updated December 2023.
 
In this version ALL the features of the included Interface work as expected with some enhancements.
=== Installation ===
 
Further to the '''ai2''' supplied with CumulusMX, I have now developed '''aiX'''. This is has the same look and feel as the original but...
Download the above package and extract it to '''somewhere other than your CumulusMX files'''.
* Used more of the default JavaScript reducing its size and dependence on custom scripts
* Uses the new theme developed for the Alternative Website which are smaller and more easily modified to suite your own preferences.
* Uses newer html features where appropriate and...
* Removes redundant styles and scripts.
 
It can be loaded alongside the existing ai2 so you can evaluate and test it for your own weather station.
The package contains a second zip file and documentation which you should read to understand what it does and what you can do with it.
 
It can be downloaded from [[file:AiX.zip|here]] and also from [https://oaktreewebs.co.uk/wiki/doku.php?id=wiki:ai:overview my Wiki] ('''Updated 21/04/2025'''). Just unzip it in the interface folder of your CumulusMX installation and then access in the same way as ai2 but using the folder aiX.
Unzip the second zip file, again away from CumulusMX. This is to ensure that you don't accidentally overwrite critical files in the existing Interface.
 
Any comments / observations to me please.
You should now have a folder called '''ai2'''. This can be copied as is into the Interface folder so that it is a sub-folder of the Interface folder. You can rename the AI2 folder if you wish.
 
=== Installation ===
To use the AI, you should now use the url: '''localhost:8998/ai2/'''
 
As the AI is now included with CumulusMX, there is no need to download it unless an interim upgrade is provided.
 
To use the AI, you should now use the url: '''localhost:8998/ai2/'''
 
If you renamed the folder then use the new name rather than ''ai2''.
If you access the normal CumulusMX interface from a different computer then use the IP address of the machine running CumulusMX rather than ''localhost''.
If you run CumulusMX through a different port then use that port rather than 8998.
 
If you already have the AI running on your system then please '''don't''' try to merge the two - keep them separate as files will change with each release and this '''will''' cause you issues. Technically you could simply create new folders for each AI release and run any of them in conjunction with the existing Interface.
 
==General Features==
* The Header and Footer can be fixed (default) or scroll, the footer is always at the bottom of the screen when page content is short and always scrolls on small screens.
 
* If you don't use a Davis station directly connected to your system, you will '''not''' see the 'Davis Stats' panel.
 
* The fonts used are fully responsive.
 
Beneath these buttons you will see the values used in the CMXConfig object to store these settings. If your browser does '''not''' allow the setting to be stored, you can copy this directly into the ai-pagemanager.js file replacing what is already there.
 
==Editing pages directly==
On the next release of the AI, I will be adding extra pages to the wiki to help you take control of the AI and make changes to suit your needs.
 
The AI does include a 'development' page that you can use to try out different layouts with the available dates well as making it easy for you to change columns and column orders.
374

edits

Navigation menu