Utilisateur:Momo50/boîte à outils/EmbedVideo
De Wikimanche
L'extension EmbedVideo ajoute une fonction d'analyseur appelée #ev
pour intégrer des clips vidéo de plus de 24 services de partage de vidéos populaires dans plusieurs langues et pays. Elle ajoute également des gestionnaires de médias vidéo et audio pour prendre en charge la transformation des fichiers standard [[File:Example.mp4]] dans les tags HTML5 intégrés <video> et <audio>.
- Page d'accueil du projet
- Documentation à Github
- Code Source
- code source à Github
- Bogues
- questions à Github
- Licence
- EmbedVideo est publié sous La licence MIT.
Remarque : Depuis la série 2.x l'extension EmbedVideo a un nouveau mainteneur et une base de code entièrement réécrite. Il conserve la compatibilité ascendante avec EmbedVideo 1.0 et EmbedVideoPlus.
Installation
- Télécharger et placer le(s) fichier(s) dans un répertoire appelé EmbedVideo dans votre dossier extensions /.
- Ajouter le code suivant au bas de votre LocalSettings.php:
WfLoadExtension ('EmbedVideo');
- Configuration requise
- Pour terminer - Naviguer vers Spécial:Version sur votre wiki pour vérifier que l'extension est installée avec succès.
Utilisation
Pour le contenu téléchargé localement, le processus pour l'afficher sur une page est identique à une image. Voir la documentation de syntaxe de l'image sur MediaWiki.org pour une référence complète sur cette fonctionnalité.
Cet exemple affichera une vidéo en page à l'aide d'une balise `<video>` HTML5.
[[Fichier:Exemple.mp4]]
Pour spécifier les horodateurs de début et de fin dans le support, utiliser les paramètres de début et de fin. L'horodatage peut être formaté comme suit : ss, :ss, mm:ss, hh:mm:ss, or dd:hh:mm:ss.
[[Fichier:Exemple.mp4|start=2|end=6]]
Balises
La fonction d'analyseur EmbedVideo s'attend à être appelée de l'une des façons suivantes :
#ev
- Balise classique du parseur
#ev - Tag du parser classique
{{#ev:service|id}}
{{#ev:service|id|dimensions}}
{{#ev:service|id|dimensions|alignement}}
{{#ev:service|id|dimensions|alignement|description}}
{{#ev:service|id|dimensions|alignement|description|conteneur}}
{{#ev:service|id|dimensions|alignement|description|conteneur|urlargs}}
{{#ev:service|id|dimensions|alignement|description|conteneur|urlargs|autoresize}}
Toutefois, les arguments optionnels nécessaires peuvent être laissés vides, ne rien mettre entre les pipes (|) :
{{#ev:service|id|||description}}
Balise du parser pour les modèles - #evt
La balise #evt de l'analyseur permet la clé=paires de valeurs qui permettent une modélisation et une lisibilité plus faciles.
{{#evt: service=youtube |id = https://www.youtube.com/watchv= pSsYTj9kCHE |alignment = right }}
Balise <embedvideo>
Les vidéos peuvent être facilement intégrées avec la balise <embedvideo></embedvideo>. L'ID/URL passe comme entrée entre les balises et les paramètres peuvent être ajoutés comme les arguments de balises.
<embedvideo service="youtube">https://www.youtube.com/watch?v=pSsYTj9kCHE </embedvideo>
Attributs pour les Balises
Attribut | La description |
---|---|
service = "(Voir les services pris en charge ci-dessous.)"
|
Requis : oui
|
id = "[id|url]"
|
Requis : oui
|
dimensions="[WIDTH|WIDTHxHEIGHT|hauteur d'x]"
|
Requis : non, Par défaut: 640
Exemples : 480, 480x320, x320. Si la hauteur est pas fournie, elle sera automatiquement calculée à partir du rapport par défaut largeur et service.
|
alignement="[left|center|right|inline]"
|
Requis : non, Par défaut : aucune
|
description="[texte wiki]"
|
Requis : non, Par défaut : aucune
|
container="[cadre]"
|
'Requis:' non, 'Par défaut:' aucune
|
urlargs="modestbranding=1 & version=3"
|
Requis : non, Par défaut :aucune
|
autoresize="false"
|
Requis : non, Par défaut : true
|
Exemples
Par exemple, une vidéo de YouTube utilise le sélecteur de service 'youtube'. Vous pouvez spécifier l'ID brut:
{{#ev:youtube|pSsYTj9kCHE}}
Ou spécifier l'URL complète:
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE}}
Pour afficher la même vidéo comme un droit aligné grande vignette avec une description:
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|1000|right|Let eet GO|frame}}
Pour YouTube d'avoir le début de la vidéo à un code de temps spécifique utiliser les urlargs (arguments d'URL) paramètres. Prenez le reste des arguments d'URL à partir de l'URL personnalisée et les placer dans les urlargs. S'il vous plaît noter que tous les services vidéo prennent pas en charge les arguments d'URL supplémentaires ou peuvent avoir des clés différentes pour leurs arguments d'URL.
https://www.youtube.com/watch?v=pSsYTj9kCHE&start=76
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=76}}
arguments d'URL peuvent être utilisés pour hacher une vidéo et passer en boucle :
https://www.youtube.com/watch?v=pSsYTj9kCHE&start=160&end=180&loop=1
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=160&end=180&loop=1}}
Services supportés
Comme la version 2.x, EmbedVideo prend en charge l'intégration du contenu vidéo des services suivants:
Site | Nom du service (s) | ID Exemple | Exemple d'URL (s) | |
---|---|---|---|---|
Archive.org Vidéos | archiveorg | electricsheep-flock-244-80000-6 | https://archive.org/details/electricsheep-flock-244-80000-6
https://archive.org/embed/electricsheep-flock-244-80000-6 | |
[1] | Bambuser - Diffusions | bambuser_channel - Chaînes | 5262334 | http://bambuser.com/v/5262334 |
[2] | faisceau - Streams | RocketBear | https://beam.pro/RocketBear | |
Bing | bing | 31ncp9r7l | http://www.bing.com/videos/watch/video/adorable-cats-attempt-to-eat-invisible-tuna/31ncp9r7l | |
[3] | blip - Blip nécessite l'URL complète à la page de la vidéo et ne pas accepter l'ID brut. | http://blip.tv/vinylrewind/review-6864612 | ||
[4] | mediacccde | 32c3-7305-quantum_cryptography | https://media.ccc.de/v/32c3-7305-quantum_cryptography | |
[5] | collegehumor | 6875289 | http://www.collegehumor.com/video/6875289/batman-says-his-goodbyes | |
[6] | dailymotion | x1adiiw_archer-réveil-up-as-h-jon-benjamin_shortfilms | http://www.dailymotion.com/video/x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms | |
TVPot | tvpot - Obtenir l'URL ou l'ID dans le menu partager URL. | s9011HdLzYwpLwBodQzCHRB | http://tvpot.daum.net/v/s9011HdLzYwpLwBodQzCHRB | |
Div Share | DivShare | |||
Edutopia | contenu Edutopia déplacé vers YouTube. S'il vous plaît utiliser le sélecteur de service youtube ci-dessous. | |||
[7] | FunnyorDie | c61fb67ac9 | http://www.funnyordie.com/videos/c61fb67ac9/to-catch-a-predator-elastic-heart-edition | |
[8] | gfycat | BruisedSilentAntarcticfurseal | http://www.gfycat.com/BruisedSilentAntarcticfurseal | |
Hitbox | hitbox | Washuu | http://www.hitbox.tv/Washuu | |
Player | jwplayer | cr5d8nbu-8ZpoNmmJ | https://content.jwplatform.com/players/cr5d8nbu-8ZpoNmmJ.html | |
[9] | kickstarter | elanlee / explosion-chatons | https://www.kickstarter.com/projects/elanlee/exploding-kittens | |
[10] | metacafe | 11404579 | http://www.metacafe.com/watch/11404579/lan_party_far_cry_4/ | |
Nico Nico Video | nico | sm24394325 | http://www.nicovideo.jp/watch/sm24394325 | |
RuTube | RuTube | b698163ccb67498db74d50cb0f22e556 | http://rutube.ru/video/b698163ccb67498db74d50cb0f22e556/ | |
TeacherTube | teachertube | 370511 | http://www.teachertube.com/video/thats-a-noun-sing-along-hd-version-370511 | |
TED Talks | ted | bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war | http://www.ted.com/talks/bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war | |
[11] | Tudou | mfQXfumwiew | http://www.tudou.com/listplay/mfQXfumwiew.html | |
Twitch | twitch - Live Streams | twitchvod - Vidéos archivées sur demande | Twitch Plays Pokémon | http://www.twitch.tv/twitchplayspokemon |
Videomaten | videomaten | |||
Vimeo | vimeo | 105035718 | http://vimeo.com/105035718 | |
Vine | vigne | h2B7WMtuX2t | https://vine.co/v/h2B7WMtuX2t | |
Yahoo | yahoo | katy-perry-danses-requins-2.015 à 024.409.668 | https://screen.yahoo.com/videos-for-you/katy-perry-dances-sharks-2015-024409668.html | |
[12] | youtube - Vidéos simples | youtubeplaylist - Playlists | pSsYTj9kCHE | https://www.youtube.com/watch?v=pSsYTj9kCHE
https://www.youtube.com/watch?v=CW_PbErQ_c8&list=PL76E80C7F756A2047 |
[13] | youku | XODc3NDgzMTY4 | http://v.youku.com/v_show/id_XODc3NDgzMTY4.html |
Paramètres de configuration
Variable | Valeur par défaut | La description |
---|---|---|
$wgEmbedVideoMinWidth | Entier - largeur minimum de lecteurs vidéo. Largeurs spécifiées ci-dessous de cette valeur seront automatiquement bornées à lui. | |
$wgEmbedVideoMaxWidth | Entier - largeur maximum de lecteurs vidéo. Largeurs spécifiées ci-dessus de cette valeur seront automatiquement bornées à lui. | |
$wgEmbedVideoDefaultWidth | Entier - Globalement remplacer la largeur par défaut des lecteurs vidéo. Lorsque vous ne définissez cette utilise la largeur par défaut du service vidéo qui est typiquement 640 pixels. |
Notes de versions
- v2.7.4
- Ajout du support pour playlist dans evlplayer
- Ajout du support pour la liste de vidéos youtube
- Documentation mise à jour pour evlplayer
- Ajout de la dépendance manquante pour evlplayer dans extension.json
- v2.7.3
- Twitch VOD par défaut à
autoplay=false
par défaut - Autoriser la taille des vidéos dans des proportions de 1:1 pour des cas d'utilisation spéciaux.
- v2.7.2
- Fonction ajoutée à evlplayer pour autoriser le contenu vidéo par défaut
- v2.7.1
- Correction du problème avec les vidéos youku qui ne sont pas intégrées correctement sur les wikis activés pour https.
- v2.7.0
- Ajout du support SoundCloud
- Possibilité d'utiliser le nom du service comme étiquette d'analyseur (si elle n'est pas définie précédemment)
- v2.6.1
- Ajout de nouvelles options de configuration pour désactiver l'ajout de gestionnaires de supports et d'extensions de fichiers.
- https://github.com/HydraWiki/mediawiki-embedvideo/issues/76
- Correction d'un tableau non initialisé.
- https://github.com/HydraWiki/mediawiki-embedvideo/issues/77
- Correction d'index indéfinis dans la classe AudioHandler.
- https://github.com/HydraWiki/mediawiki-embedvideo/issues/78
- Propriétés de classe corrigées qui ont été déclarées comme étant statiques.
- https://github.com/HydraWiki/mediawiki-embedvideo/issues/75
- Correction des problèmes de langue RTL avec CSS.
- https://github.com/HydraWiki/mediawiki-embedvideo/pull/73
- v2.6.0
- Ajout d'un support pour l'alignement vertical des vidéos.
- Amélioration du dimensionnement des balises vidéo et audio dans Chrome et Firefox lors de l'utilisation des balises du gestionnaire de média.
- Correction d'une variable non définie.
- https://github.com/HydraWiki/mediawiki-embedvideo/issues/71
- v2.5.2
- Si ffmpeg n'est pas installé sur le serveur, la classe FFProbe n'essaye plus d'utiliser et, au contraire, il suffit de renvoyer les descriptions génériques.
- Les propriétés corrigées sur FFProbe sont incorrectement déclarées statiques.
- Correction des problèmes lors du renvoi des descriptions génériques lorsque le fichier local auquel le ffprobe a accédé n'est pas lisible.
- v2.5.1
- Ajout d'un soutien à l'argument d'URL pour les services Twitch.
- v2.5.0
- Ajout de support pour les tags VideoLink
- Support pour Disclose.tv ajouté
- Le support Twitch VOD est mis à jour.
- Tag de l'analyseur #evu ajouté
- v2.4.1
- Améliorations et réparations de Sophivorus fusionnés.
- Prise en charge de TubiTV.com avec l'identifiant du service tubitv.
- Correction du rapport d'aspect vimeo.
- Fixed daily motion ID regex.
- Correction des messages d'erreur à double analyse.
- v2.4.0
- Nouveaux gestionnaires de médias pour intégrer des fichiers vidéo et audio importés localement.
- Nécessite la mise en place des fichiers binaires ffmpeg et ffprobe.
- Utilise HTML5 et tags.
- Deux nouveaux paramètres:
- $ WgFFmpegLocation - Définit l'emplacement du ffmpeg binaire.
- $ WgFFprobeLocation - Définir l'emplacement du ffprobe binaire.
- v2.3.3
- Support pour JW Player.
- v2.3.2
- Correction de redimensionnement automatique de rupture au moment de quitter plein écran.
- v2.3.1
- Correction du problème # 54 (EmbedVideo ne fonctionne pas avec la classe mw pliable)
- Correction question n ° 50 ( "arg" devrait être "args" dans addService)
- Option d'alignement Ajout de "en ligne"
- Centre fixe option d'alignement css
- Auto Resize vise désormais mobile ainsi
- v2.3.0
- Dur coupé du support pour les anciennes versions alors MediaWiki 1.25
- Attribut Auto Resize ajouté
- Array_key_exists Révocation () régression pour fixer le tag <embedvideo> étant cassé.
- v2.2.9
- Correction du problème avec Twitch.tv passage à HTTPS.
- [Support https://github.com/HydraWiki/mediawiki-embedvideo/pull/52 ajoutée pour http://media.ccc.de]
- De nouveaux services peuvent maintenant être ajoutés à partir d'autres extensions par programme.
- v2.2.8
- Support pour Daum TVPot
- Fix pour les arguments d'URL pour youtube et youtubeplaylist.
- Support pour Beam.pro.
- Support pour Hitbox.tv.
- v2.2.7
- v2.2.6
- NicoNico vidéo fixe d'identité; va travailler avec de nouveaux formats d'identité.
- v2.2.5
- Failles XSS rapportés par Mischanix.
- v2.2.4
- Fix Bing pour travailler avec leurs nouvelles URL.
- Supprimer MSN comme leur service de vidéo nouvelle ne supporte pas l'intégration.
- Normaliser soutien Tudou par leur wiki.
- V2.2.3
- Ajout du support pour Youku et Tudou.
- v2.2.2
- Modèle de remplacement d'expression régulière Mise à jour pour les URL Twitch. Old Twitch intégrer les URL ne redirigent pas automatiquement.
- v2.2.1
- E_NOTICE fixe étant jeté pour index de tableau non définis.
- Retour porté certains PHP 5.3 changements de compatibilité. S'il vous plaît noter que les futures versions de EmbedVideo ne peuvent pas supporter PHP 5.3 car il est une version obsolète. Mise à niveau vers PHP 5.4 au minimum est recommandé.
- v2.2.0
- Correction d'un bug avec un alignement qui causerait l'aligner à gauche de ne pas travailler semblable à la façon dont MediaWiki gère les images et autres médias.
- Nouveau tag parser mieux adapté pour les modèles; #evt.
- Nouveau HTML comme le format d'étiquette qui peut prendre des paramètres.
- v2.1.0
- Le paramètre de largeur a été changé pour les dimensions. Voir la documentation des paramètres ci-dessus.
- Nouveau paramètre de conteneur à utiliser un cadre MediaWiki pouce standard ou par défaut à un conteneur générique.
- Le paramètre de description ne force le cadre de pouce pour être utilisé.
- Ajout du support pour Archive.org, Blip.tv, CollegeHumor, Gfycat, Nico Nico Video, TED Talks, and Vine.
- Possibilité de centre align intègre.
- Module ressource de CSS.
- v2.0
- URL des pages de joueurs qui contiennent l'ID vidéo brut peuvent maintenant être utilisées comme paramètre d'identification.
- Validation des ID premières est améliorée.
- Base de code réécrit pour avoir une classe de Videoservice pour l'extensibilité future.
- Switched à iframes HTML5 chaque fois que possible pour embeds.
- Tous les services révisés pour être à jour et de travail.
- Le 'auto' et 'centre' valeurs d'alignement ont été éliminées car elles ne fonctionnaient pas. Ils sont prévus pour être mise en œuvre correctement dans l'avenir.
Notes développeur
Le principal avantage d'utiliser une fonction de l'analyseur comme mécanisme d'injection pour les clips vidéo (par opposition à une balise d'extension) est que les fonctions de l'analyseur peuvent utiliser les paramètres de modèle (de la forme {{{1}}}).
Par exemple, disons que vous vous trouviez en faisant beaucoup de vidéos YouTube dans la taille des vignettes, aligné à droite comme une image. Vous pourriez faire un modèle appelé Modèle:Youtube_tn
qui pourrait contenir ceci :
<div class = "tright pouce"> {{#ev: Youtube|{{{1}}}|{{{2|100}}}}} </div>
Et puis l'appeler comme ceci:
{{Youtube_tn|IdYoutube}}
Rapport de bogues
Il y a un traceur mis en place sur la page Github du projet.
Contribuer
Les rapports de bogues, demandes de fonctionnalités et de correctifs sont toujours les bienvenus. Les nouveaux contributeurs peuvent être ajoutés au projet Github si l'intérêt est suffisant.