They're free, but use at your own risk

The scripts referenced here are used in the operation of this weather station, and may be freely copied and used to support your station. Please note that you use these scripts at your own risk. No warranty is expressed or implied. I accept no liability for any damages that may ensue from their use.
You will need to configure them for your own particular weather station website.
 A RSS Feed is available to help keep you informed on updates to the scripts.

Many of these scripts are now available on GitHub at https://github.com/ktrue

If you find one or more of the scripts useful to you, please consider making a donation to help offset the routine expenses of operation of this website. Thanks for your kind support!

A Version History is available -- check back from time to time to see if there are updates to scripts you have downloaded earlier. Announcements of version updates and new scripts are made on WXForum.net and Weather-Watch forums and saratogaWXPHP Twitter account as they become available.

This page was updated Saturday, 05-Feb-2011 11:22 AM

Weather Display/PHP/AJAX Website Template Set - installation

Note: these template sets are now deprecated and replaced by the new V3 template sets. No additional updates will be made to the V2 templates here after 4-Feb-2011.

Note: As distributed, the template files are expected to be located in the document root of your website and the required subdirectories located below the document root. It is possible to use the templates from a subdirectory if the identical directory substructure is maintained and you continue to have URL and FILE relative addressing consistent (as it is now). You may be required to make additional changes that are not documented in the instructions if you wish to use the templates in a subdirectory.

The installation and configuration of the template set is fairly straightforward using these steps:

1. Make sure your website can run PHP (check it here). These templates will run with PHP4.x or PHP5.x. If you have PHP5, make sure that allow_url_fopen is enabled .. some of the scripts may use this feature.
   If you don't have PHP on your website then these templates will not work for you -- I suggest you use the Carterlake/AJAX/HTML template instead which only uses HTML/CSS and JavaScript and will work on any website.
