Boussole

Les bonnes adresses de la galaxie SPIP ou d’ailleurs !

Installez ce plugin sur votre site et vous aurez accès, dans vos squelettes, à l’ensemble des sites de la Galaxie SPIP en utilisant les modèles ou noisettes proposés.

Pour les bricoleurs, vous pouvez aussi utiliser ce plugin pour afficher votre propre liste de sites et concevoir vos propres affichages.

Avertissements

Le plugin Boussole a évolué récemment pour passer en version 4 dans le but de simplifier son code et son utilisation sur les sites client ou serveur. Pour migrer vers cette version et en comprendre les évolutions veuillez lire l’article Boussole v4.

Le présent article a donc été modifié pour être lisible quelque soit la version du plugin. Si une explication n’est valable que pour une version donnée cela est clairement précisé. Sinon, par défaut, l’explication est valable pour toutes les versions.

Objectifs

Le plugin Boussole a comme buts :

  • de constituer la liste « officielle » des sites SPIP en proposant une charte réutilisable,
  • de proposer une liste de modèles prédéfinis pour insérer la boussole en fonction du besoin et de couvrir par là même l’ensemble des affichages utilisés dans la galaxie SPIP (voir l’article Charte de la boussole SPIP),
  • d’être utilisé, a minima, dans tous les sites de la galaxie -et plus si affinité,
  • et donc de constituer un repère commun pour tous les utilisateurs de SPIP.

En outre, il est possible de créer sa propre boussole personnalisée de la galaxie SPIP ou de tout autre univers.

Exemples d’utilisation

En outre, la plupart des sites de la galaxie SPIP ont été mis à jour avec la Boussole. Les noms, adresses, icônes et libellés de ces sites sont maintenant identiques et donc plus facilement repérables.

La planche ci-dessous illustre les différents affichages de la Boussole dans la galaxie.

Exemples d’utilisation sur les sites SPIP

Installation

Comme tout plugin, il suffit de suivre les procédures manuelles ou automatiques standard : veuillez vous reporter à cette documentation : SPIP-1-9-Les-Plugins.

Pré-requis

Boussole ne nécessite aucun autre plugin pour fonctionner en v2. A partir de la version v4, le plugin Boussole nécessite le plugin Cache Factory.

Modèle de données

Le modèle de données de Boussole distingue trois notions principales :

  • la Boussole, qui n’est autre qu’une liste de sites. Une boussole est identifiée par un alias unique qui prend la valeur « spip » pour la galaxie SPIP. Elle est décrite dans un fichier XML.
  • le Groupe, qui est un sous-ensemble thématique des sites d’une boussole. Le groupe est identifié par un alias unique au sein d’une boussole.
  • le Site, identifié par un alias unique au sein d’une boussole. Un site de boussole peut être mis en relation avec un site référencé de SPIP.

Versions 0 et 1 :
Le modèle de données est matérialisé par une unique table spip_boussoles. La table est mise à jour à partir de la lecture du fichier XML de la boussole. La DTD de ce fichier est matérialisée par le fichier boussole.dtd à la racine du plugin.

Version 2 et ultérieures :
Le modèle de données est toujours matérialisé par la table spip_boussoles qui n’a pas évoluée. Par contre, une nouvelle table spip_boussoles_extras a été ajoutée pour accueillir les traductions des noms, slogans et descriptions des objets manipulés par le plugin (boussole, site, groupe). Ces tables sont mises à jour par requête au serveur hébergeant la boussole souhaitée.

Initialisation du plugin

Étant donné que Boussole est principalement destiné à la galaxie SPIP, lors de son activation, la boussole SPIP est automatiquement chargée en base de données et donc disponible à l’utilisation.

L’interface privée

Elle propose - via le menu Squelettes (ou Configuration en SPIP 2 sans le plugin Bandeau) - une interface réservée aux webmestres et composée :

  • d’une page principale autorisant l’ajout, la mise à jour ou la suppression d’une boussole
    Page de gestion des boussoles
  • une page d’édition d’une boussole donnée permettant d’en configurer l’affichage : visibilité et classement des groupes et des sites
    Page de configuration d’une boussole

