QTube è un semplice plugin nativamente sviluppato per Joomla! 1.5 (quindi non c'è bisogno di attivare l'opzione Legacy Mode) che consente di includere facilmente video YouTube in qualsiasi contenuto. Un modulo è anche disponibile per poter includere un video in una posizione modulo del template.
Come si usa il plugin
L'unica cosa che è necessario fare è includere nel contenuto dell'articolo una particolare stringa di comando nel punto esatto dove volete far apparire il video.
Questo è un comando di QTube nella sua forma più semplice.
{qtube vid:=xxx}
Al posto di xxx dovrete inserire l'identificatore assegnato da YouTube.com a quel particolare video: Per ottenerlo visitate il sito YouTube e controllate la barra degli indirizzi del vostro browser mentre state riproducendo il video che volete includere. Vedrete un indirizzo come questo
La sequenza di caratteri evidenziata nell'immagine sopra è l'idenditificatore del video che vi serve. Per includere il video di questo particolare esempio dovreste utilizzare il seguente comando
{qtube vid:=XJKsxmiEWOc}
Parametri del plugin
Chi ha bisogno di controllare in modo più completo lo stile dei video inclusi può utilizzare una serie di parametri aggiuntivi. Questo è un esempio di una stringa di comando che include tutti possibili parametri supportati da QTube. Vediamoli uno per uno.
{qtube vid:=xxx w:=320 h:=267 c1:=00ff00 c2:=0000ff b:=1 rel:=1 ap:=1 hd:=1 dc:=1 cl:=class id:=id}
- vid si tratta dell'unico parametro obbligatorio, è l'identificatore del video già spiegato in precedenza.
- w, h sono utilizzati per impostare rispettivamente la larghezza e l'altezza (in pixel) del riquadro all'interno del quale è riprodotto il video.
- c1, c2 colori utilizzati per i pulsanti del riproduttore video. Usare valori esadecimali.
- b (0/1) 1: un bordo è visualizzato attorno al riquadro all'interno del quale viene riprodotto il video. 0: (zero): nessun bordo.
- rel (0/1) 1: Collegamenti a video correlati sono mostrati una volta che il video è terminato; 0: nessun video correlato.
- ap (0/1) 1: attiva modalità autoplay, la riproduzione del video inizia appena la pagina è visualizzata; 0: no autoplay, l'utente deve iniziare la riproduzione del video manualmente premendo il tasto Play.
- hd (0/1): mostra video in alta qualità (se disponibile).
- dc (0/1): Mostra video da www.youtube-nocookie.com con cookie posticipati.
- cl valore dell'attributo class del tag html . Questo parametro consente ad utilizzatori più esperti di controllare lo stile del riquadro video attraverso un foglio di stile css.
- id valore dell'attributo id del tag html . Di nuovo per l'utilizzo in un foglio di stile.
Valori predefiniti per tutti questi parametri (con l'ovvia eccezione di vid) possono essere impostati dalla pagina di amministrazione di QTube nel backend di Joomla! Quando il valore di un parametro non è espressamente incluso nella stringa di comando, verrà utilizzato il valore predefinito.
Come si usa il modulo
Il modulo QTube supporta tutti i parametri di configurazione spiegati sopra. In più sono presenti due ulteriori parametri Prima del video, Dopo il video che servono ad inserire del testo o codice HTML prima o dopo l'oggetto video. Utili ad esempio per un testo di descrizione o per includere il video tra due tag come
.Una volta installato il modulo, tutti i parametri sono accessibili dall'area di amministrazione di Joomla! (Estensioni -> Gestione moduli).
