Statystyka IMPERATOR STATS

(C)2000-2002 by
    Autor:       Adam "Logic" Sobocinski <logic@stone.pl>
    Wsppraca:  Piotr "Gajcy" Galas <gajcy@viper.pl>
                 Micha "MD5" Bundyra <md5@pf.pl>

Strona domowa:   http://www.iportal.nano.pl

----------------------------

Spis treci:

1. Licencja
2. Instalacja
3. Upgrade
4. Sprawy techniczne
5. Konfiguracja
6. Znane problemy
7. FAQ

1. Licencja
----------------------------
Program w wersji 5 ma status freeware.
Statystyk mozesz rozpowszechnia, pod warunkiem nie pobierania za ni
adnych opat. Moesz jej uzywa za darmo (take na stronach komercyjnych)
pod warunkiem, e tresc jest zgodna z polskim prawem oraz po
bezplatnej rejestracji na stronie domowej: www.iportal.nano.pl.
Autor nie bierze odpowiedzialnosci za jakiekolwiek szkody wynikle
z uzytkowania programu.

Uwaga!
Nie wolno usuwa logo statystyki, ktre pojawi si po instalacji
na stronie w miejscu wywolania skryptu. Jesli usuniesz ten znaczek
bedziesz uzywa programu nielegalnie.


Wsparcie
Jesli zalezy ci na dalszym rozwoju statystyki, wyslij dowoln kwot na jej rozwj.
Nie ma okreslonej kwoty, wplacasz tyle na ile twoim zdaniem zasluguje
Imperator Stats :), na numer konta:

mBank - 94 1140 2004 0000 3402 2975 3839

jako nazwe przelewu wpisz swoj email,
w tym momencie strona takiej osoby, znajdzie sie w dziale osob
wspierajacych projekt statystyki.



2. Instalacja
--------------
Aby zainstalowac statystyk musisz skopiowa j do katalogu "istats5".
w systemach unixowych (linux, unix, BSD) nalezy ustawic
prawa do zapisu serwerowi WWW, lub ustawic je na chmod 777.
Dla katalogu logs takze ustawiamy prawa na 777.

Aby statystyka zaczla naliczac poszczeglne wejscia, nazlezy wstawic kod
<script language="JavaScript">
<!--
document.write("<img src=http://server/istats5/stat.php?ref=1&idref=" + escape(document.referrer) + ">")
//-->
</script>

Uwaga: Poprzednia metoda "include", nie dziaa z now wersj statystyk.


W miejscu dolaczenia statystyki pojawi si logo, poprzez ktre mona wej
do statystyk. Strona na ktrej bdzie umieszczona statystyka musi miec
rozszerzenie .php  .php3  .phtml  lub inne rozpoznawane na serwerze
jako plik PHP.

Przed pierwszym uruchomieniem, nalezy ustawic adres www, prowadzacy do statystyk.
Mozna to zrobic w pliku conf.php, lub poprzez panel administracyjny.
Panel administracyjny wywolujemy, wpisujac adres
http://adres_www_do_statystyk/istats5/index.php?p=admin

Jeli chcesz zlicza pojedycze podstrony serwisu wystarczy, e wczysz opcj
"zliczaj podstrony" w panelu administracyjnym, a nastpmie umiecisz kod
odpowidni na kadej podstronie ktra ma by zliczana. 

Zaleca sie zmiane hasla do statystyk. Domyslnie jest to 'istats'.

3. Upgrade
-------------------

Nie ma mozliwosci zrobic upgrade z wersji 4 lub nizej, poniewaz system logow
w nowej wersji jest niekompatybilny ze starszymi. Zmiany te byly konieczne
aby podniesc niezawodonosc programu.

4. Konfiguracja
-------------------
Konfigurowa statystyk, mona na dwa sposoby. Poprzez panel
administracyjny (zalecany), lub poprzez edycj pliku conf.php.

Statystyka posiada dwa poziomy zabezpieczenia, dla ktrych ustawia
si oddzielnie hasa.
Pierwszy poziom - dostp tylko do prezentacji
Poziom drugi    - dostp do prezentacji i administracji statystyki
Jeli pozostawisz te pola puste, statystyka bdzie dostpna dla wszystkich.

Przy opcji "Lista IP do wykluczenia (rozdzielone ";")", jest mozliwosc
wpisania listy numerow IP, ktore maja zostac wylaczone ze zliczania.
Jesli wiec mam numer IP 127.0.0.1, wpisanie tego numeru w konfiguracje,
spowoduje, ze nasz wejscia nie beda zliczane.
Jest mozliwosc wylaczenia calej klasy za pomoca gwizdki *.
Np. 127.0.0.* - wszystkie adresy z zakresy 127.0.0.1 - 127.0.0.254 beda
wylaczone ze zliczania.


