Pomoc

Dokumentacja Funkcje serwera

Biblioteka skryptów CGI

Książka gości

Skrypt /cgibin/guestbook umożliwia odwiedzającym Twoją stronę pozostawienie widocznej dla pozostałych opinii na dowolny, określony przez Ciebie temat np. przeczytanego tekstu. Książka gości składa się z dwóch elementów: skryptu, którego zadaniem jest dopisywanie nowych wypowiedzi oraz z tworzonej i uzupełnianej automatycznie strony WWW zawierającej wyrażone wcześniej opinie.

W ramach jednego konta może funkcjonować wiele książek gości. Opinie dot. każdej książki przechowywane są w osobnym pliku, który musi znajdować się w katalogu głównym konta. Nazwę pliku określasz samodzielnie, używając do tego znanego już (z konfiguracji formmaila) pola ukrytego w formularzu.

Aby zainicjować guestbooka - wersja dla początkujących:

Wywołaj skrypt wpisując w pasku adresu przeglądarki http://domena.konta/cgibin/guestbook
Wpisz pierwszą opinię.

Skrypt stworzy w katalogu głównym konta plik o nazwie guestbook.htm Będzie on zawierał formularz do wpisywania nowych wypowiedzi oraz listę już wyrażonych opinii. Plik ten możesz edytować jak każdy dokument HTML.

Edytując wygląd strony pamiętaj, aby nie zmieniać położenia następującej linii:

Sekwencja ta określa miejsce, pod którym skrypt będzie umieszczał nowe wypowiedzi. Musi ona znajdować się w osobnej linii, nad wcześniej wpisanymi opiniami.

Jest to przykład prostego wykorzystania skryptu. Operując jednak na szablonach możesz stworzyć mechanizm odpowiadający Twoim indywidualnym gustom.

Aby zainicjować guestbooka - wersja dla zaawansowanych:

Wejdź do Panelu Administracyjnego konta i wybierz w zakładce Konfiguracja WWW sekcję Szablony skryptów,
Zdefiniuj za pomocą kolejnych szablonów wygląd stron generowanych przez skrypt:
- GUESTBOOK_TOP - wygląd górnej części stron generowanych przez skrypt,
- GUESTBOOK_BOTTOM - dolna część stron książki gości,
- GUESTBOOK_FORM - formularz dodający nową opinię do książki, w źródle występują następujące słowa kluczowe:
  - $FORM - wymagalny znacznik otwarcia skryptu,
  - $INPUT() - pole typu INPUT w formularzu, w nawiasie - nazwa (NAME),
  - $TEXT() - pole typu TEXTAREA w formularzu, w nawiasie - nazwa (NAME),
  - $SUBMIT() - przycisk zatwierdzający wpis - SUBMIT, w nawiasie - nazwa (NAME).
- GUESTBOOK_REQUIRE - lista pól wymagalnych w formularzu (składnia: nazwa1, nazwa2, nazwa3),
- GUESTBOOK_HEADER - nagłówek listy istniejących komentarzy,
- GUESTBOOK_ITEM - definicja wyglądu poszczególnych wpisów w książce gości, w źródle mogą występować następujące słowa kluczowe:
  - $FIELD - wyświetla zawartość pola o nazwie zdefiniowanej w nawiasie,
  - $ENV - wstawia zmienną środowiskową podaną w nawiasie,
  - $DATE - umieszcza datę wpisu,
  - $TIME - wprowadza godzinę wpisu.
- GUESTBOOK_EMPTY - wyświetla listę pól wymaganych, lecz niewypełnionych przez wpisującego opinię, słowo kluczowe $NAME podaje nazwy pól pustych.

Nazwa	Budowa
Strona główna guestbooka	GUESTBOOK_TOP GUESTBOOK_FORM GUESTBOOK_HEADER GUESTBOOK_ITEM GUESTBOOK_BOTTOM
Strona z informacją o niekomplentym wpisie	GUESTBOOK_TOP GUESTBOOK_EMPTY GUESTBOOK_BOTTOM

Wywołaj skrypt wpisując w pasku adresu przeglądarki http://nazwa.home.pl/cgibin/guestbook
Wpisz pierwszą opinię.
O ile to konieczne zmień dowolnym edytorem HTML powstały plik guestbook.htm. Możesz np. przekleić wygenerowany formularz (kod HTML między znacznikami <FORM> a </FORM>) do dowolnej strony bądź też za pomocą parametru <INPUT TYPE=HIDDEN NAME="file" VALUE="file.htm"> zmienić nazwę strony, w której skrypt umieszczać będzie opinie.

Stosując możliwości skryptu możesz uruchomić kilka niezależnych książek gości w ramach jednego konta.

Każdy własny plik HTML z księgą gości musi znajdować się w katalogu głównym konta.