La fonction vidéo vous permet d’embarquer des fichiers vidéo et de les lire à l’aide d’un simple code court. Cette fonctionnalité a été ajoutée à partir de WordPress 3.6 et elle est utilisée ainsi :
[video]
Vous pouvez également saisir l’URL du média sur une nouvelle ligne et elle sera automatiquement transformée en contenu embarqué :
Mon contenu vidéo sympa
https://my.movies.com/video/film/sympa.mp4
Plus de contenu sympa
Cas d’usage
J’ai une ancienne publication à laquelle est attaché un fichier vidéo se trouvant dans la médiathèque et je souhaite utiliser le code court pour afficher cette vidéo sur mon site :
[video]
J’ai l’URL d’un fichier MP4
présent dans la médiathèque ou externe au site et je veux le rendre lisible sur mon site :
[video src="video-source.mp4"]
J’ai l’URL d’un fichier vidéo dans les différents formats de fichier supportés par HTML5 :
[video mp4="source.mp4" ogv="source.ogv" webm="source.webm"]
Options
Les options suivantes sont prises en charge :
src
(chaîne (en anglais)) (optionnel) – Le fichier source de votre vidéo. Si la source n’est pas incluse, le premier fichier vidéo joint à la publication sera utilisé. Vous pouvez utiliser les options suivantes pour définir des formats de fichier supplémentaires destinés à fournir une solution de secours lorsque le format principal n’est pas reconnu :
« mp4
», « m4v
», « webm
», « ogv
», « wmv
», « flv ».
Par défaut : le premier fichier vidéo joint à la publication.
poster
(chaîne (en anglais)) (optionnel) – Permet de définir l’image par défaut avant que la vidéo ne démarre.
https://www.exemple.org/wp-content/uploads/image.jpg
Par défaut : aucune.
loop
(chaîne (en anglais)) (optionnel) – Permet la lecture en boucle de la vidéo.
« off
» – La lecture ne boucle pas.
« on
» – La lecture se fait en boucle sans discontinuer.
Par défaut : « off
».
autoplay
(chaîne (en anglais)) (optionnel) – Démarre automatiquement la lecture de la vidéo dès que le fichier est chargé.
« off » – Ne démarre pas automatiquement.
« on
» – Démarre la lecture dès que le fichier est disponible.
Par défaut : « off
».
preload
(chaîne (en anglais)) (optionnel) – Spécifie si la vidéo doit être chargée durant le chargement de la page, et comment.
« metadata
» – Seules les métadonnées doivent être chargées en même temps que la page.
« none
» – La vidéo ne doit pas être chargée lors du chargement de la page.
« auto
» – La vidéo doit être entièrement chargée lorsque la page se charge.
Par défaut : « metadata
».
width
(entier (en anglais)) (obligatoire) – Définit la largeur de la vidéo. La valeur est automatiquement détectée lors du téléversement dans la médiathèque.
Par défaut : largeur du média.
height
(entier (en anglais)) (obligatoire) – Définit la hauteur de la vidéo. La valeur est automatiquement détectée lors du téléversement dans la médiathèque.
Par défaut : hauteur du média.
Exemple utilisant toutes les options :
[video mp4="video.mp4" ogv="video.ogv" webm="video.webm" poster="image.jpg" loop="on" autoplay="on" preload="metadata" width="640" height="360"]
Articles en relation
Codes courts WordPress : audio, caption (en anglais), embed (en anglais), gallery (en anglais), playlist (en anglais)
Traduit par Loïc Antignac
Relu par Jb Audras & Jenny Dupuy
Dernière mise à jour le 18 octobre 2021