##master-page:HelpOnMacros/EmbedObject
##master-date:2008-05-12 01:23:33
#acl -All:write Default
#format wiki
#language it

<<Navigation(siblings)>>
<<BR>><<BR>>
<<TableOfContents>>

= EmbedObject =

Questa macro è utilizzata per includere (incorporare) un oggetto in una pagina wiki (gli oggetti in questo caso sono elementi solitamente gestiti da plug-in) come Flash, PDF o filmati. La dimensione dell'oggetto può essere modificata, altri parametri dipendono dal tipo dell'applicazione.

Se l'allegato non è stato caricato, verrà mostrata la riga per caricarlo.

(!) Nuovo in 1.6: !MoinMoin ha una nuova sintassi (per alcuni tipi di allegati sperimentali) di inclusione come: `{{target|desc|params}}`.

== Abilitare EmbedObject ==

!EmbedObject è un macro standard inclusa in moin. Per motivi di sicurezza, i tipi miem devono essere abilitati nel proprio file `wikiconfig.py` per poter sfruttare !EmbedObject.

 1. Nel file `wikiconfig.py`, nella sezione "Content options", aggiungere le seguenti righe: {{{
    mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', 'application/xhtml+xml',] 

    mimetypes_embed = ['application/x-dvi', 'application/postscript', 'application/pdf', 'application/ogg', 'application/vnd.visio', 'image/x-ms-bmp', 'image/svg+xml', 'image/tiff', 'image/x-photoshop', 'audio/mpeg', 'audio/midi', 'audio/x-wav', 'video/fli', 'video/mpeg', 'video/quicktime', 'video/x-msvideo', 'chemical/x-pdb', 'x-world/x-vrml',] 
}}}
 1. È utile aggiungere o rimuovere i tipi mime da `mimetypes_embed` tenendo solo quelli strettamente necessari all'interno del proprio sito. Per esempio, se è necessario Falsh, spostare `'application/x-shockwave-flash'` da `mimetypes_xss_protect` a `mimetypes_embed`.

''Consultare: AiutoSuConfigurazione''

'''Tipi MIME supoprtati:'''
 . application/x-shockwave-flash
 . application/x-dvi
 . application/postscript
 . application/pdf
 . application/ogg
 . application/vnd.visio 

 . image/x-ms-bmp
 . image/svg+xml
 . image/tiff
 . image/x-photoshop

 . audio/mpeg
 . audio/midi
 . audio/x-wav
                
 . video/fli
 . video/mpeg
 . video/quicktime
 . video/x-msvideo
                
 . chemical/x-pdb

 . x-world/x-vrml  

== Sintassi e uso ==

{{{
<<EmbedObject(attachment[,opzione][,opzione])>>
}}}

'''Parametri:'''

In base alla classe del tipo mime possono essere usati dei parametri diversi da quelli predefiniti: 
{{{
  width = None, float
  height = None, float
  pagename = None, unicode
  align = middle
  alt = ''
  play = False
  loop = False
  quality = high
  op = True
  repeat = False
  autostart = False
  menu = True
  hidden = False
}}}

Tutti i tipi mime supportano i parametri "width" e "height".

(!) Dalla versione 1.7 !MoinMoin supporta anche la lettura delle unità. Le unità accettate per i parametri "width" e "height" sono px, em, pt, in, mm e %. Se non viene fornita un'unità, quella predefinita è px.

Inoltre:
 . `'video'` supporta `repeat, autostart, menu, op`
 . `'audio'` supporta `play, repeat, autostart, op, hidden`
  . il valore di "width" predefinito è 60 e quello per "height" è 20
 . `'application'` supporta `play, menu, autostart`

== Esempi ==

Esempi di base:
{{{
<<EmbedObject(example.swf)>>
<<EmbedObject(example.pdf)>>
<<EmbedObject(example.svg)>>
}}}

Esempi più complessi:
{{{
<<EmbedObject(testpdf.pdf,width=100%,height=600px)>>
<<EmbedObject(example.swf,width=637px,height=392px,play=true,loop=true)>>
}}}
