pgsrc/Help%2FTranscludePlugin

   1 Date: Tue, 17 Sep 2002 13:03:19 -0700
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.4pre)
   3 X-Rcs-Id: $Id: Help%2FTranscludePlugin,v 1.2 2007-01-10 20:48:11 rurban Exp $
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FTranscludePlugin;
   6   pgsrc_version="2 $Revision: 1.2 $";
   7   flags="";
   8   markup=2;
   9   charset=iso-8859-1
  10 Content-Transfer-Encoding: binary
  11
  12 The Help:TranscludePlugin can be used to embed include whole (external) web
  13 pages within a wiki page.
  14
  15 ! Plugin Arguments
  16
  17 =src= |
  18   The URL of the page to transclude
  19 =height= |
  20   The (initial) height of the transclusion frame.
  21   If, possible, after the transcluded page is loaded,
  22   the frame is resized via javascript so that it
  23   fits the entire transcluded page.  (See below for more.)
  24
  25 ! Bugs / Caveats
  26
  27 o Pages are transcluded using =<iframe>= tags.  Older browsers do not
  28   support ''iframe''s.  In that case the user will be presented with a
  29   link to the trancluded material.
  30
  31 o When possible, JavaScript code is used to adjust the height of the
  32   _iframe_ so that it fits the entire transcluded page.
  33   Unfortunately, this seems possible only when the transcluded page
  34   comes from the same server as the wiki page.  (This restriction is
  35   due to security checks built in to the JavaScript language.)
  36
  37 o The recursion detection code does not currently work.  Be careful to
  38   avoid recursive transclusions, or you'll be sorry (or at least
  39   amused.)
  40
  41 ! Example
  42
  43 <verbatim>
  44 <?plugin Transclude src="http://phpwiki.sourceforge.net/demo/ChangeLog" ?>
  45 </verbatim>
  46
  47 will get you
  48
  49 <?plugin Transclude src="http://phpwiki.sourceforge.net/demo/ChangeLog" ?>