Version 21 — Juillet 2014 — flouvel
ALBUMS V2 EST ENCORE EN DÉVELOPPEMENT !
Cette page fait office de documentation provisoire en attendant la publication de l’article adéquat.
Téléchargement : http://files.spip.org/spip-zone/alb...
Les mise en garde d’usage s’appliquent : il est déconseillé d’installer cette version de développement sur un site en production, il peut rester quelques bugs et certaines options manquent ou sont susceptibles de changer.
Les rapports de bug, idées et contributions sont les bienvenus.
Les albums sont des objets éditoriaux que l’ont peut lier à n’importe quel autre objet, et auxquels on peut lier des documents.
Concrètement, ils servent à accueillir vos documents, que vous pouvez sélectionner, grouper et arranger comme bon vous semble. On peut ensuite les insérer au fil du texte, dans vos articles ou tout autre objet, ou les appeler dans vos squelettes indépendamment du contexte.
Une fois le plugin téléchargé et installé, rendez-vous dans la page de configuration pour définir sur quels objets associer les albums. Veillez également à vérifier que l’ajout de documents sur les albums est activé (page ’contenu du site’), ce qui doit normalement être le cas par défaut.
On peut créer un nouvel album soit par la barre d’ajout rapide, ou en se rendant directement sur un objet sur lequel l’ajout d’album est activé.
On peut y créer un nouvel album (sans quitter la page), ou bien choisir un album existant.
Dans le cas d’une création, une fois l’album enregistré, il ne reste plus qu’à lui ajouter des documents.
Les albums sont ’dépliables’, un clic sur le bloc permet de voir et éditer les documents.
Enfin, on peut inclure n’importe quel album (qu’il soit déjà lié à l’objet ou non) dans le texte au moyen de la balise
<albumXX>
ou
<albumXX|liste>
Il y a pour l’instant 2 type de vues : vue en mode ’aperçu’ ou en mode ’liste’.
Chaque plugin proposant une interaction avec les documents peut proposer son propre modèle album. Le plugin nivoslider dispose d’une ébauche de modèle <albumXX|nivoslider>
.
Un plugin ’albumorama’ proposant plusieurs modèles de diaporamas et galeries jquery pour les albums est en cours.
Par la suite, on peut également imaginer des playlists pour fichiers audio ou vidéos : <albumXX|dewplayer>
.
On dispose d’une boucle...
<BOUCLE_albums(ALBUMS){id_album=xx}{orphelin?}{...}>
...et des balises suivantes :
#TITRE, #DESCRIPTIF, #ID_ALBUM
La boucle ALBUMS accepte un critère {orphelin}
qui sélectionne les albums sans lien vers un autre objet éditorial.
Un autre critère {contenu}
est à faire, afin de pouvoir sélectionner les albums en fonction de leur type contenu.
ex :
{contenu = video}
-> albums avec des vidéos{contenu IN #ARRAY{audio,video}}
-> albums avec audio OU video{contenu}
-> albums non vides{!contenu}
-> albums videsPour palier à ce manque, on peut faire des sélections d’ids, en utilisant le critère {id_album IN #GET{selection}}
dans la boucle.
#SET{selection,#ARRAY}
#SET{media, file|audio}
<BOUCLE_id_contenus(spip_documents_liens spip_documents albums){media == image|audio}{objet = album}{tout}>
[(#GET{selection}|find{#ID_OBJET}|non) #SET{selection,#GET{selection}|push{#ID_OBJET}} ]
</BOUCLE_id_contenus>
Valéry (14/05/2013) : ne manque-t-il pas la notion de tri ? Le plugin Mosaïque la propose pour les portfoglio d’article mais uniquement en glisser / déposer (pas accessible). Une interface à base de flèches (monter / descendre) n’est-elle pas envisageable ?
François (18/08/2013) : <albumX|par num titre> permet de trier, mais si on veut que le doc D soit dans l’album X et dans l’album Y classé par num titre, pas d’autres solutions que de dupliquer le doc D ! en D1 et D2 avec num titre différent pour X et Y, ce qui est tout à fait gérable ! ;-)
François (02/12/2013) : pourrait-on lier un album à un album ? pour un sous album en quelque sorte.
Inconnu : J’arrive à éditer ce texte ! est- ce normal ?
Valéry (31/03/2014) : oui cette page est un wiki.
François (07/01/2014) (dommage que cette page soit pas simplement publiée sur contrib, c’est déjà suffisant comme doc !)
Pourquoi varchar(255) et non pas text pour le type du champ titre de la table _albums ? (cf mon message sur le plugin Fulltext. ) J’ai modifié, « titre » => « text DEFAULT ’’ NOT NULL », /*« (au lieu de varchar(255) DEFAULT ’’ NOT NULL »,*/ avec pour seul effet de rendre efficient la recherche dans l’espace privé sur les albums.
De même pour « statut », pourquoi 255 ? « varchar(10) DEFAULT ’0’ NOT NULL », au lieu de « varchar(255) DEFAULT ’’ NOT NULL », ?
Valéry (31/03/2014) : l’insertion de l’album dans l’article de désactive pas l’affichage des documents dans le portfoglio (critère
{vu = non}
ne semble pas pris en compte)
Éric(28/05/2014 : Pourrait-on ajouter une légende, titre, copyright et proposer des hyperliens, bien pratique par exemple pour des logos en bas d’article.