Documentación

Documentación

Descripción

El plugin ‘Youtube Channel Gallery’ muestra un vídeo y una galería de miniaturas, que se reproducen en el reproductor, de un canal de usuario de Youtube.

Características

  • Muestra las miniaturas de los últimos vídeos de un canal de usuario de Youtube.
  • Cuando se pulsa en una de las miniaturas el vídeo se reproduce el correspondiente vídeo en el reproductor superior.
  • El plugin usa el YouTube IFrame player API, lo cual permite a Youtube servir el player en formato HTML5 en lugar de en formato Flash para poder ser utilizado en dispositivos móviles. En el sidebar de esta página puede verse un ejemplo del plugin funcionando. El plugin se puede descargar desde la web de WordPress.
  • YouTube Data API v3.
  • Se puede usar el plugin como un widget o un shortcode.
  • Se pueden usar múltiples instancias del plugin en la misma página, para mostrar diferentes canales de Youtube.

Campos del widget

Descripción de los diferentes campos del plugin:

  • Título: título del widget.

Pestaña Feed

Contiene los datos necesarios para conectarse con la API de YouTube:Pestaña Feed

  • Key: Tienes que insertar tu propia API key. La API key insertada es un ejemplo y si no cambias la API key por la tuya puedes recibir un mensaje de cuota excedida. Esto es necesario en la versión 3 de YouTube API, obteniendo las credenciales de autorización. Shortcode atributo: key; valor: API key. (Obligatorio).
  • Tipo de feed de vídeo: opción para seleccionar el tipo de feed a usar para mostrar los vídeos. Puedes seleccionar Subidos por el usuario, Favoritos del usuario, Likes de usuario or Lista de resproducción. Shortcode atributo: feed; valor: user (por defecto), favorites, likes o playlist. (Opcional).
  • Nombre de usuario de YouTube: el nombre de usuario de los vídeos de YouTube que se quieren mostrar o el id de la lista de reproducción. Shortcode atributo: user; valor: texto. (Obligatorio).
  • Orden de lista de reproducción: Esta opción aparece sólo si seleccionas “Subidos por el usuario” en Tipo de feed de vídeo. Shortcode atributo: feed_order; valor: date (por defecto), rating, relevance, title, videoCount or viewCount. (Opcional).
    • date: Los recursos se ordenan en forma cronológica inversa, según la fecha en que se crearon.
    • rating: Los recursos se ordenan de mayor a menor calificación.
    • relevance: Los recursos se ordenan según su relevancia para la consulta de búsqueda. Este es el valor predeterminado de este parámetro.
    • title: Los recursos se ordenan alfabéticamente por título.
    • videoCount: Los canales se ordenan en forma descendente, según el número de videos subidos.
    • viewCount: Los recursos se ordenan de mayor a menor, según el número de reproducciones.
  • Tiempo de cache (horas): Horas que los datos del RSS data se mantienen guardados en la base de datos, para no hacer una petición cada vez que se visualiza la página. Asignar este valor en función de la frecuencia con que se actualiza tu canal de YouTube. Shortcode attribute: cache_time; value: Number. (Optional).
  • Activar cache: Si desactivas este campo el cache será eliminado y no será usado. Esto es útil para refrescar inmediatamente el RSS de YouTube usado por el plugin. Vuelve a activar la cache cuando la galería muestre los cambios que has realizado en tu canal de YouTube. Shortcode attribute: cache; values: 0(default) or 1 . (Optional).

Pestaña Player

Contiene los parámetros para la personalización del reproductor de YouTube:Pestaña reproductor

  • Reproductor: selecciona dónde quieres reproducir el vídeo. Shortcode attribute: player; values: 0, 1 (default) or 2. (Optional).
    • Sin reproductor: cuando pulsas en las miniaturas, éstas irán a su página en YouTube.
    • Mostrar reproductor: se mostrará el reproductor de Youtube y cuando pulses sobre una miniatura el vídeo comenzará a reproducirse sobre ese reproductor.
    • Mostrar reproductor en Magnific Popup: no se mostrará el reproductor de Youtube y cuando se pulse en una miniatura aparecerá una ventana modal y el vídeo comenzará a reproducirse en ella.
  • Ancho: indica el ancho del reproductor de vídeo. Shortcode atributo: videowidth; valor: Número. (Opcional).
  • Dimensiones del ancho: dimensiones del ancho del reproductor de vídeo. Shortcode attribute: width_type; values: % (default) or px. (Optional).
  • Relación de aspecto: indica las proporciones del reproductor, formato estándar (4:3) o panorámico (16:9). Shortcode atributo: ratio; valor: ratio; values: 4×3 or 16×9 (default). (Optional).
  • Tema: Muestra los controles del reproductor (como por ejemplo los botones de reproducir o volumen) dentro de una barra de control oscura o clara. Shortcode atributo: theme; valor: dark (por defecto) o light. (Opcional).
  • Color de la barra de progreso: especifica el color que se utilizará en la barra de progreso del reproductor de vídeo para resaltar la cantidad de vídeo que el usuario ha visto. Shortcode atributo: color; valor: red (por defecto) o white. (Opcional).
  • Calidad de video: permite establecer la calidad del vídeo sugerida para los vídeos. El valor del parámetro de calidad sugerido puede ser pequeño, mediano, grande, HD720, HD1080, highres o por defecto. YouTube recomienda ajustar el valor del parámetro a por defecto, que indica a YouTube que seleccione la calidad de reproducción más adecuada, que puede variar entre usuarios, vídeos, sistemas y demás condiciones de reproducción. Si se propone un nivel de calidad que no está disponible para el vídeo, la calidad se establece en el nivel más bajo siguiente que esté disponible. Shortcode atributo: quality; valor: small, medium, large, hd720, hd1080, highres o default (por defecto). (Opcional).
  • Autoplay: se reproduce automáticamente el vídeo inicial cuando se carga el reproductor. Shortcode atributo: autoplay; valor: 0 (por defecto) o 1. (Opcional).
  • Mostrar los vídeos relacionados: este parámetro indica si el reproductor de vídeo debe mostrar vídeos relacionados cuando finaliza la reproducción del vídeo. Shortcode atributo: rel; valores: 0 (por defecto) o 1. (Opcional).
  • Mostrar información (título, cargador): muestra información, como el título del vídeo y la calificación, antes de que el vídeo comienze a reproducirse. Shortcode atributo: showinfo; valores: 0 (por defecto) o 1. (Opcional).
  • Orden: orden del reproductor. Shortcode attribute: player_order; values: Number. 1 (default). (Optional).

