Moteurs de recherche personnalis�s par lien

Dans le cas d'un moteur accessible via un lien, les sp�cifications du moteur de recherche sont h�berg�es sur votre site Web. Pour un moteur h�berg� par Google, les sp�cifications sont stock�es sur les serveurs Google.

Pour cr�er un moteur de recherche personnalis� classique h�berg� par Google, vous pouvez soit vous connecter et utiliser l'assistant, soit cr�er un fichier�XML et l'importer vers Google (via l'onglet Options avanc�es). Le code de votre champ de recherche utilise alors le param�tre "cx" pour faire r�f�rence � ces sp�cifications h�berg�es par Google. Pour modifier l'un des aspects du moteur de recherche personnalis�, vous devez utiliser le panneau de configuration ou importer de nouvelles sp�cifications�XML. Cela implique certaines contraintes�:

La cr�ation et la mise � jour du moteur de recherche personnalis� sont effectu�es manuellement.
Il est difficile de cr�er un tr�s grand nombre de moteurs de recherche personnalis�s, un pour chaque utilisateur, par exemple, ou encore un moteur l�g�rement diff�rent pour chacune de vos pages.
La cr�ation automatique de moteurs de recherche personnalis�s par programmation via d'autres sources de donn�es, telles que les flux iCal, RSS, Google Base, etc. est assez complexe.

Les moteurs accessibles via un lien ne sont pas soumis aux m�mes contraintes que les moteurs h�berg�s par Google. Avec un moteur accessible via un lien, vous stockez les sp�cifications du moteur sur votre site Web et incluez l'URL de ces sp�cifications dans les requ�tes de recherche de votre moteur. Google extrait alors les sp�cifications de votre site Web lorsqu'un internaute effectue une recherche � l'aide de ce dernier. Cette m�thode comporte plusieurs avantages essentiels�:

Vous pouvez ais�ment convertir vos donn�es en moteur de recherche personnalis�.
Vous pouvez cr�er automatiquement un nombre illimit� de moteurs de recherche personnalis�s, chacun adapt� � un type d'utilisateur particulier, une page sp�cifique, une heure de la journ�e, etc. En pratique, il est possible de g�n�rer des moteurs de recherche personnalis�s � la demande, bas�s sur la requ�te d'un utilisateur ou sur une page de votre site sur laquelle un internaute effectue une recherche. Nous vous proposons pour cela plusieurs outils efficaces. Vous pouvez notamment cr�er d'un moteur accessible via un lien � partir des liens figurant sur une page.
Vous pouvez facilement mettre � jour la d�finition de votre moteur accessible via un lien sans envoyer de donn�es � Google.
Il n'existe aucune limitation concernant le nombre d'annotations que chaque utilisateur peut ajouter.

Vous pouvez d�sormais exploiter au mieux votre cr�ativit� en g�n�rant automatiquement des moteurs de recherche personnalis�s. Les outils fournis par Google et d'autres tiers facilitent la synchronisation de votre moteur de recherche personnalis� avec votre site Web et des sites tiers. Pensez � exploiter diverses sources d'information int�ressantes pour cr�er vos moteurs de recherche personnalis�s, notamment les flux iCal, vos journaux de sites r�f�rents ainsi que les signets ou l'historique de navigation des utilisateurs. Vous pouvez m�me adapter les �l�ments graphiques de votre moteur de recherche personnalis� en fonction de l'�tat ou de la fr�quentation de votre site Web. Laissez libre cours � votre imagination, les possibilit�s sont infinies !

Les sp�cifications du moteur de recherche personnalis� peuvent faire r�f�rence � un ou plusieurs fichiers d'annotations externes. Cela facilite le partage d'annotations entre moteurs de recherche personnalis�s.

Notez toutefois que certaines fonctionnalit�s des moteurs h�berg�s par Google, la collaboration et le marqueur Google notamment, ne fonctionnent pas avec les moteurs accessibles via un lien. Si vous avez d�j� d�fini des annotations stock�es sur Google, vous pouvez les t�l�charger et les inclure dans votre moteur personnalis� par lien. Pour plus d'informations, consultez la rubrique Passer d'un moteur h�berg� par Google � un moteur accessible via un lien. Les moteurs accessibles via un lien sont toujours gratuits et prennent en charge les annonces. Les m�canismes associ�s ne peuvent pas servir � h�berger les sp�cifications du moteur pour Google�Site�Search.

Exemple de moteur accessible via un lien

L'exemple suivant illustre en toute simplicit� l'utilisation d'un moteur accessible via un lien, dont les sp�cifications se trouvent sur http://www.guha.com/cref_cse.xml. Les sp�cifications du moteur de recherche personnalis� contiennent les sites � parcourir, la pr�sentation des r�sultats, etc. Voici le code � utiliser pour le champ de recherche utilisant les sp�cifications de moteur de recherche personnalis�. Notez le param�tre intitul� "cref".

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref" action="http://www.google.com/cse">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.dz/cse/brand?form=cref"></script>
<!-- Google CSE Search Box Ends -->

Param�tres essentiels du formulaire :

cref : URL des sp�cifications de votre moteur de recherche personnalis�.
q: le champ de recherche

Essayez ce moteur de recherche tout de suite !

Notez que ce champ de recherche pourrait �tre situ� sur le m�me site que le fichier de sp�cifications du moteur de recherche personnalis�, sur plusieurs pages de ce site ou encore sur un autre site.

� la premi�re requ�te d'un internaute, nous proc�dons � l'extraction des sp�cifications du moteur de recherche personnalis� et les utilisons pour traiter la requ�te. Nous les pla�ons en m�moire cache et les actualisons r�guli�rement. Par cons�quent, vous n'aurez pas besoin de r�pondre aux requ�tes de sp�cifications de Google � chaque fois qu'un internaute lance une requ�te. Si vous modifiez les sp�cifications de votre moteur accessible via un lien et que vous devez les actualiser imm�diatement, il vous suffit d'acc�der � la page d'actualisation de votre moteur et d'entrer l'URL de vos sp�cifications.

Exemple de moteur de recherche personnalis� dont les r�sultats sont h�berg�s sur votre site

Vous pouvez utiliser un moteur accessible via un lien pour h�berger les r�sultats sur votre site, de la m�me mani�re qu'un moteur personnalis� classique. Pour ce faire, deux extraits de code sont n�cessaires, l'un pour le champ de recherche et l'autre pour les r�sultats de recherche. Le code du champ de recherche est similaire au pr�c�dent exemple, avec quelques modifications :

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref_iframe" action="http://www.guha.com/results.html">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="hidden" name="cof" value="FORID:9" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.dz/cse/brand?form=cref_iframe"></script>
<!-- Google CSE Search Box Ends -->

Param�tres essentiels du formulaire :

Champ action : URL � laquelle vous souhaitez h�berger les r�sultats (dans cet exemple, nous utilisons l'adresse http://www.guha.com/results.html).
cref : URL des sp�cifications de votre moteur de recherche personnalis�.
cof�: FORID:9, FORID:10 ou FORID:11. Il d�finit le format des annonces � afficher. Pour plus d'informations, reportez-vous aux sp�cifications du moteur de recherche personnalis�.
q: le champ de recherche

Le champ action ci-dessus fait r�f�rence � l'URL de la page sur laquelle vous devez ins�rer le code suivant. Placez ce dernier � l'emplacement o� vous souhaitez voir appara�tre les r�sultats de recherche :

<div id="cse-search-results"></div>
<script type="text/javascript">
  var googleSearchIframeName = "cse-search-results";
  var googleSearchFormName = "cse-search-box";
  var googleSearchFrameWidth = 600;
  var googleSearchDomain = "www.google.com";
  var googleSearchPath = "/cse";
</script>
<script type="text/javascript" src="http://www.google.com/afsonline/show_afs_search.js"></script>

Annotations dans un moteur accessible via un lien

Pour que votre moteur accessible via un lien fonctionne, vous devez sp�cifier les annotations comme indiqu� dans l'exemple pr�c�dent. Vous pouvez sp�cifier vos annotations de deux mani�res diff�rentes :

Annotations externes�: vous avez sp�cifi� l'emplacement de vos fichiers d'annotation � l'aide de balises <Include>. En savoir plus sur les fichiers d'annotation externes.. L'exemple fourni dans la section pr�c�dente utilise deux fichiers d'annotations externes�: d'une part un fichier stock� sur un serveur, d'autre part la sortie d'un script.

Annotations int�gr�es �: vous ins�rez les annotations, ainsi que les sp�cifications du moteur de recherche personnalis� dans un m�me fichier. En savoir plus sur les annotations int�gr�es. Ci-dessus un exemple avec deux annotations int�gr�es�: http://www.solarenergy.org/* et http://www.solarfacts.net/*.

La taille des fichiers doit �tre inf�rieure � 3 Mo. Si vos annotations occupent davantage d'espace, vous pouvez les r�partir dans plusieurs fichiers et utiliser des balises <Include> afin de sp�cifier ces fichiers. Vous pouvez ainsi inclure jusqu'� 50 fichiers dont le poids total doit �tre inf�rieur � 10 Mo. De cette mani�re, nous esp�rons vous permettre d'inclure environ 25 000 annotations par moteur de recherche personnalis�. Si cela est insuffisant, nous vous recommandons, de cr�er plusieurs moteurs de recherche personnalis�s et de les r�unir ensuite pour vos utilisateurs. Cette interface de programmation vous permettra de r�aliser toutes vos id�es, ou presque !