-------------------------------------------------------------------- Moteur'Ed 1.0 (Moteur de recherche interne - PHP) par T.Arsicaud / 2001 deltascripts@ifrance.com -------------------------------------------------------------------- Version du 02/06/2001 Merci d'avoir choisi Moteur'Ed 1.0. Vous trouverez dans ce document des indications sur les caractéristiques de ce moteur de recherche, sur le système requis pour son utilisation et sur sa procédure d'installation. I/ CARACTERISTIQUES de Moteur'Ed 1.0 Moteur'Ed 1.0 est un moteur de recherche écrit en PHP, conçu pour des sites Web de petites ou moyennes dimensions (jusqu'à 200 pages HTML). Contrairement à la majorité des programmes de ce type, il ne nécessite pas l'installation d'une base de données (du type MySQL) et peut donc facilement être installé sur des espaces d'hébergement proposant PHP mais pas nécessairement de bases de données en complément. Moteur'Ed 1.0 est spécialisé dans la recherche de mots-clés à l'intérieur de fichiers HTML et de fichiers textes. Il dispose d'un algorithme simple, permettant d'afficher en premier lieu les réponses les plus pertinentes correspondant aux requêtes formulées par les utilisateurs. Moteur'Ed 1.0 élimine automatiquement les mots "vides" apparaissant dans les requêtes, permet la recherche d'expressions entre guillemets et autorise l'utilisation de jokers (exemple : astronom* pour astronome, astronomes, astronomie...). Les recherches sont effectuées sur le titre et sur le texte des documents, dans la limite de leurs 8000 premiers caractères. Le script d'indexation permet de prendre en compte tous les documents contenus dans un répertoire principal (spécifié par le webmestre) et dans les sous-répertoires qu'il contient. Moteur'Ed 1.0 est entièrement paramétrable a été conçu afin de faciliter au maximum l'intégration du moteur de recherche dans des pages Web possédant une mise en page relativement complexe. Une démo de Moteur'Ed 1.0 est disponible à l'adresse suivante : http://www.echodelta.net/scriptsphp/moteured/ II/ SYSTEME REQUIS Moteur'Ed 1.0 fonctionne avec (et à partir de) PHP 3.0.8. En cas de problèmes avec une version antérieure, n'hésitez pas à me contacter par email, à l'adresse : deltascripts@ifrance.com. Comme nous l'avons vu, Moteur'Ed 1.0 ne nécessite pas de bases de données. III/ CONDITIONS D'UTILISATION Moteur'Ed 1.0 est gratuit. Vous pouvez l'utiliser, le modifier comme bon vous semble, tant que vous conservez la mention "Moteur'Ed 1.0 - (c) 2001 Thierry Arsicaud (deltascripts@ifrance.com)" copiée au début de chaque script. N'hésitez pas à m'envoyer un mail si vous utilisez Moteur'Ed 1.0 sur votre site, pour me faire part de vos commentaires ou de vos suggestions. Bien que cela ne constitue pas une obligation, un lien vers le site de Moteur'Ed (http://www.echodelta.net/scriptsphp/moteured/) sera bien évidemment toujours le bienvenu... IV/ INSTALLATION Pour installer Moteur'Ed 1.0 sur votre site, vous devez disposer d'un logiciel de FTP disposant d'une commande CHMOD, à l'image du logiciel gratuit FTP WORKS 1.33, téléchargeable à l'adresse suivante : http://www.corbanware.com/ftpworks.html Les étapes de l'installation du moteur de recherche sont les suivantes : a) créez un répertoire sur votre espace d'hébergement (nommez le comme vous le souhaitez) b) changez les droits d'accès à ce répertoire, à l'aide de la commande CHMOD (ou équivalente), en indiquant "777" ou "rwxrwxrwx" (cette opération est nécessaire pour la sauvegarde des données relatives aux documents indexés, dans un fichier texte nommé indexsite.dat). c) transférez y les fichiers suivants : indexat.php Module d'indexation du moteur de recherche moteured.php Formulaire d'interrogation du moteur de recherche resultats.php Script affichant les résultats de la recherche L'installation de Moteur'Ed 1.0 est alors terminée. V/ INDEXATION Le script indexat.php est utilisé pour l'indexation des fichiers html et textes contenus dans le site Web. Les premières lignes de ce script permettent de spécifier le répertoire principal à l'intérieur duquel sont recherchés les documents à indexer (ainsi que dans les sous-répertoires qu'il contient). Pour activer l'indexation (ou la réindexation) du site, il suffit de saisir, dans votre navigateur, l'adresse renvoyant vers le script d'indexation : www.serveur.com/repertoire/indexat.php Cette activation du script génère un fichier texte dans le répertoire d'installation du moteur de recherche, nommé indexsite.php. Ce fichier texte contient des informations relatives aux titres, descriptions et contenus des documents indexés, dans la limite de leurs 8000 premiers caractères. Notez que la description d'un document, d'une longueur maximum de 150 caractères, est extraite du metatag "description" intégré dans la page Web (lorsqu celui-ci a été précisé). Dans le cas où les metatags n'ont pas été renseignés, la description est automatiquement déduite des 150 premiers caractères du texte du document. Il est important de noter que le script d'indexation indexat.php n'est PAS PROTEGE par un mot de passe. Pour des raisons de sécurité, il est recommandé de le renommer, en prenant garde à ce que son nouveau nom soit assez difficile à deviner (par exemple : NOMCOMPLIQUE.php). Bien qu'il puisse sembler rudimentaire, ce système de protection est efficace, et empêchera que des utilisateurs mal intentionnés ne tentent de réindexer le site à votre place. VI/ FORMULAIRE DE RECHERCHE Vous avez la possibilité d'intégrer votre propre code html dans le fichier moteured.php, afin de maintenir une cohérence (en termes de mise en page) avec les autres pages de votre site Web. VII/ AFFICHAGE DES RESULTATS DE LA RECHERCHE Les premières lignes du script resultats.php permettent de préciser le nombre maximum de réponses à afficher par page. Il vous est également possible de modifier les paramètres d'affichage, et d'insérer votre propre code html afin de maintenir une cohérence avec les autres pages de votre site Web. VII/ REQUETES FORMULEES PAR LES UTILISATEURS L'utilisateur du moteur de recherche doit saisir ses différents mots clés en les séparant par des espaces. Il a la possibilité de rechercher des expressions en les saisissant entre guillements "", et peut utiliser des jokers pour étendre sa recherche (exemple : astronom*). Les réponses aux requêtes sont affichées dans l'ordre décroissant de leur pertinence. L'algorithme utilisé pour cette opération privilégie notamment les documents contenant un ou plusieurs mots clés dans leur titre, ou contenant éventuellement des expressions complètes dans leur texte. Les recherches sont automatiquement effectuées en mode OU (il n'est pas possible d'effectuer une recherche exclusivement en mode ET). Les documents contenant l'ensemble des mots-clés saisis dans la requête apparaissent toutefois en premier lieu dans la liste des résultats retournés par le moteur. Vous avez la possibilité de connaître les requêtes formulées par les utilisateurs de votre site, en consultant le fichier req.txt localisé dans le répertoire d'installation du moteur de recherche. Ce fichier est automatiquement créé est mis à jour lors de chaque utilisation du moteur. IX/ CREDITS Moteur'Ed 1.0 a été développé par Thierry Arsicaud, en décembre 2000 - janvier 2001. N'hésitez pas à m'envoyer un mail pour me faire part de vos éventuelles difficultés d'utilisation, de vos commentaires ou suggestions. N'oubliez pas de visiter régulièrement mon site Web pour des mises à jour de Moteur'Ed 1.0 et le téléchargement de nouveaux scripts (forum de discussion, livre d'or, ect...) -------------------------------------------------------------------- Thierry Arsicaud - deltascripts@ifrance.com http://www.echodelta.net/scriptsphp/