Diff: Help/TranscludePlugin
Differences between current version and predecessor to the previous major change of Help/TranscludePlugin.
Other diffs: Previous Revision, Previous Author
| Newer page: | version 4 | Last edited on February 23, 2012 2:52 pm | by PhilHollenback | |
| Older page: | version 3 | Last edited on February 23, 2012 2:52 pm | by PhilHollenback | Revert |
Content of versions 3 and 4 is identical.
Version 4 was created because:
current version
The Transclude plugin can be used to embed include whole (external) web pages within a wiki page.
Arguments
Argument |
Description |
Default value |
|---|---|---|
src |
The URL of the page to transclude |
none |
title |
The title of the page to transclude |
Transcluded page |
height |
The (initial) height of the transclusion frame. If, possible, after the transcluded page is loaded, the frame is resized via Javascript so that it fits the entire transcluded page. (See below for more.) |
450 |
quiet |
If set, frame appears as normal content |
false |
Bugs / Caveats
- Pages are transcluded using <iframe> tags. Older browsers do not support iframes. In that case the user will be presented with a link to the transcluded material.
- When possible, Javascript code is used to adjust the height of the iframe so that it fits the entire transcluded page. Unfortunately, this seems possible only when the transcluded page comes from the same server as the wiki page. (This restriction is due to security checks built in to the Javascript language.)
- The recursion detection code does not currently work. Be careful to avoid recursive transclusions, or you'll be sorry (or at least amused.)
Example
<<Transclude src="http://phpwiki.svn.sourceforge.net/viewvc/phpwiki/trunk/pgsrc/ReleaseNotes?view=markup">>
will get you
Transcluded from http://phpwiki.svn.sourceforge.net/viewvc/phpwiki/trunk/pgsrc/ReleaseNotes?view=markup
