Modèle et Plugin Itheora pour SPIP

Modèle v0.5c (maj: 22/05/2009)
Plugin v1.2 (maj: 12/04/2010)

Voici un modèle pour Spip v1.9.1 ou ultérieure qui permet d'inclure facilement sous SPIP des documents audio/vidéo au format libre Ogg/Vorbis/Theora à l'aide d'Itheora.

Il est proposé sous 2 formes:

Un modèle tout simple à insérer dans n'importe quel squelettes (SPIP >=1.9.1). Vous devrez par ailleurs compléter le modèle par la dernière version d'Itheora, ainsi que votre sélection de skins et de langues, à partir du site d'Itheora, en les plaçant au bon endroit selon un mod opératoire que vous trouverez ci-dessous
Un plugin "tout en un" (SPIP >=2.0.0) qui contient tout cedont vous pourriez avoir besoin (le modèle bien-sûr, Itheora v2.2, plusieurs skins, toutes les langues disponibles, ainsi qu'un outil intégré à l'administration de SPIP pour configurer le player).

C'est à vous de voir quel module est le plus adapté à vos besoin.

Par ailleurs, il est important de noter que suite à l'utilisation d'une librairie php-ffmpeg bugguée chez plusieurs hébergeurs, il vaudra mieux utiliser des fichiers OGG qui ne contiennent pas de stream "skeleton" (automatiquement ajouté par ffmpeg2theora et les GUI qui l'utilisent...). Avec ffmpeg2theora (en ligne de commande sous Windows, Linux, MacOs) ajouter l'option --noskeleton. Sous Windows, il vous est suggéré d'utiliser Wtheora (en cochant la case "sans skeleton").

1) Soit: installation du modèle (simple) (spip >= 1.9.1)

Télécharger le modèle simple.
Dans le dossier du squelette, installer un sous-dossier "itheora" qui contient ce dernier (v1.0RC1 ou ultérieure)
Dans ce même dossier du squelette, créer s'il n'existe pas déjà un sous-dossier "modeles" (sans accent) dans lequel vous copierez le fichier itheora.html ci-joint
Vous pouvez modifier le skin, la langue, les désactivations, l'inclusion par défaut en modifiant les variables $defaut_skin,$defaut_l,$defaut_d,$defaut_inc au début du fichier itheora.html (du sous-dossier modèles).

Attention ! Si votre squelette n'est pas placé dans le dossier /squelettes de la racine de votre site (par exemple qu'il est fournit sous forme de plugin dans un dossier /plugins/auto/evaweb3) il faudra mettre les dossiers "modeles" et "itheora" là où est votre squelette (c'est-à-dire par exemple dans /plugins/auto/evaweb3!)

2) Soit: installation du plugin (spip >= 2.0.0)

Télécharger le plugin complet.
S'il n'existe pas déjà, créer le dossier "plugins" dans la racine de votre site SPIP
Y installer le contenu du zip que vous venez de télécharger
Dans l'interface privée de SPIP, dans "Configuration" / "Gestion des plugins", activer le plugin itheora.
Dans le menu configuration, une nouvelle icône "Itheora" est apparue: cliquer dessus pour aller configurer toutes les options d'apparence de Itheora (skin, langue, options...)

3) Utilisation

Dans votre article, insérer le document vidéo/audio en tant que document (local ou distant sur une url). N'oubliez pas d'ajouter si nécessaire un titre, une vignette personalisée (en cas d'absence et si votre héberge supporte le module php-ffmpeg, celle ci sera prise automatiquement au milieu de la vidéo), des commentaires. N'entrez la taille en pixels de la vidéo que si la vidéo est distante, ou si vous voulez afficher une vidéo dans une taille autre que sa taille native. La taille sera normalement auto-détectée.
A l'intèrieur du texte de l'article, insérer votre vidéo à l'aide d'une balise <itheoraxxx>

Options:

On peut bien sûr choisir l'alignement de sa vidéo avec par exemple un <itheoraxxx|left> (ou |right ou |center)
On peut spécifier un skin différent: |s=toto (toto: nom du skin) (par defaut: skin "defaut")
On peut forcer une langue |l=fr ou |l=auto (si auto: langue de l'article spip; si vide, langue du navigateur (détectée par itheora)
On peut désactiver des fonctionnalités: |d=[sptim...] Voir le détail des options sur le site d'itheora. Par exemple |d=st désactive les boutons partage et theorasea. (par defaut: d=st). Pour l'instant:

o, s, f et d pour enlever les boutons options, share , fullscreen et download
i pour désactiver les infobulles
t pour désactiver l'envoie vers Theora Sea
m pour désactiver la lecture manuelle.

On peut spécifier la durée de la vidéo |t=12 (en secondes). Utile pour avoir le curseur et se déplacer dans la vidéo. La durée de la vidéo est autodétectée normalement la plupart du temps, sauf dans certains cas si la vidéo est distante et que votre hébergeur n'accepte pas les ouverture de fichier distantes.

4) Téléchargement

modele-itheora.zip v0.5c
plugin-itheora.zip v1.2 (contient itheora v2.2, le modèle 0.5c, les langues fr-en-it-es-de, plusieurs skins)

Pour toute question ou rapport de bug: opensource (arobase) grisambre (point) net