! Nous n'avons pas obtenu l'autorisation de modifier ce script pour le traduire en francais.
Seule sa présentation est en français.
WebHints est un script de qui permet d'afficher sur votre site une petite phrase qui change chaque jour (phrase ou blague du jour).
Les anciennes phrases sont conservées dans un fichier et il est possible d'y effectuer une recherche par mot clé.
L'archive contient 3 fichiers perl et un fichier .txt contenant les explications en angais.
hints.pl est le script qui sert a afficher la phrase du jour et permet de rechercher dans les archives.
hints_add.pl permet d'ajouter une phrase à la collection
hints_pop.pl est un script supplémentaire permettant de s'assurer que la phrase change bien chaque jour. Il vous averti quand votre stock de phrases commence a être relativement bas.
Installation du script
Pour chacun de ces scripts, vous devez vérifier comme d'habitude que la première ligne pointe bien vers l'interpréteur perl de votre système.
Les variables suivantes doivent être définies dans un ou plusieurs script(s).
Plusieurs variables étant communes aux 3 scripts, elles sont toutes présentées ci dessous :
$HintsDir : doit être le répertoire qui contient le fichier texte avec vos petites phrases. Tout le monde doit pouvoir écrire dedans ce répertoire, faites donc un chmod 666.
$NewHintsDir : le chemin complet vers le répertoire contenant les phrases qui n'ont pas encore été affichées.
$DataFile: cette variable doit pointer vers un fichier qui va retenir la date d'ajout dans la base de données. Lors de sa création, ce fichier ne doit rien contenir, et doit être utilisable par tout le monde en lecture/écriture (chmod 666).
$CGIURL: cette variable doit contenir l'url d'accès au script hints.pl.
$AddURL: cette variable doit contenir l'url d'accès au script hints_add.pl.
$SSI: si cette variable est à 0, le script va générer une page entière. Si elle est à 1, le script va juste renvoyer la phrase du jour sans plus.
$HintsTitle: Le titre de la page.
$BodySpec: Vous devez indiquer ici les caractéristiques que vous voulez donner au tag BODY des pages générées par le script (couleur de fond, couleur du texte, ...).
$HeaderFile: cette variable doit pointer vers le fichier contenant le code HTML permettant d'afficher le haut des pages générées par le script.
$FooterFile: cette variable doit pointer vers le fichier contenant le code HTML permettant d'afficher le bas des pages générées par le script.
$MailProg: doit pointer vers votre programme d'envoi de mail (sendmail ou équivalent).
$MailAddress: l'adresse mail à laquelle doivent vous parvenir les notifications quand votre réserves de petites phrases atteint un niveau dangereusement bas. N'oubliez pas de de placer un \ (backslash ou antislash) devant le caractère @.
Utilisation
Pour afficher le texte, vous avez 2 possibilités :
soit taper directement l'url du script dans le browser (ou via un lien), et alors le script génère une page HTML entière pour afficher votre texte (n'oubliez pas de mettre la variable $SSI à 0, et de définir vos entêtes et pieds de pages dans la configuration)
soit en insérant la phrase dans une page existante, via un appel SSI, avec <!--#exec cgi="/cgi-bin/hints.pl" -->
