wp-forecast Reference v1.7 (english)

First of all, let me tell, you have found the english reference page of wp-forecast.
This translation was well done by Barbara at a really sunny day.

Barbara, thanks a lot for your work. The wp-forecast Reference in english is updated frequently. For the most recent information you can have a look at german reference page

This document will be completed step by step.

  1. Introduction
  2. Download
  3. Installation
    1. Requirements
    2. Installing wp-forecast
    3. Updating wp-forecast
    4. Adjusting wp-forecast.css
  4. Configuration
    1. Number of displayed locations and widgets
    2. General configurations (adjustable for each location/widget)
    3. Display configurations (adjustable for each location/widget)
    4. Configurations when using wp-forecast as widget
  5. Displaying the forecast
    1. Displaying by widget
    2. Displaying by inserting the code in sidebar.php
    3. Direct call via an URL
  6. Version History

1. Introduction

wp-forecast is a plugin for the popular blogging software WordPress. This plugin offers the possibility to display the current weather as well as a weather forecast for up to nine days and twenty locations. The plugin uses the weatherdata from accuweather.com. This way it is possible to display weather information for nearly all places on earth in your own WordPress blog. In addition to the functionality of choosing a location and making general configurations (for instance the interval for updating the weather data), wp-forecast gives you the possibility to display or hide every single weather information. A simple weather display looks like this:

 

wp-forecast simple widget

wp-forecast is published under the GNU General Public License. Additionally please note the terms of license of accuweather.com.

I am taking great efforts in testing the software that I develop and in trying not to produce any errors, but I still cannot exclude the incidence of a serious error. Therefore I do not take the responsability or warranty for the software that I am placing at disposal. The software can only be used on one’s own risk, I cannot be made responsible for any damages (for instance loss of data) caused by using my software.

2. Download
In this section you find a link to the current version of wp-forecast for download. Older versions can be found in the section “Version History”.

wp-forecast-2.1.zip 4557 Downloads

3. Installation

3.1 Requirements

wp-forecast requires PHP version 4.3 or higher and WordPress Version 2.2.x or higher. No more specific features are necessary. However some web hosts are blocking the PHP function ‘fsockopen’, which prevents wp-forecast from collecting the weather data. In this case you should ask your hoster to enable the function ‘fsockopen’ (and rather switch to another hoster if he doesn’t).

3.2 Installing wp-forecast

The installation of wp-forecast is like installing any other WordPress plugin. First unzip the archive to a local directory (using winzip, unzip or tar). Then upload the directory wp-forecast on your WordPress server into the directory wp-content/plugins.

Now log in to your WordPress account as administrator. Under ‘Plugins’ you can activate the plugin by clicking ‘activate’.

3.3 Updating wp-forecast

If you have already installed wp-forecast and now want to use a newer version, it is not necessary to deactivate the plugin. Just copy the new files into your wp-forecast directory. By deactivating the plugin all your settings will be deleted.

3.4 Adjusting wp-forecast.css

To accomodate the look of the wp-forecast widgets to your own liking, you can edit the file wp-forecast.css, which is a cascading stylesheet file. You find a good CSS reference here: http://www.w3schools.com/cssref/.

A wp-forecast widget is displayed in this class hierarchy:

<div class=wp-forecast">
<div class="wp-forecast-curr">
<div class="wp-forecast-curr-details">
</div>
<div class="wp-forecast-copyright">
</div>
</div>
<div class="wp-forecast-fc">
<div class="wp-forecast-fc-details">
</div>
</div>
</div>

4. Configuration

The plugin’s settings, except for the widget options (see 5.1), can be done under Settings – wp-forecast.

4.1 Number of displayed locations and widgets, system parameter

Anzahl Widgets

In the upper part of the settings dialog the number of the used widgets is fixed and the settings of each widget can be selected.

wp-forecast supports up to twenty widgets, so it is possible to display the weather of up to twenty locations in your blog. Just select the number of widgets you would like to display from the dropdown list and click on “save”.