2. Make a local backup of your current website to a .zip file or a subdirectory. You don't need to do this if you have no preexisting weather website (New Install).
3. Download the selected template set appropriate to your geographical location
   (USA, Canada, Canada-ML, World, World-ML)
   (Note:if you expect to offer multiple languages, then start with the -ML version of the template.
   You won't be able to easily upgrade to -ML later .. best to start with the version with multilanguage support)
   
   

   Download	Updated
   Canada Template .ZIP	15 Jan 2011 07:40pm PST (16 Jan 2011 03:40 GMT)
   Canada-ML Template .ZIP	03 Jan 2011 01:49pm PST (03 Jan 2011 21:49 GMT)
   USA Template .ZIP	15 Jan 2011 07:40pm PST (16 Jan 2011 03:40 GMT)
   World Template .ZIP	15 Jan 2011 07:40pm PST (16 Jan 2011 03:40 GMT)
   World Multilingual .ZIP	03 Jan 2011 01:49pm PST (03 Jan 2011 21:49 GMT)
   The following language plugins are for the World-ML template only. The contents are included in the full distribution, and are included here for ease of update to an existing World-ML template site.
   World-ML English Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Afrikkans Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Bulgarian Language Plugin	03 Jul 2009 04:02pm PDT (03 Jul 2009 23:02 GMT)
   World-ML Danish Language Plugin	03 Jul 2009 04:02pm PDT (03 Jul 2009 23:02 GMT)
   World-ML Dutch Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML German Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Finnish Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML French Language Plugin	06 Jan 2009 12:33pm PST (06 Jan 2009 20:33 GMT)
   World-ML Greek Language Plugin	17 Jan 2009 03:41pm PST (17 Jan 2009 23:41 GMT)
   World-ML Italian Language Plugin	16 Jul 2009 03:49pm PDT (16 Jul 2009 22:49 GMT)
   World-ML Norwegian Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Polish Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Portuguese Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Romanian Language Plugin	22 Apr 2010 05:50pm PDT (23 Apr 2010 00:50 GMT)
   World-ML Spanish Language Plugin	06 Jan 2009 12:22pm PST (06 Jan 2009 20:22 GMT)
   World-ML Swedish Language Plugin	06 Jul 2009 12:15pm PDT (06 Jul 2009 19:15 GMT)

   [see Version History]
   
   
4. Download the Icons for your weather forecast program.
   Use the Carterlake Icons for USA, Canada [if you have WXSIM], World, World-ML .
   Use the Environment Canada icons for Canada, Canada-ML.
   If you have advforecast2.php, WU-forecast.php or WXSIM plaintext-parser.php installed, you can reuse your existing /forecast/images icons.
   If you have ec-forecast.php installed, you can reuse your existing /ec-icons images.
   
   Download: Carterlake Forecast/Icons .zip | Canada /ec-icons .zip
   
   
5. Edit the Settings.php file and perform the common configuration and then the template-specific configuration
   (USA, Canada, Canada-ML, World, World-ML).
6. Edit the top.php file to make changes to the site <meta> tags if necessary. To keep your website XHTML 1.0-Transitional, make sure new <meta> tags are self terminated with attributes in lower case
   <meta content-type="... />
7. Edit the ajaxWDwx.js script and configure it for location of clientraw.txt and desired units (English or Metric). Use the comments in the script itself to guide the configuration.
   Note: for Canada-ML and World-ML template, leave the Language section of ajaxWDwx.js in English -- the proper translation will be loaded using the language-LL.js automatically if a language other than English is selected on the website.
8. Edit the wxabout.php page to include the description of your weather station and your town.
   For Canada-ML and World-ML template, edit the English in wxabout.php, and edit the wxabout-LL.html files for each language you plan to offer on your website.
9. For World and World-ML template users, edit the wxradar.php and wxadvisory.php pages to have content from your national meterological service.
10. Follow the instructions in the README.txt in the WD-webfiles directory of the distribution to configure Weather-Display to begin uploading testtags.txt to testtags.php.
    Note: you only need to upload testtags.txt to testtags.php as of Version 2.0 of the templates.
    the prior trends-inc.txt/trends-inc.html set is no longer used.
    
    Detail instructions thanks to Martin from http://www.hebrides-weather.co.uk/
    
    Place the testtags.txt in your wdisplay/webfiles folder on your weather system PC.
    In the WD main program page, goto Control Panel > Web files/Web page/realtime FTP/WDL > Custom Web page setup TAB.
    In the bottom right you'll see a an area marked "Special File Conversion".
    In the top text box enter "testtags.txt" (local file) then "testtags.php" (remote filename)
    Now turn the switch to ON and click "test", then OK to exit the window.
    This will convert the files to what you need, now we need to upload them to the website.
    
    Upload:
    Control Panel > Internet File Creation & Upload > Setup Page #2. Look down the list for File #29 "Special Custom File Convers." and click the "Set" button.
    Click the "Show file create times" button and set the create interval, I have mine set to create every 5 minutes. Then click "Save Now" and then "Show file upload times" and set these to the same as the create times, click "Save Now" and turn the switch to ON if it's not already there, then click OK to exit the window.
    
11. Configure Weather-Display to upload clientraw.txt to your website.
12. If your website already includes any of the following scripts, you'll need to copy settings from your existing scripts to the corresponding settings area in the script of the same name. See the file list for details.
13. If you have custom wind-rose graphics in your existing ajax-images/ directory, copy them to the new ajax-images/ directory from the distribution.
14. If you're in the Southern Hemisphere, you might want the moon images that match your view of the sky at night. Use these to replace the images in /ajax-images directory.
    
    Download: Southern Hemisphere Moon Images
     
15. If you have an existing Carterlake template on your website, copy the weather-screen.css and weather-print.css files to the local distribution to preserve your settings. If you're not using the ajax-dashboard or ajax-sidebar, on your existing Carterlake template site, you'll need to add the .ajaxDashboard and .ajaxSidebar entries from the weather-screen-php.css to your existing weather-screen.css.
16. Now you can upload the files to your website using FTP (ASCII mode for all .php, css and txt files, BINARY mode for all .gif, .jpg, .png). Upload the ajax-images directory. Upload /forecast/images and /ec-icons if you don't alread have them installed. Upload radar/ if you are using the Canada template set.
17. View each new page of your site starting with wxindex.php and use the navigation links to navigate all pages. Your website should be ready for use.

When you've decided that the new site is to be made 'live', then use these steps to have it become the primary display.

1. Rename (on your local disk) wxindex.php to index.php
2. Edit menubar.php (or flyout-menu.xml for flyout-menu users) to replace wxindex.php with index.php in the link.
3. Upload menubar.php (or flyout-menu.xml for flyout-menu users) and index.php to your website.

NOTE: the Canada-ML and World-ML templates contain substantial modifications to many of the common routines shared by the other template sets to enable the translation functions.
Make sure you install ALL the Canada-ML or World-ML files over any preexisting copies of the same name including the ajax-images/ graphics , and make sure you are running Weather-Display in English, otherwise the translation feature of the Canada-ML or World-ML template will not work correctly.

Starting with Version 2.0, the Canada, USA, World templates now use the dashboard, trends and other function from the multilingual templates (minus the translation functions). This change was released 6-Jul-2009, and details are available.

Included items in the distribution zip files

Legend: R=Required, O=Optional, C=cache file used by script, n/a=Not Applicable, *=note in description column.
Green=No conflict with existing installations,
Yellow=possible conflict with existing installation .. read referenced note number details below.

If you have an existing script, copy settings from your current script into the new copy to preserve current site operation while you're updating. You should use the new copy of the script on your site as it has integration with the Settings.php configuration function.

Notes:

1. If you've already installed the /forecast/images because of prior installation of advforecast2.php, WU-forecast.php or WXSIM plaintext-parser.php, you can use your existing NOAA icon set
2. If you've previously installed ec-forecast.php with the /ec-icons you may reuse the icons. Be advised that EC has updated the look of their icons so you may find the newer ec-icons set more to your liking.
   You will need to update your ec-forecast.php script with the latest version which has Settings.php awareness.
3. If you've previously installed the ec-radar.php script, you'll already have a /radar/ cache directory. You will need to update to this version of ec-radar.php which has Settings.php awareness.
4. You need to pick a pair of CSS files to use (one -screen, one -print) from the default set included with it's 800px screen size, or the original Carterlake full-screen size. The original Carterlake CSS files have additions for .ajaxDashboard and .ajaxSidebar definitions. If you have your own customized weather-screen.css and weather-print.css files, you may use them if you add the CSS definitions for .ajaxDashboard and .ajaxSidebar to your current CSS files.
5. The ajaxgizmo.js JavaScript is slightly updated with this release, but if you've used the Carterlake/AJAX/HTML templates or the AJAX/WD/PHP Demo files, that copy of ajaxgizmo.js will work fine.
6. The ajaxWDwx.js JavaScript is Version 2.11 which supports the new icon=35 (windy/rain). You should replace your current copy with this updated version.
7. The thermometer.php script is updated to support Settings.php configuration. You should replace your current copy with this version. The support graphic (thermometer-blank.png) has not changed and you can retain your old copy if you wish.
8. The advforecast2.php script is changed to provide support for Settings.php configuration. You should replace your existing copy of the script with this updated version.
9. If you'd installed the WD/AJAX/PHP Demo files, please replace the ajax-dashboard.php and ajax-sidebar.php with these versions. They include support for Settings.php configuration, and the ajax-dashboard.php is updated to handle weather stations with/without UV and/or Solar sensors.
10. If you've previously installed the WXSIM plaintext-parser.php, please replace your copy of the script with this one as it supports Settings.php configuration. Also replace the plaintext-parser-data.txt (and for Canada, the plaintext-parser-lang-fr.txt file) with the included files.
11. If you've previously installed the radar-status.php script, please replace your copy of the script with this one as it provides support for Settings.php configuration.
12. If you've previously installed the quake-USA-test.php or quake-WORLD-test.php script, please replace your copy of the script with this one as it provides support for Settings.php configuration.
    Note: quake-WORLD-test.php and quake-USA-test.php scripts have been renamed to quake-WORLD.php and quake-USA.php respectively with V1.10 of the distributions.
13. If you've previously installed the rss-advisory.php script, please replace your copy of the script with this one as it provides support for Settings.php configuration.
14. If you've previously installed the rss-top-warning.php script, please replace your copy of the script with this one as it provides support for Settings.php configuration.
15. If you've previously installed the WD/AJAX/PHP Demo, please replace the testtags.txt in your c:\wdisplay\webfiles directory with the included in this distribution (WD-webfiles directory).. It provides support for the wxastronomy.php page. As of Version 2.00 of the templates, the trends-inc.txt/trends-inc.html files are no longer required to display trends .. the required data is incorporated in testtags.txt V1.04 or higher.
16. If you've previously installed the WU-forecast.php script, you can continue to use the /forecast/icons from your original installation. Please replace the WU-forecast.php script with the distribution version -- it provides support for Settings.php configuration.
17. If you've previously installed the WU-radar-inc.php, please copy your settings from it and paste them in the settings area of the WU-radar-inc.php script included with this distribution. The updated WU-radar-inc.php supports Settings.php configuration (but not ALL the configuration.. that's why the copy of your settings from your existing copy was necessary to avoid going through the setup process for the script again.
18. If you use either wxlive.php or wxmesomap.php, be aware you'll need to purchase a license for the product(s). Copy the associated Flash .swf file(s) into the same directory as the wxlive.php, wxmesomap.php.
    You'll need to also upload swfobject.js and wdl-mml-forcesize.js into the same directory. The wxlive.php and wxmesomap.php pages need configuration to point to the XML file to run the product.
    See the WDL-MML-readme.txt for additional information.

Proceed to Settings.php config | menubar.php config | plugins page