Polski plik ReadMe dla eStats v4.9

Spis treści

  1. Wstęp
  2. Cechy
  3. Wymagania
  4. Instalacja
  5. Aktualizacja z poprzedniej wersji
  6. Licencja
  7. Kontakt

Wstęp

eStats jest skryptem umożliwiającym prowadzenie kompleksowych statystyk odwiedzin witryny, zbierającym wiele różnych danych na temat użytkowników oraz ich aktywności.

Cechy

Skrypt umożliwia:

Wymagania

Wymagana wersja PHP to co najmniej 5.2.0.

Wymagana jest dostępność na serwerze przynajmniej jednego z następujących typów baz danych: SQLite, MySQL lub PostgreSQL.

Opcjonalne zależności to rozszerzenia PHP: gd, geoip, gettext, mbstring, bzip, zip, zlib.

Instalacja

  1. Skopiuj cały katalog estats na swój serwer;
  2. Katalogom data/, data/backups/, data/cache/ oraz data/tmp/ nadaj CHMOD 777, a plikowi conf/config.php CHMOD 666 (utwórz je jeśli nie istnieją);
  3. Otwórz w przeglądarce katalog, do którego skopiowałeś pliki;
  4. Postępuj zgodnie z wyświetlanymi instrukcjami;
  5. Aby statystyki zaczęły zliczać odwiedziny musisz umieścić na monitorowanych stronach kod (aby skrypt działał prawidłowo serwer musi umożliwiać wykonywanie kodu PHP w pliku strony!):
    <?php
    define('ESTATS_COUNT', 1);
    define('ESTATS_ADDRESS', 'ADDRESS'); // opcjonalnie
    define('ESTATS_TITLE', 'TITLE'); // opcjonalnie
    @include ('PATH');
    ?>
    Gdzie:

    ADDRESS - adres podstrony (bez http://adres.strony.pl, np. /index.php?strona=glowna) (opcjonalnie);
    TITLE - jeśli kodowanie znaków podstrony jest inne niż UTF-8, to nie używaj w nim znaków spoza angielskiego alfabetu (opcjonalnie);
    PATH - ścieżka dostępu do pliku stats.php w katalogu estats/, np. ../katalog/estats/stats.php.

    Linie z parametrami oznaczonymi jako opcjonalne można usunąć, wtedy użyte zostaną wartości pobrane ze strony lub domyślne.
  6. Aby działało zbieranie informacji o rozdzielczościach ekranu, wersji wtyczki flash itd. należy umieścić ponadto gdzieś na stronie następujący kod:
    <noscript>
    <div>
    <a href="http://estats.emdek.cba.pl/">
    <img src="PATHantipixel.php?count=COUNT" alt="eStats" title="eStats" />
    </a>
    </div>
    </noscript>
    <script type="text/javascript">
    var eCount = COUNT;
    var ePath = 'PATH';
    var eTitle = 'TITLE'; // opcjonalnie
    var eAddress = 'ADDRESS'; // opcjonalnie
    var eAntipixel = 'ANTIPIXEL'; // opcjonalnie
    </script>
    <script type="text/javascript" src="PATHstats.js"></script>
    Gdzie:

    PATH - ścieżka dostępu do katalogu estats/, np. /katalog/estats/;
    COUNT - 0 - zbieraj tylko dane techniczne, 1 - zbieraj wszystkie dane (tylko gdy nie można użyć kodu PHP);
    ADDRESS - adres podstrony, np. /katalog/podstrona.html (opcjonalnie);
    TITLE - tytuł podstrony (opcjonalnie);
    ANTIPIXEL - wybrany antypixel dla podstrony, np. default/silver.png (opcjonalnie).

    Linii z parametrami oznaczonymi jako opcjonalne nie można usunąć, należy pozostawić puste wartości dla użycia wartości pobranych ze strony lub domyślnych.

Aktualizacja z poprzednich wersji

Aktualizacja ze starszych wersji serii 4.9.xx polega na zwykłej podmianie plików.

W przypadku używania bazy danych SQLite oraz wersji starszych od 4.9.50 wymagana jest ręczna konwersja bazy danych do formatu wersji 3.x (ze względu na wycofanie obsługi wersji 2.x od PHP 5.3).

Pamiętaj aby zawsze utworzyć kopię zapasową danych przed aktualizacją!

Licencja

Kontakt

Jeśli znajdziesz jakieś błędy w skrypcie (choćby to była zwykła literówka) lub masz jakieś pomysły, które mogłyby uatrakcyjnić go, to napisz o tym na forum projektu.

Ostatnio zmieniany: 2011-01-28 16:12:10 CET