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 odwiedzalności 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.
Opcjonalne zależności to rozszerzenia PHP: gd, geoip, gettext, mbstring, bzip, zip, zlib.

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

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 (starszych od 4.9.50) serii 4.9.xx polega na uzupełnieniu brakujących opcji w Konfiguracji Zaawansowanej (Narzędzia / Konfiguracja / Zaawansowane).

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

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-01 10:43:17 CET