1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
<?php // -*-php-*-
rcs_id('$Id: RedirectTo.php,v 1.13 2004/02/17 12:11:36 rurban Exp $');
/*
Copyright 2002 $ThePhpWikiProgrammingTeam
This file is part of PhpWiki.
PhpWiki is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
PhpWiki is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with PhpWiki; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/**
* Redirect to another page or external uri. Kind of PageAlias.
* Usage:
* <?plugin RedirectTo href="http://www.internet-technology.de/fourwins_de.htm" ?>
* or <?plugin RedirectTo page=AnotherPage ?>
* at the VERY FIRST LINE in the content! Otherwise it will be ignored.
*
* Author: Reini Urban <rurban@x-ray.at>
*
* BUGS/COMMENTS:
* Todo: fix with USE_PATH_INFO = false
*
* This plugin could probably result in a lot of confusion, especially when
* redirecting to external sites. (Perhaps it can even be used for dastardly
* purposes?) Maybe it should be disabled by default.
*
* It would be nice, when redirecting to another wiki page, to (as
* UseModWiki does) add a note to the top of the target page saying
* something like "(Redirected from SomeRedirectingPage)".
*/
class WikiPlugin_RedirectTo
extends WikiPlugin
{
function getName() {
return _("RedirectTo");
}
function getDescription() {
return _("Redirects to another url or page.");
}
function getVersion() {
return preg_replace("/[Revision: $]/", '',
"\$Revision: 1.13 $");
}
function getDefaultArguments() {
return array( 'href' => '',
// 'type' => 'Temp' // or 'Permanent' // so far ignored
'page' => false,
);
}
function run($dbi, $argstr, &$request, $basepage) {
$args = ($this->getArgs($argstr, $request));
$href = $args['href'];
$page = $args['page'];
if ($href) {
/*
* Use quotes on the href argument value, like:
* <?plugin RedirectTo href="http://funky.com/a b \" c.htm" ?>
*
* Do we want some checking on href to avoid malicious
* uses of the plugin? Like stripping tags or hexcode.
*/
$url = preg_replace('/%\d\d/','',strip_tags($href));
$thispage = $request->getPage();
if (! $thispage->get('locked')) {
return $this->disabled(fmt("%s is only allowed in locked pages.",
_("Redirect to an external url")));
}
}
else if ($page) {
$url = WikiURL($page,
array('redirectfrom' => $request->getArg('pagename')),
'abs_path');
}
else {
return $this->error(fmt("%s or %s parameter missing",
"'href'", "'page'"));
}
if ($page == $request->getArg('pagename')) {
return $this->error(fmt("Recursive redirect to self: '%s'", $url));
}
if ($request->getArg('action') != 'browse')
return $this->disabled("(action != 'browse')");
$redirectfrom = $request->getArg('redirectfrom');
if ($redirectfrom !== false) {
if ($redirectfrom)
return $this->disabled(_("Double redirect not allowed."));
else {
// Got here by following the "Redirected from ..." link
// on a browse page.
return $this->disabled(_("Viewing redirecting page."));
}
}
return $request->redirect($url);
}
};
// $Log: RedirectTo.php,v $
// Revision 1.13 2004/02/17 12:11:36 rurban
// added missing 4th basepage arg at plugin->run() to almost all plugins. This caused no harm so far, because it was silently dropped on normal usage. However on plugin internal ->run invocations it failed. (InterWikiSearch, IncludeSiteMap, ...)
//
// Revision 1.12 2004/02/03 09:45:39 rurban
// LDAP cleanup, start of new Pref classes
//
// Revision 1.11 2003/11/22 17:54:50 carstenklapp
// Minor internal change: Removed redundant call to gettext within
// fmt(). (locale make: RedirectTo.php:81: warning: keyword nested in
// keyword arg)
//
// Revision 1.10 2003/02/24 00:40:09 carstenklapp
// PHP's closing tag \?\> within // cvs log comments caused the trailing comments to display as literal text on the PluginManager page.
//
// Revision 1.9 2003/02/21 22:59:00 dairiki
// Add new argument $basepage to WikiPlugin::run() and WikiPluginLoader::expandPI().
// Plugins need to know what page they were invoked from so that they can handle
// relative page links (like [/Subpage]) correctly. ($request->getArg('pagename')
// is not always the right page to use --- think included pages...)
//
// Many plugins don't need the $basepage, in which case, I think they can just ignore
// the extra argument. (I don't think PHP will generate any warnings.)
//
//
// Also: deleted <?plugin-head? > code. It's not needed any more, now that
// we always cache output.
//
// The FrameInclude plugin seems broken now, though I'm not convinced it's
// my fault. If it is, sorry... (I'll try to look at it a bit more
// within a few days, to see if I can figure out the problem.)
//
// Revision 1.8 2003/02/16 19:49:18 dairiki
// When redirecting to a page, use an absolute URL.
// This fixes a bug when redirecting from a sub-page (since,
// in that case the redirect happens before the <base> element gets
// sent.)
//
// Revision 1.7 2003/02/15 23:32:56 dairiki
// Usability improvements for the RedirectTo plugin.
//
// (Mostly this applies when using RedirectTo with a page=OtherPage
// argument to redirect to another page in the same wiki.)
//
// (Most of these ideas are stolen verbatim from UseModWiki.)
//
// o Multiple redirects (PageOne -> PageTwo -> PageThree) not allowed.
//
// o Redirects are not activated except when action == 'browse'.
//
// o When redirections are disabled, (hopefully understandable)
// diagnostics are displayed.
//
// o A link to the redirecting page is displayed after the title
// of the target page. If the user follows this link, redirects
// are disabled. This allows for easy editing of the redirecting
// page.
//
// FIXME: Stylesheets, and perhaps templates other than the defaults
// will probably have to be updated before this works well in other
// styles and/or themes.
//
// Revision 1.6 2003/01/18 22:01:44 carstenklapp
// Code cleanup:
// Reformatting & tabs to spaces;
// Added copyleft, getVersion, getDescription, rcs_id.
//
// For emacs users
// Local Variables:
// mode: php
// tab-width: 8
// c-basic-offset: 4
// c-hanging-comment-ender-p: nil
// indent-tabs-mode: nil
// End:
?>
|
