doc/plugins/embed.mdwn

   1 [[!template id=plugin name=embed author="[[Joey]]"]]
   2 [[!tag type/html]]
   3
   4 This plugin allows embedding content from external sites on
   5 wiki pages.
   6
   7 Normally, the [[htmlscrubber]] does not allow the tags that are used for
   8 embedding content from external sites, since `<iframe>`, `<embed>`, and
   9 `<object>` tags can be used for various sorts of attacks. This plugin
  10 allows such tags to be put on a page, if they look like they are safe.
  11
  12 In the examples below, the parts of the html that you can change are denoted
  13 with "XXX"; everything else must appear exactly as shown to be accepted by the
  14 plugin.
  15
  16 ## google maps
  17
  18 Use html like this to embed a map:
  19
  20         <iframe width="XXX" height="XXX" frameborder="XXX" scrolling="XXXX" marginheight="XXXX" marginwidth="XXXX" src="http://maps.google.com/?XXX"></iframe>
  21
  22 (This method only allows embeddeding a simple map. To use the full
  23 [Google Maps API](http://www.google.com/apis/maps/) from ikiwiki, including
  24 drawing points and GPS tracks on the map, try the [[contrib/googlemaps]]
  25 plugin.)
  26
  27 ## youtube
  28
  29 Use html like this to embed a video:
  30
  31         <object width="XXX" height="XXX"><param name="movie" value="http://www.youtube.com/v/XXX"></param><param name="wmode" value="transparent"></param>
  32         <embed src="http://www.youtube.com/v/XXX" type="application/x-shockwave-flash" wmode="transparent" width="XXX" height="XXX"></embed></object>
  33
  34 ## google video
  35
  36 Use html like this to embed a video:
  37
  38         <embed style="width:XXXpx; height:XXXpx;" id="XXX" type="application/x-shockwave-flash" src="http://video.google.com/googleplayer.swf?XXX" flashvars=""></embed>
  39
  40 ## google calendar
  41
  42 Use html like this to embed a calendar:
  43
  44         <iframe src="http://www.google.com/calendar/embed?XXX" style="border-width:XXX" width="XXX" frameborder="XXX" height="XXX"></iframe>
  45