$Id: README,v 1.2 2004/08/27 12:47:51 lexx Exp $

0. Co to?

Ten may zestaw narzdzi pozwala za pomoc squida w dosy elegancki sposb 
wywietla wiadomoci administracyjne. Oczywicie aby to dziaao w 100%,
wszyscy uytkownicy musz korzysta ze squida.

1. Instalacja.

Mona wyrni 3 etapy:

a) konfiguracja squida
b) konfiguracja redirectora
c) konfiguracja serwera wirtualnego

Ad a.

Do squid.conf dodajemy dwie linie:
------
redirector_bypass on
redirect_program /sciezka/do/lms-squid-warnings
------
ktre informuj squida aby dla kadego adresu uywa naszego redirectora.

Ad b.

Otwieramy w naszym ulubionym edytorze plik lms-squid-warnings i 
praktycznie wszystko co mona ustawi w naszym redirectorze to:
------
my $configfile = '/etc/lms/lms.ini';
------
Czyli pooenie pliku konfiguracyjnego. Reszta konfiguracji ustawiana jest 
w lms.ini, gdzie dopisujemy:
------
[squid-warnings]
redirect        = http://nasz.serwer.pl/winetka/
------
Czyli adres winetki.

Ad c.

Do katalogu gdzie ma by widoczna winetka kopiujemy index.php, message.html 
i zawarto katalog img.

2. W dziaaniu.

Kluczowym elementem jest redirector. Odpowiada on za to, aby w momencie 
ustawienia dla danego komputera flagi warn, przekierowywa wszystkie dania
wysyane do squida na nasz, ustalony wczeniej adres. Przekierowaniu
nie ulegaj adresy zawierajce adres naszej winetki, tak aby umoliwi 
zaadowanie si obrazkw.

Po przekierowaniu uytkownik ma moliwo oznaczenia wiadomoci jako 
przeczytanej, po czym skrypt automatycznie kieruje przegldark na pierwotnie
wywoywany URL.

Po drodze nigdzie nie s wykorzystywane adne reguki firewalla, ani aden
daemon nie jest przeadowywany. Skrypty podczas dziaania nie modyfikuj
adnych plikw. Jedyn wad moe by nieznaczne spowolnienie pracy squida
(przykadowo, na moim Athlonie 1.2 przetworzenie 2000 adresw, z czego poowa 
podlegaa przekierowaniu, a druga nie trwao 0,774 sekundy, co daje czas 
przetwarzania okoo 0,000387 sekundy na adres. W momencie pisania tego tekstu
strona gwna Wirtualnej Polski skadaa si z 62 elementw, przez co 
redirector zwikszy jej czas adowania o 0,023994 sekundy).