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

35 discussions

  • Sur spip 4.1.5, album 4.0.3, sarka remoad 4.5.15
    j’obtiens un
    Warning : Use of undefined constant _ALBUMS_AFFICHER_TITRE - assumed ’_ALBUMS_AFFICHER_TITRE’ (this will throw an Error in a future version of PHP) in /htdocs/tmp/cache/skel/html_c03b4a2a4cb0eecad0e3c794845c7374.php(413) : eval()’d code on line 1
    on line1 ily a

    <? php
    et le m^zme fichier htlm en 426, deux fois, 418, 322
    https://emuz.pm/Ouvrage-de-references.html
    
    Que puis je faire?

    Répondre à ce message

  • Bonjour,
    album est compatible spip 4.0.* (et même apparemment 4.1.0)
    Un petit détail, une noisette perso /inclure/documents.html ne peut pas être utilisée car albums appelle celle de squelettes_dist : plugins/auto/albums/v3.6.3/inclure/documents.html ligne 10 : INCLURE fond=squelettes-dist/inclure/documents, env
    Donc la noisette perso pour les documents doit juste s’appeler autrement, /inclure/docs.html par exemple.
    Cette surcharge est-elle indispensable ?
    (Il ne semble pas que fond puisse dépendre de [variable, squelette appelant …], mais en supprimant cette ligne 10 ça marche pareil, dans mon cas …)

    Répondre à ce message

  • 1

    Bonjour,
    AlbumV2.
    #URL_ALBUM n’existe pas ?

    solution trouvée, créer l’ URL : #URL_ECRIREalbum&id_album=#ID_ALBUM

    [(#SESSION{statut}|=={1comite}|oui) 
    <a href="#URL_ECRIRE{album&amp;amp;amp;id_album=#ID_ALBUM}"> 
    Modifier cette album </a>]

    ce n’est pas user friendly d’ajouter un doc ainsi mais déjà mieux.
    J’ai cherché vainement le formulaire privé « ajouter document », à l’album
    pour permettre d’ajouter facilement un document à un album présent dans un article,
    plus rapidement qu’en passant par le bouton d’administration de l’article l’incluant !

    • pour permettre d’ajouter facilement un document à une page album, spip.php ?albumX , FORMULAIRE_JOINDRE_DOCUMENT ! :

      [(#AUTORISER{modifier, album, #ID_ALBUM} |sinon{<:participer_site:>})
      #FORMULAIRE_JOINDRE_DOCUMENT{new,#ENV{id_album},'album','auto'} 
      <!--et non {new,album,#ID_ALBUM} -->
      ]

    Répondre à ce message

  • 1

    Il y a un défaut de conception (je ne sais pas où le signaler) dans le modèle au dépôt sur l’usage du nouvel élément HTML5 <figure>. Cet élément sert à encapsuler une image, ou tout autre document, mais aussi une liste d’images. Voir : HTML5 : Éléments <figure> et <figcaption>.

    Tel qu’il est définit par ce plugin dans SPIP, un album est une figure et devrait donc être balisé <figure class="album>…</figure>. Or ce n’est pas possible car la liste contient des éléments <figure> (car <figure> n’accepte pas <figure> comme enfant).

    Pour bien faire, la liste ne devrait contenir que de vignettes : <li><a><img title="">… c’est-à-dire sans les éléments <figure> ni <figcaption>.

    Répondre à ce message

  • 1
    Renée Picard

    Bonjour
    Je développe un site en 3.0.13 et je ne réusissais pas à faire afficher les albums créés jusqu’à ce que j’utilise simplement <albumX> , X étant le numéro de l’album et non pas de l’article. Si cela peut en aider d’autres, tant mieux !
    Merci pour ce plugin qui est bien pratique.
    RP

    • Bonjour,
      je suis aussi en spip 3.0.13, mais cela ne veut pas fonctionner. J’ai bien créé l’album n°1, qui est bien associé à l’article, mais j’ai <album1> dans mon article au lieu de me l’afficher.
      Où est mon erreur ?
      Merci d’avance

    Répondre à ce message

  • 1

    Bonjour,

    J’ai une page avec plein d’albums et c’est assez long à charger.
    Auriez-vous une idée pour accélérer le processus ou alors de ne pas charger toutes les images... ?

    P.S. Je travaille avec la version 2.2.9 du plugin

    Répondre à ce message

  • Bonjour,

    j’ai installé ce plugin Albums 2.2.7 sur un site spip 3.O.10, tout est ok sauf sur ie où les albums ne sont pas visibles dans mes articles. Avez-vous déjà eu le problème et auriez-vous une solution ?

    Merci pour votre aide !

    Répondre à ce message

  • Bonjour,
    J’ai créé un album, il a des images, il est publié et il est attaché un article.

    Dans mon squelette article il a :

    [(#MODELE{album,id_article,env}{titre=<:info_portfolio:>})]
    [(#INCLURE{fond=documents}{id_article}{env})]

    le modèle est celui du plugin (je ne l’ai pas surchargé)

    nada, rien ne s’affiche dans l’espace public.

    où est mon erreur ? SPIP 3.013

    merci

    dd

    Répondre à ce message

  • 2

    Bonjour pourrait-on constituer un album de manière automatique
    l’album serait constitué de toutes les images avec un mot clé spécifique.
    On peut aller plus loin, avec un agrégateur de contenu permettant de filtrer la constitution de l’album : images appartenant à une rubrique (ou article) et/ou emportant un ou des mots clés spécifiés ...

    • peut-on choisir de n’afficher qu’une vignette d’un album. Le clic déclenche le diaporama et on accède à l’ensemble des photos de l’album...

    • l’idée d’album, c’est d’avoir un objet « album » que l’on construise manuellement. Si on veut regrouper selon des mot clefs, alors il faut faire son propre modèle (de même du coup pour ta question de vignette)

    Répondre à ce message

  • Bonjour,
    le lien de téléchargement est erroné pour spip3 sur la page de doc :
    http://files.spip.org/spip-zone/albums.zip > plutôt http://files.spip.org/spip-zone/albums_2.zip peut-être ?
    si oui, je ne parvient pas à faire marcher cette version 2 : le plugin ne fait rien, malgré un album créé et des photos ajoutées, rien n’apparaît... faut-il désactiver quelques chose, supprimer les portfolios par défaut de spip ?
    Merci de votre aide.

    Répondre à ce message

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