Inicio

Instalación

I) Prerrequisitos

ITheora necesita un servidor que acepte PHP. Puede borrar los directorios de las pieles que no esté utilizando, excepto el predeterminado: "default". También puede borrar el video de ejemplo (que es un video de Wikimedia)

II) Instalación

Para instalar ITheora, primero debe descomprimir el archivo (si no lo ha hecho todavía - use 7zip si está usando Windows®) y ponga su contenido en su sitio web. Asegúrese de tener acceso de lectura y escritura en los directorios.

III) Transmisión

La manera más sencilla es usando el generador de código: code.php (es recomendable cambiarle el nombre a este archivo para evitar su uso por parte de terceros)
Llene el formulario. El código se mostrará como resultado junto con un resumen.

Valores de v y detección automática de imágenes

Los videos DEBEN estar en formato "ogg" y las imágenes de vista previa en "jpg".
Los valores de v pueden ser:

La imagen de previsualización debe ser: video.jpg o video.ogg.jpg.
Si no especifica una imagen, se usará el archivo "null.jpg" (del directorio /skin/nombre_de_la_piel).
Las imágenes y los videos se redimensionarán automáticamente de acuerdo con el formato elegido - tendrá que ajustar el formato a la piel.
El aspecto general del reproductor y del video está enlazado a la hoja de estilo y a otras imágenes en el directorio de la piel.

Funcionamiento

Si no desea usar el generador de código, puede hacer las cosas manualmente.
Inserte el código siguiente para mostrar el video en su sitio web (tendrá que modificarlo de acuerdo a sus necesidades):

Código:
<object data="http://votre_site.org/itheora/index.php?v=exemple.ogg&t=4&w=340&h=280" type="application/xhtml+xml" style="width: 340px; height: 280px;">
<!--[if IE]>
<iframe src="http://votre_site.org/itheora/index.php?v=exemple.ogg&t=4&w=340&h=280" style="width:340px; height:280px;" allowtransparency="true" frameborder="0" ></iframe>
<![endif]-->
</object>

Aquí, en "v=ejemplo", "ejemplo" es el nombre del video (en el directorio "data"), "t=4" es la duración en segundos, "w=340" y "h=280" el ancho y la altura del reproductor respectivamente.
La piel predeterminada es ajustable, es decir, puede reducir o aumentar el tamaño del reproductor si lo desea.
Para hacerlo, debe agregar los parámetros "w" y "h" (cuyos valores son 340 y 280, predeterminadamente) y modificar consistentemente los parámetros "width" y "height" en el código.

Todos los parámetros son opcionales (excepto v, claro está): t, w y h se calculan automáticamente (solo para videos alojados localmente (en su servidor) y si el video tiene sonido).

Otros parámetros

  • n=nombre_del_video (el título aparecerá en el área de avisos (tooltips))
  • s=piel, las pieles deben agregarse en el directorio "skin". Puede crear sus propias pieles
  • l=idioma, el idioma se detecta automáticamente pero es posible forzarlo
  • d=item_a_desactivar, para el valor m (reproducción manual), i (info/tooltip), t (botón para referenciar en TheoraSea), s (botón "Parar"), p (botón "Compartir"), d (botón "Descargar")
    Ejemplo, para reproducir automáticamente, desactivar la descarga y desactivar el código para compartir: d=mpd.
  • p=imagen_del_video, contenido alternativo en otro lugar (desactivar para autodetección)
  • b=archivo_bittorrent, contenido alternativo en otro lugar (idem)
  • f=video.flv (flash), contenido alternativo en otro lugar

IV) Opciones

Desactivar definitivamente

En lugar de usar el parámetro d, puede desactivar definitivamente algunos elementos

Los avisos (tooltips) pueden eliminarse en algunas pieles o en el archivo de idioma: edite lang.lg.php o skins/style.php y haga $info igual a 0.
TheoraSea puede eliminarse en el archivo de idioma: comente (//) la línea $txt_shr.
Puede eliminar botones en el directorio skins/nombre_de_la_piel/boutons/(play, stop, share, download, torrent).png.
Y para desactivar el uso de url de otros anfitriones (hosts): elimine el archivo lib/cortado_url.jar.

P2P

Puede usar P2P para las descargas con el fin de ahorrar ancho de banda, solo tiene que poner un archivo .torrent en el mismo directorio del video. (el archivo .torrent debe tener el mismo nombre que el video). Si el visitante no tiene un cliente de BitTorrent, podrá descargar el video usando el enlace de Coral alternativo.
La detección automática de los archivos torrent funciona igual que con las imágenes.

Flash

También puede reemplazar el applet de Java por un reproductor de Flash. Para esto, debe usar el parche disponible en el área de descargas y convertir el archivo ogg a flv. Los dos videos deben estar en el servidor, en el mismo directorio. Después, solo tiene que poner el archivo como parámetro en el código: v=nombre_del_video.flv o v=video.ogg&f=video.flv
Igualmente para videos externos. El objetivo es comprometer el nivel de accesibilidad (por el peso del applet de Java) y, al mismo tiempo, poder promover la utilización del formato theora.

Nota: si desea que el código XHTML sea válido, tendrá que reemplazar "&" por "&amp;"