| 1 |
=== wp-forecast === |
| 2 |
Contributors: tuxlog |
| 3 |
Donate link: http://www.tuxlog.de |
| 4 |
Tags: weather,forecast,widget |
| 5 |
Requires at least: 2.8 |
| 6 |
Tested up to: 2.9.1 |
| 7 |
Stable tag: 2.8 |
| 8 |
|
| 9 |
wp-forecast is a highly customizable plugin for wordpress, showing weather-data from accuweather.com and/or weatherbug.com. |
| 10 |
|
| 11 |
== Description == |
| 12 |
You are reading the readme.txt file for the wp-forecast plugin. |
| 13 |
wp-forecast is a plugin for the famous wordpress blogging package, |
| 14 |
showing the weather-data from accuweather.com and/or weatherbug.com. |
| 15 |
please also refer to the terms of usage of accuweather.com and weatherbug.com |
| 16 |
|
| 17 |
Features: |
| 18 |
|
| 19 |
+ Displays the weather data from AccuWeather.com and or WeatherBug.com |
| 20 |
at your wordpress pages, posts or sidebar |
| 21 |
+ Let you choose the |
| 22 |
* location (of course) |
| 23 |
* the time after the weather data is refreshed |
| 24 |
* the langugage (currently only english or german are |
| 25 |
available) |
| 26 |
* metric or american measures |
| 27 |
* windspeed unit |
| 28 |
* the forecast days |
| 29 |
* the daytime forecast for up to nine/seven days |
| 30 |
* the nighttime forecast for up to nine nights |
| 31 |
+ support wordpress widgets, easy placement :-) |
| 32 |
+ customize the information you want to show |
| 33 |
+ supports pull-down forecast data to efficiently use space |
| 34 |
+ multiple wp-forecast widget support |
| 35 |
+ integration into your site via css (see below) |
| 36 |
+ comes with an api for wordpress-pro's ;-) |
| 37 |
+ comes with a checklist to validate your connection settings |
| 38 |
|
| 39 |
Credits: |
| 40 |
|
| 41 |
+ Barbary Jany testing a lot and bring it to valid XHTML |
| 42 |
+ Frans Lieshout&Wim Scholtes translation to dutch |
| 43 |
+ Luís Reis translation to portugues |
| 44 |
+ Håkan Carlström translation to swedish |
| 45 |
+ Gabriele von der Ohe translation to german with entities |
| 46 |
(for iso-8859-1 or latin1 blogs) |
| 47 |
+ Martin Loyer/Jean-Pierre translation to french |
| 48 |
+ Robert Lang language file for en_US |
| 49 |
+ Detti Giulio/Stefano Boeri translation to italian |
| 50 |
+ Eilif Nordseth translation to norwegian |
| 51 |
+ Michael S.R. Petersen translation to dansk |
| 52 |
+ Jaakko Kangosjärvi translation to finish |
| 53 |
+ Lukasz "linshi" Linhard translation to polish |
| 54 |
+ Castmir translation to spanish |
| 55 |
+ Tamas Koos translation to hungarian |
| 56 |
+ Valeria Pellegrini translation to russian |
| 57 |
+ Valentina Boeri translation to romanian |
| 58 |
+ Roland Geci translation to slovak |
| 59 |
+ All the others giving feedback about missing features and bugs. |
| 60 |
Thank you very much for your contribution to wp-forecast. |
| 61 |
|
| 62 |
|
| 63 |
== Installation == |
| 64 |
|
| 65 |
1. Upload to your plugins folder, usually `wp-content/plugins/`, keeping |
| 66 |
the directory structure intact \(i.e. wp-forecast.php should end up |
| 67 |
in `wp-content/plugins/wp-forecast/`\). |
| 68 |
|
| 69 |
1. Activate the plugin on the plugin screen. |
| 70 |
|
| 71 |
3. Visit the configuration page \(`Options -> WP-forecast`\) to pick the |
| 72 |
number of widgets, data to display and to change any other option. |
| 73 |
|
| 74 |
4. Visit the Themes/Widgets page to place your wp-forecast widget within |
| 75 |
your themes sidebars or insert it manually and edit your template |
| 76 |
file and put the wp-forecast function where you want your weather |
| 77 |
data to show up. |
| 78 |
Example: `<ul><li> |
| 79 |
<?php if(function_exists(wp_forecast)) { |
| 80 |
wp_forecast( <widget_id> ); |
| 81 |
} ?> |
| 82 |
</li></ul>` |
| 83 |
|
| 84 |
You have to replace <widget\_id> with the choosen widget id. |
| 85 |
For the first widget use wp\_forecast("A"), for the second |
| 86 |
wp\_forecast("B") and so on. |
| 87 |
In most cases it is advisable to put the call into a div environment. |
| 88 |
|
| 89 |
5. Optional |
| 90 |
If you would like to have another set of icons download it |
| 91 |
from <http://accunet.accuweather.com/wx/accunet/graphics_icons.htm> |
| 92 |
and put it into the wp-content/plugins/wp-forecast/icons folder |
| 93 |
|
| 94 |
6. Optional |
| 95 |
If you would like to change the style, just edit wp-forecast.css |
| 96 |
there are three classes div.wp-forecast for outer formatting, |
| 97 |
table.wp-forecast for the middle part or iconpart and |
| 98 |
wp-forecast-details for everything below the icon |
| 99 |
|
| 100 |
|
| 101 |
== Translations == |
| 102 |
|
| 103 |
wp-forecast comes with various translations, located in the directory `lang`. |
| 104 |
if you would like to add a new translation, just take the file |
| 105 |
wp-forecast.pot (in the wp-forecast main directory) copy it to |
| 106 |
<iso-code>.po and edit it to add your translations (e.g. with poedit). |
| 107 |
|
| 108 |
please be aware that the number codes stand for the weather-situations. |
| 109 |
you can see the mapping in en_US.po. there are also the letters N, S, W, E |
| 110 |
they stand for the winddirections and can be translates either. |
| 111 |
|
| 112 |
there are different translations for the german language using |
| 113 |
different charsets. the default de\_DE uses UTF-8, de\_DE-iso-8859-1 |
| 114 |
uses iso-8859-1 and de\_DE-latin1 uses HTML entitites. |
| 115 |
|
| 116 |
to use a different as the default just rename the appropriate file |
| 117 |
to de\_DE.po and de\_DE.mo |
| 118 |
|
| 119 |
|
| 120 |
== Frequently Asked Questions == |
| 121 |
= Where can I get further information about the plugin? = |
| 122 |
|
| 123 |
There are severeal ressources to visit: |
| 124 |
|
| 125 |
* [The german reference][germanref] |
| 126 |
* [A short FAQ list in german][gerfaq] |
| 127 |
* [A checklist in case of problems (german and english)][checklist] |
| 128 |
* [The english readme.txt][engreadme] |
| 129 |
* [The english reference (a bit out of date but still useful)][engref] |
| 130 |
|
| 131 |
[germanref]: http://www.tuxlog.de/wordpress/2008/wp-forecast-referenz-v14/ |
| 132 |
"German wp-forecastreference" |
| 133 |
[gerfaq]: http://www.tuxlog.de/wordpress/2007/wp-forecast-wie-geht-das/ |
| 134 |
"wp-forecast FAQ - Wie geht das?" |
| 135 |
[checklist]: http://www.tuxlog.de/uncategorized/2009/checkliste-fur-wp-forecast-checklist-for-wp-worecast/ |
| 136 |
"wp-forecast checklist for connection problems" |
| 137 |
[engreadme]: http://www.tuxlog.de/wp-content/downloads/wp-forecast-readme-2.4.txt |
| 138 |
"you are actually reading this one" |
| 139 |
[engref]: http://www.tuxlog.de/wordpress/2008/wp-forecast-reference-v17-english/ |
| 140 |
"english reference for wp-forecast" |
| 141 |
|
| 142 |
= After upgrading the plugin my widgets are gone. Any Ideas? = |
| 143 |
|
| 144 |
Probably you used the automatic upgrade which disables the widget during update and therefore removes the configured widgets. Just add the widgets again. |
| 145 |
|
| 146 |
= After upgrading my settings are gone. How can this be? = |
| 147 |
|
| 148 |
Probably you have enabled "Delete options during plugin deactivation?" and used automatically update or disabled the plugin during update. When this option is marked everey database entries inserted by wp-forecast are removed from the database. |
| 149 |
|
| 150 |
== Screenshots == |
| 151 |
1. wp-forecast as a widget with two day forecast |
| 152 |
2. wp-forecast admin dialog |
| 153 |
3. wp-forecast in an iframe with a two day forecast |
| 154 |
|
| 155 |
|
| 156 |
== Changelog == |
| 157 |
|
| 158 |
= v2.8 (2010-01-30) = |
| 159 |
* prevent wp-forecast-nowp.css from being deleted during automatic plugin update |
| 160 |
* added beaufort to set of windunits |
| 161 |
* updated dutch translation, thanks to Wim :-) |
| 162 |
* fixed warning during autoupdate with wordpress >Version 2.8.6 |
| 163 |
* rounded pressure to get rid of long values |
| 164 |
|
| 165 |
= v2.7 (2010-01-22) = |
| 166 |
* added unit label to timeoffset field in admindialog |
| 167 |
* added selection dialog widget to let user choose which location to view |
| 168 |
* extended pulldown widget to use more than one pulldown widget per page |
| 169 |
* prevent wp-forecast.css from being deleted during automatic plugin update |
| 170 |
|
| 171 |
= v2.6 (2009-12-17) = |
| 172 |
* fixed wrong urlencoded link to weather forecast at accuweather |
| 173 |
* fixed undefined variable warning for $wp_forecast_pre_transport in wp-forecast.php |
| 174 |
* fixed uncompress bug in wordpress 2.9 with workaround in fetch_url |
| 175 |
* fixed invalid xhtml/javascript in admin dialog once more |
| 176 |
* added open in new window feature for weather provider link |
| 177 |
* added time offset to correct wrong calculated accuweather times |
| 178 |
|
| 179 |
= v2.5 (2009-10-17) = |
| 180 |
* fixed wrong html in widget dialog with wordpress v2.8, that leads to problems with placing widgets in internet explorer |
| 181 |
* set default for widget call via v2.8.1 widgetdialog |
| 182 |
* replaced "Copyright" with © |
| 183 |
* added parameters width and height to shortcode |
| 184 |
* added feature to show/hide forecast data with javascript |
| 185 |
* added transport check to admin dialog |
| 186 |
|
| 187 |
= v2.4 (2009-07-04) = |
| 188 |
* changed readme to support new changelog feature at wordpress.org |
| 189 |
* fixed faq section in readme, resized icon |
| 190 |
* added default css file which is used when no user specific one is available |
| 191 |
* fixed div container when date/time is disabled |
| 192 |
* fixed widget title to be display correct |
| 193 |
|
| 194 |
= v2.4beta (2009-06-18) = |
| 195 |
|
| 196 |
* fixed translation of winddirection in api |
| 197 |
* added translation for romanian |
| 198 |
* fixed russian and italian translation |
| 199 |
* modified show function to use data api |
| 200 |
* avoid to store new cache when http fetch results in failure notice from acuweather |
| 201 |
* add support for weatherbug |
| 202 |
* reduced the number of database reads and writes and raise performance |
| 203 |
* changed the xhtml using only div and not table or others |
| 204 |
* added shortcode wpforecast |
| 205 |
* catch error when weather bug does not deliver a shorttext |
| 206 |
* since it leads to problems with some installations |
| 207 |
* added menu icon |
| 208 |
* moved settings to main menu |
| 209 |
* switched the widget dialog to new oo-progamming for versions after 2.7.1 |
| 210 |
* added a preselection of the transfer method to be used with wp-forecast |
| 211 |
|
| 212 |
|
| 213 |
= v2.3 (2009-01-30) = |
| 214 |
|
| 215 |
* fixed some wrong italian translations |
| 216 |
* added shorttext for api daily forecast |
| 217 |
* fixed translation in api |
| 218 |
* process failure notice from accuweather if it occures |
| 219 |
* added lat and lon to data api |
| 220 |
* switched to wordpress default function to get remote data from accuweather |
| 221 |
* changed default value of cache refresh to 1800 seconds |
| 222 |
* added translation to russian |
| 223 |
|
| 224 |
|
| 225 |
= v2.2 (2008-12-29) = |
| 226 |
|
| 227 |
* fixed some mistakes in finish translation (thanks to Jaska) |
| 228 |
* added hungarian translation |
| 229 |
* added parameter to avoid option deletion when deactivating the plugin |
| 230 |
* added parameter for direct call to add a html-header |
| 231 |
* added multi-checkbox-switch in admin-dialog (for convenience only) |
| 232 |
* added translation for winddirections |
| 233 |
* added data api for wordpress-pro's to design layouts individually |
| 234 |
|
| 235 |
|
| 236 |
= v2.1 (2008-11-09) = |
| 237 |
|
| 238 |
* added language support for spanish (thanks to Castmir) and |
| 239 |
* polish (thanks to Lukasz) |
| 240 |
* fixed minor css bug |
| 241 |
|
| 242 |
|
| 243 |
= v2.0 (2008-11-02) = |
| 244 |
|
| 245 |
* added finish translation (thanks to Jaska) |
| 246 |
* fixed a problem with overloaded textdomains (translations) |
| 247 |
* since wordpress does not a sanity check if a loaded domain is reloaded, we have to do it |
| 248 |
|
| 249 |
|
| 250 |
= v1.9 (2008-10-04) = |
| 251 |
|
| 252 |
* surpress fsockopen warning messages in case of connection problems and output the error as html comment |
| 253 |
|
| 254 |
|
| 255 |
= v1.8 (2008-09-17) = |
| 256 |
|
| 257 |
* added css class wpf-icon to make it easier formating the weather icons |
| 258 |
* added autodetection for icon filetype |
| 259 |
* gif, png and jpg are supported |
| 260 |
* corrected some translations |
| 261 |
|
| 262 |
|
| 263 |
= v1.7 (2008-07-20) = |
| 264 |
|
| 265 |
* removed a bit of redundant html when widget title is empty |
| 266 |
* fixed bug in output of current conditions |
| 267 |
* added option to show a link to the accuweather forecast |
| 268 |
* added dansk translation |
| 269 |
|
| 270 |
|
| 271 |
= v1.6 (2008-07-11) = |
| 272 |
|
| 273 |
* removed some hardcoded css |
| 274 |
* it is now possible to call the widget directly outside from wp |
| 275 |
* fixed a problem with wp >2.5 and the widget dialog |
| 276 |
* removed some redundant html |
| 277 |
* when showing no current weather information |
| 278 |
* placed forecast header into own table with own css class |
| 279 |
* added timeout parameter for the accuweather connections |
| 280 |
* rounded humidity to integer values |
| 281 |
* fixed some typos in swedish translation and added norwegian selection (thanks to RAM_OS) |
| 282 |
|
| 283 |
|
| 284 |
= v1.5 (2008-05-12) = |
| 285 |
|
| 286 |
* fixed two dutch phrases in dutch translation |
| 287 |
* added norwegian translation (thanks to Eilif) |
| 288 |
|
| 289 |
|
| 290 |
= v1.4 (2008-01-26) = |
| 291 |
|
| 292 |
* fix loading the wright textdomain when called from outside wordpress |
| 293 |
* added a bit debug code |
| 294 |
* work around for a bug in k2rc3 theme |
| 295 |
* added italian translation |
| 296 |
* added english lanuage file |
| 297 |
* a bit of code cleanup |
| 298 |
* extend function wp-forecast to select language per widget |
| 299 |
* added functions to display a set and a range of widgets at once |
| 300 |
|
| 301 |
|
| 302 |
= v1.3 (2007-12-26) = |
| 303 |
|
| 304 |
* added french translation |
| 305 |
* added german icon 11 (fog, 11_de.gif) |
| 306 |
* extended css classes to support horizontal view via css |
| 307 |
* removed repeating section title |
| 308 |
|
| 309 |
|
| 310 |
= v1.2 (2007-11-05) = |
| 311 |
|
| 312 |
* extend error handling for serverloss |
| 313 |
* added iso8859-1 coded german translation |
| 314 |
* fixed bug with german winddirections |
| 315 |
* added a widget title |
| 316 |
* removed standard location label (this can be handled via alternate location) |
| 317 |
|
| 318 |
|
| 319 |
= v1.1 (2007-10-01) = |
| 320 |
|
| 321 |
* fixed: setting the current time could not be disabled |
| 322 |
* fixed: on some servers the current date was converted to 0 |
| 323 |
* switched translations to gettext as recommended by wp codex |
| 324 |
|
| 325 |
|
| 326 |
= v1.0 (2007-09-09) = |
| 327 |
|
| 328 |
* fixed accuweather call for us locations |
| 329 |
* now works with wordpress mu |
| 330 |
|
| 331 |
|
| 332 |
= v1.0b4 (2007-09-01) = |
| 333 |
|
| 334 |
* fixed humidity / pressure checkbox |
| 335 |
* removed hard coded formatting, added css class |
| 336 |
* added support to show current time |
| 337 |
|
| 338 |
|
| 339 |
= v1.0b3 (2007-07-29) = |
| 340 |
|
| 341 |
* fixed output of before/after widget stuff for empty forecast |
| 342 |
* fixed different parameters for calling wp_forecast as widget and from sidebar.php |
| 343 |
* added swedish translation (thx to Håkan Carlström) |
| 344 |
|
| 345 |
|
| 346 |
= v1.0b2 (2007-07-25) = |
| 347 |
|
| 348 |
* work around for bug 4275 in wordpress 2.2 |
| 349 |
* removed widget id from output |
| 350 |
|
| 351 |
|
| 352 |
= v1.0b (2007-07-17) = |
| 353 |
|
| 354 |
* added support for up to 20 widgets with different locations and settings |
| 355 |
* added portugese language support |
| 356 |
* weather data is now cached in the database |
| 357 |
* no cookies needed anymore |
| 358 |
* default value of missing translations is now english |
| 359 |
* removed configuration dialog from widgets page to avoid misunderstanding about setup |
| 360 |
* fixed some minor errors |
| 361 |
|
| 362 |
|
| 363 |
= v0.9.1 (2007-07-01) = |
| 364 |
|
| 365 |
* added new field windgusts |
| 366 |
* fixed some incompatibility with complex themes |
| 367 |
|
| 368 |
|
| 369 |
= v0.9 (2007-06-23) = |
| 370 |
|
| 371 |
* added copyright notice |
| 372 |
* added date for current conditions |
| 373 |
* added alternative location name |
| 374 |
|
| 375 |
|
| 376 |
= v0.8 (2007-06-18) = |
| 377 |
|
| 378 |
* added dutch language support |
| 379 |
* show time in wordpress format (option: time_format) |
| 380 |
|
| 381 |
= v0.7 (2007-06-11) = |
| 382 |
* Fixed an incompatibility with wpSEO (used same global variable language which should never happen) |
| 383 |
|
| 384 |
|
| 385 |
= v0.6 (2007-06-07) = |
| 386 |
|
| 387 |
* Fixed a lot of incorrect XHTML |
| 388 |
* added translation for winddirection |
| 389 |
* changed display of low- and hightemperature in forecast |
| 390 |
* no decimals for windspeed |
| 391 |
* fixed two phrases in translation |
| 392 |
* added hint for dealing with german umlaute and search location dialog |
| 393 |
* added a bit error handling to surpress long error messages when receiving no or invalid xml from accuweather |
| 394 |
|
| 395 |
|
| 396 |
= v0.5 (2007-06-03) = |
| 397 |
|
| 398 |
* added support for wp widgets |
| 399 |
* Fixed some incorrect XHTML code |
| 400 |
* added selection of the fields to show |
| 401 |
* added windspeed unit support (hope you like it Barbara :-)) |
| 402 |
* added german language support for admin page |
| 403 |
|
| 404 |
|
| 405 |
= v0.4 (2007-05-31) = |
| 406 |
|
| 407 |
* never published, only code cleaning done |
| 408 |
|
| 409 |
|
| 410 |
= v0.3 (2007-05-18) = |
| 411 |
|
| 412 |
* Integrate forecast |
| 413 |
|
| 414 |
|
| 415 |
= v0.2 (2007-05-17) = |
| 416 |
|
| 417 |
* Fixed some incorrect XHTML code |
| 418 |
* Fixed path settings for icons and css |
| 419 |
* Tested with various browsers |
| 420 |
|
| 421 |
|
| 422 |
= v0.1 (2007-01-15) = |
| 423 |
|
| 424 |
* Initial beta release |
| 425 |
|