Each widget is assigned to a widget ID. This widget ID is a letter from A to T. By this letter each widget is identified definitely.

To configure a widget it can be selected by its widget ID from the second dropdown list. Clicking on “select widget” lets you see the appropriate adjustings underneath.

From version 1.6 you can set a time limit for the connection and the date transfer from accuweather. This parameter is very useful when you have a slow connection from your server to accuweather’s server and want to avoid long waiting periods when the page is loading. This setting is in seconds and is valid for all widgets.

4.2 General configurations (adjustable for each location/widget)

On the left side of the settings dialog you see the general options of each widget, which means that the options are displayed and saved for the widget that is just being displayed.

Settings dialog

Location: The location whose weather data should be displayed. As accuweather’s abbreviations for the locations and its partly misspelled names cannot always be handled easily you can also search the location in the field Searchterm at the bottom of the settings dialog. Enter a search phrase (for instance London), and click on “Search location”. The results of your search are displayed in a dropdown list. Select your location from that list and click on “Set location”. The selected location with the necessary accuweather code will be displayed in the field Location. Click on “Update options” to complete your settings. Notice: accuweather does not support umlauts like german ü or swedish ø, so you have to replace them by the corresponding vowal (ü by u or ø by o) in your searchterm.

Locationname: Here you can enter an alternative locationname. The names that come from accuweather are mostly in english and will be replaced by your alternative name. Entering &nbsp; in this field will display no locationname at all.

Refresh cache after … secs: In this field you can enter the time interval (in seconds) after which the weather data should be updated. When calling a page that contains a wp-forecast-widget whose weather data is older than the displayed time interval, the weather data will be updated by accuweather.

Use metric units: Activating this checkbox will display metric units for temperature (Degree Celsius (C)) and wind speed (meter per second) instead of the english units Fahrenheit and mph.

Use current time: Activating this checkbox will display the current time instead of the last time the weather data had been updated by accuweather.

Windspeed-Unit: Here you can set the windspeed-unit. Possible settings are meter per second (m/s), kilometer per hour (km/h), miles per hour (mph) and knots (kts).

Language: Here you can set the language for the selected widget. Currently english, german, french, dutch, portuguese, italian and swedish are supported.

Forecast: Here you can select which forecast data should be displayed beside the current weather data. A forecast up to 9 days is possible, seperated into day (Daytime) and night (Nighttime).

Save your selected settings by clicking on “Update options”.

4.3 Display configurations (adjustable for each location/widget)

On the right side of the settings dialog you see the display configuration for each weather data. A selected checkbox means the information will be displayed, a non-selected checkbox means it will not be displayed. “n/a” means ”not available”. The settings can be selected seperately for the current conditions, the daytime forecast and the nighttime forecast. Save your selected settings by clicking on “Update options”.

4.4 Configurations when using wp-forecast as widget

Content follows.

5. Displaying the forecast

Content follows.

5.1 Displaying by widget

Content follows.

5.2 Displaying by inserting the code in sidebar.php

wp-forecast offers you several functions when inserting the code directly into your sidebar.php.

function wp_forecast($wpfcid="A", $language_override=null)
function wp_forecast_range($from=0, $to=0, $numpercol=1, $language_override=null)
function wp_forecast_set($wset, $numpercol=1, $language_override=null)

The necessary parameter for the function wp_forecast is the ID of the widget to display. Optionally you can indicate the iso languagecode of the language the forecast should be displayed in.

Examples:

wp_forecast ( "A" ); // displays widget A in the language of your blog's settings
wp_forecast( "C", "de_DE" ); // displays widget C in german

As wp-forecast supports up to 20 widgets, you have to indicate which widget to use when you insert wp-forecast manually into your sidebar. To do so, use letters in alphabetical order.
For your first widget use wp_forecast(“A”), for the second one wp_forecast(“B”), and so on.
For downwards compatibility the first widget (”A”) will be selected automatically when the code is inserted without an ID (wp_forecast()).

Generally you should check the existance of a called function in your sidebar.php. You can do this by a simple if-query which can be used with the other functions as well:

