Un plugin qui tire parti d’une nouvelle possibilité offerte par la nouvelle version 2.9 de Dotclear qui permet de définir des médias comme étant liés à des billets, autrement que par le biais des pièces jointes.
Du coup, et c’était une demande récurrente depuis quelques temps par ceux qui conçoivent sites et thèmes avec Dotclear, il devient possible de définir une image à la une et par extension un média à la une à l’aide de ce plugin.
La sélection du média à la une (« featured media » en anglais) se fait de la même manière que les pièces jointes pour les billets et les pages, a priori juste dessous les annexes (à droite de la zone d’édition) :
Une fois le média choisi il apparait de la même façon que les éventuelles annexes :
Voilà pour la partie gestion.
En ce qui concerne l’affichage de ce média à la une, il vous faudra utiliser la ou les balises proposées par ce plugin pour gérer l’affichage de ce média. Voici un exemple de ce qui peut être fait :
<!-- # Featured media --> <tpl:FeaturedMedia> <div class="post-featured-media" id="featured-media-{{tpl:EntryID}}"> <tpl:FeaturedMediaIf is_audio="1"> {{tpl:include src="_audio_player.html"}} </tpl:FeaturedMediaIf> <tpl:FeaturedMediaIf is_video="1"> <tpl:FeaturedMediaIf is_flv="0"> {{tpl:include src="_video_player.html"}} {{tpl:else}} {{tpl:include src="_flv_player.html"}} </tpl:FeaturedMediaIf> </tpl:FeaturedMediaIf> <tpl:FeaturedMediaIf is_image="1"> <img src="{{tpl:FeaturedMediaImageURL size="m"}}" alt="{{tpl:FeaturedMediaTitle}}" /> </tpl:FeaturedMediaIf> </div> </tpl:FeaturedMedia>
Ça permet d’afficher le lecteur audio ou vidéo s’il s’agit respectivement d’un média sonore ou vidéo, sinon d’afficher l’image en taille medium.
Balises template
La liste des balises template mises à disposition est très similaire à celles utilisées pour les pièces jointes :
Bloc media à la une <tpl:FeaturedMedia>
<tpl:FeaturedMedia> … </tpl:FeaturedMedia>
Définit un bloc contenant le média à la une du billet ou de la page s’il est spécifié. Cette balise est obligatoire.
Bloc de test <tpl:FeaturedMediaIf>
<tpl:FeaturedMediaIf [operator="…"] [condition 1] [condition 2] … > … </tpl:FeatureMediaIf>
Avec les attributs suivants :
- operator=”&&”[1] (défaut) ou operator=”||”[2] : combine les conditions avec un et logique (toutes les conditions vraies valident l’ensemble, par défaut) ou un ou logique (au moins une des conditions vraies valide l’ensemble)
- is_image=”0” ou is_image=”1” : teste si le média est une image
- has_thumb=”0” ou has_thumb=”1” : teste si le média a une miniature carrée (square)
- has_size=”sq|t|s|m|…” : teste si le média à une miniature de la taille demandée
- is_audio=”0” ou is_audio=”1” : teste si le média est un fichier sonore
- is_video=”0” ou is_video=”1” : teste si le média est un fichier vidéo (vidéo Flash comprise)
- is_mp3=”0” ou is_mp3=”1” : teste si le média est un fichier audio mp3 (utilisable avec le lecteur Flash)
- is_flv=”0” ou is_flv=”1” : teste si le média est un fichier vidéo flv (utilisable avec le lecteur Flash)
Vous pouvez si besoin utiliser une balise {{tpl:else}}
à l’intérieur du bloc pour traiter le cas où la condition n’est pas validée.
L’exemple en début de billet montre l’usage possible de certains de ces tests.
Valeur {{tpl:FeaturedMediaMimeType}}
Retourne le mime-type du média.
Valeur {{tpl:featuredMediaType}}
Retourne le type de média (“video”, “image”, “audio”, …).
Valeur {{tpl:featuredMediaFileName}}
Retourne le nom du fichier média.
Valeur {{tpl:featuredMediaSize [full=”1”] }}
Retourne la taille du fichier média. Si l’attribut full=”1” est spécifié alors la taille est retournée sous forme lisible (Ko, Mo, Go, …).
Valeur {{tpl:featuredMediaTitle}}
Retourne le titre du média.
Valeur {{tpl:featuredMediaThumbnailURL}}
Retourne l’URL de la miniature carrée (square) du média, si elle existe.
Valeur {{tpl:featuredMediaImageURL [size=”…”] }}
Retourne l’URL de la miniature à la taille demandée (sq, t, s, m, …), si size=”…” est spécifié et si elle existe, sinon l’URL du média original.
Valeur {{tpl:featuredMediaURL}}
Retourne l’URL du média.
Condition has_featured_media pour la balise <tpl:EntryIf>
Une nouvelle condition est ajoutée à la balise <tpl:EntryIf> qui permet de tester si l’entrée à un média à la une ou pas :
- has_featured_media=”0” ou has_featured_media=”1”
Exemple :
<tpl:EntryIf has_featured_media="1"> … </tpl:EntryIf>
Ce billet servira de support pour cette version du plugin.
1 De Philippe -
Vous en rêviez ? Franck l’a fait !
Merci tout plein :)
2 De i_love_dc -
bonjour Franck
Merci pour ce plugin topissime et merci à Philippe de me l’avoir fait découvrir.
Seul bémol (pour ma part)…
Il semblerait que l’ajout de class ne soit pas possible ???
exemple :
<img src="<<tpl:FeaturedMediaImageURL class"ma-class-englobant-limage" size="m">>" alt="tpl:FeaturedMediaTitle" />
la class n’apparait jamais dans le source car le code semble se “nettoyer”.
y a t’il quelque chose que j’aurai mal fait ou est-ce impossible de donner une class supplémentaire a ce code ?
Voir ma question et un peu plus de détail sur le forum dotclear à ce propos.
http://forum.dotclear.org/viewtopic…
3 De Franck -
i_love_dc qu’est-ce que fiche l’attribut class dans la balise tpl:FeaturedMediaImageURL ?
4 De Noé Cendrier -
Peau neuve
Il était plus que temps. Après 10 ans de bons et loyaux services, le thème bleu qui étrenna mon domaine à moi a vécu. Pour les nostalgiques qui veulent se rappeler à quoi ça ressemblait, vous pouvez croquer ce champi cliquer sur ce lien – et revenir au...
5 De Noé -
Coucou,
j’utilise avec joie ce plugin sur mon beau site rhabillé (pour l’hiver). Y aurait-il moyen de bricoler pour que, si présent et si image, ce soit le média de une qui s’affiche par Social meta ?
Et, apparemment, le média de une compte comme une annexe, un peu confusant dans la liste des billets…
Merci, en tout cas, j’adore cette fonctionnalité \o/
6 De Franck -
Alors oui, le média (ou les médias d’ailleurs) attaché(s) au titre de ce plugin sont effectivement des annexes, d’un type particulier. Qu’ils soient pris en compte dans le calcul du nombre d’annexes est du coup plutôt normal.
Cela dit, ça vaudrait le coup que je me penche la-dessus pour pouvoir paramétrer, d’une part, ce comptage (du genre oui/non) et d’autre part que je regarde l’option que tu souhaites.
À suivre donc…
7 De Noé -
Merci à toi, et si je peux aider, tu me dis 😉
8 De Franck -
Bon en relisant tes demandes Noé je vois que la première a été aussi demandée par Tomek et que j’ai intégré ça dans les dernières versions de socialMeta et featuredMedia.
Je vais jeter un œil à cette histoire de compteur :-)
9 De Franck -
C’est étrange parce que normalement la distinction entre types de fichiers attachés (attachements et featured) est censée être faite.
Sauf qu’à te relire, je me demande si tu parles de l’affichage public du blog où plutôt de la liste des billets dans l’administration !