Jeśli jesteś właścicielem tej strony, możesz wyłączyć reklamę poniżej zmieniając pakiet na PRO lub VIP w panelu naszego hostingu już od 4zł!
WDC jest lekkim i jednocześnie zaawansowanym czatem napisanym za pomocą PHP i JavaScript. W skrypcie zaimplementowano rangi użytkowników, rejestrację, bbcode, emoticonki, więcej.

Dokumentacja:

Spis treści:

  1. Wstęp
    1. Rozwinięcie skrótu WDC
    2. O projekcie
    3. Cechy projektu
    4. Autorzy
    5. Cechy WDC 1
    6. Wymagania
  2. Instalacja
  3. Opcje
    1. Wstęp
    2. Opcje clienta
    3. Opcje serwera
  4. Wsparcie dla przeglądarek
  5. FAQ

Wstęp

Rozwinięcie skrótu WDC:

WDC czyli Wszędzie Działający Czat ;)

O projekcie:

Jest to projekt który ma umożliwić umiejscowienie webmasterom, czatu na swojej stronie, nawet jeśli nie mają oni dostępu do javy, albo z jakiś względów nie chcą jej użyć. WDC jest napisany za pomocą PHP i JavaScript, co sprawia, że może być błyskawicznie wdrożony i powszechnie używany. Dzięki temu również każdy może dostosować czat do swoich wymagań i upodobań. Większość czatów w javie działa na portach innych niż 80 co sprawia, że spora część użytkowników za firewallami nie może z nich korzystać, WDC nie ma z tym problemu ponieważ korzysta z protokołu http. Istotnym problemem czatów w javie jest ich zasobożerność i skomplikowany sposób dostosywania wyglądu do strony. WDC jest zbudowany z (X)HTMLa dzięki czemu nie będziesz miał żadnych problemów z dostosowaniem wyglądu do swojej strony.

Cechy projektu:

Autorzy

Aktualnie skrypt pisze sam, jeśli chcesz pomóc zarejestruj się i zgłaszaj błędy oraz propozycje w zakładce projekt (dostępne po zalogowaniu).

Cechy WDC 1:

Wymagania:

Instalacja:

  1. Pobierz najnowszą stabilną wersję WDC
  2. Rozpakuj i wrzuć pliki na serwer
  3. Nadaj folderowi data i całej jego zawartości chmod 0777 (W przypadku platform Uniksowych).
  4. Po tym mamy działający czat, o czym możemy się przekonać wpisując*:
    • http://nasza_domena/ścieżka_do_folderu_z_plikami_czatu/ lub
    • http://nasza_domena/ścieżka_do_folderu_z_plikami_czatu/module.php lub
    • http://nasza_domena/ścieżka_do_folderu_z_plikami_czatu/popup.html
Zmiana loginu i hasła administratora:

Wykonanie tego punktu jest istotne z punktu bezpieczeństwa i nie należy go omijać!

W celu zmiany loginu i hasła administratora należy wykonać poniższe kroki:

  1. Otwarcie pliku server.php (ścieżka: pliki_czatu/options/server.php). Jeśli twój edytor nie wyświetla pliku poprawnie zmień edytor na taki który interpretuje Uniksowe zakończenia lini jak np. Notepad++.
  2. Odnalezenie lini zawierającej "define('ROOT_NAME', 'root');". Linia ta definiuje login administratora. W tym przypadku jest nią root. Aby zmienić ją musimy zmienić tekst między znakami apostrofu ', czyli jeśli chcielibyśmy zmienić nazwę administratora na admin linia wyglądałaby tak: define('ROOT_NAME', 'admin');.
  3. O ile zmiana nazwy administratora nie jest konieczna o tyle zmiana hasła już tak. W tym celu odnajdujemy linię zawierającą "define('ROOT_PASSWORD', 'asder');" (linia 25). W tym przypadku hasło to asder. Jak już się już zapewne domyślasz, żeby zmienić hasło wystarczy zamienić tekst asder na własne hasło.

WDC jako moduł

