lib/plugin/FrameInclude.php

   1 <?php // -*-php-*-
   2 // rcs_id('$Id$');
   3 /*
   4  * Copyright 2002 $ThePhpWikiProgrammingTeam
   5  *
   6  * This file is part of PhpWiki.
   7  *
   8  * PhpWiki is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * PhpWiki is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with PhpWiki; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22
  23 /**
  24  * FrameInclude:  Displays a url or page in a seperate frame inside our body.
  25  *
  26  * Usage:
  27  *  <<FrameInclude src=http://www.internet-technology.de/fourwins_de.htm >>
  28  *  <<FrameInclude page=OtherPage >>
  29  *  at the VERY BEGINNING in the content!
  30  *
  31  * Author:  Reini Urban <rurban@x-ray.at>, rewrite by Jeff Dairiki <dairiki@dairiki.org>
  32  *
  33  * KNOWN ISSUES:
  34  *
  35  * This is a dirty hack into the whole system. To display the page as
  36  * frameset we:
  37  *
  38  *  1. Discard any output buffered so far.
  39  *  2. Recursively call displayPage with magic arguments to generate
  40  *     the frameset (or individual frame contents.)
  41  *  3. Exit early.  (So this plugin is usually a no-return.)
  42  *
  43  *  In any cases we can now serve only specific templates with the new
  44  *  frame argument. The whole page is now ?frame=html (before it was
  45  *  named "top") For the Sidebar theme (or derived from it) we provide
  46  *  a left frame also, otherwise only top, content and bottom.
  47  */
  48 class WikiPlugin_FrameInclude
  49 extends WikiPlugin
  50 {
  51     function getName() {
  52         return _("FrameInclude");
  53     }
  54
  55     function getDescription() {
  56         return _("Displays a url in a seperate frame inside our body. Only one frame allowed.");
  57     }
  58
  59     function getDefaultArguments() {
  60         return array( 'src'         => false,       // the src url to include
  61                       'page'        => false,
  62                       'name'        => 'content',   // name of our frame
  63                       'title'       => false,
  64                       'rows'        => '18%,*,15%', // names: top, $name, bottom
  65                       'cols'        => '20%,*',     // names: left, $name
  66                                                     // only useful on WikiTheme "Sidebar"
  67                       'frameborder' => 1,
  68                       'marginwidth'  => false,
  69                       'marginheight' => false,
  70                       'noresize'    => false,
  71                       'scrolling'   => 'auto',  // '[ yes | no | auto ]'
  72                     );
  73     }
  74
  75     function run($dbi, $argstr, &$request, $basepage) {
  76         global $WikiTheme;
  77
  78         $args = ($this->getArgs($argstr, $request));
  79         extract($args);
  80
  81         if ($request->getArg('action') != 'browse')
  82             return $this->disabled("(action != 'browse')");
  83         if (! $request->isGetOrHead())
  84             return $this->disabled("(method != 'GET')");
  85
  86         if (!$src and $page) {
  87             if ($page == $request->get('pagename')) {
  88                 return $this->error(sprintf(_("recursive inclusion of page %s"),
  89                                             $page));
  90             }
  91             $src = WikiURL($page);
  92         }
  93         if (!$src) {
  94             return $this->error(sprintf(_("%s or %s parameter missing"),
  95                                         'src', 'page'));
  96         }
  97
  98         // FIXME: How to normalize url's to compare against recursion?
  99         if ($src == $request->getURLtoSelf() ) {
 100             return $this->error(sprintf(_("recursive inclusion of url %s"),
 101                                         $src));
 102         }
 103
 104         static $noframes = false;
 105         if ($noframes) {
 106             // Content for noframes version of page.
 107             return HTML::p(fmt("See %s",
 108                                HTML::a(array('href' => $src), $src)));
 109         }
 110         $noframes = true;
 111
 112         if (($which = $request->getArg('frame'))) {
 113             // Generate specialized frame output (header, footer, etc...)
 114             $request->discardOutput();
 115             displayPage($request, new Template("frame-$which", $request));
 116             $request->finish(); //noreturn
 117         }
 118
 119         // Generate the outer frameset
 120         $frame = HTML::frame(array('name' => $name,
 121                                    'src' => $src,
 122                                    'title' => $title,
 123                                    'frameborder' => (int)$frameborder,
 124                                    'scrolling' => (string)$scrolling,
 125                                    'noresize' => (bool)$noresize,
 126                                    ));
 127
 128         if ($marginwidth)
 129             $frame->setArg('marginwidth', $marginwidth);
 130         if ($marginheight)
 131             $frame->setArg('marginheight', $marginheight);
 132
 133         $tokens = array('CONTENT_FRAME' => $frame,
 134                         'ROWS' => $rows,
 135                         'COLS' => $cols,
 136                         'FRAMEARGS' => sprintf('frameborder="%d"', $frameborder),
 137                         );
 138
 139         // Produce the frameset.
 140         $request->discardOutput();
 141         displayPage($request, new Template('frameset', $request, $tokens));
 142         $request->finish(); //noreturn
 143     }
 144 };
 145
 146 // Local Variables:
 147 // mode: php
 148 // tab-width: 8
 149 // c-basic-offset: 4
 150 // c-hanging-comment-ender-p: nil
 151 // indent-tabs-mode: nil
 152 // End:
 153 ?>