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

From Cumulus Wiki
Jump to navigationJump to search
(Created page with "== An Alternative (additional) Interface == Following the release of the new default website for CumulusMX, an alternative interface pack is now available. It runs in tandem...")
 
m (Remove unwanted content)
Tags: Mobile edit Mobile web edit
 
(152 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{TOCright}}
== An Alternative (additional) Interface ==
== The Alternative Interface ==
[[Category:Cumulus MX]]


== Overview ==
Following the release of the new default website for CumulusMX, an alternative interface pack is now available. It runs in tandem with the existing Interface and provides similar facilities. It's primary purpose at this stage is to make its style fit with the default website and provide the facility to change the colour theme used throughout the site. Some pages have had some cosmetic or layout changes and the menu has been condensed.


The Alternative Interface (AI) is currently provided as an '''addition''' to the existing Interface for CumulusMX.
Here are some screenshots of the AI.

<gallery>
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).
https://cumuluswiki.org/images/f/f0/AI_Alarm_Settings.png|The Alarm Setting page. It is now responsive.

https://cumuluswiki.org/images/9/9b/AI_Dashboard.png|A reworked dashboard. Alarms ar at the top. Looking to include records as well.
In the near future it may replace the existing Interface but this is still under discussion.
https://cumuluswiki.org/images/0/0f/AI_Data_Logs_Editor.png|The Data Logs Editor page. The table scrolls sideways within the page frame.

https://cumuluswiki.org/images/8/83/AI_Diary_Editor.png|A re-designed diary editor. The calendar also uses the theme colours.
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.
https://cumuluswiki.org/images/2/2a/AI_Extra_Sensor_Settings.png|This and most pages that use 'alpaca' forms are generally unchanged apart from the theming. Also shows one of the dropdown menus.

https://cumuluswiki.org/images/5/5f/AI_Gauges.png|The standard Gauges page but now the tooltips reflect the theme colours.
====The AI for CumulusMX Version 4+====
https://cumuluswiki.org/images/thumb/5/58/AI_Interface_Data_Log_Viewer.png/314px-AI_Interface_Data_Log_Viewer.png|The data log editor

https://cumuluswiki.org/images/6/6c/AI_Theme_Selector.png|The included theme selector. Themes can be temporary or permanent - it's up to you.
In this version ALL the features of the included Interface work as expected with some enhancements.
</gallery>

=== Installation ===

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 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.

==General Features==

This is a list of the features that the AI provides
* It has a large number of ''themes'' that can be used to change the colours used throughout the site

* 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.

* Dashboard graphics have been updated. These also appear on other weather data pages.

* The menu has been adapted to have fewer top level entries and focus on managing your weather station. It provides a link back to the default Interface if required. ('''See note at top of the page''').

* All pages use a feature called flexboxes so can be re-organised simply by changing the order style for each panel.

* The Utility pages have been combined into one page although the ''Latest Errors'' page is still available.

* Modifications have been made to all the Charts pages so that you can zoom in on small data sets. They also latch within the current session so if you move away from the page, and return, the same chart will be displayed.

* Modifications have been made to the Steel Series Gauge popup tooltips and it now includes the scrolling text graphic.

* The Logs pages have fixed regions to display line, date (and time) and scroll sideways rather than break the page layout. Their popup editors have been restyled.

* Font-Awsome icons are available throughout the site.

Significant, but not exhaustive improvements have been added for accessibility. Anyone requiring these features with knowledge of how to improve the AI2 should contact me.

== The Menu ==

As far as possible, the menu has been split between those pages that simply allow you to view information provided by your weather station and those that allow you to edit them.

[[File:Screenshot AI Menu.png|800px|alt=AI Menu|The latest AI Menu]]

===Viewing Data===
[[File:Screenshot Weather Data Menu.png|350px|left|alt=AI Weather Data menu|The mainWeather Data menu]]

====The first three menu items====
There are three top level menu items at the left to enable this.

These are '''Dashboard''', '''Weather Data''' and '''Extra Sensors'''.

The ''Dashboard'' menu item is always visible in both large and small screen, other menu items collapse until you expand the menu with the classic ''hamburger'' item.

The '''Weather data''' menu, as shown on th left, contains links for all other pages that simply allow you to view rather than edit data.

The exceptions are for the NOAA reports pages which can still be used to regenerate the currently displayed or all missing reports.

