<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnMacros/EmbedObject</title></articleinfo><section><title>EmbedObject</title><para>This macro is used to Embed an Object into a wiki page-- objects being things usually handled by plug-ins, such as Flash, PDF, or movies. Optional size of the object could be adjusted. Further keywords are dependent on the kind of application. </para><para>If the attachment file isn't uploaded yet the attachment line will be shown. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://wiki.ninux.org//moin_static197/ninuxtheme02/img/idea.png" width="16"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> New in 1.6: <ulink url="http://wiki.ninux.org/HelpOnMacros/EmbedObject/MoinMoin#">MoinMoin</ulink> has new (for some target types rather experimental) transclusion syntax like this: <code>{{target|desc|params}}</code>. </para><section><title>Enabling EmbedObject</title><para>EmbedObject is an included standard moin macro since version 1.5.4. However, for security reasons, mimetypes have to be specifically enabled in your wikiconfig.py to enable EmbedObject. </para><orderedlist numeration="arabic"><listitem><para>In your wikiconfig.py file, under the &quot;Content options&quot; section, add the following lines: </para><screen><![CDATA[    mimetypes_xss_protect = ['text/html', 'application/x-shockwave-flash', 'application/xhtml+xml',] 
]]><![CDATA[
    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',] ]]></screen></listitem><listitem><para>You should specifically add and/or remove content types from the <code>mimetypes_embed</code> to only those you need to use on your site. For example, if you need Flash, move the <code>'application/x-shockwave-flash'</code> from the <code>mimetypes_xss_protect</code> to the <code>mimetypes_embed</code> line. </para></listitem></orderedlist><para><emphasis>see related: <ulink url="http://wiki.ninux.org/HelpOnMacros/EmbedObject/HelpOnConfiguration#">HelpOnConfiguration</ulink> </emphasis> </para><para><emphasis role="strong">supported mimetypes:</emphasis> </para><itemizedlist><listitem override="none"><para>application/x-shockwave-flash </para></listitem><listitem override="none"><para>application/x-dvi </para></listitem><listitem override="none"><para>application/postscript </para></listitem><listitem override="none"><para>application/pdf </para></listitem><listitem override="none"><para>application/ogg </para></listitem><listitem override="none"><para>application/vnd.visio  </para></listitem><listitem override="none"><para>image/x-ms-bmp </para></listitem><listitem override="none"><para>image/svg+xml </para></listitem><listitem override="none"><para>image/tiff </para></listitem><listitem override="none"><para>image/x-photoshop </para></listitem><listitem override="none"><para>audio/mpeg </para></listitem><listitem override="none"><para>audio/midi </para></listitem><listitem override="none"><para>audio/x-wav </para></listitem><listitem override="none"><para>video/fli </para></listitem><listitem override="none"><para>video/mpeg </para></listitem><listitem override="none"><para>video/quicktime </para></listitem><listitem override="none"><para>video/x-msvideo </para></listitem><listitem override="none"><para>chemical/x-pdb </para></listitem><listitem override="none"><para>x-world/x-vrml   </para></listitem></itemizedlist></section><section><title>Syntax &amp; Usage</title><screen><![CDATA[<<EmbedObject(attachment[,option][,option])>>]]></screen><para><emphasis role="strong">Keyword Parameters:</emphasis> </para><para>Dependent on the mimetype class a different set of keywords is used from the defaults: </para><screen><![CDATA[  width = ""
  height = ""
  play = false
  loop = false
  quality = high
  op = true
  repeat = false
  autostart = false
  menu = true
  hidden = false]]></screen><para>All mimetypes support width &amp; height parameters. </para><para>Additionally: </para><itemizedlist><listitem override="none"><para><code>'video'</code> supports  <code> repeat, autostart, menu, op </code> </para></listitem><listitem override="none"><para><code>'audio'</code> supports  <code> play, repeat, autostart, op, hidden </code> </para><itemizedlist><listitem override="none"><para>the default width is 60 and default height is 20 </para></listitem></itemizedlist></listitem><listitem override="none"><para><code>'application'</code> supports <code>play, menu, autostart </code> </para></listitem></itemizedlist></section><section><title>Examples</title><para>Basic examples: </para><screen><![CDATA[<<EmbedObject(example.swf)>>
<<EmbedObject(example.pdf)>>
<<EmbedObject(example.svg)>>]]></screen><para>Realistic examples: </para><screen><![CDATA[<<EmbedObject(testpdf.pdf,width=100%,height=600)>>
<<EmbedObject(example.swf,width=637,height=392,play=true,loop=true)>>]]></screen></section></section></article>