Mosaïque

Dépendances

Ce plugin nécessite les plugins Champs extra et Saisies pour fonctionner.

Utilisation

Le plugin Mosaïque ajoute un lien « Trier les images du portfolio » sur la page d’édition des articles (bouton « Modifier cet article ») dont le portfolio contient au moins deux images.

Ce lien ouvre une popup qui présente les images (jpg, png et gif) du portfolio de l’article dans une mosaïque. On peut ordonner les vignettes de la mosaïque par simple glisser-déposer.

Lorsque l’ordre est déterminé, un clic sur « Enregistrer » ferme la popup, et un message informe le rédacteur qu’il doit encore enregistrer l’article pour que l’ordre des vignettes soit sauvegardé dans la base.

Affichage de la mosaïque

Il y a plusieurs moyens d’afficher la mosaïque :

Avec les squelettes de la dist
Le squelette de la dist inclure/documents.html est surchargé par le plugin pour prendre en compte l’ordre de la mosaïque. Sur les sites qui utilisent les squelettes par défaut, l’affichage de la mosaïque fonctionne donc sans modification supplémentaire.

Par les modèles
Le plugin introduit également deux modèles spécifiques :

• <articleXXX|mosaique> permet d’afficher la mosaïque de l’article XXX.
• <ordre_mosaique|id_article=XXX> retourne l’ordre des id des images de la mosaïque de l’article XXX, séparés par des virgules : 35,2,56,1,etc.

Utilisation dans les squelettes
Pour récupérer l’ordre d’une mosaïque dans une boucle DOCUMENTS, on utilise la méthode suivante (dans un contexte où l’id_article est défini) :

<BOUCLE_exemple(DOCUMENTS) {id_document IN #MODELE{ordre_mosaique,id_article}|explode{','}}>
[...]
</BOUCLE_exemple>

Remarquons qu’aucun critère de tri (critères {par ...} ou {tri ...}) ne doit être précisé dans la boucle.
De même, on veillera à n’insérer les autres éventuels critères qu’après l’appel d’ordre_mosaique dans les critères :

<BOUCLE_exemple(DOCUMENTS) {id_document IN #MODELE{ordre_mosaique,id_article}|explode{','}} {extension IN jpg,gif} {titre=='bob'} {','}>

Remarque concernant le fonctionnement

L’ordre de la mosaïque est conservé dans un champ extra mosaique de la table spip_articles.
Il existe donc une balise #MOSAIQUE utilisable dans le contexte des boucles ARTICLES. Cependant l’utilisation de cette balise est à proscrire, car elle contient le dernier ordre défini par le rédacteur et ne tient pas compte des éventuels ajouts (ou suppressions) ultérieurs d’images dans le portfolio. Dans 99% des cas on préférera donc la méthode décrite ci-dessus pour récupérer l’ordre de la mosaïque dans les squelettes.

Développements possibles

On peut imaginer deux principaux axes de développement de ce plugin :

• Le principe pourrait être généralisé aux objets d’une rubrique (articles, brèves, documents...), ce qui permettrait de se passer de la traditionnelle numérotation (parfois laborieuse) des objets par leur titre.
• Dans la perspective du développement d’un nouvel objet éditorial « album », le principe pourrait être retenu afin que l’album prenne en compte la notion d’ordre, et ce de manière intuitive pour le rédacteur.

Migrer vers Ordoc

Le plugin Mosaïque est déprécié, il est préférable d’utiliser le plugin Ordoc : ordonner les documents attachés qui offre une interface plus moderne pour gérer la position des documents sur un article.

Il existe un plugin de migration Migration de Mosaïque vers Ordoc.