deformed-offering

Free Weather Website Templates

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.
RSS feed for Scripts Updates A RSS Feed is available to help keep you informed on updates to the scripts.

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

Note Item USA Canada Canada
ML
World World
ML
Description
* /ajax-images/* R R R R R Collection of conditions images, moon images and support graphics (*Note: may replace existing wind-rose graphics) (included in all distributions)
* /ajax-images-original/* O O O O O Collection of original wind-rose images.
1 /forecast/images/* R O* R R R Forecast icons for USA, World. Required for Canada, Canada-ML if WXSIM is used.
Download: Carterlake-icons
2 /ec-icons/* n/a R R n/a n/a Forecast icon set for Environment Canada
Download: ec-icons
3 /radar/* n/a R R n/a n/a Cache directory for Environment Canada Radar
4 weather-screen-php.css R* R* R* R* R* CSS file for screen viewing 800px width
4 weather-print-php.css R* R* R* R* R* CSS file for printing 800px width
weather-screen-*-*.css R R R R R Collection of wide and narrow Themes (part of Theme Changer system by Mike Challis)
4 weather-screen.css O* O* O* O* O* CSS file for screen viewing (Carterlake original style)
4 weather-print.css O* O* O* O* O* CSS file for printing (Carterlake original style)
5 ajaxgizmo.js R R R R R JavaScript for rotating display of conditions by ajax-gizmo.php
6 ajaxWDwx.js R R R R R JavaScript for AJAX updates of conditions from clientraw.txt to webpage (ajax-dashboard, ajax-sidebar, ajax-gizmo all use)
  language-LL.js n/a n/a R n/a R AJAX language translation support for language=LL
  floatTop.js R R R R R Used for floating 'Top' link on wxhistory.php
  wdl-mml-forcesize.js O* O* O* O* O* Required if you have MML or WDL installed for wxmesomap.php and/or wxlive.php
  swfobject.js O* O* O* O* O* Required if you have MML or WDL installed for wxmesomap.php and/or wxlive.php
CanadaLegend.gif n/a R R n/a n/a Legend displayed on wxadvisory.php for Canada map.
7

thermometer-blank.png,
thermometer-blank-black.png

R R R R R Backgrounds for thermometer.php image
8 advforecast2.php RC n/a n/a n/a n/a NWS Forecast script
9 ajax-dashboard.php R R R R R Provides dashboard conditions display on wxindex.php
9 ajax-dashboard-testpage.php O O O O O basic test page for ajax-dashboard.php
9 ajax-gizmo.php R R R R R Provides rotating conditions display on pages.
9 ajax-gizmo-testpage.php O O O O O basic test page for ajax-gizmo.php
common.php R R R R R required file for common PHP functions
2 ec-forecast.php n/a RC RC n/a n/a Provides forecast and advisories from Environment Canada
3 ec-radar.php n/a RC RC n/a n/a Provides Radar images from Environment Canada
flyout-menu.php R R R R R CSS and HTML generator for flyout menu system
flyout-menu.xml R R R R R Menu description XML file for flyout-menu system.
flyout-menu-test.xml R R R R R Test menu description XML file for flyout-menu system.
footer.php R R R R R required file for footer part of page
get-meteoalarm-warning-inc.php n/a n/a n/a O* O*

Obtains warning info from EUMETNET/Meteoalarm.eu (Europe/EU only)

get-UV-forecast-inc.php RC RC RC RC RC Obtains UV forecast for latitude/longitude from KNMI/EMA
GR3-radar-inc.php R n/a n/a n/a n/a Used by wxgr3radar.php for listing GR3 files and animating GRLevel3 radar images.
header.php R R R R R required file for heading part of page
include-style-switcher.php R R R R R Required for Mike Challis' Theme Changer
include-wxhistory.php R R R R R Required for wxhistory.php page.
menubar.php R R R R R required file for left navigation menu part of page
10 plaintext-parser.php O O O O O Required if WXSIM is used for forecasts
11 radar-status.php RC n/a n/a n/a n/a Provides NOAA NEXRAD radar site status
quake-Canada.php n/a R R n/a n/a Used by wxquake.php for listing nearby earthquakes from Natural Resources Canada.
quake-UK.php n/a n/a R R R Used by wxquakeUK.php for listing nearby earthquakes from BGS.
12 quake-USA.php R n/a n/a n/a n/a Used by wxquake.php for listing nearby earthquakes from USGS.
12 quake-WORLD.php n/a n/a R R R Used by wxquake.php for listing nearby earthquakes from USGS.
13 rss-advisory.php RC n/a n/a n/a n/a Provides NOAA advisory/watch/warning info via RSS
14 rss-top-warning.php RC n/a n/a n/a n/a Provides summary NOAA advisory/watch/warning info via RSS
Settings.php R R R R R required file for configuration settings used by all pages
18 swfobject.js R* R* R* R* R* Support script for wxlive.php, wxmesomap.php. *Required if either page is used on site.
15 testtags.php R* R* R* R* R* Required file for weather data from Weather-Display. (*Note: may be renamed in Settings.php)
Upload testtags.txt to testtags.php via WD routinely.
7 thermometer.php R R R R R Provides the thermometer display on ajax-dashboard
15 trends-inc.php R R R R R Required file for weather data from Weather-Display. Used in wxtrends.php to display weather trends from testtags.php.
top.php R R R R R required file for initial HTML for all pages
18 wdl-mml-forcesize.js R* R* R* R* R* Support script for wxlive.php, wxmesomap.php. *Required if either page is used on site.
16 WU-forecast.php n/a n/a n/a RC RC Provides the international forecast from Weather Underground (non-USA, non-Canada)
17 WU-radar-inc.php R n/a n/a n/a n/a

Provides generation of Weather Underground Radar and maps display used on wxradar.php (USA Only)
Note: perform setup using
WU-radar-testpage.php?show=loc on your website.
See instructions to set up, then copy some of those settings back into Settings.php.

17 WU-radar-testpage.php R n/a n/a n/a n/a Test page to use for configuring WU-radar-inc.php
wxabout.php R R R R R About page for the site
wxabout-LL.html n/a n/a R n/a R About page for the site in language LL
wxadvisory.php R R R O* O* Optional in World template -- (*Note: needs country-specific content before uploading to website or will use get-meteoalarm-warning-inc.php for Europe warnings)
wxastronomy.php R R R R R Astronomy page for the site.
wxforecast.php R R R R R Forecast details page for the site
wxgr3radar.php O n/a n/a n/a n/a Optional GRLevel3 NEXRAD radar display page
wxgraphs.php R R R R R Graphs (24h, 72hr and month-to-date) images from WD
wxindex.php R* R* R* R* R* Home page for site (Note: may be renamed if link is adjusted in menubar.php)
wxhistory.php O* O* O* O* O* Display the Weather-Display monthly reports (named [month][year].htm Note: config required.. see wxhistory.php page for details in settings area)
wxlinks.php R R R R R Links page for the site.
18 wxlive.php O O O O O Page for Weather-Display Live (purchased product)
18 wxmesomap.php O O O O O Page for Weather-Display MesoMap Live (purchased product).
wxnewpage.php R* R* R* R* R* *Note: This is the new page template for the site. It doesn't need to be uploaded to your website.. just kept handy on your local copy of the website that you use for editing.
wxquake.php O O O O O Optional Earthquake display page.
wxquakeUK.php n/a n/a n/a O O Optional Earthquake display page. (UK only)
wxradar.php R R R O* O* Optional in World template -- (*Note: needs country-specific content before uploading to website.)
wxsimforecast.php O O O O O Display WXSIM icon/text forecast. Use if you have WXSIM.
wxtrends.php R R R R R Display the weather trends from the included trends-inc.html uploaded by WD.
language-LL.txt n/a n/a R n/a R Translation lookup file for language=LL
language-LL-local.txt n/a n/a O n/a O Local additional translation lookup file for language=LL (use for menu addition translations)
10 plaintext-parser-data.txt O O O O O Required if you have WXSIM enabled.
10 plaintext-parser-lang-LL.txt n/a n/a O* n/a O* *Note:Required in World-ML if 'LL' language is enabled and WXSIM is enabled.
10 plaintext-parser-lang-fr.txt n/a O* O* n/a O* *Note: Required in Canada template if WXSIM is enabled, Required in World-ML if 'fr' language is enabled..

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

deformed-offering