urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ikiwiki/doc/plugins/embed.mdwn

54 lines
2.2 KiB
Plaintext
Raw Normal View History

Migrate doc/plugins via prefix_directives This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc | xargs --max-args 1 ./ikiwiki-transition prefix_directives
2008-07-21 13:31:57 +02:00
[[!template id=plugin name=embed author="[[Joey]]"]]
[[!tag type/html]]
* Add embed plugin, which allows embedding content from google maps, video, calendar, and youtube. Normally, the htmlsanitiser eats these since they use unsafe tags, the embed plugin overrides it for trusted sites. * The googlecalendar plugin is now deprecated, and will be removed eventually. Please switch to using the embed plugin.
2007-08-23 22:14:08 +02:00
This plugin allows embedding content from external sites on
wiki pages.
Normally, the [[htmlscrubber]] does not allow the tags that are used for
embedding content from external sites, since `<iframe>`, `<embed>`, and
`<object>` tags can be used for various sorts of attacks. This plugin
allows such tags to be put on a page, if they look like they are safe.
In the examples below, the parts of the html that you can change are denoted
with "XXX"; everything else must appear exactly as shown to be accepted by the
plugin.
formatting
2008-12-31 21:28:03 +01:00
**This plugin is deprecated.** Rather than relying on these complex lists
deprecate embed plugin too I see that this plugin's lists of safe content are already well out of date, and htmlscrubber_skip offers a non whitelist based approach, so let's deprecate this plugin for 3.0.
2008-12-26 21:27:49 +01:00
of safe content, which constantly fall out of date, you're recommended to
configure the [[htmlscrubber]] to not scrub some pages, which only trusted
users can edit. Then you can embed anything from anywhere on those pages.
See [[tips/embedding_content]] for details and examples.
This plugin's lists of safe embedded content will not be maintained, and
the plugin will be removed in a future release.
* Add embed plugin, which allows embedding content from google maps, video, calendar, and youtube. Normally, the htmlsanitiser eats these since they use unsafe tags, the embed plugin overrides it for trusted sites. * The googlecalendar plugin is now deprecated, and will be removed eventually. Please switch to using the embed plugin.
2007-08-23 22:14:08 +02:00
## google maps
Use html like this to embed a map:
<iframe width="XXX" height="XXX" frameborder="XXX" scrolling="XXXX" marginheight="XXXX" marginwidth="XXXX" src="http://maps.google.com/?XXX"></iframe>
(This method only allows embeddeding a simple map. To use the full
[Google Maps API](http://www.google.com/apis/maps/) from ikiwiki, including
drawing points and GPS tracks on the map, try the [[contrib/googlemaps]]
plugin.)
## youtube
Use html like this to embed a video:
<object width="XXX" height="XXX"><param name="movie" value="http://www.youtube.com/v/XXX"></param><param name="wmode" value="transparent"></param>
<embed src="http://www.youtube.com/v/XXX" type="application/x-shockwave-flash" wmode="transparent" width="XXX" height="XXX"></embed></object>
## google video
Use html like this to embed a video:
<embed style="width:XXXpx; height:XXXpx;" id="XXX" type="application/x-shockwave-flash" src="http://video.google.com/googleplayer.swf?XXX" flashvars=""></embed>
## google calendar
Use html like this to embed a calendar:
<iframe src="http://www.google.com/calendar/embed?XXX" style="border-width:XXX" width="XXX" frameborder="XXX" height="XXX"></iframe>