


Opis gadetu "Weather report" 




Autorzy: 
* Micha Drozd <mdrozd@sns.pl>
* Piotr Wojnarski <piotrwojnarski@o2.pl>

I. Opis
~~~~~~~

Gadet ma za zadanie pokazywa w wybranym miejscu strony prognozy
pogody dla wybranej miejscowoci. Mona go wykorzysta we wasnych
stronach pisanych z uyciem jzyka skryptowego PHP. Istnieje moliwo
konfiguracji zarwno przekazywanych informacji, jak i rwniez sposobu
ich prezentacj (wicej informacji -- patrz Konfiguracja w dalszej
czci tego dokumentu). Prognozy pogody podawane sa za porednictwem
portalu "gazeta.pl". Z tego powodu autorzy nie ponosz
odpowiedzialnoci za przekazywane przez gadet prognozy pogody jak i
rwnie za ustarki bdce win portalu "gazeta.pl". 


II. Instalacja
~~~~~~~~~~~~~~

Instalacja skryptu polega na przekopiowanie plikw weather.php i
ewentualnie weather.conf do katalogu na serwerze obsugujcym skrypty
PHP. Uwaga: Jeeli serwer dziaa w tzw. SAFE MODE naley zwrci
uwag na uprawnienia skryptu i pliku weather.conf (wicej informacji
mona uzyska od administratora Twojego systemu, ewentualnie
http://www.php.net). Naley upewni si, e serwer jest zdolny
do korzystania z usug portalu gazeta.pl.  


III. Konfiguracja
~~~~~~~~~~~~~~~~~

Konfiguracja gadetu przebiega w dwch etapach:

* konfiguracja zawartoci
* konfiguracja prezentacji

IIIa. Konfiguracja zawartoci
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Konfiguracja dokonywana jest poprzez ustawienie zmiennych w tablicy
asocjacyjnej $_WEATHER. Jeeli na stronie wystpuje wicej ni jedna
prognoza pogody, naley pamita, aby przed kolejnymi wstawieniami
ustawia wartoci zmiennych konfiguracyjnych odpowiednio do swoich
potrzeb (chyba, e wszystkie prognozy maj mie te same parametry).

Konfiguracja zawartoci polega na :

* wybraniu miasta dla ktrego prognoza ma by pokazywana
  
  W tym celu ustawiamy zmienn $_WEATHER['miasto'], np.:
  
  $_WEATHER['miasto']="Warszawa";
  
  Uwaga: przy takim korzystaniu niezbdny jest plik weather.conf.
  
  Jeeli w Twoim serwisie bdziesz stale wykorzystywa tylko pogod z
  jednego miasta mona zrezygnowa z pliku weather.conf. W tym celu
  odczytaj z niego dwie wartoci liczbowe, ktre odpowiadaj Twojemu
  miastu i przeka je do gadetu w nastpujcy sposb:
  
  zamy, e w pliku weather.conf istnieje linia 

  d	   4 2

  ustawiamy wtedy wartoci zmiennych konfigurujcych nastpujaco:

  $_WEATHER['nregion'] = 4;
  $_WEATHER['nmiasto'] = 2;
 
* wczeniu/wyczeniu wywietlania nagwkw kolumn.

  W tym celu ustawiamy zmienn konfiguracyjn 'headers', np.:

  $_WEATHER['naglowki'] = 1;  // powoduje wczenie nagwkw
  
  lub

  $_WEATHER['naglowki'] = 0;   // powoduje wyczenie nagwkw

  Gdy zmienna ta nie jest ustawiona, nagowki s wczone.

* wybraniu iloci dni obejmujcych prognoz (maksymalnie 4 dni wraz z
  dzisiejszym). 

  W tym celu ustawiamy zmienne konfiguracyjne odpowiednio 'dzis',
  'jutro', 'pojutrze', 'popojutrze' na wartoci 0 (nie wywietla) lub
  1 (wywietla). Jeeli adna ze zmiennych ('dzis', 'jutro',
  'pojutrze' lub 'popojutrze') nie bdzie ustawiona domylnie
  wywietlona bdzie peognoza na 4 dni. Jeeli natomiast ustawiona
  bdzie cho jedna z tych zmiennych, domylnym ustwieniem jest nie
  wywietlanie prognozy na dany dzie, np.:

  $_WEATHER['dzis'] = 1; // wywietlanie tylko prognozy na jutro
  
  $_WEATHER['jutro'] = 1;       // \  
  $_WEATHER['pojutrze'] = 1;	//  > wywietlenie prognozy na
  $_WEATHER['popojutrze'] = 1;  // /    nastpne 3 dni
  



IIIb. Konfiguracja prezentacji
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Konfiguracja sposobu wywietlania informacji jest dokonywana za pomoc
kaskadowych arkuszy stylw. 

Caa prognoza jest w elemencie <div> z atrybutem "id" ustawionym na
"weather-report". Ustawienie formatowania tego dokumentu ma wpyw na
wygld gadetu, np.: 

<style>
#weather-report * {
 color : red;
}
</style> 


ustawia kolor wszystkich napisw wywietlanych przez gadzet na czerwony. 