Albums

Ce plugin permet d’afficher une ou plusieurs galeries d’images au fil du texte, dans les articles et ailleurs.

Un portfolio… des albums !

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> ».

Un même document peut appartenir à deux albums différents

Notes

[*Un album est un ensemble de documents, que l’on peut afficher en galerie (ou en liste) au fil du texte, dans un article ou ailleurs.

Discussion

Aucune discussion

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