File	Date	Author	Commit
README.TXT	2009-11-19	Piotr Mach	[cd7fa1] - poprawka działania na stronach w utf-8
klasy-gg.inc	2009-11-19	Piotr Mach	[cd7fa1] - poprawka działania na stronach w utf-8
przyklad1.html	2009-11-19	Piotr Mach	[cd7fa1] - poprawka działania na stronach w utf-8
przyklad2.php	2002-03-20	Piotr Mach	[adc739] - odbieranie wiadomości oczekujących na serwerze
www2gg.php	2009-11-19	Piotr Mach	[cd7fa1] - poprawka działania na stronach w utf-8

Read Me

#  BRAMKA WWW2GG V2.9 W CALOSCI W PHP A WIEC MULIPLATFORMOWA
#  MOZLIWA DO ZAMIESZCZENIA NA SERWERACH BEZ OBSLUGI CGI
#
#  (C) Copyright 2001 - 2009 Piotr Mach <pm@ggadu.com>
#  Bramka powstała dzięki opisowi protokołu gadu-gadu
#  z projektu EKG http://dev.null.pl/ekg/ (GG dla Linuksa)
#
#  LICENCJA : Możesz używać i przerabiać skrypt bez ograniczeń,
#	      jednak by zachować przyzwoitość należy wymienić autora skryptu 
#	      i link do oryginalnej wersji: http://gg.wha.la gdy tworzysz modyfikacje.
#


Skrypt udaje program gadu-gadu w wersji 6.0.x, wysyła jedną wiadomość pod podany
numerek GG i informuje o jej odebraniu. Użycie skryptu jest całkowicie legalne.

1. Jak tego używać ? Bardzo prosto:
-----------------------------------

- Potrzebujesz serwer z obsługą PHP > 4.0.0 (celowo nie uzywa mozliwosci wyzszych wersji php)
- Skopiuj do katalogu strony plik www2gg.php i funkcje-gg.inc
 (w razie problemów połącz te pliki lub wpisz pelna sciezke do funckje-gg.inc)
- W żródle skryptu www2gg.php wpisz nowe konto gg które będzie pełnić role bramki
- Możesz również zmienić statusy opisowe numeru bramki (także ustawić na puste = "")
- Na stronie w miejscu gdzie chcesz umieścić bramke wstaw FORM z nastepujacymi polami
    - "adresat"
    - "tresc"
Moga to być listy wyboru, pola textowe, hidden, cokolwiek.
Jako action podaj scieżke do skryptu. To wszystko.

Przykład:
<FORM METHOD="post" ACTION="www2gg.php">
    <INPUT TYPE="text" NAME="tresc" SIZE=100>
    <INPUT TYPE="text" NAME="adresat" SIZE="9" MAXLENGTH="9">
    <INPUT TYPE="submit" NAME="Submit" VALUE="Wyslij">
</FORM>
Skrypt sprawdzi poprawność danych, więc nie musisz się o to martwić.


2. Wersja rozszerzona bramki
----------------------------

Tak jak w pkt.1 plus możliwość wysylania z dowolnego konta 

W tym celu dodaj jeszcze:
 - pole wyboru o nazwie "tryb" o wartościach "numer_wlasny" i "numer_bramki"
 - pola "numer" i "haslo" w ktore beda wpisywane odpowiednie dane potrzebne
  do wysłania wiadomości.

Patrz plik przyklad1.html

Skrypt automagicznie rozpozna czy jest to wersja prostsza (adresat
i tresc) czy rozszerzona po obecności pola "tryb" więc nie musisz sie o to martwić :)



WYŚWIETLANIE WIADOMOSCI OCZEKUJACYCH NA SERWERZE GADU GADU
-----------------------------------------------------------

Po zalogowaniu do serwera gg wysylane sa wiadomośći oczekujące na odebranie
zostaną one wyświetlone dla trybu z możliwoscia wpisania konta nadawcy.

Dla trybu prostszego również zostaną odebrane ale nie będą wyświetlone (przepadną) 
ponieważ mogłaby je przeczytać inna osoba niż ta do której były adresowane.

Jeśli chccesz aby były zawsze wyświetlane ustaw opcje
WYSWIETL_OCZEKUJACE_WIADOMOSCI_DLA_BRAMKI=1 w pliku www2gg.php







Mini Changelog :)
-----------------
20.11.2009 v2.9.1 - poprawka działania na strnach w utf-8
17.10.2009 V2.9   - w pełni sprawna wersja z okazji 8-LECIA powstania bramki WWW2GG!!!
 - drobne uzupełnienie listy serwerów i kodu logowania
30.04.2004 V2.2.1
 - usuniecie drobnego bledu, przez ktory nie dzialalo na starszych wersjach php
23.04.2004 V2.2 
 - uaktualnienie skryptu by udawał gg w wersji 6.x bo niższe przestały działać.
08.02.2002 V2.1 
 - możliwosc ustawienia automatycznej odpowiedzi na wiadomosc "do bramki"
 - odbiektowy (jak na php 4x) kod, bardzo latwy do zastosowania we wlasnych skrytpach
26.01.2003 V2.0 
 - poprawa filtrow zabopiegajacych blokadzie wiadomosci
 - funkcja liczaca nowy hash logowania co dało mozliwośc udawania gg w wersji 4.9.x
 - możliwość wpisania statusów opisowych przy wysyłaniu i dla stanu "niedostepny" bramki
 - wyswietlanie statusu razem z opisem i ew. data powrotu adresata wiadomosci
 - przepisanie części na obiekty, być może łatwiej się teraz używa w innych skryptach a może nie:)
 - uaktualnienie listy IP serwerów gadu
06.07.2002 V1.4
 - zmiana linków zabobiegająca blokadzie "antyspamowej" 
15.05.2002 V1.3
 - poprawienie bledow (kto sie spieszy...:)
09.05.2002 V1.2 
 - dodanie formatowania tekstu, zamiana kolorów na html
 - poprawne dzialanie na register_global=off (PHP 4.2.0)
 - pewniejsze działanie, ładniejszy kod;)
21.03.2002 V1.1 
 - Odbieranie wiadomości oczekujących na serwerze
 - 3 proby logowania
 - poprawki w łączeniu z serwerem
17.10.2001 V1.0
 - pierwsza działająca wersja




_______________________________________
++ <nowe wersje na http://gg.wha.la> ++