L’objet collection
Le plugin crée un nouvel objet "collection" qui est un conteneur comme l’est une "rubrique" pouvant accepter comme éléments des medias créés avec le plugin emballe medias.
Ce nouvel objet SPIP dispose des champs suivant :
-
id_admin(id_auteur de la personne créant la collection, il est considéré comme administrateur de la collection et est le seul à pouvoir en modifier les caractéristiques) ; -
titre; -
descriptif; -
type_collection(appelé "Usage" également) ; -
genre; -
statut;
Les usages
Deux types d’usage sont disponibles, le choix de l’usage est réalisé dans le formulaire d’édition de la collection :
- "collection personnelle", où seuls les auteurs associés à cette collection peuvent ajouter des médias à l’album ;
- "collection collaborative", n’importe quel auteur identifié peut ajouter des éléments à l’album ;
Les genres
Quatre genres prédéfinis de collection sont disponibles en fonction du type de médias acceptés :
- Mix, tous les types de médias peuvent être ajoutés à la collection ;
- Images, seules les images sont acceptées, utile pour faire des albums photos ou des albums d’icônes ;
- Son, seuls les documents audios sont acceptés, utile pour mettre en ligne un album musical ;
- Video, seuls les documents vidéos sont acceptés, utile pour mettre en ligne une série documentaire par exemple ;
Edition de collections
L’édition normale
L’édition de collections se passe en deux étapes :
- la création et l’édition du contenu propre à la collection (son titre, son descriptif...), dans un premier temps, avec l’utilisation d’un formulaire habituel comme pour tout autre objet SPIP (
#FORMULAIRE_EDITER_COLLECTION) ; - l’association ou dissociation de médias à la collection dans un second temps via un formulaire spécifique (
#FORMULAIRE_AJOUTER_MEDIA_COLLECTION) ; - après les deux étapes précédentes, vous avez une collection utilisable. Vous pouvez également associer un medias depuis sa propre page publique si le bouton d’ajout à une collection est inséré dans le squelette que vous utilisez ;
La création rapide
Un formulaire de création rapide est également mis à disposition #FORMULAIRE_CREER_COLLECTION_RAPIDE ne demandant que le titre d’une collection pour la créer automatiquement avec les options par défaut (collection personnelle mixte).
L’association rapide d’un média à une collection
Un formulaire / bouton #FORMULAIRE_ASSOCIER_MEDIA_COLLECTION permettant d’associer rapidement un média à une collection est également disponible. Il prend comme paramètre l’id_article du média, par exemple : #FORMULAIRE_ASSOCIER_MEDIA_COLLECTION{1}
Ce formulaire est caché au chargement de la page et est accessible par l’utilisateur via un bouton "Associer à une collection".
Au clic sur ce bouton le formulaire peut s’afficher de deux méthodes différentes :
- via mediabox si le plugin mediabox est activé et que l’option dans la configuration des collections l’empêchant n’est pas cochée ;
- insertion dans la page juste après le bouton si mediabox est désactivé ou son usage empêché ;
Ce formulaire ne présente qu’un seul select permettant de choisir à quelle collection ce média doit être ajouté.
Le select est composé de deux groupes de choix possibles ("optgroup") :
- la liste des collections de l’utilisateur en cours, toutes ses collections sont affichées, même celles auxquelles le média est déjà associé et celles dont le genre n’acceptera pas le média en cours (si on est sur un média vidéo et la collection n’accepte que des sons par exemple). Dans ces deux derniers cas, l’option du select sera grisée et non sélectionnable ;
- la liste des collections collaboratives qui n’appartiennent pas à l’auteur en cours. Dans ce cas seules les collections où l’on peut ajouter le média sont affichées ;
Après l’ajout du média à une collection, le formulaire recharge automatiquement la liste des collections liées au média si l’inclusion "inclure/collections_liees_media.html" est insérée dans la page avec l’option "ajax".
Intégration à MediaSPIP et autres plugins
Le plugin a été développé pour MediaSPIP au départ, il est donc intégré à 100%.
Cependant, comme ce n’est pas un plugin obligatoire, par défaut, MediaSPIP ne montre pas d’entrée directe de publication dans le menu idoine.
Pour permettre aux utilisateurs de publier des collections, il faut dans un premier temps activer/installer le plugin puis ajouter le masque de formulaire adéquat.
Ajouter le masque de formulaire des collections
Pour ce faire, allez dans l’administration du MediaSPIP via le bouton Administrer.
Puis, dans la barre de navigation, cliquez sur Configuration des masques de formulaires
De là, dans la partie basse de la page vous devriez avoir un lien pour créer un nouveau masque de formulaire de type "collection" sur lequel vous devez cliquer.
Remplissez le formulaire qui apparaitra en cochant la case "Figurer dans le menu public", ce qui affichera un lien direct de publication de collection dans le menu "Publier" habituel.
Les utilisateurs correspondant aux statuts choisis dans la configuration du masque pourront ainsi créer leurs propres collections.
Ajout rapide de collections
Le visiteur a également la possibilité de créer une collection en un click depuis :
- Le formulaire de la barre de navigation visible sur la page listant toutes les collections ;
- Sur sa page profil, dans le bloc "Modifier" de la navigation, l’utilisateur a accès à ses collections. S’il clique sur ce lien, il aura à disposition dans la colonne de navigation le formulaire de création rapide de collection ;
À noter que ce formulaire crée une collection avec le titre fournit et les options par défaut, elle est également automatiquement publiée en ligne.
Association rapide d’un média à une collection
Sur chaque page de média, si l’utilisateur en cours est identifié et a créé ou participe à une ou plusieurs collections, le bouton "Associer à une collection" est affiché, permettant de sélectionner à quelle collection on souhaite lier le média.
Syndiquer le contenu du site lié à cette rubrique
