Voir la source de Afficher une vidéo Peertube dans une page mediaWiki

= Introduction =
Ce tutoriel est adapté à un système d'exploitation '''Linux (Ubuntu 22.04)'''. Mais, si vous utilisez Windows vous pourrez facilement faire quelques petites modifications pour votre système d'exploitation.

= Installer l'extension Iframe =

Depuis une console chargez l'archive de l''''extension Iframe''' :
 cd <chemin d'installation de mediawiki>/extensions/
 wget https://github.com/sigbertklinke/Iframe/archive/refs/heads/master.zip

Ensuite '''décompressez l'archive''' et supprimez-là :
 unzip master.zip
 rm master.zip

Le dossier de l'extension doit s'appeler Iframe. S'il le faut '''renommez'''-le. Par exemple :
 cd <chemin d'installation de mediawiki>/extensions/
 mv Iframe-master Iframe

'''Ajoutez ces lignes en bas du fichier  de configuration LocalSettings.php''' à la racine du  wiki  :
 $wgIframe = array();
 wfLoadExtension('Iframe');
 $wgIframe['width'] = 640; 
 $wgIframe['height'] = 400; 
Les deux dernières lignes sont respectivement les '''tailles horizontale''' et '''verticale''' de la vidéo en pixels dans la page. À vous de les définir.

On pourra ajouter '''plusieurs serveurs''' pour intégrer des pages web, des images, des vidéos. Chaque serveur sera défini ainsi sous la déclaration wfLoadExtension('Iframe') dans LocalSettings.php:
 <pre>$wgIframe['server']['maclef'] = [ 'scheme' => 'https', 'domain' => 'mondomain' ];</pre>
* '''server''' sera défini par une clé (maclef), un nom que vous choisirez.
* '''sheme''' est le protocole utilisé par le serveur, ici https
* '''domaine''' est le domaine d'où proviendra l'élément intégré.  

Si, par exemple, vous voulez intégrer des vidéos de l'instance https://peertube.stream/ ajoutez :

 <pre>$wgIframe['server']['peertube'] = [ 'scheme' => 'https', 'domain' => 'peertube.stream' ];</pre>

'''Source''' : https://www.mediawiki.org/wiki/Extension:Iframe

= Intégrer une vidéo dans une page mediawiki =

Maintenant que vous avez configuré l'extension, vous pouvez intégrer une vidéo Peertube dans une page de votre wiki.

'''Prenons par exemple l'intégration de la vidéo d'une Baudroie Abyssale''' qui se trouve à l'adresse : https://peertube.stream/w/nGywifTrwfKtSZMwFBPSPC
== Trouver l'URL utilisée pour intégrer une vidéo dans une page web ==
Allez '''à la page de la vidéo sur l'instance Peertube''' dans '''"Partager"''' puis '''"intégration"'''. Copiez le code d'intégration de la vidéo. Pour cet exemple ce code est :
 <pre>
 <iframe title="Baudroie Abyssale modélisée dans Blender" src="https://peertube.stream/videos/embed/afb9b48d-6f89-453b-addb-481d8160e2ba" allowfullscreen="" sandbox="allow- same-origin allow-scripts allow-popups" width="560" height="315" frameborder="0"></iframe>
 </pre>

Le code de la vidéo à intégrer : videos/embed/afb9b48d-6f89-453b-addb-481d8160e2ba, est différent du code de l'url de la vidéo directe : w/nGywifTrwfKtSZMwFBPSPC 

== Code d'intégration de la vidéo dans la page du wiki ==
Pour intégrer la vidéo Peertube dans la page écrire, on utilise le code de la vidéo à intégrer :
 <pre>
    <iframe key="peertube" path="videos/embed/afb9b48d-6f89-453b-addb-481d8160e2ba" />
 </pre>

* '''key'''  : est  la clé que vous avez définie dans la configuration du wiki.
* '''path''' : est le chemin de la vidéo à la racine du domaine. Attention, il ne faut pas ajouter de / au début de path.
* Si vous voulez permettre aux visiteurs d'afficher la vidéo plein écran,  ajoutez l'option '''allow="fullscreen"''' comme ceci :
 <pre>
    <iframe key="peertube" path="videos/embed/afb9b48d-6f89-453b-addb-481d8160e2ba" allow="fullscreen" />
 </pre>


'''La vidéo devrait s'afficher dans la page :'''
 <iframe key="peertube" path="videos/embed/afb9b48d-6f89-453b-addb-481d8160e2ba" allow="fullscreen"/>