SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs sur SPIP-Zone, 94 visiteurs en ce moment

Accueil > Navigation > Recherche > OpenSearch > Squelette OpenSearch 1.1 pour rechercher dans un site web SPIP

Squelette OpenSearch 1.1 pour rechercher dans un site web SPIP

31 octobre 2006 – par Nicolas Krebs

5 votes

module au format OpenSearch 1.1, permettant de lancer des recherches dans un site web fonctionnant avec SPIP

Squelette OpenSearch 1.1, pour rechercher dans un site web SPIP, version 1.0

-  Nom de squelette : Squelette OpenSearch 1.1
-  Version du squelette : 1.0
-  Auteur : Nicolas Krebs
-  Licence : GPL
-  Compatibilité SPIP : SPIP 1.9 nécessaire
-  Principales fonctionnalités et spécificités : publication d’une déclaration de moteur de recherche, au format OpenSearch 1.1, permettant de lancer des recherches dans un site web fonctionnant avec SPIP.
-  Contributions intégrées et sources d’inspiration : la documentation de ce format (ainsi que les Squelettes Atom 1.0 (version 1.1) et dist/recherche.html de SPIP 1.9 pour le squelette atom).

Version de SPIP

Version de SPIP requise : 1.9 pour la version 1.0, 1.9.2 pour la version 1.0.1.

Installation

Décompresser le fichier ci-joint et copier les deux fichiers *.html dans le dossier des squelettes de votre site web motorisé par SPIP.

Utilisation

Le squelette recherche-opensearch.html publie, au format OpenSearch 1.1, une déclaration de moteurs de recherche, qui peut être utilisée par le client web pour ajouter à ceux installés. Voir par exemple Mozilla Firefox, Microsoft IE7, Mozilla Firefox.

Une fois le squelette installé, vous pouvez y accéder par http://site.spip.example/spip.php?page=recherche-opensearch (avec le réglage des url par défaut de SPIP 1.9).

Pour utiliser le module depuis une page web html, vous devez faire un lien html vers la déclaration, qui peut être :
-  un lien dans un article spip : « [->http://site.spip.example/spip.php?page=recherche-opensearch] »
-  un lien dans un squelette : « <a rel="search" type="application/opensearchdescription+xml" href="(#URL_PAGE{recherche-opensearch})">Cliquer ici pour installer un moteur de recherche pour ce site web</a> »
-  un lien dans la partie head du squelette (typiquement squelette sommaire.html, rubrique.html ou inc-head.html) : « [<link rel="search" type="application/opensearchdescription+xml" href="(#URL_PAGE{recherche-opensearch})" title="[(#NOM_SITE_SPIP|couper{16}|texte_backend)]" />] ».

Version du code précendant, limitant la recherche à une rubrique (et ses sous-rubriques) : « [<link rel="search" type="application/opensearchdescription+xml" href="(#URL_PAGE{recherche-opensearch}|parametre_url{id_rubrique,#ID_RUBRIQUE})" title="[(#NOM_SITE_SPIP|couper{16}|texte_backend)][ (#ID_RUBRIQUE)]" />] ».

Le squelette par défaut dist/recherche.html (dans SPIP 1.9.1) ne comporte pas de telle limitation à une rubrique. L’utiliser sans modification avec un module limitant à une rubrique produira des résultats non conformes au module. (Il faut ajouter {id_rubrique ?} dans les boucles de recherche de recherche.html et préciser la limitation ailleur dans la page.)

Le squelette recherche-atom.html, quant à lui, sert à publier les résultats de recherche au format atom 1.0 (voir l’article Squelettes Atom 1.0 (version 1.1) dont dérive le squelette), de la même façon que recherche.html publie au format html. Cependant ce squelette n’utilise pas de pagination, ce qui limite fortement le nombre de réponses qu’il publie pour une recherche (seule la première page de résultats étant indiquée).

Note : si recherche-atom.html indique recherche.html comme une alternative, l’inverse n’est pas vrai. Si vous souhaitez le faire, vous pouvez ajouter dans la partie head « [<link rel="alternate" type="application/atom+xml" href="(#URL_PAGE{recherche-atom}|parametre_url{id_rubrique,#ID_RUBRIQUE}|parametre_url{recherche,#RECHERCHE})"/>] ».

Exemple

spip-contrib.net opensearch 1.1.xml
Utiliser ce fichier opensearch 1.1 pour rechercher dans spip-contrib.net.

donne accès à un module de recherche pour http://www.spip-contrib.net/. Si le téléchargement direct du fichier ne permet pas de l’ajouter comme moteur de recherche (comme c’est le cas avec Mozilla Firefox 2.0), utiliser le formulaire html ci-joint. Afin d’épargner les ressources de la machine hébergeant http://www.spip-contrib.net/, on pourra utiliser un moteur de recherche tiers, par exemple http://www.google.fr/search?as_sitesearch=spip-contrib.net&q={searchTerms} (plaçable dans l’élément Url d’une copie de spip-contrib.net opensearch 1.1.xml).

Licence

Ces deux squelettes sont fournis sous licence GPL.

Conformité et test

-  Le squelette Atom est soumis aux mêmes limitations que Squelettes Atom 1.0 (version 1.1).
-  La version définitive du format OpenSearch 1.1 n’est pas encore publiée à la date de rédaction de cet article, pour lequel la version de mi-2006 (quelle date ?) a été utilisée.

Section à compléter.

P.-S.

06/03/2007 ajout des fichiers, version 1.0.1

Dernière modification de cette page le 6 mars 2007

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?
  • [Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Passer un site SPIP sous https://

    23 février 2017 – 39 commentaires

    Comment migrer simplement votre site SPIP de http:// vers https:// Le protocole https:// devient de plus en plus courant : C’est mieux pour la vie privée de tous La plupart des grands sites l’a déjà adopté Certains navigateurs commencent à afficher (...)

  • cipr : plugin « Prévisualisation étendue »

    22 septembre 2010 – 40 commentaires

    Ce plugin "cipr : Prévisualisation étendue" permet de naviguer sur le site en prévisualisation, entre articles et rubriques, sur la page d’accueil, etc. Ce plugin de prévisualisation étendue permet de : naviguer en prévisualisation entre articles et (...)

  • À propos des plugins actifs

    13 novembre 2010 – 25 commentaires

    À propos des plugins actifs affiche dans la partie publique de votre site la version de SPIP utilisée et la liste des Plugins activés avec affichage de l’icône, le nom, la version, l’état et une introduction de sa fonction. Si le Plugin n’a pas (...)

  • ScolaSPIP 4

    19 janvier 2016 – 362 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 3 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)

  • Convertir un site SPIP 3 en utf-8 avec le plugin Grenier

    8 janvier 2014 – 23 commentaires

    SPIP 3 fonctionne nativement avec l’encodage universel unicode utf-8. Sur certains sites (par exemple sur une mise à jour), on peut avoir un site qui est resté en iso-latin ce qui n’est pas conseillé (source de bugs, d’incompatibilité, ...) . (...)