Présentation

SEamlESS est un plugin jQuery permettant la recherche et l'affichage asynchrones de descriptions de spectacles (brochure pdf).

Installation

Prérequis

Pour que SEamlESS fonctionne sur un site, il faut
  1. que le site hébergeant (ou celui référencé via le paramètre search-domain) soit inscrit auprès des AML comme un site autorisé
  2. que chaque page hébergeant SEamlESS contienne un lien vers une bibliothèque jQuery, min. 1.8

Configuration

Base

Les étapes nécessaires à une installation basique de SEamlESS sont
  1. ajouter une référence aux fichiers main.js et style.css (adresse : http://ict.aml-cfwb.be/seamless) dans la section <head> de chaque page où SEamlESS doit s'exécuter.
    La référence au fichier main.js doit obligatoirement se situer après celle à la bibliothèque jQuery mentionnée dans les prérequis.
    Attention : si la page où doit fonctionner SEamlESS contient des scripts en bas de page, il peut être nécessaire de placer la référence au fichier main.js également en bas de page, après ceux-ci.
    Pour ajouter ces références, deux méthodes sont possibles :
    • - copier directement ces fichiers au coeur de votre site ; dans ce cas, les futures mises à jour fonctionnelles de SEamlESS devront se faire manuellement, ce qui toutefois évite toute rupture fonctionnelle sur votre site.
    • - (recommandée) pointer directement vers ces fichiers sur le serveur des AML ; dans ce cas, les futures mises à jour fonctionnelles de SEamlESS seront automatiques pour votre site. Les exemples ci-dessous illustrent cette seconde méthode.
    <link href="http://ict.aml-cfwb.be/seamless/style.css" rel="stylesheet" type="text/css" />
    <script src="http://ict.aml-cfwb.be/seamless/main.js"></script>
    Selon le principe de l'héritage css, SEamlESS utilisera les informations de style de son élément parent pour lui-même et ses éléments enfants, par ex. la famille, la taille et la couleur de la police, la couleur de l'arrière-plan...
    Vous pouvez bien sûr modifier ce comportement par défaut en créant pour SEamlESS et/ou ses éléments enfants vos propres styles et en ajoutant une référence à ceux-ci dans la balise <head> après la référence au fichier style.css.
  2. ajouter une balise <div> comportant la classe SeamlessClass à l'endroit où SEamlESS doit apparaître
    <body>
    ...
    <div class="SeamlessClass"/>
    ...
    </body>
    Bien que ce soit déconseillé, vous pouvez théoriquement avoir plusieurs SEamlESS sur une même page. Dans ce cas, seule l'étape 3 doit être répétée.

Paramètres

SEamlESS peut être paramétré afin de modifier le mode de recherche et/ou l'affichage des résultats. Il suffit pour cela d'ajouter des attributs spécifiques à la balise div créée à l'étape 3.

Recherche

nom fonction valeurs
possibles
valeur
par défaut
remarque
search-domain détermine la cie dont les spectacles sont affichés [nom de domaine] [site hébergeant]
search-tools détermine si les outils de recherche (zone de texte, bouton "Chercher", case à cocher "Séquence exacte") doivent être visibles y n y
search-auto lance autmatiquement une recherche sur le texte entré [texte de recherche] [vide]
search-exact détermine si la case "Séquence exacte" doit être cochée à l'ouverture de la page y n n pris en compte avec search-auto
search-seasons détermine si le menu déroulant des saisons doit être visible y n y

Résultats

nom fonction valeurs
possibles
valeur
par défaut
remarque
results-seasons détermine si les "bornes" saisons doivent être visibles y n y si = "n", results-all = "y"
results-scroll détermine si les résultats doivent s'afficher sur une ligne (avec ascenseur horizontal) ou sur toute la page y n y
results-all détermine si toutes les saisons doivent être déployées à l'affichage des résultats y n n si ="n", seule la première saison est déployée
results-firstactor détermine si les tuiles "spectacle" doivent contenir le nom du "premier" interprète y n y
results-circle détermine si les tuiles "détails" doivent être en cercle y n n

Outil en ligne

Pour générer le code de configuration de la balise <div> de SEamlESS, vous pouvez utiliser l'outil en ligne à l'adresse http://ict.aml-cfwb.be/seamless/tools/test.html.
Cet outil vous permet de générer le code de base ainsi que les paramètres tout en testant visuellement le résultat.

Exemples d'implémentation

Contact

Luc Wanlin
1er assistant Informatique/Archivistique
Archives et Musée de la Littérature (www.aml-cfwb.be)
Boulevard de l'Empereur 4
1000 Bruxelles
Tél. : 02 / 519 55 89
Mail : luc@aml-cfwb.be