SteelSeries Gauges: Difference between revisions

no edit summary
No edit summary
 
(11 intermediate revisions by 2 users not shown)
{{AddOnBanner|name=SteelSeries Gauges|type=Web Page|author=Mark Crossley|contact='mcrossley' via the forum|updated=2523 AugustOctober 20132018|version=2.47.42}}
[[Image:gauge.png|left]]
[[Image:Steelseries-sshot-3.jpg|thumb|Default Gauges]]
Please note that these gauges use HTML5 'features' and so will not run on older browsers, in particular versions of Internet Explorer prior to IE9. Also if you are planning on embedding the code in an existing page, then the whole page should be converted to the HTML5 standard.
 
== Quick Start Guide for Cumulus 1 Users (Other software users may want to scan this too) ==
 
1. Extract all the file in the SteelSeries zip file to a folder on your PC.
 
2. Copy "realtimegaugesT.txt" to your Cumulus web folder (N.B. The file in the SteelSeries zip is for Cumulus 1, Cumulus MX supplies its own file with this name, but using a slightly different format).
 
3. Copy "gauges-ssT.htm" to your Cumulus web folder.
 
4. On main Cumulus screen, in '''Configuration''' menu, pick ''Internet'' option, '''Files''' tab and typecomplete a row for each file (again this guide is for Cumulus 1, Cumulus MX automatically uploads realtimegauges as a standard file):
 
realtime file:-
Realtime = Yes
FTP = Yes (unless you are local hosting)
UTF-8 = Yes
gauges HTML file:-
Process = Yes
Realtime = No
FTP = Yes (unless you are local hosinghosting)
UTF-8 = Yes
 
(The standard Cumulus template is Cumulus\web\gaugesT.htm, this uses "Cumulus\web\gauges-ssT.htm" so you can retain the old one).
'''''NOTE''': Cumulus does not actually update any data when it processes the (gauges-ssT.htm) web pagetemplate, it simply replaces the 'static-ish' values such as your station name, location, version etc. If you wish you can edit the ''gauges-ssT.htm'' file and directly enter the information, then you do not need to get Cumulus to process the file, just copy it once to your web site, removing the 'T' from the filename. OR, you can let Cumulus process and upload the HTML file to your web site a few times, then disableremove it againfrom 'files' tab table.''
 
5. If required edit the "gauges.js", the key items are at the top:
 
- The path on your website to the "realtimegauges.txt" file.
- The relative path on your website to your 'trend' graphs folder (''images'' in standard Cumulus set up).
- The relative path on your website to your old 'gauges.htm' page. (users with 'old' browsers will be redirected to this page)
 
6. If you do not require the UV/Solar Index gauges, then change the lines
showSolarGauge  : false,
 
7. IfFTP youthe arefolders installing'css' toand a'scripts' weband foldertheir differentcontents from(the yourfiles Cumulusthat 'root'are oncontained yourin webthe server,ZIP youfile) willfrom alsoyour needPC to edit the folder where your "gauges-ss.htm" file, andis amendlocated (probably the relativesame pathfolder towhere all your other Cumulus "weatherstyle.css"HTM filefiles are located) on your web server.
 
98. Test the page.
8. FTP the folders 'css' and 'scripts' and their contents (the files that are contained in the ZIP file) from your PC to the folder where your "gauges-ss.htm" file is located (probably the same folder where all your other Cumulus HTM files are located) on your web server.
 
9. Test the page.
 
=== Relative Paths ===
 
Are just that, they specify where something is on your web site folder structure relative to the page you are currently displaying.
If you are installing to a web folder different from your Cumulus 'root' on your web server, you will first need to edit the "gauges-ss.htm" file, and amend the relative path to your Cumulus "weatherstyle.css" file. So if you copy these gauges to a folder called 'gauges-ss' in the root of your website, the relative path of the Cumulus css file is one folder back in the path. You would then enter the path as "../weatherstyle.css".
 
== What Next? ==
= Downloads =
 
The code for the gauges canis benow downloadedon fromGitHub, here:it can be [httphttps://wiki.sandaysoftgithub.com/filesmcrossley/Steelseries/gaugesSteelSeries-ssWeather-v2-4-4.zipGauges/ Downloadviewed here].
The gauges package can be downloaded from here: [https://github.com/mcrossley/SteelSeries-Weather-Gauges/archive/master.zip Download here].
 
 
= Release History =
 
The latest version of the gauges is 2.47.42, a full version history can be [[SteelSeries_Versions|found here]].