La navigation et les filtres

Le but du site étant de faciliter la recherche de plugins, il existe plusieurs menus de navigation et de filtres rapidement accessibles :

• la barre de navigation du bandeau permet de se déplacer rapidement dans les pages « Plugins » —liste de tous les plugins— « Téléchargements » —liste de tous les téléchargements— et « Dépôts » —liste de tous les dépôts—. L’aide du site et l’interface de signalements y est aussi accessible.
• le menu des catégories permet généralement de se déplacer en un clic dans la page des Plugins de la catégorie choisie. Cependant, dans la page des téléchargements, ce menu agit comme un filtre restricitif sur les téléchargements de la catégorie sélectionnée.
• le menu des branches SPIP ou des dépôts agit comme un filtre de la liste des plugins ou des téléchargements dans leur page respective.

Ces filtres sont cumulables.

En outre, un menu de langue sous le bandeau permet de changer en un clic la langue du site.

La page d’accueil

La page d’accueil du site est composée de trois blocs distincts :

• une sélection de plugins exposés « en vedette » dans un cadre en haut de la page,
• la liste des plugins les plus utilisés dans les sites de la galaxie
• la liste des plugins ayant subis des modifications récemment.

Comme la plupart des affichages de plugin, ces listes présentent, si cela a un sens, le nom, le slogan et la version la plus récente de chaque plugin.

La liste des plugins en vedette est soit déterminée manuellement par l’administrateur du site pour exposer une liste de plugins précis —en utilisant le plugin Mes Favoris, soit choisie au hasard à chaque recalcul de la page si aucune sélection n’est active.

La liste des plugins les plus utilisés est calculée suite à la mise à jour des statistiques d’utilisation des plugins par le plugin « SVP Statistiques ». Ce plugin se sert des données que collecte régulièrement le site stats.spip.org en scannant les sites SPIP sur le net.
Pour l’instant, seules les statistiques globales —toutes versions SPIP confondues— sont stockées et restituées par Plugins SPIP. Mais des évolutions sont prévues pour améliorer l’heuristique de calcul de cette liste afin de la rendre plus dynamique et cohérente avec la période observée.

La liste des plugins récemment mis à jour est identifiée en extrayant la date du dernier commit des plugins référencés sur le site. Cette date ne tient pas compte non plus de la version SPIP.

La page des plugins

Cette page présente une liste paginée, avec pour chaque plugin, un résumé composé a minima du nom, du logo, du slogan, de la compatibilité SPIP, de l’auteur et des statistiques d’utilisation. il est possible de trier cette liste alphabétiquement par nom du plugin (tri par défaut), par date de mise à jour ou par popularité (statistiques d’utilisation du plugin).

Suivant le lien qui est utilisé pour se rendre sur cette page, l’affichage de la liste sera filtré ou pas :

• lien « Plugins » de la barre de navigation du bandeau ou “Toutes les catégorie” du menu latéral ? liste in extenso
• lien de « catégorie » dans le menu latéral ou dans le texte d’une page ? liste des plugins de la catégorie choisie
• lien d’un nom de « dépôt » dans le texte d’une page ou dans la liste des dépôts ? liste des plugins du dépôt
• lien d’une « branche SPIP » - 1.9, 2.0... - dans le bloc de filtre des branches affiché sur certaines pages ? liste des plugins compatibles avec la branche choisie.

La page d’un plugin

Cette page présente toutes les données disponibles sur un plugin, à savoir, les informations standard du plugin (nom, préfixe, slogan...) ainsi que la description détaillée de tous ses « paquets » (zip) classés par numéro de version décroissant.

Elle est composée de trois blocs d’informations :

• la définition du plugin avec son nom, son slogan, sa catégorie, son préfixe ainsi que les données de mise à jour, d’utilisation et de compatibilité SPIP.
• la description détaillée de chaque paquet : seul le paquet ayant le numéro de version le plus élevé étant présenté in extenso ; les autres paquets —moins à jour a priori— sont listés avec leur nom et leur numéro de version mais leur description détaillée n’est pas visible et il faut cliquer sur le nom du paquet pour voir apparaître sa description. Toutes les informations du paquet sont disponibles dans ce bloc (les auteurs, les mentions, l’archive, les dépendances, les traductions...)
• la liste des dernières modifications et des derniers messages de forum —uniquement pour un plugin ayant actuellement sa documentation sur SPIP-Contrib— concernant le plugin. Ce bloc est positionné au dessus du pied de page et possède un fond de la couleur attribuée à la catégorie du plugin.

La page des téléchargements

Cette page est destinée à remplacer à terme l’adresse http://files.spip.org/spip-zone/ en améliorant la présentation des informations.

Elle affiche par dépôt, la liste des paquets disponibles pour chaque plugin hébergé classée par ordre alphabétique. Chaque paquet est désigné par son nom d’archive —qui fait aussi office de lien de téléchargement— et informe sur sa version, sa date de mise à jour et sa compatibilité SPIP, permettant à l’utilisateur de choisir l’archive qui lui convient.

Il est possible de filtrer cette page par catégories —menu des catégories— par branches SPIP et par dépôts, tous ces filtres étant cumulables.

Outre les plugins, cette page propose le téléchargement des contributions non plugins comme par exemple, certains squelettes, l’ensemble des thèmes Zpip ou Sarka-SPIP, les jeux d’icônes...

La page des dépôts

Cette page présente la liste des dépôts proposant des plugins sur le site Plugins SPIP. Pour chaque dépôt sont affichés le nombre de plugins et paquets hébergés ainsi que la date de dernière mise à jour sur le site. Le lien du dépôt renvoie sur la page « Plugins » filtrée sur le dépôt choisi.

La recherche d’un plugin

Le site offre, dans son bandeau, un formulaire simple pour rechercher des plugins par mots-clés. La recherche s’effectue sur le préfixe, le nom, le slogan, l’auteur et la description d’un plugin.

Le résultat de la recherche est fourni en utilisant la page Plugins filtrée cette fois sur la liste des plugins répondant aux critères choisis. En outre, le résultat est toujours filtré par défaut sur les plugins compatibles avec la version stable SPIP du moment. Si la recherche ne fournit aucun résultat cela peut être du à ce filtre de compatibilité : il est donc possible d’étendre simplement la recherche à toutes les branches SPIP.

La validation d’un paquet.xml

Il est possible de valider un paquet.xml d’un plugin en cours de développement en se rendant sur la page Valider un paquet.xml du site. A l’instar du validateur W3C, cette page permet de vérifier la conformité des paquet.xml, ce qui est prérequis au fonctionnement de tout plugin.

Il suffit de copier-coller le contenu du paquet.xml dans le formulaire proposé et d’effectuer les corrections on-line jusqu’à sa validation. Le contenu valide peut être alors recopié dans le fichier d’origine.