Présentation
Ce plugin permet de créer des collections d’objets éditoriaux hétéroclites dans SPIP.
Note : Dans certains cas (notamment pour un nouveau site), il peut être préférable d’utiliser le plugin Sélections Éditoriales. N’hésitez pas à regarder de son côté aussi.
Installation
Ce plugin nécessite le plugin Sélecteurs générique en version 2.0.0 minimum.
Attention : pensez bien à activer le fichier .htaccess
(ou équivalent) de SPIP, sans quoi l’API d’autocomplétion ne fonctionnera pas.
Utilisation du plugin
La page qui liste les grappes du site est accessible dans le menu Édition de l’espace privé.
La création d’une Grappe nécessite d’indiquer un identifiant textuel pour cette grappe, et de définir quels objets éditoriaux on peut affecter dedans.
Ceci fait, il est possible d’ajouter des éléments dans la grappe, si un sélecteur d’autocompletion existe pour cet objet (c’est à dire un fichier selecteurs/grappes_{objets}.html
tel que selecteurs/grappes_articles.html
)
Boucles et balises
Tables du plugin
spip_grappes
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 |
identifiant | texte | Identifiant textuel de la grappe | #IDENTIFIANT |
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 | ... |
type | texte | ? | #TYPE |
visibilite | texte | ? ’public’ | #VISIBILITE |
date | date | date de création de la grappe | #DATE |
maj | date | date de la dernière modification apportée à la grappe | #MAJ |
Note : Les champs type
et visiblitite
se sont pas exploités par le plugin…
spip_grappes_liens
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 |
Note : Un ordre peut être donné par glisser / déplacer dans les listes d’objets, qui affecte le champ rang_lien
.
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>
Historique
Version 3
- Nécessite SPIP 4.2 minimum
- Réécriture du JS
- Nécessite plugin Selecteur Générique v2
- Nécessite plugin Select2 v2
- Retour JSON des
selecteurs/grappes_*
au format Sélecteur Générique v2
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 : |