The ''Extra sensors''' menu provides access for any extra sensors that are attached or 'air linked' to your weather station.

<br><br><br><br><br><br><br><br><br>
===Editing Data===

[[File:Screenshot Settings Menu.png|600px|left|alt=The Settings Menu|The Settings Menu]]
As can be seen in the screenshot on the left, there are four top level menu items to the right of the ''diamond''.

These give access to either page that enable you to configure setting for your CumulusMX system or to editing your weather station data.

These are: '''Logs''', '''Settings''', '''Edit''' and '''Utilities'''.

These mirror the same menu items as on the default Interface. One feature of the AI is that the ''Settings'' Menu is a drop down panel with columns. On the mobile menu it reduces to two columns. This makes it easier to access all items even on small screens.
<br><br><br><br><br><br><br><br>
====The Default Interface====

Access is provided to this via the last top level menu at the extreme right of the menu (just visible in the screenshot). It will open the Interface in a new Window.

==Using the AI Settings Page==

The AI Settings page enables you to make global changes to the way the Interface looks. Things you can change are:

*Page Geometry
*:Use this to alter the gaps between the Header & Page content, and the Page content & Footer.
*:Change the units used to measure those gaps. The site uses the Font Height, the Screen Height or pixels. Pixels are fixed, the others are responsive.
*:Make the Header scroll with the page (Only if the page is long enough)
*:Make the Footer scroll with the page (only on long pages). The Footer will always scroll on small screens.

*The Theme
*:There are approximately 16 light themes
*:There are the same number of dark themes
*:There is one '''High Contrast''' theme.

*The Seagull Animation
*:The default is None (however, the seagull does still fade in at its default position).
*:You can choose:
*::'''Float down the screen''', or
*::'''Slide across the screen'''
*:If you chose an animation you can adjust the speed in seconds
*:Regardless of any animation, you can force the seagull to hide behind page content if preferred.

As you make changes to any of these settings it will be reflected in the current page only. To use the current selection you '''must''' click the bottom '''Use this Configuration'''. To restore the default settings as programmed into the AI use the button '''Restore default'''.

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.

Latest revision as of 09:44, 10 November 2024

The Alternative Interface

Overview

The Alternative Interface (AI) is currently provided as an addition to the existing Interface for 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).

 In the near future it may replace the existing Interface but this is still under discussion.

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+

In this version ALL the features of the included Interface work as expected with some enhancements.

Installation

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 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.

General Features

This is a list of the features that the AI provides

  • It has a large number of themes that can be used to change the colours used throughout the site
  • 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.
  • Dashboard graphics have been updated. These also appear on other weather data pages.
  • The menu has been adapted to have fewer top level entries and focus on managing your weather station. It provides a link back to the default Interface if required. (See note at top of the page).
  • All pages use a feature called flexboxes so can be re-organised simply by changing the order style for each panel.
  • The Utility pages have been combined into one page although the Latest Errors page is still available.
  • Modifications have been made to all the Charts pages so that you can zoom in on small data sets. They also latch within the current session so if you move away from the page, and return, the same chart will be displayed.
  • Modifications have been made to the Steel Series Gauge popup tooltips and it now includes the scrolling text graphic.
  • The Logs pages have fixed regions to display line, date (and time) and scroll sideways rather than break the page layout. Their popup editors have been restyled.
  • Font-Awsome icons are available throughout the site.

Significant, but not exhaustive improvements have been added for accessibility. Anyone requiring these features with knowledge of how to improve the AI2 should contact me.

The Menu

As far as possible, the menu has been split between those pages that simply allow you to view information provided by your weather station and those that allow you to edit them.

AI Menu

Viewing Data

AI Weather Data menu

The first three menu items

There are three top level menu items at the left to enable this.

These are Dashboard, Weather Data and Extra Sensors.

The Dashboard menu item is always visible in both large and small screen, other menu items collapse until you expand the menu with the classic hamburger item.

The Weather data menu, as shown on th left, contains links for all other pages that simply allow you to view rather than edit data.

The exceptions are for the NOAA reports pages which can still be used to regenerate the currently displayed or all missing reports.

The Extra sensors' menu provides access for any extra sensors that are attached or 'air linked' to your weather station.










Editing Data

The Settings Menu

As can be seen in the screenshot on the left, there are four top level menu items to the right of the diamond.

These give access to either page that enable you to configure setting for your CumulusMX system or to editing your weather station data.

These are: Logs, Settings, Edit and Utilities.

These mirror the same menu items as on the default Interface. One feature of the AI is that the Settings Menu is a drop down panel with columns. On the mobile menu it reduces to two columns. This makes it easier to access all items even on small screens.







The Default Interface

Access is provided to this via the last top level menu at the extreme right of the menu (just visible in the screenshot). It will open the Interface in a new Window.

Using the AI Settings Page

The AI Settings page enables you to make global changes to the way the Interface looks. Things you can change are:

  • Page Geometry
    Use this to alter the gaps between the Header & Page content, and the Page content & Footer.
    Change the units used to measure those gaps. The site uses the Font Height, the Screen Height or pixels. Pixels are fixed, the others are responsive.
    Make the Header scroll with the page (Only if the page is long enough)
    Make the Footer scroll with the page (only on long pages). The Footer will always scroll on small screens.
  • The Theme
    There are approximately 16 light themes
    There are the same number of dark themes
    There is one High Contrast theme.
  • The Seagull Animation
    The default is None (however, the seagull does still fade in at its default position).
    You can choose:
    Float down the screen, or
    Slide across the screen
    If you chose an animation you can adjust the speed in seconds
    Regardless of any animation, you can force the seagull to hide behind page content if preferred.

As you make changes to any of these settings it will be reflected in the current page only. To use the current selection you must click the bottom Use this Configuration. To restore the default settings as programmed into the AI use the button Restore default.

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.