55026e582367693c3e83fc44490d9ecf58563817
[moodle.git] / search / LISEZMOI.txt
1 Cette distribution partielle contient une refonte du moteur de 
2 recherche globale de Moodle.
4 Le moteur de recherche est capable d'indexer et de rechercher 
5 des informations dans un grand nombre de contenus stockés
6 dans la plate-forme à travers la manipulation des activités et
7 des blocs.
9 Le moteur de recherche procède à une première indexation des
10 ressources disponibles par action de l'administrateur. Une fois
11 cette indexation effectuée, le moteur maintient régulièrement les
12 indexes, en ajoutant les nouvelles entrées et en nettoyant les 
13 entrées obsolètes.
15 La recherche permet d'obtenir des références d'accès au contexte
16 qui diffuse cette information, au nom de l'utilisateur courant.
17 Le filtrage des résultats enlève de la liste des réponses toute
18 ressource que la situation de l'utilisateur empêcherait de voir
19 s'il y accédait dans son contexte habituel.
21 Mise en oeuvre
22 ##############
24 Pour déployer le moteur : 
27 * Copie de fichiers
29 1. Ajouter les deux librairies fournies aux librairies de Moodle
30 2. Ecraser le répertoire "search" par le répertoire fourni
31 3. Ecraser le bloc "blocs/search" par le bloc fourni.
33 * Installation logique
35 4. Aller dans les notifications administratives et dérouler la procédure d'installation/mise à jour du bloc. L'installation crée la table image
36 des documents indexés et utilisés dans le module search.
38 5. Insérer un nouveau bloc de recherche globale dans la plate-forme
40 6. Effectuer une recherche vide (en administrateur)
42 7. Aller sur la page des statistiques
44 8. Activer l'indexation (indexsplash.php). Attention, si la plate-form contient beaucoup de contenus cette indexation peut être TRES LONGUE.
46 Pour effectuer des recherches, une fois la première indexation terminée, retourner au bloc de recherche et tenter une recherche.
48 Eléments pris en charge
49 #######################
51 Dans l'état actuel, les éléments indexés par le moteur sont :
53 - les entrées de forum
54 - les fiches de base de données
55 - les commentaires sur fiches de données
56 - les entrées de glossaire
57 - les commentaires sur entrées de glossaire
58 - les ressources natives Moodle
59 - les ressources physiques de type MSWord
60 - les ressources physiques de type PDF
61 - les ressources physiques de type fichier texte (.txt)
62 - les ressources physiques de type HTML (.htm et .html)
63 - les ressources physiques de type XML (.xml)
64 - les ressources physiques de type (Microsoft) Powerpoint (.ppt)
65 - les pages de wiki
66 - les entités de projet technique
67 - les sessions de chat
69 Extensions
70 ##########
72 L'API du moteur de recherche permet désormais : 
74 - l'indexation de contenus de blocs.
75 - l'indexation de modules contenant une information complexe ou de plusieurs types distincts
76 - la sécurisation des informations indexées lors des extractions de résultats
77 - l'indexation de tout module tiers par ajout d'un fichier php calibré
78 - l'indexation de toute nouvelle resource physique par ajout d'un fichier php calibré
80 Extensions futures
81 ##################
83 - De nouvelles prises en charge de contenus tels que les attachements des forums, les attachement des glossaires, ainsi que d'autres modules non encore
84 implémentés.
86 - l'extension mnet de la recherche dans un réseau de moodle interconnectés.
88