**********************************************

	Statystyka Stron WWW "REGGI-STAT"
	Wersja 0.9.4 z dnia 2002.11.12

	Autor: 
	REGGI Uslugi Komputerowe Marek Reinowski
	www.reggi.pl, reggi@reggi.pl

************************************************

STRONY NIEKOMERCYJNE (prywatne):
Statystyki mozesz uzywac do woli za "dziekuje" na mojego maila ;-) 
Milym gestem bedzie umieszczenie na stronie odnosnika do mnie w postaci:

<!-- Poczatek kodu do umieszczenia obrazka REGGI-STAT -->
<A HREF="http://reggi.pl" TARGET="_blank">
<IMG SRC="http://reggi.pl/images/reggi_stat.gif" WIDTH="83" HEIGHT="31" BORDER="0" ALT="REGGI-STAT - php za free - webdesign - hosting - darmowe skrypty - REGGI - www.reggi.pl">
</A>
<!-- Koniec kodu do umieszczenia obrazka REGGI-STAT -->



STRONY KOMERCYJNE (w tym wszystkie serwisy nalezace do podmiotow gospodarczych, urzedow itp):
Warunkiem wykorzystania statystyki jest umieszczenie w kazdym dokumencie html obrazka za pomoca ponizszego kodu:

<!-- Poczatek kodu do umieszczenia obrazka REGGI-STAT -->
<A HREF="http://reggi.pl" TARGET="_blank">
<IMG SRC="http://reggi.pl/images/reggi_stat.gif" WIDTH="83" HEIGHT="31" BORDER="0" ALT="REGGI-STAT - php za free - webdesign - hosting - darmowe skrypty - REGGI - www.reggi.pl">
</A>
<!-- Koniec kodu do umieszczenia obrazka REGGI-STAT -->