if ( function_exists(wp_forecast) ) {
wp_forecast( &lt;widget_id&gt; );
}

The function wp_forecast_range displays several widgets in a table. The parameters are a from- and a to-value (both integer), the number of widgets per table row and the iso languagecode. All parameters are optional.
Without parameters the first widget is displayed in your standard language.

Examples:

wp_forecast_range(0,6,2); // displays the first 6 widgets in a table 3x2
wp_forecast_range(10,20,5) // displays widgets 10 to 20 in a 5x2 table

The function wp_forecast_set displays the number of widgets you would like to display. The parameters are an array with your selected number of widgets, the number of widgets per table row and the iso language code. The number of widgets is essential, the other two parameters are optional.

Examples:

wp_forecast_set( array("C","D","H","A"), 2 ); // displays widgets C, D, H, A in a 2x2 table
wp_forecast_set( array("A","B","C","K","L","M"), 3, "fr_FR"); // displays widgets A, B, C, K, L, M in a 3x2 table

5.3 Direct call via an URL

It is possible to call a widget directly via an URL. The URL has to be something like http://my.wordpress.domain/wp-content/plugins/wp-forecast/wp-forecast-show.php?wpfcid=A. “A” indicates your selected widget. As a second parameter you can use language_override to adjust the language of the widget.

