Avant d’effectuer une mise à jour depuis la version 1 ou 2, consultez les notes sur la rétro-compatibilité. Les modèles, notamment, on reçut quelques changements pour la bonne cause.
En préambule, une courte vidéo de présentation.
Si vous rencontrez des difficultés pour la lecture, rendez vous sur medias.spip.net où le fichier source est téléchargeable.
Évolutions
- v3.6.0 : permet de réordonner les documents des albums par glisser-déposer
Des albums, pour quoi faire ?
Dans sa première version, le plugin permettait d’insérer des galeries d’images au fil du texte, dans les articles.
Depuis la version 2, les albums sont des objets éditoriaux à part entière, aussi la portée du plugin est plus générale : il sert à la gestion de groupes de documents.
⇒ Des groupes de documents
Un album, c’est donc un conteneur pour une série de documents.
Précisons le bien, si le terme « album » évoque des albums d’images, il peut contenir tout type de document : images, bandes-son, vidéos et autres.
Un même document peut appartenir à plusieurs albums : toutes sortes de combinaisons sont envisageables.
⇒ Albums et documents liés à un objet
En SPIP 3, les documents liés à un objet sont présentés sous forme de 3 groupes : « illustrations », « portfolio » et « documents ». Leur finalité est expliquée dans cet article, mais retenons qu’il s’agit d’une séparation arbitraire pensée pour les articles.
Dans cette documentation, on va se référer à ces documents comme des documents « individuels », par opposition au documents regroupés au sein d’albums.
Les documents individuels et les albums sont indépendants et n’ont pas d’incidence l’un sur l’autre : on peut continuer à gérer les documents individuels comme avant.
En pratique, vous avez le choix au moment d’ajouter des documents à un objet : ils peuvent être ajoutés individuellement, ou regroupés au sein d’albums.
Installation & configuration
L’installation se fait comme n’importe que plugin.
2 tables vont être ajoutées : spip_albums
et spip_albums_liens
.
Des plugins supplémentaires doivent être installés si vous souhaitez bénéficier du formulaire qui permet de personnaliser les balises <album> à insérer dans le texte. Il s’agit de dépendances optionnelles.
Une fois l’installation effectuée, un passage sur la page de configuration est ensuite nécessaire. Elle est constituée de 2 onglets.
⇒ Onglet « options »
L’option principale permet de définir sur quels objets les albums pourront être ajoutés.
2 autres options permettent de proposer un titre par défaut lorsqu’on ajoute un nouvel album à un objet, et d’activer le déplacement de documents par cliquer-glisser.
⇒ Onglet « outils »
Un formulaire permet de migrer des articles en albums.
Il est prévu dans le cas où l’on se servait d’articles comme de pseudo albums, et se charge de créer des vrais albums à l’identique à partir de ceux-ci.
Utilisation
Les albums peuvent être autonomes ou liés à d’autres objets éditoriaux.
⇒ Dans le cas d’albums autonomes, on les créera depuis la barre d’outil rapide ou depuis la page des albums, comme n’importe quel objet éditorial.
⇒ Dans le cas d’albums liés à des objet éditoriaux, leur gestion est assez similaire à celle des documents : on peut gérer les albums depuis la fiche d’un objet ou lorsque celui-ci est en cours d’édition.
Gestion des albums sur la fiche d’un objet
Sur la fiche d’un objet éditorial, les albums font suite aux documents. L’interface permet d’ajouter de nouveaux albums ou des albums existants, d’éditer leur texte et de manipuler leurs documents.
⇒ Ajouter des albums
Le bouton « Ajouter un album » fait apparaître un formulaire proposant deux méthodes [1] :
Créer et remplir un nouvel album. Titre et descriptif sont optionnels : laissé vide, le titre sera rempli à posteriori avec « Nouvel album N° X ».
Choisir un ou plusieurs albums existants : on peut parcourir la liste, ou rentrer directement les numéros des albums.
⇒ Editer un album sur place
Les albums peuvent être édités sur place. Pour l’édition complète (gestion des auteurs, des mots-clés etc.), on se rendra sur leur fiche.
Editer le texte : une icône apparaît au survol du header, elle permet d’afficher le formulaire d’édition du titre et du descriptif.
Ajouter des documents : un lien situé en bas fait apparaître le formulaire d’ajout de documents.
Manipuler les documents : les boutons d’édition apparaissent au survol de chaque document.
Il est également possible, sous certaines conditions, de déplacer des documents entre albums par cliquer-glisser.
⇒ Retirer des albums
Pour retirer un album, cliquer sur le bouton qui apparaît au survol, en bas de chaque album.
Lorsqu’il y a plusieurs albums, un bouton présent à la fin de la liste permet de tous les retirer d’un coup.
Gestion des albums lors de l’édition d’un objet
Pendant l’édition d’un objet, la gestion des albums s’opère au même endroit que celle des documents, dans la colonne de gauche.
Quand l’objet peut recevoir à la fois des documents et des albums, un menu permet de basculer entre les deux.
⇒ Ajouter, éditer et retirer les albums
On gère les albums de la même façon que lorsqu’on se trouve sur la fiche de l’objet : même formulaire pour ajouter des documents, mêmes possibilités pour éditer les albums et manipuler leur documents.
⇒ Insertion des balises <album> dans le texte
Les albums insérés dans le texte au moyen de la balise <albumX> seront automatiquement associés à l’objet : ce comportement est similaire à celui des balises <doc>, <img> et <emb> des documents.
Un formulaire permet de personnaliser les balises de chaque album : choix de la variante, alignement, paramètres des modèles, etc.
Important : pour bénéficier de cette fonctionnalité, des plugins supplémentaires doivent être installés. Consultez la section sur l’installation.
Les modèles
L’apparence, la structure et certains paramètres évoluent par rapport aux versions 1 et 2. Consultez les notes sur la rétro-compatibilité.
2 modèles « album » sont proposés : le modèle de base est une vue en vignettes, complété d’une variante avec une vue en liste.
Par défaut, ces 2 modèles produisent un affichage minimaliste : titre, descriptif, et autres éléments "superflus" ne sont pas affichés à moins d’utiliser les paramètres adéquats (détaillés plus bas).
De même, la feuille de style chargée sur le site public ne contient que le strict minimum.
Ces 2 modèles ne prétendent pas répondre à tous les cas de figure. Les usages possibles sont trop vastes pour être tous pris en compte par un modèle générique : listes de lecture audio ou vidéo, diaporamas, etc.
Pour vos besoins spécifiques, ajoutez des variantes du modèle.
⇒ Modèle <album> : vue en vignettes
Ce modèle est prévu pour afficher des séries d’images : les documents sont affichés sous forme de vignettes cliquables.
Il est basé sur Tiny Typo, la base CSS de Romy Têtue.
Les images peuvent être retaillées et recadrées pour obtenir un affichage uniforme, par défaut elles sont retaillées selon une hauteur de 100 pixels.
La structure HTML de base est la suivante (avec #HTML5 activé) :
<figure class="album vignettes figure">
<ul>
<li>
<a href="#"><img src="..."></a>
</li>
</ul>
<figcaption>...</figcaption>
</figure>
⇒ Modèle <album|liste> : vue en liste
Cette variante affiche les documents sous forme d’une simple liste. Elle est donc adaptée à tout type de documents.
La structure HTML de base est la suivante :
<div class="album liste">
<ul class="spip">
<li>
<a href="#">...</a>
</li>
</ul>
</div>
Paramètre | Description |
---|---|
titre |
« oui » pour afficher le titre N’importe quelle chaîne pour un titre personnalisé. |
balise_titre |
Pour encapsuler le titre dans une balise, sans les chevrons. → strong, h4, etc. |
descriptif |
« oui » pour afficher le descriptif |
par |
Tri des documents, défaut : « titre » → date, titre, media, fichier, extension, taille |
media |
Pour restreindre à un type de document → image, file, audio, video |
Paramètre | Description |
---|---|
largeur |
Largeur maximale des vignettes |
hauteur |
Hauteur maximale des vignettes, défaut : 100 (pixels) |
recadrer |
« oui » pour recadrer les images |
label |
« oui » pour afficher le titre de chaque document |
Paramètre | Description |
---|---|
metas |
« oui » pour afficher les infos complémentaires de chaque fichier, ou une liste d’éléments séparés par des virgules : → extension, taille, dimensions |
Pour que vos propres variantes du modèle soient prises en compte par le formulaire de personnalisation des balises, il faut créer un fichier YAML en plus du squelette HTML.
Ce fonctionnement est inspiré par celui du plugin Insérer Modèles : chaque fichier YAML décrit le modèle et ses paramètres, sous forme de saisies. La syntaxe est identique, avec toutefois 2 éléments supplémentaires :
-
alias
: nom de la variante -
description
: description de la variante (optionnelle)
Pour assurer la compatibilité avec le plugin cité plus haut, 4 paramètres sont obligatoires : modele
, id_modele
, id_album
et variante
.
Les 3 premiers étant identiques pour toutes les variantes, ils sont regroupés dans un fichier inc-yaml/album-compat.yaml qu’il suffit d’inclure.
Pour les saisies, une option supplémentaire config
permet d’avoir comme valeur par défaut un réglage stocké dans la table spip_meta
.
Dans l’idée, config:'truc'
revient à faire 'defaut'=>lire_config('truc')
en php.
Exemple : Imaginons un plugin fournissant une variante « diaporama ».
Ce modèle accepterait entre autre un paramètre vitesse
dont la valeur par défaut serait enregistrée dans une méta du plugin. Le squelette HTML serait nommé album_diaporama.html et le fichier YAML album_diaporama.yaml.
Ce dernier ressemblerait à ça :
nom: 'un album (diaporama)'
logo: 'prive/themes/spip/images/album-24.png'
icone_barre: 'album-diaporama.png'
alias: 'Diaporama'
parametres:
- 'inclure:inc-yaml/album-compat.yaml'
-
saisie: 'hidden'
options:
nom: 'variante'
defaut: 'diaporama'
-
saisie: 'input'
options:
nom: 'vitesse'
config: 'plugin/vitesse'
- le reste des saisies...
En cas de doute, vous pouvez prendre la variante « liste » comme référence.
Albumothèque
L’albumothèque est l’équivalent de la médiathèque, pour les albums.
Les filtres situés dans la colonne de gauche sont prévus pour sélectionner les albums en fonction de leurs documents et de leurs liaisons avec les objets : articles, auteurs, mots-clés etc. Attention, il ne s’agit pas de menus, mais bien de filtres : un clic pour activer, un autre pour désactiver.
Des champs avec autocomplétion permettent de trouver un objet précis.
Par exemple, pour afficher les albums liés à un article en particulier, il faut cliquer sur l’icône à droite du filtre « articles », puis rentrer les premières lettres du titre ou son numéro : les articles correspondants vont apparaître dans une liste déroulante, cliquer sur un résultat va mettre à jour la liste des albums.
La fontion d’autocomplétion ne va chercher que les objets ayant un lien avec les albums.
Déplacer des documents entre albums par cliquer-glisser
Il est possible de déplacer les documents entre albums par cliquer-glisser. L’option doit être activée dans la page de configuration, et vous devez y avoir l’autorisation.
Gardez en tête qu’il s’agit d’une fonctionnalité un peu expérimentale !
Lorsqu’on entame le déplacement d’un document, les albums pouvant recevoir celui-ci sont surlignés d’une bordure verte, il suffit d’y relacher le document. Dès qu’un document à été déplacé, un formulaire apparaît en bas de la liste pour enregistrer les modifications. On peut cependant effectuer plusieurs déplacement d’affilée avant de les enregistrer.
Notez qu’il est possible de manipuler également les documents « individuels » liés aux objets.
Boucles & critères
⇒ Critère {orphelins}
Le critère {orphelins}
permet de sélectionner les albums sans lien avec un objet éditorial (on qualifiait ces albums « d’autonomes » plus haut).
⇒ Jointures
Les albums ont une jointure automatique pour tous les objets (cf. déclaration de la base).
Dès qu’un qu’un id_xxx
est présent dans l’environnement, on peut donc sélectionner les albums liés à l’objet sans avoir à faire de jointure explicite avec la table de liens :
<BOUCLE_albums(ALBUMS){id_xxx}>
Attention, pour {id_auteur}
, le comportement est différent :
-
<BOUCLE_albums(ALBUMS){id_auteur}>
sélectionne les albums de l’auteur (d’après la table spip_auteurs_liens). -
<BOUCLE_albums(ALBUMS){objet=auteur}{id_objet=#ID_AUTEUR}>
sélectionne les albums liés à l’auteur (d’après la table spip_albums_liens).
⇒ Sélectionner les albums en fonction de leurs documents
En faisant une jointure avec la table spip_documents
, on peut utiliser certains critères des documents :
<BOUCLE_albums(ALBUMS documents){documents.critere=xxx}>
Quelques exemples avec les critères les plus utiles :
-
{documents.media IN image,audio}
: albums contenant des images ou des bandes-sons. -
{documents.id_document=x}
: albums contenant le document n°x. -
{documents.titre LIKE %truc%}
: albums contenant des documents dont le titre ou le nom de fichier comprend le terme « truc ». -
{documents.extension == mp3|ogg|oga}
: albums contenant des fichiers mp3 ou ogg audio. -
{documents.taille > 1000000}
: albums contenant des documents d’une taille supérieure à 1Mo [2].
Autorisations
Voici comment sont définies certaines autorisations particulières (les administrateurs complets peuvent tout faire).
- Modifier un album : il faut être auteur de l’album et avoir le droit de modifier tous les objets auquel l’album est lié.
- Ajouter un album à un objet : il faut que l’objet soit activé dans les options, et avoir le droit de le modifier.
- Déplacer des documents entre albums : il faut que l’option soit activée, et dans le contexte d’un objet, avoir le droit de modifier tous les albums liés.
- Supprimer un album : il faut qu’il soit vide, inutilisé et non publié.
Rétro-compatibilité
Modèles
La syntaxe de la version 1, qui avait disparu de la version 2, est à nouveau supportée dans cette version : <album|id_article=x> et <album|id=x,y,z>
La structure du modèle de base a changé, afin notamment de respecter l’usage des balises <figure> et <figcaption> en HTML5.
Visuellement, quelques altérations ont eu lieu :
- par défaut, les titres sont cachés.
- le titre et le descriptif du modèle de base passent en bas.
Changement de quelques paramètres :
- vignettes & liste : titraille
est supprimé
- vignettes & liste : balise_titraille
est déprécié au profit de balise_titre
- liste : infos
est déprécié au profit de metas
Divers
- Le critère {contenu}
apparu dans la version 2 est supprimé : on peut utiliser à la place le critère {documents.media == x}
avec une jointure (ALBUMS documents) pour un résultat similaire.
Voir la section sur les jointures.
Paramétrage fin par les constantes
- Constante _ALBUMS_TITRE_COURT : si vous insérez define('_ALBUMS_TITRE_COURT','oui');
dans votre mes_options.php, le titre des images sous les images sera réduit à leur titre et n’incluera pas les indications techniques.
Discussions par date d’activité
95 discussions
Bonjour,
La version proposée en téléchargement est la 3.5.1 qui « n’est pas compatible » SPIP 3.2 mais apparemment la dernière version 3.5.3 (Revision 106863 : _plugins_/albums/trunk/paquet.xml) est compatible
Je ne vois aucune mise à jour dispo dans la Gestion des plugins ...normal ?
Pour une fois le zip ne suivait pas le trunk, mais un tag. D’où le blocage.
Le nouveau zip sur le trunk devrait être disponible prochainement.
@tcharlss : je me suis permis de rebrancher sur le trunk, cf mon message en https://zone.spip.org/trac/spip-zone/changeset/107017
merci !
Répondre à ce message
Bonjour,
Je n’arrive pas à faire apparaitre un album dans un article sur ce site en construction :
http://www.tikellid.infini.fr/
Il y a bien dans l’article :
http://www.tikellid.infini.fr/Nos-reunions
un appel <album12> mais l’affichage ne fonctionne pas autant dans le site privé que public.
Merci de m’orienter vers la solution, car je cale sur la résolution de ce problème.
- SPIP 3.1.6
- Albums 3.5.1
- Court-circuit 2.5.0
- Formulaire de contact avancé 0.16.1
- Le Couteau Suisse 1.9.13
- Pages 1.3.7
- ...
Répondre à ce message
Bonjour,
Je suis sous spip 3.1.16 avec escalV3.87.15, albums3 3.5.1 et nivo slider 3.2.7
J’ai de gros soucis d’affichage des photos dû à l’orientation portrait ou paysage. C’est soit l’un soit l’autre et les images sont du coup tronquées.
Y-a-t-il un moyen d’adapter l’affichage pour que chaque images s’affichent correctement ?
Merci d’avance
Répondre à ce message
Alors voila, je suis sur spip 3.1.5
Et j’ai la dernière version du plugin album.
Quand dans un article je veux choisir un album... il ne me les propose pas tous (j’ai vérifier qu’ils sont bien publiés) et quand je le mets manuellement (<album2>) les images s’ouvrent en changeant de page ! Et non plus en lopin.
Bref plus rien ne fonctionne !
Quelqu’un a une idée ?
En fait le mediabox ne fonctionne plus non plus !
C’est la panique !
Dans le premier message le correcteur m’a écris lopin à la place popin !
Sinon, j’ai regardé dans les low apache (au cas ou) et dans le débuggeur Firefox.
Pas d’erreur ni dans l’un ni dans l’autre.
J’ai vérifié que mes images sont bien dans le portfolio (j’avais eu le problème une fois)... elles y sont.
Dans l’interface privé, dans un article si je clique sur une image elle s’ouvre aussi dans une page alors que si je clique sur le modifier d’une image, j’ai bien un popin qui s’ouvre.
Bref, je ne sais pas trop où chercher... et c’est vraiment (pardonner l’expression) la merde !
Ah oui, je suis passé sur SPIP 3.1.6 et ça ne change rien, et je ne peux pas changer le plugin puisque la version antérieure en téléchargement est pour spip 3.0
Bon... Voilà.
Il a fallut remplacer
par
Puisque les image dans le cas d’un album sont dans des
et dans le cas du portfolio dans des Donc tout est rentré dans l’ordre... mais c’était le flip !Répondre à ce message
Bonjour
Comme tout le monde le dit, merci pour ce plugin !
Je cherche le fichier qui paramètre le pop-in d’agrandissement des images pour supprimer le type du fichier image, son poids et sa taille en pixel et ne laisser apparaître que le titre du fichier. Autrement dit qu’il ne reste dans l’agrandissement que « ma belle image » et plus - JPGE - 54ko - 100x100px
Dans le fichier modele/album_liste, il y a bien une ligne :
Mais je ne suis pas sur que ce soit là et surtout, il y a une tel imbrication d’accolade et de cricket que j’ai peur de faire une boulette pour essayer d’arriver à ce que je cherche.
Si quelqu’un sait ou je peux faire ma manipulation... merci d’avance.
Denis
Bonjour,
Merci pour la remarque et oui, dans les modèles des albums, c’est un peu la soupe, je le concède !
De mémoire la popup prend l’attribut
title
des images, donc il faut le changer dans le modèle.C’est à cette ligne : https://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/modeles/album_liste.html#L120
Mais il y a plus simple : une option a été ajoutée pour afficher justement un titre court, sans avoir à surcharger le modèle.
Dans ton fichier mes_options.php, ajoute ceci :
N’hésite pas à faire un retour si ça ne fonctionne pas, je n’ai pas encore testé cette option.
Bonjour
Et merci pour la réponse. La solution dans le fichier mes_options fonctionne, par contre, vider le cache ne suffit pas il faut vider le dossier tmp.
Merci pour ton aide ? C’est vraiment sympa.
Amicalement
Denis
Répondre à ce message
Bonjour,
Quelqu’un a-t-il déjà essayé l’affichage d’Albums avec des objets vidéos « issus de youtube » ?
Avec un album composé exclusivement de « documents vidéos » issus de youtube et viméo, j’ai besoin de vos conseils pour les afficher correctement.
Ces « documents vidéos » sont d’habitude incorporés individuellement par le Plugin-Video-s, et cela fonctionne parfaitement.
Pour faciliter le choix des lecteurs, j’essaye de regrouper sur une page, plusieurs de ces « documents vidéos » avec :
En fait, cela ne recadre aucunement les dimensions d’affichage.
Comment faire ?
Quand je choisis de les afficher en liste avec
Les documents sont bien listés, mais les liens aboutissent à une page 404.
Quand j’incorpore individuellement dans un tableau spip, chaque « document vidéo » par le Plugin-Video-s, le recadrage fonctionne parfaitement, exemple dans le tableau des finalistes
Merci de vos solutions
Bonjour,
Désolé de répondre si tard.
Alors concernant les dimensions d’affichage, les paramètres
largeur
ethauteur
servent à recadrer physiquement les images, donc ils n’ont aucune incidence sur les vidéos effectivement.Ensuite, le plugin que tu mentionnes utilises un modèle bien spécifique pour afficher les vidéos, donc la meilleur solution c’est de faire une variante du modèle des albums. Dans les grandes lignes :
modeles/albums_videos.html
<albumN|video>
<INCLURE{fond=modeles/video, id_document}>
(plus les autres paramètres nécessaires éventuellement, voir la doc de vidéos)Grand merci pour les précisions de la réponse qui arrive parfaitement.
Il est bon de garder confiance, et ne pas être « désolé ». Dans certaines zones terrestres, les facteurs doivent chausser des raquettes pour calmement apporter le courrier malgré le blizzard et les hauteurs de neige.
Les destinataires de courriers que nous sommes, sont très contents, même si le courrier met plusieurs semaines pour traverser des vallées enneigées et les aléas de la vie.
:-))
Répondre à ce message
Lorsque je fais une recherche dans l’admin d’un site en SPIP 3.0.24 avec la dernière version du plugin albums j’ai ce message d’erreur :
Erreur SQL 1054
Unknown column ’L3.id_rubrique’ in ’field list’
SELECT albums.id_album, resultats.points AS points, ’’, albums.titre, albums.statut, L3.id_rubrique, albums.titre AS titre_rang, albums.date FROM spip_albums AS
albums
INNER JOIN spip_resultats AS resultats ON ( resultats.id = albums.id_album ) INNER JOIN spip_albums_liens AS L3 ON ( L3.id_album = albums.id_album ) WHERE (resultats.recherche=’2e6fe38264f29940’ AND resultats.table_objet=’albums’ AND resultats.serveur=’’) GROUP BY albums.id_album ORDER BY resultats.points DESC, albums.titre../plugins/auto/albums/v3.5.0/prive/objets/liste/albums.html _liste_album 7
dd
Hop, merci pour le retour, c’est corrigé dans la version 3.5.1 (le zip sera prêt plus tard aujourd’hui)
Répondre à ce message
Bonjour
Bravo pour ce plugin. Très utile.
Je suis en train de le tester mais je bute sur un pb : J’ai des titres de photo assez longs.
Quand je clique sur une vignette de l’album pour l’afficher en grand, le compte de la photo (1/3, 2/3, 3/3 ...) se retrouve affiché par dessus le titre...
Y a-t-il un moyen que ce décompte n’apparaisse pas ?
Merci d’avance pour votre réponse.
Répondre à ce message
Un petit message juste pour être tenu au courant des discussions sur ce plugin puisque je l’ai un peu modifié ces derniers jours
Merci pour ces ajouts en passant !
bah de rien, je risque d’utiliser ce plugin pas mal, environ 230 sites, donc merci à toi surtout pour le dev ;)
Répondre à ce message
Bonjour
Suite à une mise à jour de Spip (SPIP 3.1.2), lorsque je suis sur la page modifier un article (article_edit), les documents et images n’apparaissent plus. En faisant F5, ils apparaissent.
J’ai une erreur : Error : cannot call methods on sortable prior to initialization ; attempted to call method ’destroy’ .
Dans l’erreur il y a entre autre deplacerDocuments() qui se rapporte à écrire et il sort cette ligne $(« #albums .boite-album .liste_items,#portfolios .liste_items »).sortable(« destroy ») ;
En désactivant Albums (3.3.24) ou en ne cochant pas « Déplacement de documents entre albums par cliquer-glisser » , le problème ne se pose plus.
Merci
Bonjour,
Merci pour le retour. J’ai effectivement reproduit le problème chez moi, ça devrait être réglé dans la prochaine version (3.3.25)
Bonjour et merci tcharlss, ton plugin est bien pratique :)
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 :
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 : |