5. Sprawy techniczne
--------------------
Dziaanie skryptu opiera si na funkcjach PHP, JavaScript i cookies.
Operuje na plikach tekstowych, czyli nie potrzebuje adnych baz danych.

Wersja 5 i wyzsze korzystaja z nowego unikalnego systemu zapisu logow,
dzieki temu pozwala to na bardziej wydajne dzialanie programu.

W skad statystyki wchodz nastpujce pliki:

stat.php     - gwny kod statystyki
rstat.php    - dodatkowy modu do zliczania rodzielczoci i bitw kolorw
pages.php    - dodatkowy modu do zliczania wej na poszczeglne podstrony
conf.php     - plik z danymi do konfiguracji statystyki
index.php    - skrypt do prezentacji wynikw statystyki
winday.php   - wywietla informacje o odwiedzinach z podanego miesica
login.php    - skrypt do logowania

statclass.php  - gwna klasa statystyki
common.php     - funkcje wykorzystywane w obu warstwach (zapisu i prezentacji)
lang.inc.php - lista krajw
ogolne.inc.php - informacje kiedy i ile ;-)
hosts.inc.php  - z jakiego hosta i kraju
tech.inc.php   - techniczne informacje o odwiedzajcych
pages.inc.php  - zapisuje odwiedzane podstrony
seach.inc.php  - adresy referujce, wyszukiwarki i sowa kluczowe
last.inc.php   - wywietla list ostanich wej
kraj.inc.php   - wywietla list krajw
admin.inc.php  - konfiguracjia statystyki

get_search.php    - modu identyfikjcy wyszukiwarki i sowa kluczowe wpisane do nich
get_os.php        - modu identyfikujcy system operacyjny
get_browser.php   - modu identyfikujcy przegldark

img/           - pliki graficzne
doc/           - dokumentacja
logs/          - logi


Jesli znajdziesz blad w dziaaniu lub masz pomys co doda do
tej statystyki napisz e-mail : logic@stone.pl


6. Znane problemy
-----------------

Jesli z jakiego powodu statystyka nie dziala poprawnie, sprawdz
nastepujace rzeczy:

- gdy statystyka nie utworzyla katalogu "logs"
  zmien prawa katalogu istats5 na chmod 777;

- gdy statystyka nie zapisuje wejsc, pomimo utworzenia katalogu "logs",
  prawdopodobnie nieprawidlowo zostaa zainstalowana statystyka,
  w tym przypadku usun cay katalog, program powinien ponownie stworzyc
  katalog, oraz wymagane w nim pliki;

- nie wyswietla sie logo statystyki i/lib nie zlicza wejsc,
  w tym przypadku sprawdz konfiguracje, w zmiennej $istat['base_path'],
  powinna znajdowac sie bierzaca sciezka do statystyk;

- nie zlicza mi kolorow i rozdzielczosci w dziale "techniczne",
  prawdopodobnie nie jest ustawiona, lub jest ustawiona nieprawidlowo
  sciezka (url) do statystyk. Ustawic ja mozna w pliku conf.php za
  pomoca dowolnego edytora tekstowego, lub poprzez panel administracyjny
  na stronie www;


7. FAQ
--------------

1. Pytanie:
Czy mog uywa statystyki na stronie komercyjnej?

Odpowiedz:
Tak, jedynie  wymagane jest pozostawienie logo w widocznym miejscu na stronie.
Dotyczy to take stron prywatnych.


2. Pytanie:
Chciabym zmieni logo, poniewa to ktre jest nie pasuje mi do strony,
czy jest to moliwe?


Odpowiedz:
Jeli czujesz si na siach zrobi adne logo statystyki na swoj stron, zrb to.
Ale poinformuj mnie o tym wysyajc maila na adres logic@stone.pl


3. Pytanie
Tam gdzie umieszczam kod statystyki, dostaje komunikat lub podobny:
Warning: session_start(): Cannot send session cookie - headers already sent by (output started at /home/www/index.php:3) in /home/www/istats5/stat.php on line 7

Odpowiedz:
Problem spowodowany jest przez korzystanie z sesji. Poniewaz metoda wstawienia
statystyk do strony poprzez polecenie "include" nie dziaa poprawanie na 
wielu stronach, zrezygnowalimy ze wsparcia dla tej metody. 
Aby statystyka dziaa poprawnie na stronie, naley wstawic kod:

<script language="JavaScript">
<!--
document.write("<img src=http://server/istats5/stat.php?ref=1&idref=" + escape(document.referrer) + ">")
//-->
</script>

Gdzie "server" to adres www serwera, na jakim zainstalowana jest statystyka


Jeli masz jakie pytania napisz: e-mail : logic@stone.pl


--------------------------------------------------------------------
   <END>