6. Version History

  • pre 1.0b see older versions
  • 2007-07-17 v1.0b added support for up to 20 widgets with different, locations and settings, added portugese language support, weather data is now cached in the database, no cookies needed anymore, default value of missing translations is now english, removed configuration dialog from widgets page to avoid misunderstanding about setup, fixed some minor errors
  • 2007-07-25 v1.0b2 work around for bug 4275 in wordpress 2.2, removed widget id from output
  • 2007-08-04 v1.0b3 fixed output of before/after widget stuff for empty forecast, fixed different parameters for calling wp_forecast as widget and from sidebar.php, added swedish translation (thx to Håkan Carlström)
  • 2007-09-01 v1.0b4 fixed humidity / pressure checkbox, removed hard coded formatting, added css class, added support to show current time
  • 2007-09-09 v1.0 fixed accuweather call for us locations, now works with wordpress mu
  • 2007-10-01 v1.1 fixed: setting the current time could not be disabled, fixed: on some servers the current date was converted to 0, switched translations to gettext as recommended by wp codex
  • 2007-11-05 v1.2 extend error handling for serverloss, added iso8859-1 coded german translation, fixed bug with german winddirections, added a widget title, removed standard location label (this can be handled via alternate location
  • 2007-12-26 v1.3 added french translation, added german icon 11 (fog, 11_de.gif), extended css classes to support horizontal view via css, removed repeating section title
  • 2008-01-26 v1.4 fix loading the wright textdomain when called from outside wordpress, added a bit debug code, work around for a bug in k2rc3 theme, added italian translation, added english lanuage file, a bit of code cleanup, extend function wp-forecast to select language per widget, added functions to display a set and a range of widgets at once
  • 2008-05-12 v1.5 fixed two dutch phrases in dutch translation, added norwegian translation (thanks to Eilif)
  • 2008-07-11 v1.6 removed some hardcoded css, it is now possible to call the widget directly outside from wp, fixed a problem with wp >2.5 and the widget dialog, removed some redundant html, when showing no current weather information, placed forecast header into own table with own css class, added timeout parameter for the accuweather connections, rounded humidity to integer values, fixed some typos in swedish translation and added norwegian selection (thanks to RAM_OS)

Older versions to download:

Kommentare

  1. talensac:

    Hello, I’ve a problem with the wp-forecast plugin for wordpress. Since 3 or 4 days, I have this message: “Failure notice from provider:
    Connection Error:http_request_failed”
    I don’t know what can I do. it’s an API problem, do have you ever been the same kind of problem ?

    Thank.
    from france

    Antworten

    • webmaster:

      Hello talensac,

      can you please try the connection test (link on admin page) and post the results. Did you change anything in your setup or did your provider change some security settings for php? I guess your are using accuweather as the weather data provider. Is it correct?

      Regards, Hans

      Antworten

      • talensac:

        Hello, thanks for your attention.
        The results of the connection test is this one with Accuweather (than I use):
        “Checking for Weatherprovider Accuweather
        Checking default transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘forecastfox.accuweather.com’
        Checking fsockopen transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘forecastfox.accuweather.com’
        Checking exthttp transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘forecastfox.accuweather.com’
        Checking streams transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘forecastfox.accuweather.com’
        Checking curl transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘forecastfox.accuweather.com'”
        With Weatherbug the result is:
        “Checking for Weatherprovider WeatherBug
        Checking default transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘.api.wxbug.net’
        Checking fsockopen transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘.api.wxbug.net’
        Checking exthttp transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘.api.wxbug.net’
        Checking streams transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘.api.wxbug.net’
        Checking curl transport
        Test ends in error.
        Error-Message was http_request_failed Couldn’t resolve host ‘.api.wxbug.net'”

        I haven’t change nothing in my setup and there was no problem before with the same setup and WP version.
        I have seen the same problem on many website use this plugin. I think is not a problem with my website…
        Cheers

      • webmaster:

        Well, the message says “http_request_failed Couldn’t resolve host” and thats the problem. It means that your server is not able to resolve the accuweather server name to an ip address. There can be various reasons for this. I would recommend to ask your provider why this host is not resolved. I assume your RSS newsfeeds are working (dashboard)? You can also try different transfer methods which wp-forecast supports. You can change it on the admin page. Just try them one after the other by changing the transfer method and then doing the connection test again. Sometimes we have had experienced that due to security restrictions only one or two of the methods are working.

        Regards, Hans

      • talensac:

        hi Hans,
        Thanks again for your help.
        I have tested the different transfer method in admin, but it’ doesn’t work too.
        In other way, I have an error feed message in dashoard :good:
        this message is:
        A feed could not be found at http://blogsearch.google.com/blogsearch_feeds?hl=en&scoring=d&ie=utf-8&num=20&output=rss&partner=wordpress&q=link:http://localhost/mywebsite/. A feed with an invalid mime type may fall victim to this error, or SimplePie was unable to auto-discover it.. Use force_feed() if you are certain this URL is a real feed.

        Do you think there’s a link with my accuweather problem ?

        ps: it’s strange I can’t ask here to your last message…

      • webmaster:

        Yes, of course. Maybe this hostname could also not be resolved.
        You should check your logs or contact your provider and ask if they can find out why the names are not resolved.
        Sometimes this is a security restriction but we need to know what your provider allows and what not. They should also tell you if they did a change to the configuration during the last weeks.

      • talensac:

        Yes, I have posted my question to my provider last tuesday and I have no answer from them…
        I will tell you ;-)

  2. The widget works great. Thank you.

    My client also wants the weather displayed on a page. I’ve done this using the [wpforecast id="B" width="400" height="700"] shortcode. However the text is quite small and nothing I seem to change in the css file seems to change it when I use the short code.

    When using the shortcode is there a way to make the text a little larger?

    Thanks for your help,
    Karen

    Antworten

    • webmaster:

      Hello Karen,

      yes , of course. You can use the css attribute font-size to change the font size. E.g. to change the font size of the text in the details block
      use the wp-forecast-curr-details class. To change the size in the header use wp-forecast-curr-head. But you have to change wp-forecast-default-nowp.css to change the css settings for the shortcode. Do not change wp-forecast-default.css because this one is only for widgets.

      regards, hans

      Antworten

  3. pato:

    hi hans,

    congrats for the work on wp-forecast.

    i’m having trouble working with wp-forecast.
    if i select any specific widget (i.e: location ‘A’ or ‘B’ or ‘C’) it displays correctly. but if i choose the ‘?’ display method and select a location from the drop-down list the location doesn’t change. it never updates. what am i doing wrong? i’m using wp-forecast 3.4 on wordpress 3.1.2.

    Please help! Thanks

    Antworten

    • webmaster:

      hello pato,

      the wpf_update.js script is not loaded on your page. the normal way this works automatically. did you change anything or can you test it with only wp-forecast activated?

      regards, hans

      Antworten

    • pato:

      i don’t get it …

      i’ve deactivated all other plugins and it still doesn’t work.
      the file script wpf_update.js is set on the wp-forecast folder in the server.
      the wpf_update(); function is being called at wp_selector onchange.
      i haven’t changed anything besides setting all the locations already.
      already tried the following wp-forecast versions 2.0, 2.4 and 2.8 to 3.4.
      what should i do?
      thanks in advance!

      Antworten

      • webmaster:

        hi pato,

        okay I have checked it again and found jquery is also not loaded. so please check your theme header.php for the following hint from twentyten theme:

        /* Always have wp_head() just before the closing 
        	 * tag of your theme, or you will break many plugins, which
        	 * generally use this hook to add elements to  such
        	 * as styles, scripts, and meta tags.
         */
        	wp_head();
        ?>
        </head>

        regards, hans

    • pato:

      hi again hans …

      finally i can see the light at the end of the tunnel. the weather is updating.

      even though the weather is updating there’s another issue that came up … it’s related with the widget display method. the wp-forecast widget is being displayed over two different widgets.
      the title and the location dropdown menu are in the right postition but then the weather content is displayed in the widget that follows.
      this wasn’t happening before. =/
      any clue on how to solve this?

      thanks!

      Antworten

    • pato:

      hi again hans …

      nevermind the issue of wp-forecast being displayed in two different widgets. it’s miracously solved!

      thanks so much for the help and fast replies!

      wouldn’t be able to solve this issue without your help.

      thanks for the wonderfull plugin and all the help once again.

      you’re the man!

      danke!

      Antworten

  4. Bruce Norton:

    hi Hans,

    Thanks for your suggestion. Sounds good to me.
    Could you help me identify which .php file is calling wp-forecast?
    I am using the Delicious with Genesis from StudioPress.

    (And feel silly having to ask…)
    Auf Dich!
    Bruce

    Antworten

    • webmaster:

      hello Bruce,

      wp-forecast is called from wp-forecast.php :-)

      regards, hans

      Antworten

    • Bruce Norton:

      Hello Hans,

      Thanks I was searching wp-[hyphen]forecast not wp_[underscore]forecast.
      Unfortunately it is still not working.
      I have tried quite a few things.
      But changing the 3 locations I find wp_forecast( ); don’t seem to have any effect.

      function wp_forecast($wpfcid="C", $language_override=null) //from approximately line 204 of wp_forecast.php
      wp_forecast("C", $language_override);//line 239
      wp_forecast("C", $language_override);//line 272

      It still displays the “A” location.
      I assume it is because I am inserting WP_FORECAST as a widget, rather than calling it manually.
      http://dan-icecanada.com/
      user: Dan-Ice Guest
      pass: guest

      Really appreciate your time.

      Antworten

      • webmaster:

        hello Bruce,

        I thought your idea was to show a random place in the wp-forecast widget. I think it is the easiest way to use php as I described few comments before. If you do not want to edit sidebar.php direclty, just use a php exec plugin that lets you enter some php and displays the result as a widget.

        regards, hans

    • Bruce Norton:

      Hi Hans,

      I do want to use your random function. I was just using “C” to see where to put the random function.
      I do not have a “sidebar.php” in my theme from StudioPress.
      So I am still struggling with where to put your random $wid generator.
      Can i put it directly in wp_forecast.php?
      If not, I have no idea where to put it.
      This is what I see in my “home.php” file.

      Widgets screen. There you can drag the widget into the Home Middle Right widget area on the right hand side.", 'genesis'); ?>


      regards,
      bruce
      p.s. simplified site username to guest (password is still guest)
      http://dan-icecanada.com/

      Antworten

      • webmaster:

        hi Bruce,

        as I mentioned before use a php exec plugin (e.g. WP exec php, Shortcode Exec PHP or Exec-PHP) which lets you put php code into a widget. then use my php code. thats all.

        regards, hans

    • Bruce Norton:

      hi Hans,

      Working with PHP Execution and the script you gave me (with the change from hyphen to underscore).
      Thank you for your time and patience.

      Bruce

      Antworten

  5. Bruce Norton:

    Hello Hans,
    I would like to have a different, random city’s weather show up each time the page loads.
    Pretty new to Word Press (2 weeks) but my thought is to write a function to choose a location at random from an array.

    Where do you store the configuration settings for the selected location.
    I cannot find where “ARC|GL|GL003|NUUK|” is stored, for example.

    Thanks in advance for any help.
    dankeschön

    Bruce

    Antworten

    • webmaster:

      hi Bruce,

      wouldn’t it be easier so control this before wp-forecast? well, anyway, the data is stored in the wp-options table, where option_name is like wp-forecast-opts(ID).
      I would think about using a piece of php generating the randomness befor calling wp-forecast e.g.

      // lets say you have 5 widgets
      $random_wid=rand(65, 65+5);
      $wid=chr($random_wid);
      wp-forecast($wid);
      ...

      regards, hans

      Antworten

  6. fede:

    can i use do_shorte_code for showing forecast, i mean something like this [wp-forecast]

    Antworten

    • webmaster:

      hello fede,

      the answer is “yes, you can”. :-) the syntax is [wpforecast id="A" lang="de_DE" width="300" height="500"], where only the id is required, the rest is optional.

      regards, hans

      Antworten

  7. fred:

    Hi,
    I just installed your wp-forecast. I would like it to show exactly as in your web page,
    http://www.tuxlog.de/wordpress/2008/wp-forecast-reference-v17-english/
    in the right column. This is, with a search for weather location. I read on the installation, but could not find a way to have that.
    Can you help on that?

    Thanks

    Antworten

    • webmaster:

      hello fred,

      if I got you wright, you want to have a selection widget in your sidebar. first of all, add the some locations via the admin screen, then add the widget and choose the question mark as your location from the widget settings. do not forget to check the pull down checkbox in the settings of the widget A to get the pull down forecast.

      thats it, hans

      Antworten

  8. Carlos:

    Hello,

    Yes it was. I entered directly the location code, cause the search engine did not work for me.

    Thanks so much.

    Antworten

  9. Carlos:

    Hello,

    When I enter “london” in “Search Location”, it does not appear any dropdown list to set the accurate place. There are a lot of London throughout the world, and the one that is displayed don’t correspond to the London I want to get (London, City of Westminster).

    Thanks for all.
    Carlos

    Antworten

    • webmaster:

      hello Carlos,

      I just tried it and get for accuweather entering London as a search term: London United Kingdom(Westminster, England) and various other London’s. is this the place you are looking for? the code is EUR|UK|UK241|LONDON| if you want to enter it directly in the location field.

      regards, hans

      Antworten

  10. Agnes:

    Hello: thanks, This is the most powerful widget – and it works!
    Well, I still have a trouble
    I got it work perfectly with Accuweather
    Unfortunaltely, the service has few locations for Botswana where I am intrerested.
    WheatherBug has many more. But I dont manage to get it work… (on WP 3.01)
    When I search location, like “Paris” I get
    “XML Fehler: EntityRef: expecting ‘;’ in Zeile 1″
    (is it because I dont have a partner ID?)
    I have gone th weatherbug Widget buildrr and do not know what to pick from the long code

    Forecast
    Satellite
    Photos


    Your weather just got better.

    Any help?

    Antworten

    • webmaster:

      hello Agnes,

      I would say thats the problem. to use the service of weatherbug you need a partner id, which yo can get at the weatherbug website.

      regards, hans

      Antworten

Hinterlasse eine Antwort

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind markiert *

Du kannst folgende HTML-Tags benutzen: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

:bye: 
:good: 
:negative: 
:scratch: 
:wacko: 
:yahoo: 
B-) 
mehr...
 
Blogverzeichnis - Blog Verzeichnis bloggerei.de