Networks

La procédure de mise en oeuvre doit être suivie méthodiquement pour permettre une installation réussie du guestbook. La procédure décrite ci-après est sensiblement différente de celles mise à disposition précédement, il est donc important de bien la lire.

Il y a 4 parties dans le guestbook :

guestbook.pl

Ce fichier est un script CGI que vous devrez copier et modifier

guestbook.html

Ce fichier HTML contient le guestbook tel qu'il apparait pour les visiteurs. Ce fichier est modifié par le script guestbook.pl.

addguest.html

Ce fichier contient la page que les visiteurs utiliseront pour ajouter leurs commentaires dans le guestbook.

guestlog.html

Les événements et erreurs générées par le script guestbook.pl sont conservées dans ce fichier. Son utilisation vous est propre; il n'est pas nécessaire de le rendre accessible aux visiteurs.

Avant de commencer, vous devez décider de l'endroit où les fichiers guestbook.html et addguest.html seront placés dans votre site Web. En principe, le fichier guestbook.pl sera placé dans le répertoire CGI, mais ce n'est pas indispensable. (l'extension en .pl fait que le fichier sera executable comme un CGI de n'importe quel répertoire.)

Pour démarrer, le script doit être copié sur votre propre répertoire Web. Il ne peut pas être lancé depuis un répertoire CGI car une personnalisation du fichier est nécessaire. Pour copier le script, utiliser une des sequences de commandes par Telnet, comme décrit dans les FAQ on CGI.

Pour les comptes Advanced :

cd ~/public_html

mkdir cgi-local

cp /usr/www/cgi-bin/guestbook.pl cgi-local

chmod 755 cgi-local/guestbook.pl

Pour les comptes Webmaster :

cd ~/public_html

cp /usr/www/cgi-bin/guestbook.pl cgi-bin

chmod 755 cgi-bin/guestbook.pl

Utilisez alors votre éditeur favori pour modifier le script. Vous devrez installer quatre variables dans le script:

$guestbookurl

Cette variable est l'URL complet de votre fichier guestbook normalement appelé guestbook.html. Ce fichier ne doit pas être placé dans votre répertoire cgi-bin. exemples :

$guestbookurl = "http://www.domain.com/guestbook.html";

...ou:

$guestbookurl = "http://www.pair.com/username/guestbook.html";

Ne tenez pas compte du contenu du fichier guestbook.html à cette étape.

$guestbookreal

Il s'agit du "vrai" chemin vers le guestbook.html sur le server. Ce n'est pas un URL. Votre site Web est placé soit sous /usr/www/users/username/ soit sous /u2/www/users/username/; vous pouvez trouver votre chemin en utilisant les commandes (via Telnet):

cd ~/public_html
pwd

Exemples:

$guestbookreal = "/usr/www/users/username/guestbook.html";

...ou:

$guestbookreal = "/u2/www/users/username/guestbook.html";

$guestlog

Il s'agit du "vrai" chemin vers le fichier guestlog.html. Il suit les mêmes règles que le $guestbookreal. Exemples:

$guestlog = "/usr/www/users/username/guestlog.html";

...ou:

$guestlog = "/u2/www/users/username/guestlog.html";

$cgiurl

Il s'agit de l' URL complet de votre copie du script guestbook.pl. Exemples:

$cgiurl = "http://www.domain.com/cgi-bin/guestbook.pl";

...ou:

$cgiurl = "http://www.domain.com/cgi-local/guestbook.pl";

...ou:

$cgiurl = "http://www.pair.com/username/cgi-bin/guestbook.pl";

Si vous choisissez d'utiliser le cgiwrap pour tourner votre guestbook, le paramétrage correct pour $cgiurl est le suivant :

$cgiurl = "http://www.domain.com/cgi-sys/cgiwrap/username/guestbook.pl";

Le script guestbook.pl peut être configuré plus finement avec une variété d'options (mise à 1 '"oui" ou 0 "non" à l'intérieur du script):

$mail

Si paramétré à 1, un message e-mail vous sera envoyé dès qu'un nouveau commentaire est entré dans le guestbook. Si $mail est paramétré à 1, vous devez indiquer une valeur pour i $recipient.

$remote_mail

Si paramétré à 1, la personne qui aura rentrée un nouveau commentaire dans le guestbook recevra un e-mail standard comme accusé de reception. Si ce paramètre est renseigné, vous devez spécifier une valeur pour $recipient.

$recipient

Si $mail ou $remote_mail est paramétré à 1, ce champ doit être remple. Il rensigne votre propre adresse e-mail.

$uselog

The champ indique si la fonction de "logging" (enregistrement des événements et erreurs) sera utilisée.

$linkmail

Si paramétré à 1, l'adresse e-mail dans le guest book sera affichée et activée en tant que lien hypertext mailto.

$separator

Si paramétré à 1 (défaut),<HR> est utilisé comme séparateur entre les commentaires du guestbook. Si paramétré à 0, <P> est le séparateur.

$redirection

Si paramétré à 1, le visiteur sera automatiquement redirigé sur le guestbook. Ceci fonctionne avec la plupart des navigateurs Web.

$entry_order

Si paramétré à 1 (défault), les nouveaux commentaires seront affichés en tête du guestbook. Si paramétré à 0, les nouveaux commentaires s'afficheront à la fin.

$allow_html

Si paramétré à 1 (défault) les tags HTML sont permis à l'intérieur du guestbook; si paramétré à 0, les tags HTML ne sont pas pris en compte.

$line_breaks

Si paramétré à 1 (pas le défault), les "line breaks" dans les champs de commentaires sont interprétés comme des tags <BR> dans les commentaires du guestobook.

Lorsque vous avez terminé la configuration du script guestbook.pl, le reste est très simple. Des exemples pour les trois fichiers restants (guestbook.html, addguest.html, et guestlog.html) sont disponibles sous /usr/local/pair/guestbook/ sur le serveur. Vous devrez copier ces trois fichiers à l'endroit choisi sur votre site Web, et paramétrer les autorisations pour les fichiers guestbook.html et guestlog.html comme suit :

chmod 666 guestbook.html guestlog.html

Enfin, éditer les fichiers guestbook.html et addguest.html. Vous devrez spécifier l'URL approprié pour le addguest.html dans le guestbook.html, si ils sont dans différents répertoires. Vous devrez également spécifier le lien correct vers votre "home page", ou retirer entièrement cette partie du guestbook.html. Vous devrez spécifier deux URLs dans le addguest.html - l' URL pour le script CGI doit être placé dans le champ ACTION du tag FORM, et l'URL du guestbook doit être placé à la fin du fichier.

Vous pouvez personaliser les fichiers guestbook.html et addguest.html à votre manière. La seule restriction est que le tag <!--begin--> doit être présent dans le fichier guestbook.html ; il indique l'endroit où les nouveaux commentaires doivent être ajoutés.

Si vous craigniez que des utilisateurs sur le système modifient ou piratent les commentaires de votre guestbook (car le fichier guestbook.html est accessible en écriture du monde entier), vous pouvez utiliser cgiwrap sur votre script guestbook.pl . Le tag FORM dans le addguest.html devient alors :

<FORM METHOD="POST" ACTION="/cgi-sys/cgiwrap/username/guestbook.pl">

...et vous devez changer $cgiurl dans guestbook.pl en :

$cgiurl = "http://www.domain.com/cgi-sys/cgiwrap/username/guestbook.pl";

Vous pouvez alors protéger le guest book avec :

chmod 644 guestbook.html guestlog.html