Présentation et nouveautés
Cette version 1.0 du plugin Grappes est un portage pour SPIP 3.x. Le plugin permet de grouper des objets de SPIP dans des grappes. Les objets du core (articles, rubriques, auteurs, etc.) sont pris en charge, ainsi que les nouveaux objets ajoutés par des plugins.
Côté technique, le plugin utilise les nouvelles spécifications et APIs de SPIP 3 (api de déclaration d’objet, de gestion de liens).
La version 2.0 présente une rupture de compatibilité pour vos squelettes si vous utilisiez {par rang} pour trier l’affichage de vos grappes.
Cette rupture de compatibilité a été rendue nécessaire pour adapter le plugin à SPIP 3.3.
Installation et configuration
Ce plugin nécessite le plugin Sélecteurs générique en version 0.8.3 minimum.
Attention ! : pensez bien à activer le fichier htaccess.txt de SPIP en le renommant en .htaccess ; sans ça le plugin ne fonctionnera pas (ceci est impératif pour l’auto-complétion des champs de recherche).
Utilisation du plugin
La page qui liste les grappes du site est accessible dans le menu Édition de l’espace privé.
Cette page affiche une la liste des grappes du site et un lien qui permet de créer une nouvelle grappe.
La page de vue permet d’éditer les liens de la grappe, modifier son logo et de supprimer la grappe.
La page d’édition d’une grappe permet de modifier : le titre, le descriptif, les types d’objets que l’on peut lier à la grappe et les droits d’accès.
Boucles et balises
Tables du plugin
La table spip_grappes est la table principale du plugin, c’est elle qui contient les informations relatives aux grappes.
| Nom du champ | type | utilité | balise |
|---|---|---|---|
| id_grappe | auto incrémenté | ... | #ID_GRAPPE |
| id_admin | entier | auteur de la grappe | #ID_ADMIN |
| titre | texte | ... | #TITRE |
| descriptif | texte | ... | #DESCRIPTIF |
| options | tableau sérialisé | options de la grappe (droits d’accès, etc.) | ... |
| liaisons | liste | contient les types d’objets qu’on peut lier à la grappe | ... |
| date | date | date de création de la grappe | #DATE |
| maj | date | date de la dernière modification apportée à la grappe | #MAJ |
La table spip_grappes_liens est une table de liaison classique.
| Nom du champ | type | utilité |
|---|---|---|
| id_grappe | entier | le lien avec la table spip_grappes |
| objet | texte | type de l’objet lié |
| id_objet | entier | id de l’objet lié |
| rang_lien [*] | entier | rang du lien entre l’objet et la grappe |
Le champ rang de la table de liaison n’est pas exploité par le plugin (il reste à penser une bonne interface pour le proposer). Il peut très bien être utilisé par d’autres plugins qui se baseraient sur Grappes.
Quelques exemples de boucles
Pour lister les grappes d’un auteur, on écrira dans un boucle AUTEURS :
<BOUCLE_b(GRAPPES){id_admin=#ID_AUTEUR}>
#ID_GRAPPE - #TITRE
<BOUCLE_b>Pour lister les article présent dans une grappe, on écrira dans une boucle GRAPPES :
<BOUCLE_b(ARTICLES){id_grappe}>
#ID_ARTICLE - #TITRE
<BOUCLE_b>Et pour trier les articles selon leur rang dans la grappe avec {par rang_lien} [*] :
<BOUCLE_b(ARTICLES){id_grappe}{par rang_lien}>
#ID_ARTICLE - #TITRE
<BOUCLE_b>
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
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.
Suivre les commentaires :
|
