Mi è stato chiesto di realizzare un tema Drupal in PHPTemplate, contenente diversi filmati Flash SWF nel layout grafico e in alcune pagine del sito. Drupal non digerisce gli oggetti Flash di suo. Per questo gli viene incontro il modulo, o meglio il pacchetto di moduli SWFTools. SWFTools include una api e diversi ottimi moduli che permettono di inserire vari tipi di contenuti e oggetti Flash (e non solo) in Drupal.

Il pacchetto contiene i seguenti componenti:

• Embedding diretto (di base)
• MP3/FLV players
• Jeroen Wijering Media Player
• Jeroen Wijering Image rotator
• Airtight Interactive SimpleViewer
• 1 Pixel Out MP3 Player
• SWFObject
• UFO
• jquery.flash.js
• SWFfix (when it exists)

Per inserire (embed) un oggetto Flash (swf) in un tema, in un blocco o all'interno di un qualsiasi contenuto in Drupal, i passi da seguire sono i seguenti:

1. Scarica SWFTools da drupal.org (http://drupal.org/project/swftools). Scompatta il modulo e copialo nella directory /sites/all/modules della tua installazione Drupal.
2. Scarica il javascript swfobject da http://blog.deconcept.com/swfobject/ , scompatta il pacchetto e aggiungi il javascript swfobject.js alla directory /sites/all/modules/swftools/shared in modo da trovarti con il seguente path: sites/all/modules/swftools/shared/swfobject/swfobject.js. Questo javascript contiene del codice che ovvia al classico problema del "click to activate" di IE7.
3. Loggati al tuo sito Drupal e abilita i seguenti moduli dalla pagina /admin/build/modules: SWFTools e Swfobject.
4. Vai alla pagina di amministrazione dei filtri di input (/admin/settings/filters), clicca su 'Filtered HTML' e abilita il filtro swftools. Ripeti la stessa cosa per il filtro "Full HTML" e per ogni filtro per il quale vuoi abilitare l'inserimento di oggetti in Flash direttamente dalla pagina di edit dei nodi.
5. Vai alla pagina /admin/media/swf/embed, espandi la sezione "Javascript embedding" e abilita l'opzione 'swfobject'. Questa opzione fa si che SWFTools inserisca gli oggetti Flash utilizzando il javascript swfobject.js

Bene, dovremmo ora essere in grado di aggiungere Flash e SWF al nostro sito Drupal. Ci sono 2 modi possibili di inserimento: mediante una chiamata in PHP (nel tema, in un blocco o in un nodo), o utilizzando il filtro swftools durante la creazione di un nodo.

Metodo PHP

Questo metodo è ideale se vogliamo aggiungere un oggetto Flash al nostro tema Drupal, o se vogliamo aggiungere un oggetto flash in un blocco. La funzione PHP è semplice:

<?php print swf('filmato.swf'); ?>

Questa funzione cercherà il file swf di nome filmato.swf nella directory /files (o qualsiasi altra directory abbiamo specificato nei settings). Possiamo anche aggiungere ulteriori parametri alla funzione, come ad esempio le dimensioni:

<?php print swf('filmato.swf', '200x180'); ?>

o ancora il testo da mostrare in caso Flash non sia installato:

<?php print swf('filmato.swf', '<p>Flash non è installato in questo browser..</p>','200x180'); ?>

Questo metodo può essere utilizzato in qualsiasi file del tema (es: page.tpl.php), o in un blocco o nodo che utilizzi PHP come formato di input.

Metodo via Filtro

Il secondo metodo consiste nell'inserire il nostro filmato Flash mediante una semplice tag:

<swf file="file.swf" width="250" height="125">

Se avremo settato i filtri dei formati di input correttamente, potremo aggiungere questa tag in qualsiasi nodo o blocco, e l'swf verrà inserito direttamente al suo posto.

Note: per evitare il problema di Internet Explorer 7 che mostra il messaggio "Click to activate and use this control", è necessario attivare SWF Tools/JavaScript Embedding/SWFObject - Geoff Stearns.

Una prima documentazione in inglese è disponibile in questo thread