Jesli masz uwagi, pomysly itp. to pisz do mnie na adres reggi@reggi.pl
Bede sie staral w miare wolnego czasu udoskonalac statystyke, dodawac nowe funkcje itp.
NIE UDZIELAM WSPARCIA TECHNICZNEGO (PRZYKRO MI, ALE DOBA JEST ZA KROTKA :(
Jesli sobie na prawde nie mozesz poradzic, to napisz. Musisz sie jednak liczyc z tym, ze na odpowiedz,
jesli nie bedzie oczywista i nie zajmie mi wiele czasu, bedzie trzeba poczekac do mojej najblizszej wolnej chwili.

Statystyka zapisuje licznik odwiedzin i ogolne dane w osobnych plikach, 
dzieki czemu jest mozliwosc skasowania czesci danych ze statystyki 
(jesli plik ogolne.txt ma zbyt duze rozmiary), przy jednoczesnym zachowaniu stanow licznikow.
UWAGA!!! W najblizszym czasie planuje odejscie od podzialu na 2 pliki z danymi z powodu
			udoskonalania obslugi wykluczen adresow ip. 
			Mozliwe, ze pozostawie mozliwosc osobnego zapisu pliku licznikow jako opcje.

Statystyka dziala w ten sposob, iz nie zapisuje dwukrotnego wejscia z rzedu na te sama strone z tego samego ip. Mozna jednak wlaczyc zliczanie wszystkich odswiezen strony zmieniajac w pliku stat.php wartosc zmiennej $zliczaj_wszystkie na "true".

Mozna podac liste adresow ip, z ktorych nie maja byc zliczane odwiedziny. Szczegoly ponizej.


Sposob uzycia:

Rozpakuj archiwum. 
Pliki statystyk beda domyslnie zapisywane w katalogu reggistat.

Plik stat.php odpowiada za zliczania odwiedzin i generowanie plikow z danymi do statystyki.
Powinien zostac umieszczony w katalogu ze stronami www, obrazkami itp.
Jesli PHP obsluguje funkcje graficzne (zainstalowana biblioteka gd), wynikiem jego dzialania moze byc obrazek z liczba odwiedzin danej strony. 
Jesli PHP nie obsluguje grafiki, istnieje mozliwosc wyswietlania logo statystyk w miejsce licznika, co pozwala uniezaleznic statystyki od obslugi funkcji graficznych. W tym celu nalezy zmienic wartosc zmiennej $obsluga_grafiki na wartosc 'off' (wiecej w komentarzach w pliku stat.php).

Plik index.php odpowiada za wyswietlanie statystyk. Moze byc umieszczony w katalogu chronionym haslem itp.

Plik wykluczone_ip.txt zawiera liste adresow ip, ktore nie beda brane pod uwage podczas generowania statystyki. W kazdym wierszu tego pliku moze sie znalexc tylko jeden poprawny adres ip. W raize podania blednego adresu ip, zostanie on pominiety przy wykluczaniu.
UWAGA: odwiedziny z wykluczonych adresow sa normalnie odnotowywane w danych statystyki i zliczane przez licznik. W kazdej chwili mozna przywrocic ich uwzglednianie w statystykach poprzez usuniecie danego adresu ip z pliku wykluczone_ip.txt. 
Wykluczanie dziala w ten sposob, ze przy analizie pliku z danymi statystyk, po napotkaniu wykluczonego ip, dane dla niego sa pomijane i statystyka przechodzi do analizy kolejnych odwiedzin.

Jesli zmienisz polozenie plikow, pamietaj o aktualizacji sciezek dostepu do plikow z danymi statystyk
(zmienne $plik_licznikow i $plik_odwiedzin w obu skryptach). Jest to opisane w komentarzach obu skryptow. 

Jesli statystyka nie dziala, w pierwszej kolejnosci sprawdz czy istnieja pliki liczniki.txt i ogolne.txt.  Pliki te powinny miec prawa "666" (do zapisu i odczytu przez wszystkich). Skrypt stara sie samodzielnie utworzyc i nadac odpowidnie prawa, jednak, w zaleznosci od konfiguracji, serwer moze mu na to nie pozwolic. Najwygodniej to sprawdzic odwolujac sie z przegladarki bezposrednio do pliku stat.php. W takim wypadku otrzymasz stosowny komunikat. 


Na stronach, ktore chcesz objac statystyka, dodaj nastepujacy kod:

<IMG SRC="stat.php?s=nazwa_w_statystyce&p=0&f=4&r=255&g=204&b=0" BORDER="0" ALT="Statystyka generowana przez Reggi-Stat - www.reggi.pl">

lub w przypadku statystyki pobierania pliku:

<A HREF="stat.php?s=nazwa_w_statystyce&u=nazwa_pliku">Pobierz ten plik</A>

Gdzie:
s - nazwa strony, pod jaka bedzie zapisana w statystyce (np. strona_glowna)
    musi sie skladac z liter, cyfr i znaku podkreslenia _
	Parametr Obowiazkowy!
	
p - okresla, czy licznik ma sie pokazywac na stronie.
    1 - pokazac licznik
    0 - nie pokazywac licznika
    Parametr nieobowiazkowy, jesli go nie podasz, przyjeta zostanie wartosc 0
	
u - okresla nazwe i sciezke dostepu pliku do sciagania 
    (w przypadku statystyki pobierania plikow)

f - font uzyty do pokazania licznika, musi to byc pojedyncza cyfra
	Parametr nieobowiazkowy, jesli go nie podasz, przyjeta zostanie wartosc 4
	
r, g, b - zmienne RGB koloru, jakim bedzie napisana wartosc licznika wyrazone w skali 0-255
    Parametry nieobowiazkowe, jesli ich nie podasz, przyjeta zostanie wartosci rowne 0
	

Aby obejrzec statystyke, otworz strone index.php w katalogu ze statystykami.


HISTORIA WERSJI:

Zmiany w wersji 0.9.5
- Poprawiono zliczanie i wyswietlanie blednych odwiedzin.
- Dodano rozpoznawanie przegladarek Mozilla, Konqueror, Lynx
- Poprawiono drobne bledy w formatowaniu wynikow statystyki.


Zmiany w wersji 0.9.4:
- Drobne zmiany poprawiajace blad sortowania ostatnich odwiedzin


Zmiany w wersji 0.9.3:
- Wprowadzono bardzo znaczace wewnetrzne modyfikacje poprawiajace wydajnosc i likwidujace blad przy bardzo duzych ilosciach odwiedzin.
- Poprawiono wyswietlanie wykluczonych adresow ip - teraz pokazywane sa  rowniez wykluczone adresy ip, z ktorych nie bylo jeszcze odwiedzin.
- Dodano rozpoznawanie przegladarek Netscape 6 i Netscape 7.
- Poprawiono inne drobne bledy w formatowaniu wynikow statystyki.


Zmiany w wersji 0.9.2:
- zlikwidowano blad objawiajacy sie informacja o bledzie w wierszu 256, jesli nie bylo zdefiniowanego wykluczania adresow ip


Zmiany w wersji 0.9.1:
- dodano obsluge WHOIS (pokazywanie danych dla adresu ip). Obsluga WHOIS bazuje na skrypcie Krzysztofa Walkowicza,
- zmieniono sposob wyswietlania ilosci odwiedzin w menu statystyki (dane teraz pobierane sa z danych statystyki, a nie jak wczesniej z pliku licznikow),
- dodano wyswietlanie daty, od kiedy dzialaja statystyki,
- dodano wyswietlanie wykluczonych adresow ip wraz ogolna liczba odwiedzin z danego adresu,
- poprawiono drobne bledy i wprowadzono zmiany wewnetrzne poprawiajace wydajnosc dzialania statystyki,
- zmiana nazw funkcji i zmiennych na angielskie.


Zmiany w wersji 0.9.0:
- dodano mozliwosc wykluczania adresow ip w wynikach dzialania statystyki
- przyspieszono generowanie statystyki po stronie serwera
- dodano obsluge bledow w przypadku braku plikow z danymi
- drobne zmiany poprawiajace wyglad statystyki 


Zmiany w wersji 0.8.1:
- usuniety blad wyswietlania 'pustych linii' na koncu listy dni i hostow z najczestszymi odwiedzinami 
- drobne zmiany poprawiajace wyglad statystyki 


Zmiany w wersji 0.8:
- poprawiono powazny blad powodujacy zbyt duza zajetosc pamieci, w zwiazku z czym skrypt przy duzej ilosci odwiedzin przestawal dzialac.


Zmiany w wersji 0.7: 
- dodano mozliwosc zliczania wszystkich odswiezen strony,
- usunieto bledy wystepujace podczas wyswietlania wynikow statystyk, gdy nie mozna poprawnie odczytac plikow z danymi.


Zmiany w wersji 0.6:
- dodano rozpoznawanie Windows XP,
- zmieniono sposob zliczania ilosci odwiedzin (nie pokazuje blednych odwolan w ogolnej ilosci odwiedzin)


Zmiany w wersji 0.5: 
- dodano mozliwosc dzialania statystyk bez funkcji graficznych w PHP,
- dodano komunikaty o bledach.


Zmiany w wersji 0.4: 
- dodano mozliwosc tworzenia statystyk pobierania plikow