In questo breve tutorial introdurremo all'uso di ATGoogleVideo partendo dalla  sua installazione all'interno di Plone e proseguendo con l'analisi dele varie possibilità offerte dal prodotto, senza apportare modifiche di alcun tipo alla versione scaricata.

Installazione

Una volta copiati i file nella directory Products della nostra istanza Zope,  possiamo accedere al pannello di controllo di Plone seguendo il link 'configurazione del sito' (site setup nella traduzione inglese). Cliccando sul link 'Inserimento/rimozione di prodotti' troviamo l'elenco dei prodotti installabili nel nostro Plone.

Nell'elenco dei prodotti installabili troveremo ATGoogleVideo 0.4 (Release Candidate), selezioniamolo tramite l'apposita checkbox e clicchiamo sul pulsante 'installa'.

Torniamo quindi nella pagina principale del nostro sito web; la prima novità che possiamo notare è la presenza di una nuova voce nel menu superiore di Plone (globalnav) dal nome 'videos'. Questa scheda corrisponde ad un cercatore creato in automatico dal ATGoogleVideo, che riunisce al suo interno tutti i video presenti sul nostro sito in stato 'pubblicato'.

Inserire un video

Per inserire un nuovo video è sufficiente selezionare la voce 'google video' all'interno del menu 'aggiungi alla cartella'. In questo modo apparirà una maschera in cui potremo aggiungere tutte le informazioni necessarie.

1. Titolo: titolo del nostro video
2. Descrizione: breve descrizione del contenuto del video
3. Docid: id corrispondente al video di Youtube o Google Video che vogliamo inserire
4. Quality: qualità del filmato flash che vogliamo impostare; è possibile scegliere tra: low, hight, autolow, autohight, best.
5. Autoplay: selezionare questa opzione se si vuole che il video inizi automaticamente quando apriamo la pagina contenente il video
6. Immagine: anteprima del video
7. Contenuti correlati: altri contenuti correlati al nostro video

Le informazioni da inserire sono piuttosto semplici, l'unica che necessita un minimo di spiegazione è docId.

Per conoscere l'id del video che vogliamo inserire è sufficiente controllare l'indirizzo del video stesso presente su Youtube o Google Video.

Google video id

Per inserire un video di Google Video dobbiamo raggiungere la pagina principale all'indirizzo http://video.google.it/ e cercare il video che ci interessa.

Una volta trovato, cliccando sull'anteprima dello stesso, entreremo nella pagina di visualizzazione del video. Per esempio http://video.google.it/videoplay?docid=2768368762284821227

L'id da inserire nel campo corrispondente di ATGoogleVideo è il numero presente nell'indirizzo dopo l'uguale; in questo caso 2768368762284821227

Youtube id

Per inserire un video presente su youtube il procedimento è simile: cerchiamo il video che ci interessa all'interno del sito web http://www.youtube.com e clicchiamo sull'anteprima per visualizzarlo. L'indirizzo della pagina di visualizzazione avrà una forma simile alla seguente: http://www.youtube.com/watch?v=N3OVFWCRx9o

Anche in questo caso l'id da inserire è la sigla presente nell'indirizzo dopo l'uguale: in questo caso N3OVFWCRx9o

Una volta inseriti i valori corretti e confermate le modifiche avremo inserito il nostro video all'interno di Plone. AtGoogleVideo riconoscerà in automatico se il video proviene da Youtube o da Google Gideo.

Cliccando sul link corrispondente al video appena inserito potremo notare che nella parte destra della pagina di visualizzazione viene inserita automaticamente una nuova portlet che contiene gli ultimi video inseriti nel portale.

Una volta pubblicato il video lo ritroveremo anche all'interno della scheda 'videos',  che raggruppa tutti i video pubblicati nel portale.

Link in Kupu

Un'ulteriore possibilità offerta dal prodotto è l'inserimento, attraverso Kupu, di un collegamento ai video pubblicati sul portale.

Per ottenere questo, quando inseriamo un nuovo contenuto in Plone, clicchiamo sull'icona 'insert internal link' di Kupu e selezioniamo il video che ci interessa.

Portlets

Per concludere, consiglio una piccola modifica che permette di visualizzare una portlet con gli ultimi video inseriti nel portale su tutte le pagine di Plone.

Entriamo nella ZMI e posizioniamoci alla radice della nostra installazione di Plone. Clicchiamo sulla scheda properties ed aggiungiamo la seguente riga alla proprietà 'left_slots' oppure 'right_slots':

/here/portlet_recent_google_videos/macros/portlet

In questo modo, ritornando a Plone, vedremo in ogni pagina una nuova portlet contenente gli ultimi video inseriti.