En outre, une tâche CRON tourne toutes les 24h pour mettre à jour automatiquement la boussole SPIP ou les autres boussoles (uniquement pour la version 2).

Enfin, si un site référencé fait partie d’une boussole, sa page d’édition en fera mention et affichera un lien vers cette boussole.

Référence à la boussole pour un site

L’interface publique

Des modèles

Elle est essentiellement constituée d’une liste de modèles prédéfinis consultables dans la page de démo demo/boussole.html :

  • boussole_liste_simple.html - une liste ul/li avec le titre de la boussole en h2 optionnel
  • boussole_liste_par_groupe.html - une liste ul/li par groupe avec titre du groupe en h3 et titre de la boussole en h2, optionnels
  • boussole_liste_avec_logo.html - une liste ul/li avec le titre de la boussole en h2 optionnel. Chaque bloc de site affiche le logo, le nom et une explication, slogan ou descriptif
  • boussole_panorama.html - une galerie d’icônes seuls avec le titre de la boussole en h2 optionnel
  • boussole_panorama_sepia.html - idem que le modèle précédent avec des logos sépia qui s’éclairent au survol
  • boussole_liste_actualite.html - une liste ul/li des articles syndiqués des sites référencés de la boussole.
  • boussole_contenu_z.html - une page Z avec le titre de la boussole en h1 et les titres des groupes en h3. Chaque site est un paragraphe
  • boussole_tableau.html - tableau complet de toutes les informations de la boussole. Ce modèle est utile essentiellement comme débusqueur
  • boussole_topnav.html - un menu de type topnav pour présenter la boussole sous forme d’une navigation principale.

Les sites sont généralement présentés sous forme de lien avec le slogan en bulle d’info. Le fichier html de chaque modèle comporte en commentaire une description détaillée des paramètres du modèle.

Une page Z compatible avec le noiZetier

Boussole propose aussi une page Z, boussole.html, utilisable avec ou sans le NoiZetier. Si elle est utilisée avec le NoiZetier, il est nécessaire de configurer la noisette Boussole - Contenu principal, de l’insérer explicitement dans la page et d’y ajouter un fil d’ariane éventuellement avec la noisette Boussole - Fil d’ariane - voir ci-dessous.

L’appel de cette page se fait en passant le paramètre « boussole » désignant l’alias de la boussole à afficher - spip.php?page=boussole&boussole=spip.

Cette page a été supprimée à partir de la version v4.

Des noisettes compatibles avec le noiZetier

En outre, le plugin propose des noisettes compatibles avec le NoiZetier et qui permet d’introduire facilement dans les squelettes compatibles (Aveline, SPIPClear Z...) les modèles précédemment décrits. Les noisettes disponibles sont :

  • Boussole, permettant d’utiliser et de configurer les modèles standard, à savoir :
    • boussole_liste_simple.html
    • boussole_liste_par_groupe.html
    • boussole_liste_avec_logo.html
    • boussole_panorama.html
    • boussole_panorama_sepia.html
  • Boussole - Actualités, permettant de configurer le modèle :
    • boussole_liste_actualite.html
  • Boussole - Contenu principal, destinée principalement à la page Z boussole et permettant de configurer le modèle :
    • boussole_contenu_z.html
  • Boussole - Fil d’ariane, destinée principalement à la page Z boussole

Traductions et icônes

Ce chapitre à été déplacé et enrichi dans l’article Boussole v2, usages avancés.

Créer sa propre boussole

Ce chapitre à été déplacé et enrichi dans l’article Boussole v2, usages avancés.

Discussion

