Diff: Help/TranscludePlugin

Note: You are viewing an old revision of this page. View the current version.

Differences between version 4 and previous revision of Help/TranscludePlugin.

Other diffs: Previous Major Revision, Previous Author

Newer page: version 4 Last edited on 22 May 2014 3:01 by harold Revert
Older page: version 3 Last edited on 9 September 2007 0:16 by harold Revert
@@ -1,38 +1,47 @@
-The Help:TranscludePlugin can be used to embed include whole (external) web  
- pages within a wiki page. 
+The **Transclude** [[ Help:WikiPlugin|plugin]] can be used to embed include whole (external) web pages within a wiki page. 
  
-! Plugin Arguments 
+== Arguments ==  
  
-=src= |  
- The URL of the page to transclude  
-=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.) 
+{| class ="bordered"  
+ |-  
+! 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 
+== Bugs / Caveats ==  
  
-o Pages are transcluded using = <iframe>= tags. Older browsers do not  
- support ''iframe'' s. In that case the user will be presented with a  
- link to the trancluded material. 
+* Pages are transcluded using ## <iframe>## tags. Older browsers do not support //iframe// s. 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.)  
  
-o 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.)  
+== Example ==  
  
-o The recursion detection code does not currently work. Be careful to  
- avoid recursive transclusions, or you'll be sorry (or at least  
- amused .)  
+{{{  
+<<Transclude src="http://phpwiki .svn.sourceforge.net/viewvc/phpwiki/trunk/pgsrc/ReleaseNotes?view=markup">>  
+}}}  
  
-! Example  
+will get you  
  
-<verbatim>  
- <?plugin Transclude src="http://phpwiki.sourceforge.net/demo /ChangeLog" ?>  
-</verbatim >  
-  
-will get you  
+<<Transclude src="http://phpwiki.svn .sourceforge.net/viewvc /phpwiki/trunk/pgsrc/ReleaseNotes ?view=markup" >> 
  
-<?plugin Transclude src="http: //phpwiki.sourceforge.net/demo/ChangeLog" ? > 
+<noinclude>  
+----  
+[[PhpWikiDocumentation]] [[CategoryWikiPlugin]]  
+< /noinclude > 

version 4

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