Installation
Les modèles <media>
nécessitent que le plugin Médiathèque soit installé et activé.
Le plugin Insérer Modèles n’est pas obligatoire mais fortement recommandé afin de fournir une aide aux rédacteurs pour l’insertion des modèles <media>
.
Avertissement
La version 3.3 de SPIP a résolu la grande partie des problèmes auquel ce modèle répondaient. Le plugin est toutefois compatible 3.3 pour les raisons suivantes :
- permettre de ne pas avoir à migrer ses modèles ;
- continuer à disposer de certaines options non encore présente dans les modèles de SPIP.
Syntaxe générale
Trois variantes principales
Les modèles <media>
reposent sur trois variantes principales : icone, vignette et embed.
<media12|icone>
affichera l’icône représentant le type de document.
<media12|vignette>
affichera une vignette du document. Il s’agira dans l’ordre :
- de la vignette personnalisée associée au document si elle existe.
- d’une vignette générée automatiquement à partir du document. La vignette générée est indépendante de la configuration de SPIP (que l’on ait activé ou non les vignettes automatiques dans Configuration > Fonctions avancées). Enfin, la taille de la vignette n’est pas déterminée par le paramètre de SPIP concernant les vignettes automatiques mais par le paramètre
|taille
transmis au modèle (voir ci-après). - de l’icône du type de fichier si aucune vignette personnalisée n’est disponible et si aucune fonction de génération automatique de vignette n’est disponible pour ce type de fichier.
<media12|embed>
permet d’incruster le document, l’incrustation étant fonction du type du document.
Depuis la vesion 1.2.0, on peut utiliser <media12|insert>
, équivalent à <media12|embed>
[1].
Alignement
L’alignement se précise comme actuellement avec |left
, |center
et |right
.
Exemple : <media12|icone|right>
Afficher une légende
En l’absence de paramètres spécifiques, aucune légende n’est affichée.
Pour afficher une légende simple (titre + descriptif), on ajoutera simplement |legende
au modèle. Par exemple : <media12|vignette|legende>
.
Si l’on souhaite une légende complète (titre + descriptif + crédits + type de document + poids en octets), on indiquera |legende=complete
. Par exemple : <media12|vignette|legende=complete>
.
Il est également possible d’indiquer plus précisément les éléments qui devront composer la légende. Au lieu du paramètre |legende
, on aura alors recours aux paramètres |titre
, |descriptif
, |credits
, |type
et |poids
. Par exemple, si on souhaite afficher uniquement le titre et les crédits on fera : <media12|icone|titre|credits>
. Pour afficher seulement le type de document et son poids : <media12|icone|type|poids>
.
Il est possible de personnaliser le titre, le descriptif et les crédits à afficher pour utiliser d’autres valeurs que celles associées au document (utile par exemple sur un site multilingue). On précisera alors simplement à ces trois paramètres les valeurs à prendre. Par exemple :
<media12|icone
|titre=Un autre titre
|descriptif=Un autre descriptif avec du {{gras}}, de l'{italique} et même une note[[de bas de page]].
|credits=d'autres crédits>
On peut utilise les deux formes d’écritures. Pour afficher le titre du document, des crédits personnalisés et le poids du document : <media12|icone|titre|credits=autres crédits|poids>
. Si on souhaite afficher la légende complète en personnalisant juste le titre : <media12|icone|legende=complete|titre=Mon autre titre>
.
Ajouter un lien
Pour les variantes icone et vignette, un lien pointant sur le document sera ajouté par défaut. Pour la variante embed, en l’absence de paramètre lien
, aucun lien ne sera ajouté au média.
Pour que le média pointe sur lui-même, on ajoutera simplement |lien
. Il est possible de préciser un lien spécifique, par exemple <media12|icone|lien=http://www.monsite.net>
. On peut utiliser les raccourcis SPIP pour les liens internes. Par exemple, pour pointer sur la rubrique 3 : <media12|icone|lien=rub3>
.
Il est également possible d’utiliser la syntaxe suivante [<media12|icone>->rub3]
.
L’attribut title
du lien est déterminé automatiquement par SPIP en fonction du lien. Cependant, il est possible de spécifier explicitement l’attribut title
avec le paramètre |titre_lien
. Par exemple : <media12|icone|lien=http://www.monsite.net|titre_lien=Un super site à visiter>
.
Spécifier la taille
En l’absence de paramètres spécifiques, la taille du document sera utilisée (modifiable selon le type de fichier), notamment pour les vignettes.
Les modèles <media>
proposent 4 tailles standards : icone, petit, moyen et grand. Ces quatre tailles peuvent être personnalisées dans la Configuration de SPIP, sous l’onglet Fonctions avancées.
On spécifiera la taille souhaitée en utilisant le paramètre |taille
, par exemple : <media12|vignette|taille=petit>
. Il est également possible de spécifier une taille précise en pixels de la manière suivante : <media12|vignette|taille=150>
.
Les médias sont redimensionnés en respectant le ratio hauteur/largeur. Ainsi, |taille=150
redimensionnera le média de telle manière que son plus grand côté soit égal à 150 pixels.
Si on souhaite simplement spécifier une hauteur maximum de 150 pixels, on utilisera |hauteur=150
. Pour une largeur maximum de 300 pixels, |largeur=300
. On peut utiliser les deux paramètres en même temps : <media12|vignette|hauteur=150|largeur=300>
.
Personnaliser le texte alternatif
Il est possible de personnaliser le texte alternatif ajouté aux images et autres médias avec le paramètre |alt
. Par exemple : <media12|icone|alt=Texte alternatif sur l'icône>
.
Cas du modèle appelé sans variante
Il peut arriver que le modèle soit appelé sans spécifier de variante (exemple : <media12>
).
Le modèle n’est pas censé être appelé sans variante. Si cela arrive, la variante vignette sera utilisée. Mais cela n’est pas recommandé.
Aide à l’insertion des modèles
Afin de faciliter l’insertion des nouveaux modèles, ce plugin fournit un formulaire d’insertion utilisable avec le plugin Insérer Modèles. Si celui-ci est actif, alors une aide à l’insertion des modèles media sera disponible dans le porte-plume.
Discussions par date d’activité
12 discussions
Une petite suggestion (meme si elle va aux antipodes de « normes » spipiennes)
Rajouter une valeur de paramètre supplémentaire
|lien=_blank
, qui rajouterait à l’appel le paramètretarget="_blank"
Usage : avoir la possibilité de visualiser en pleine page une illustration (dans mon besoin précis, une carte à afficher de facon plus détaillée) sans quitter l’article en-cours.
Autre possibilité (que je n’ai pas sue trouver non plus) :
|lien=popup
facilité par le plugin du même nom...
Cdlt
Normalement, si tu as installé MediaBox, tu peux choisir d’insérer une popup sur toutes les images avec lien.
Répondre à ce message
Bonjour,
j’ai installé Modèles médias sur un SPIP 3.2.1 en local (MAMP) et tout allait très bien, mais depuis la mise en ligne, les filtres de taille (taille, largeur et hauteur) ne répondent plus... (sur appel des modèles à l’intérieur d’un article :
)
J’ai essayé avec les moteurs GD2 et IMAGICK, même résultat (GD et Imagick tous deux supportés chez Infomaniak).
En revanche, lors d’un test d’insertion de
ça fonctionne bien (mais je préfère tout de même utiliser Modèles média).
Auriez-vous des idées ? Je sèche complètement malgré les progrès que j’ai fait grâce à vous sur ces forums ^_^
Question toute bête, mais dans la configuration des fonctions avancées du site (
ecrire/?exec=configurer_avancees
) est-ce que l’option Générer les minitiatures des images est bien activée ?Je viens d’aller vérifier par acquis de conscience, mais oui, bien activé.
Bon... solution (?) trouvée, si ça peut dépanner d’autres personnes :
J’ai premièrement mis à jour SPIP (3.2.1 à 3.2.4),
j’ai rétrogradé le PHP du serveur de 7.2 à 7.1,
après avoir vidé le cache, j’ai constaté que ça fonctionnait,
à tout hasard, j’ai remis PHP 7.2, et j’ai constaté que ça fonctionnait toujours...
Je ne m’y connais pas suffisamment pour y trouver une raison rationnelle, mais ça marche =)
Merci pour ce plugin ! (comme pour tant d’autres)
Et bon week-end !
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 : |