Via code d’embed classique
Sur la page d’un média compatible, un lien "Intégrer ce média +" devrait être présent.
Au clic sur ce lien, l’utilisateur n’est pas redirigé vers une autre page mais un bloc doit s’ouvrir contenant un formulaire proposant :
- le code d’export par défaut ;
- un champ largeur (pour modifier la largeur en fonction du site où
il souhaite intégrer le média) ; - un champ hauteur (pour modifier la hauteur en fonction du site où
il souhaite intégrer le média) [2] ; - si le plugin MediaBox n’est pas désactivé dans l’espace public (cette extension est activée par défaut), un lien "Prévisualiser le rendu" permet d’ouvrir dans une simili popup le contenu du code d’embed afin de prévisualiser le résultat ;
Si l’utilisateur modifie un de ces paramètres (hauteur ou largeur), il lui est nécessaire de valider le formulaire qui mettra alors à jour le contenu du code d’export.
Il a ensuite la possibilité de copier ce code d’export afin de le coller dans le site externe. Si le plugin "Zeroclipboard" est activé, un lien "Copier" est ajouté au niveau du textarea du code afin de le disposer directement dans son presse papier.
Il lui suffit alors de coller ce contenu dans son autre site pour voir s’afficher le média.
NB : l’export de médias de type vidéo et son n’est possible qu’avec un lecteur flash dans l’immédiat.
Exemple du formulaire de code d’embed :
4 notes sont associées à l’image. Survolez l’image pour afficher les notes.
Via Oembed
oEmbed est un format permettant d’intégrer une représentation d’une URL sur des sites tiers. L’API, simple, permet à un site web d’afficher le contenu intégré (comme des photos ou des vidéos) lorsqu’un utilisateur poste le lien de cette ressource, sans avoir à analyser directement la ressource.
Si le plugin oEmbed est activé sur le MediaSPIP, les liens vers ce format sont ajoutés en entête des pages de médias, invisibles par l’humain mais lisibles par les sites distants.
De nombreuses extensions de CMS (SPIP, Wordpress, Drupal...) existent afin d’utiliser ce format pour afficher les ressources. En général il est nécessaire d’autoriser l’affichage des données d’un site particulier si celui-ci n’est pas une grande plateforme reconnue (type YouTube, Dailymotion ou autre Flickr...).
Vous pouvez tester les ressources via ce proxy oEmbed.
Exemples :
Prenons l’exemple de ce média.
Il est possible de visualiser le rendu sur le proxy oEmbed de Nursit via ce lien.
Dans un article SPIP normal comme celui de cette documentation, si le plugin oEmbed est activé, il suffit d’y écrire l’Url de la page du média pour qu’elle se transforme en lecteur [3] :
Sur les réseaux sociaux
Avant toute chose, pour une intégration complète des sons et vidéos sur les réseaux sociaux type Facebook ou Twitter il est nécessaire que le site soit navigable via une connexion sécurisée https.
Dans le cas contraire ces sites n’afficheront que la vignette de ces médias et non la possibilité de les lire sur leur propre plateforme.
Chaque page de média contient normalement les éléments nécessaires à ces sites pour les intégrer.
Via podcasts
MediaSPIP dispose d’un plugin de podcasts qui n’est pas activé par défaut.
Voir la documentation du plugin en question pour en savoir plus.