Statystyka IMPERATOR STATS

(C)2000-2004 by
    Autor:       Adam "Logic" Sobocinski <logic@anubisdev.com>
    Wsppraca:  Piotr "GeoS" aka "Gajcy" Galas <geos@anubisdev.com>
                 Micha "MD5" Bundyra <md5@pf.pl>

Strona domowa:   http://www.anubisdev.com

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

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 nia
adnych opat. Moesz jej uzywa za darmo (tylko na stronach niekomercyjnych)
pod warunkiem, e tresc jest zgodna z polskim prawem oraz po
bezplatnej rejestracji na stronie domowej: www.anubisdev.com
Autor nie bierze odpowiedzialnosci za jakiekolwiek szkody wynikle
z uzytkowania programu.

Uwaga!
Aby legalnie korzystac ze statystyk ,nie wolno usuwa logo statystyki,
ktre pojawi si po instalacji na stronie w miejscu wywolania skryptu.



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.

Nastpnie wejc do konfiguracji
http://adres_www_do_statystyk/istats5/index.php?p=admin
i ustawic sciek do statystyk. Skopiowac kod ktry si
tam znajduje i wkleic do strony.

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 nastpnie umiecisz kod
na kadej podstronie ktra ma by zliczana.


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:
Statystyka przeznaczona jest dla serwisw osb prywatnych, wic
zabronione jest umieszczanie iStats na komercyjnych stronach.
Dla stron komercyjnych przeznaczony jest AnubisStat dostpny
pod adresem www.anubisdev.com

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


Odpowiedz:
Jesli czujesz si na siach zrobi adne logo statystyki na swoja stron, zrb to.
Ale poinformuj mnie o tym wysyajac maila na adres logic@anubisdev.com


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:

<!-- start istats code -->
<script language="javascript">
<!--
var ipath='server/istats5';
document.write('<SCR' + 'IPT LANGUAGE="JavaScript" SRC="http://'+ ipath +'/istats.js"><\/SCR' + 'IPT>');
//-->
</script>
<!-- end istats code -->

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


Jesli masz jakies pytania napisz: e-mail : logic@anubisdev.com


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