Utiliser oEmbed pour l'intégration de contenu
oEmbed est un système standard permettant d'intégrer automatiquement des contenus (interactifs) entre des systèmes/des sites web.
Les systèmes cibles typiques qui supportent oEmbed sont par exemple :
- Wordpress
- Typo3 (via Extension)
- Drupal (via Extension)
En savoir plus sur oEmbed: https://oembed.com/
Fonctionnement technique
La page source correspondante (par ex. une page de détail d'une vue unique/d'un média d'edu-sharing) met à disposition des informations dans l'en-tête, via lesquelles un logiciel client compatible avec oEmbed reçoit des informations pour l'intégration.
<link rel="alternate" type="application/json+oembed" href="http://localhost/edu-sharing/eduservlet/oembed?format=json&url=http%3A%2F%2Flocalhost%2Fedu-sharing%2Fcomponents%2Frender%2F0424bf6d-06b4-41ee-a51f-cb397dfd8f5a%3FrepositoryFilter%3Denterprise-7-0%2Centerprise-8-0%26mdsExtended%3Dfalse%26sidenav%3Dfalse%26materialsSortBy%3Dscore%26materialsSortAscending%3Dfalse%26fromLogin%3Dtrue%26fromLogin%3Dtrue">
<link rel="alternate" type="text/xml+oembed" href="https://localhost/edu-sharing/eduservlet/oembed?format=xml&url=https%3A%2F%2Flocalhost%2Fedu-sharing%2Fcomponents%2Frender%2F0424bf6d-06b4-41ee-a51f-cb397dfd8f5a%3FrepositoryFilter%3Denterprise-7-0%2Centerprise-8-0%26mdsExtended%3Dfalse%26sidenav%3Dfalse%26materialsSortBy%3Dscore%26materialsSortAscending%3Dfalse%26fromLogin%3Dtrue%26fromLogin%3Dtrue">
{
"type":"photo",
"version":"1.0",
"title":"48587785276_ed55ee8d1a_b.jpg",
"author_name":"Administrator ",
"provider_url":"https://localhost/edu-sharing",
"thumbnail_url":"https://localhost/edu-sharing/preview?nodeId\u003d0424bf6d-06b4-41ee-a51f-cb397dfd8f5a\u0026storeProtocol\u003dworkspace\u0026storeId\u003dSpacesStore\u0026dontcache\u003d1679574611667\u0026crop\u003dtrue\u0026maxWidth\u003d500\u0026maxHeight\u003d333",
"thumbnail_width":500,
"thumbnail_height":333,
"url":"https://localhost/edu-sharing/preview?nodeId\u003d0424bf6d-06b4-41ee-a51f-cb397dfd8f5a\u0026storeProtocol\u003dworkspace\u0026storeId\u003dSpacesStore\u0026dontcache\u003d1679574611387",
"html":"\u003ciframe width\u003d\"700\" height\u003d\"467\" src\u003d\"https://localhost/edu-sharing/eduservlet/render?node_id\u003d0424bf6d-06b4-41ee-a51f-cb397dfd8f5a\" frameborder\u003d\"0\" allow\u003d\"accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture\"\u003e\u003c/iframe\u003e",
"width":700,
"height":467
}
Sur la base de ces données, le système cible peut intégrer de manière entièrement automatique le média sous forme d'IFrame via le code HTML.
Utilisation
L'utilisation dépend du logiciel client. Dans ce qui suit, nous utilisons Wordpress comme exemple :
- Naviguez dans le système cible (Wordpress) jusqu'à la page où vous souhaitez intégrer le contenu.
- Ouvrez le contenu que vous souhaitez intégrer dans le système de edu sharing dans la fenêtre individuelle.
- Attention ! Le contenu sélectionné doit être partagé publiquement
- Copiez l'URL du navigateur depuis la page edu-sharing
- Insérez l'URL dans le système cible
- Après quelques instants, le système reconnaît l'information et le contenu est automatiquement intégré.
Remarques et restrictions
- oEmbed ne fonctionne que pour les ressources partagées et les instances edu-sharing avec accès invité.
- Les accès via oEmbed sont tracés comme des accès "normaux", il n'y a pas de distinction dans le tracking.
edu-sharing ne reçoit aucune information relative aux sites ou systèmes dans lesquels les contenus ont été intégrés via oEmbed