! Nous n'avons pas obtenu l'autorisation de modifier ce script pour le traduire en francais.
Seule sa présentation est en français.
WebSearch est un script permettant de créer un mini moteur de recherche pour votre site.
Il se base aussi bien sur le contenu des meta tags, que sur le contenu de la page elle même et des descriptions alt des images.
Les infomations retournées sont le titre de la page, sa taille, sa pertinence et la date de dernière modification.
Il est facilement possible de raffiner la recherche en choisissant sur quels termes doit s'effectuer la recherche, s'il faut tenir compte des majuscules, ...
Exemple :
Configuration du script
Comme pour chaque script, vérifiez que la première ligne pointe vers l'interpréteur du perl sur votre serveur.
La configuration commence aux alentours de la ligne 160.
@dirs doit indiquer le ou les répertoires dans lesquels le script doit rechercher les fichiers contenant vos mots clés.
Exemple : @dirs = ('../../www/*+');
Si le répertoire se termine par un / cela signifie qu'il faut chercher les mots parmi tous les fichiers html. Si on termine par une *,cela signifie l'on veut inclure les sous répertoires lors de la recherche. Un + indique que l'on veut rechercher les mots parmi tous les fichiers au format texte.
Il est possible de combiner *+ pour chercher les mots clés parmis tous les fichiers de format texte contenus dans le répertoire ou ses sous répertoires.
$avoid permet de spécifier quelles extensions, ou quels fichiers il faut ignorer lors de la recherche. Il s'agit d'une liste d'extensions, ou de fichiers.
Exemple :$avoid = '(\.cgi|\.pl|\.txt|\.bak)';
Indique qu'il faut ignorer les fichiers dont l'extension est cgi, pl, txt ou bak.
Il faut mettre un \ (back slash) devant les points pour que perl considère les points comme caractère litteral plutot que comme un joker (wildcard).
$cgiurl indique l'url du script cgi sur le système.
Exemple : $cgiurl = 'http://scripts-fr.com/cgi-bin/websearch.pl';
$baseurl et $basepath servent à définir l'url de base, et le chemin d'accès qui y est associé sur votre serveur. Tous les répertoires dans lesquels doit s'effectuer la recherche doivent se trouver dans $basepath.
Exemple :
$basepath = '/home/scripts/www/';
$baseurl = 'http://www.scripts-fr.com/';
$DisplayByDate permet de spécifier si les résulstats doivent être triés par date (1) ou triés suivant la pertinence du résulstat (0)
Exemple : $DisplayByDate = 0; affiche les résultats suivant le nombre de mots clés contenus dans la page.
$NoMETAs permet de spécifier si il faut afficher comme description le contenu des metatags (0) ou si il ne faut pas l'afficher (1).
Cette option est utile si toutes vos pages possèdent les même metatags.
Exemple : $NoMETAs = 0; affiche la description dans les résultats de la recherche.
$UseDescs permet de définir si il faut utiliser les descriptions (1) ou bien les ignorer (0) pour une raison ou une autre.
Exemple : $UseDescs = 1;
$SplitNames permet de spécifier si le script doit présenter les résultats pour la page entière (0), ou si il doit utiliser les ancres (1) placées dans la page pour permettre au visiteur d'arriver au plus pres des termes qu'il recherche.
Exemple : $SplitNames = 0;
$bodyspec permet de spécifier les attributs que devra avoir la page html : couleurs de fond, de texte, de liens, ...
Exemple : $bodyspec = "BGCOLOR=\"#ffffff\" TEXT=\"#000000\""; pour une page avec fond blanc et caractères noirs.
$header_file et $footer_file permettent de définir des fichiers html contenant le code du haut et du bas de votre page. Cela permet d'afficher les résultats de la recherche dans une page qui a le layout de votre site.
Exemple :
$header_file = "/home/scripts/includes/haut.htm";
$footer_file = "/home/scripts/includes/bas.htm";
Voilà c'est tout pour la configuration du script, vous pouvez maintenant l'uploader sur votre serveur et changer les droits pour le rendre exécutable (chmod 755 ou 777).
Utilisation du script
Il faut insérer le formulaire de recherche dans votre site, en prenant soin de changer l'action du formulaire pour le faire pointer vers le script sur votre serveur.
Voici par exemple le code html qui a été utilisé pour créer le formulaire de recherche sur cette page :