Jeśli chcesz użyć WDC jako modułu (jak tutaj), w miejscu gdzie ma się wyświetlać czat musisz wstawić kod:

<object type="text/html" data="ścieżka_do_folderu_z_plikami_czatu/index.php"> </object>

Oczywiśćie żeby cokolwiekt zobaczyć trzeba nadać elementowi object wymiary, naprzykład za pomocą css. Przy czym minimalne wymiary wynoszą 400x300. Natomiast ciąg "ścieżka_do_folderu_z_plikami_czatu/index.php" należy zastąpić właściwą ścieżką. Może więc to wyglądać tak:

<object type="text/html" data="index.php" style="width:540px;height:400px;border:solid gray 1px;margin:auto;"> </object>

Zmiana tytułu

Pierwotnie pliki zamieszczone w folderze (index.php, module.php, popup.php) miały być tylko przykładami jak użyć funkcji displayChat do wyświetlenia czatu na stronie, wyszło jednak na to, że jej użycie poza tymi przykładami jest niepotrzebne ponieważ w tej wersji nie możliwości ustalenia stałych wymiarów czatu czyli zawsze próbuje zająć całą dostępną przestrzeń. Aby zmienić tytuł należy wejść np. do pliku index.php i poprostu zmienić treść tagu title (wymaga to tylko znajomości html'a więc nie będe tego opisywał).

Opis funkcji displayChat:

Funkcja ta służy do wyświetlenia czatu w miejscu jej użycia.

string displayChat(string $path [, int $advert [, bool $XHTML]])

Opcje

Wstęp

Opcje są podzielone na dwie grupy: clienta i serwera. Opcje klienta dotyczą wyglądu, języka, opcji połączenia itp. Niektóre z tych opcji mogą być zmienione przez użytkownika. Opcje serwera to natomiast dane root'a, ilość osób mogących jednocześnie przebywać na czacie, ograniczenia dostępu itp. Opcje są zapisane w formie stałych PHP, tak jak na schemacie poniżej:

define('NAZWA_OPCJI', WARTOŚĆ_OPCJI);

Opcje clienta

Plik: pliki_czatu/options/client.php

  1. WAIT_CONNECT
    Integer
    Określa co jaki czas nawiązywane jest połączenie. Czas podajemy w milisekundach. Domyślna wartość to 2000 milisekund czyli 2 sekundy.
    define('WAIT_CONNECT', 2000);
    define('WAIT_CONNECT', 3000);
    define('WAIT_CONNECT', 3497);
  2. CAPABILITY_CHANGE_LANGUAGE
    Boolean
    Możliwość zmiany języka.
    define('CAPABILITY_CHANGE_LANGUAGE', 1);
    define('CAPABILITY_CHANGE_LANGUAGE', 0);
    define('CAPABILITY_CHANGE_LANGUAGE', true);
    define('CAPABILITY_CHANGE_LANGUAGE', false);
  3. DEFAULT_LANGUAGE
    String
    Domyślny język. Uwaga! Można tutaj podać tylko zainstalowane języki, czyli te znajdujące się w folderze client/language. Domyślnie znajdują się tam dwa: polish i english. Jako wartość należy podać nazwę pliku języka bez rozszerzenia, czyli dla pliku polish.php podajemy polish.
    define('DEFAULT_LANGUAGE', 'polish');
    define('DEFAULT_LANGUAGE', 'english');
    define('DEFAULT_LANGUAGE', 'wlasny_jezyk');
  4. DISPLAY_INPUT
    Boolean
    Wyświetl pole typu input do wyboru kanału
    define('DISPLAY_INPUT', 1);
    define('DISPLAY_INPUT', 0);
    define('DISPLAY_INPUT', true);
    define('DISPLAY_INPUT', false);
  5. DISPLAY_DEFAULT_CANAL
    Boolean
    Wyświetl domyślny kanał
    define('DISPLAY_DEFAULT_CANAL', 1);
    define('DISPLAY_DEFAULT_CANAL', 0);
    define('DISPLAY_DEFAULT_CANAL', true);
    define('DISPLAY_DEFAULT_CANAL', false);
  6. DISPLAY_HOME_CANAL
    Boolean
    Wyświetl kanał domowy użytkownika
    define('DISPLAY_HOME_CANAL', 1);
    define('DISPLAY_HOME_CANAL', 0);
    define('DISPLAY_HOME_CANAL', true);
    define('DISPLAY_HOME_CANAL', false);
  7. CAPABILITY_CHANGE_DISPLAY_CANAL
    Boolean
    Pozwól na zmiane powyższych opcji przez użytkownika
    define('CAPABILITY_CHANGE_DISPLAY_CANAL', 1);
    define('CAPABILITY_CHANGE_DISPLAY_CANAL', 0);
    define('CAPABILITY_CHANGE_DISPLAY_CANAL', true);
    define('CAPABILITY_CHANGE_DISPLAY_CANAL', false);
  8. DISPLAY_SELECT
    Boolean
    Wyświetl liste rozwijaną Uwaga! Zostanie wyświetlona zawartość tablicy canal
    define('DISPLAY_SELECT', 1);
    define('DISPLAY_SELECT', 0);
    define('DISPLAY_SELECT', true);
    define('DISPLAY_SELECT', false);
  9. DEFAULT_EDITOR
    Integer
    Określa który edytor jest domyślny. Dostępne są dwa:
    • duży oznaczony jako 1
    • mały oznaczony jako 0
    define('DEFAULT_EDITOR', 1);
    define('DEFAULT_EDITOR', 0);
  10. CAPABILITY_CHANGE_STYLE
    Boolean
    Możliwość zmiany stylu.
    define('CAPABILITY_CHANGE_STYLE', 1);
    define('CAPABILITY_CHANGE_STYLE', 0);
    define('CAPABILITY_CHANGE_STYLE', true);
    define('CAPABILITY_CHANGE_STYLE', false);
  11. DEFAULT_STYLE
    String
    Domyślny styl. Uwaga! Można tutaj podać tylko zainstalowane style, czyli te znajdujące się w folderze client/templates. Domyślnie znajdują się tam tylko jeden styl: default. Jako wartość tej opcji podajemy nazwę folderu w którym znajduje się styl (tak jak dla stylu znajdującego się w folderze default podajemy default).
    define('DEFAULT_STYLE', 'default');
    define('DEFAULT_STYLE', 'wlasny_styl');
  12. MAX_LENGTH_MESSAGE
    Integer
    Maksymalna ilość znaków wysyłanej wiadomości
    define('MAX_LENGTH_MESSAGE', 4000);
    define('MAX_LENGTH_MESSAGE', 9000);
    define('MAX_LENGTH_MESSAGE', 50);

Opcje serwera

Plik: pliki_czatu/options/server.php

  1. DEFAULT_CANAL
  2. ROOT_NAME
  3. ROOT_PASSWORD
  4. ONLY_FOR_REGISTERED
  5. MAX_PING
  6. MAX_CLIENTS
  7. SHOUTBOX_MODE

Wsparcie dla przeglądarek

Zalecane przeglądarki: Wspierane przeglądarki: Częściowe wsparcie:

FAQ:

  1. Dlaczego mam krzaki zamiast polskich liter?
    Prawdopodobnie na stronie zadeklarowałeś kodowanie inne niż UTF-8. Jeżeli nie masz możliwości zmiany kodowania możesz na stronie zamieścić iframe, a w nim wyświetlić pełno ekranowy WDC.
  2. Dlaczego zaraz po zalogowaniu jestem automatycznie wylogowywany?
    Nie ustawiłeś odpowiednich uprawnień dla folderu data i rooms. Wejdź w swojego clienta FTP i ustaw tym folderom chmod 0777 (ścieżki: pliki_czatu/server/data/, pliki_czatu/server/data/rooms/).
  3. Przy próbie zalogowania wyskakuje mi komunikat:
    Nieznana odpowiedź serwera: <br/>
    <b>Parse error<b/>: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in (...)

    Na serwerze masz PHP4, a wymagane jest PHP5+.