Pestaña Miniaturas

Contiene los parámetros para la personalización de la galería de miniaturas enlazadas a cada vídeo:Pestaña Miniaturas

  • Número de vídeos a mostrar: un número que indica el número de miniaturas que se mostrarán. Shortcode attribute: maxitems; value: Number. (Optional).
  • Resolución de miniaturas: indica la resolución de las miniaturas. La altura es generada automáticamente en base a la relación de aspecto seleccionada. Shortcode attribute: thumb_width; value: Number. 320 (default). (Optional).
  • Relación de aspecto: indica las proporciones de las miniaturas, formato estándar (4:3) o panorámico (16:9). Shortcode attribute: thumb_ratio; values: 4×3 or 16×9 (default). (Optional).
  • Columnas Miniatura: permite controlar el número de columnas en las que las miniaturas serán distribuidas. Usa Bootstrap Grid system para permitir un comportamiento responsive. Shortcode attribute: thumb_columns_phones (Móviles), thumb_columns_tablets (Tablets), thumb_columns_md (Escritorios medios), thumb_columns_ld (Escritorios grandes); value: Number. Max value 12. (Optional).
  • Mostrar título: muestra el título de la miniatura con un enlace para ver el vídeo en el reproductor. Shortcode atributo: title; valores: 0 (por defecto) o 1. (Opcional).
  • Mostrar Descripción: muestra la descripción de la miniatura con el número de palabras especificado. Shortcode atributo: description; valores: 0 (por defecto) o 1. (Opcional).
  • Etiqueta de título: seleccionar la etiqueta más apropiada para el título. Shortcode attribute: title_tag; values: h1, h2, h3, h4, h5 (default), h6. (Optional).
  • Palabras en descripción: número máximo de palabras que se muestran de la descripción. Shortcode attribute: description_words_number; value: Number. (Optional).
  • Alineación de miniaturas: define la alineación de las miniaturas respecto al título y/o la descripción. Shortcode attribute: thumbnail_alignment; values: none (default), left, right. (Optional).
  • Ancho de miniaturas: esta opción se mostrará si la opción Alineación de miniaturas está selecionada como derecha o izquierda. Se usa para asignar una tamaño relativo a la miniatura. Shortcode attribute: thumbnail_alignment_width; values: extra_small, small, half (default), large, extra_large. (Optional).
  • Mín. tamaño con alineación: es útil para usar la alineación sólo a partir de un determinado tamaño de dispositivo. Por ejemplo, si no quieres usar alineación en dispositivos móviles, para que las miniaturas no se vean tan pequeñas, puedes seleccionar la opción tablets. Shortcode attribute: thumbnail_alignment_device; values: all (default), tablets, medium, large. (Optional).
  • Añade el atributo “nofollow” a los enlaces: el atributo “nofollow” ofrece a los administradores web una forma de decir a los buscadores “No sigas estos enlaces”. Shortcode attribute: nofollow; values: 0 (default) or 1. (Optional).
  • Abrir en una ventana nueva o pestaña: esta opción solo aparece si seleccionas usar la galería sin reproductor. Los enlaces de las miniaturas de abrirán en una ventana nueva o pestaña. Shortcode attribute: thumb_window; values: 0 (default) or 1. (Optional).
  • Mostrar paginación: Muestra una paginación sencilla con enlaces siguiente y anterior, e información del número de página y total de páginas. Tener en cuenta la advertencia de Google: “Por favor, advertir que el valor es una aproximación y puede no representar un valor exacto. Además, el valor máximo es 1.000.000”. Yo he observado que este valor no funciona correctamente en cuentas de Youtube con muchos vídeos. Shortcode attribute: thumb_pagination; values: 0 or 1 (default). (Optional).

Pestaña Enlace

Contiene los parámetros para la personalización del enlace al canal o lista de reproducción de la galería:Pestaña Enlace

  • Texto del enlace: campo de personalizar el texto del enlace a la galería en YouTube. Shortcode atributo: link_tx; valor: texto. (Opcional).
  • Mostrar enlace al canal: opción para mostrar un enlace al canal de usuario de YouTube. Shortcode atributo: link; valores: 0 (por defecto) o 1. (Opcional).
  • Mostrar enlace para agradecer al desarrollador: opción para añadir un pequeños enlace a la web del desarrollador . Shortcode attribute: promotion; values: 0 or 1 (default). (Optional).

Sintaxis de shortcode

En el siguiente ejemplo se encuentran todos los atributos que se pueden usar con el shortcode y que se explican más arriba:

[Youtube_Channel_Gallery user="apple" maxitems="16" thumb_columns_phones="2" thumb_columns_tablets="4"]

©2024 PoseLab SL. All rights reserved.