Qui rédige un récit de voyage, par exemple, aimerait pouvoir illustrer son article de plusieurs petites séries de photos, une par jour. Or SPIP ne permet de faire qu’un seul album photo par article, le « portfolio ». Ce plugin permet de créer et afficher plusieurs « albums » au fil du texte, au sein d’un même article. Et où bon vous semble.
Insertion d’un album au fil du texte
Pour afficher un album dans un article, il suffit d’appeler le modèle homonyme, dans le champ de saisie, en indiquant les identifiants des documents voulus, comme ceci :
<album|id=17,2,63,15>
Il est également possible d’afficher tous les documents d’un article (c’est-à-dire le « portfolio » SPIP d’un article), comme ceci :
<album|id_article=211>
Il est possible de donner un titre à chaque album, comme ceci :
<album|id=17,2,63,15|titre=Mon super titre, hé !>
C’est peu utile, mais il est possible d’aligner chaque album, comme on le fait pour les images et documents : en passant le paramètre center
, left
ou right
. Par exemple :
<album|right|id=17,2,63,15>
Utilisation dans les squelettes
L’album s’insère dans les squelettes comme n’importe quel autre modèle, sans oublier de passer les id des documents voulus, comme suit :
#MODELE{album,id=17,2,63,15}
Pour remplacer le portfolio par défaut de SPIP, sous l’article, on écrira :
[(#MODELE{album,id_article,env}{titre=<:info_portfolio:>})]
Structure et style des albums
L’habituel « portfolio » de SPIP est remplacé par le modèle « album », afin d’homogénéiser le rendu et vous faciliter le travail. Ainsi style et structure sont les mêmes pour les albums insérés au fil du texte que pour portfolio qui fait suite à l’article.
Code généré
Un album est une liste de documents. Voici sa structure HTML de base :
<div class="album clearfix p right" id="album15">
<h2>Titre de l'album</h2>
<ul>
<li><a href="#"><img src="..."></a></li>
<li>etc.</li>
</ul>
</div>
Habillage CSS
- .clearfix
, .p
, .left
, .right
et .center
: étant déjà définis dans les feuilles de styles de la dist ou dans votre framework CSS de prédilection, il est inutile (et déconseillé) de les redéfinir dans ce plugin. S’il vous font défaut, déclarez-les dans vos propres feuilles de styles, en prenant modèle sur la dist de SPIP3.
- C’est le sélecteur .album
que vous utiliserez pour cibler tous les albums d’un coup et les habiller à votre goût.
Pour personnaliser, vous pouvez déposer votre CSS dans une feuille de style nommée « album.css
» dans le sous-répertoire /css
de votre dossier squelettes
.
Évolution / todolist
Cette première version du plugin ne fait que se greffer sur la dist de SPIP pour proposer un modèle d’insertion d’album. Ce plugin devrait évoluer pour
- être complété d’un objet SPIP « album » de façon à
- pouvoir constituer des albums [*] dans la médiathèque avant de
- les insérer plus simplement dans les articles, via le raccourci « <album25>
».
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 : |