2 discussions

  • Bon désolé mais ya pas moyens de faire une boussole perso

    Le fichier « http://spipfactory.com/boussole_factory.xml » est introuvable

    1° je suis en mutualisé est ce que cela joue ?

    2° si je met mon fichier .xml soit a la racine de la mutu ou dans spipfactory.com, j’ai la même erreur

    je vais tenter sur un site spip seul ;)

    Répondre à ce message

  • 1

    quelque difficulté sur une mutualisation utilisant le sarka a :
    Créer sa propre boussole
    donc tout d abord création du pipeline d’affichage dans sarka

    le pipeline boussolefactory

    [(#REM) <!-- Noisette perso plugin utilisé --> ]
    <div id="noisette_statistiques" class="noisette">
        <div class="contenu">
    <center>
    [(#MODELE{boussole_liste_avec_logo,
            boussole=spip,
            titre_boussole=oui,
            type_description=slogan_site,
            taille_logo=40,
            div_id=boussole,
            div_class=menu})]
    </center>
    </div></div>

    appel du pipeline dans sarka

    define('_PERSO_COLONNE_EXTRA_FIN', 'noisettes/perso/boussolefactory');

    Placer les fichiers sur le serveur , Jusque la ça va bien ;)

    Créer sa propre boussole

    Il est tout à fait possible de définir sa propre boussole en créant un fichier XML boussole_.xml à la racine du répertoire squelettes/.

    donc le fichier boussole_factory.xml
    (dans un premier temps il reprend le code suivant)

    <boussole alias="spip" version="0.2">
    
            <!-- Sites de reference SPIP -->
            <groupe type="reference">
                    <site alias="net" src="http://www.spip.net/" />
                    <site alias="doc" src="http://doc.spip.org/" />
                    <site alias="programmer" src="http://programmer.spip.org/" />
            </groupe>
    
            <!-- Sites d'aide & echanges autour de SPIP -->
            <groupe type="aide">
                    <site alias="forum" src="http://forum.spip.org/" />
                    <site alias="user" src="http://listes.rezo.net/mailman/listinfo/spip/" />
                    <site alias="irc" src="http://www.spip.net/irc/" />
                    <site alias="party" src="http://www.spip-party.net/" />
            </groupe>
    
            <!-- Sites de decouverte des realisations SPIP -->
            <groupe type="decouverte">
                    <site alias="info" src="http://www.spip-info.net/" />
                    <site alias="herbier" src="http://www.spip-herbier.net/" />
                    <site alias="video" src="http://video.spip.org/" />
                    <site alias="demo" src="http://demo.spip.org/" />
                    <site alias="test" src="http://grml.eu/" />
            </groupe>
    
            <!-- Sites des actualites SPIP -->
            <groupe type="actualite">
                    <site alias="blog" src="http://www.spip-blog.net/" />
                    <site alias="zine" src="http://zine.spip.org/" />
                    <site alias="mag" src="http://mag.spip.net/" />
                    <site alias="twit" src="http://spip.org/" />
                    <site alias="sedna" src="http://sedna.spip.org/" />
            </groupe>
            
            <!-- Sites des extensions & contributions SPIP -->
            <groupe type="extension">
                    <site alias="plugin" src="http://plugins.spip.net/" />
                    <site alias="contrib" src="http://www.spip-contrib.net/" />
                    <site alias="zone" src="http://zone.spip.org/" />
            </groupe>
    </boussole>

    Je place le fichier boussole dans le repertoire /squelettes de la mutu et lorsque je veux activer le plugin boussole dans la partie privé :

    Choisissez une boussole -> Boussole personnelle -> Saisissez l’url du fichier de description de votre boussole qui est dans le chemin : /var/www/mutusarka/squelettes/

    Je rentre l’url : http://spipfactory.com/boussole_factory.xml

    et j’ai droit a un :

    Le fichier http://spipfactory.com/boussole_factory.xml » est introuvable

    une idée, une piste ou ai-je commis une erreur ?

    merci

    • Salut Stephane,

      Inutile de copier des tonnes de code stp !

      Le message est le bon, ton url est mauvaise, donc il ne trouve pas le fichier xml c’est aussi simple que ça. Essaye avec http://spipfactory.com/squelettes/boussole_factory.xml.

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom