Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Shortcode Audio

Lo shortcode Audio permette di includere file audio e riprodurli. È stato aggiunto in WordPress 3.6 e si usa in questo modo:

[audio]

È anche possibile includere un file audio, senza l'uso di questo shortcode, inserendo semplicemente l'indirizzo del file su una propria riga, isolato dal resto del contenuto:

  Il mio magnifico contenuto

  http://my.mp3s.com/cool/songs/coolest.mp3

  Altro magnifico contenuto

Uso pratico

C'è un vecchio post che ha un file audio allegato nella Media Library, e si vuole usare il nuovo shortcode:

[audio]

Si possiede l'URL di un MP3, presente nella Media Library o esterno, che si vuole riprodurre:

[audio src="audio-source.mp3"]

Si possiede un URL principale e altri per i vari tipi di file supportati da HTML5:

[audio mp3="source.mp3" ogg="source.ogg" wav="source.wav"]

Opzioni

Sono supportate le seguenti opzioni di base:

src
(string) (opzionale) La sorgente del file audio. Se non è indicata, verrà usato il primo file audio allegato al post. Si possono usare le seguenti opzioni per definire tipi di file specifici, che verranno usati a seconda dei casi:
  • 'mp3', 'm4a', 'ogg', 'wav', 'wma'
Default: Il primo file audio allegato al post
loop
(string) (opzionale) Permette di riprodurre il file in modo continuativo. Il valore predefinito è "off".
  • "off" - ("default") il file non viene riprodotto in modo continuativo
  • "on" - il file viene riprodotto in modo continuativo
Default: "off"
autoplay
(string) (opzionale) Indica di riprodurre automaticamente il file appena esso è pronto. Il valore predefinito è "off".
  • "off" - ("default") il file non viene riprodotto automaticamente appena è pronto
  • "on" - il file viene riprodotto automaticamente appena è pronto
Default: "off"
preload
(string) (opzionale) Indica se e come caricare il file quando la pagina viene caricata. Il valore predefinito è "none".
  • "none" - ("default") il file non viene caricato quando la pagina viene caricata
  • "auto" - il file viene caricato interamente quando la pagina viene caricata
  • "metadata" - vengono caricati solo i metadati quando la pagina viene caricata
Default: "none"

File sorgente

Lo shortcode Audio si trova in wp-includes/media.php.