====== Page Redirect Plugin ======

---- plugin ----
description: Redirect a wiki page to another wiki page
author     : Elan Ruusamäe, David Lorentsen
email      : glen@delfi.ee
type       : action, syntax
lastupdate : 2024-03-01
compatible : Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather, Igor 
depends    :
similar    : goto, mediasyntax, redirect
tags       : redirect
downloadurl: https://github.com/glensc/dokuwiki-plugin-pageredirect/archive/refs/tags/2024-03-01.zip
bugtracker : https://github.com/glensc/dokuwiki-plugin-pageredirect/issues
sourcerepo : https://github.com/glensc/dokuwiki-plugin-pageredirect/

----

This plugin allows you to redirect users between [[:pages]] and [[:namespaces]] by adding a particular pattern to a page.

Features:
  * Multiple syntaxes supported for creating redirect pages
  * Notification at redirected page pointing back to provide clarity
  * Supports immediate redirection

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.


After the plugin is installed, a simple code redirects to another page:
<code>
~~REDIRECT>namespace:page~~
~~REDIRECT>http://example.com~~
</code>

You can also use this syntax since 20120816 version, however this needs to be only thing on the line:
<code>
#REDIRECT namespace:page
#redirect namespace:page
</code>

Since ''2017-05-12'' release, 2014-05-05 (Ponder Stibbons) Dokuwiki is required.
===== Configuration =====

The plugin has options that you can change via [[plugin:config|Configuration Settings]] in ''Admin'' panel.

<code php>
// Display a note about having been redirected on the new page.
$conf['show_note'] = 1;

// Allow redirects to external pages.
$conf['allow_external'] = 1;
</code>
===== Development =====

I've created [[https://github.com/glensc/dokuwiki-plugin-pageredirect/|git repo]] of this plugin, as I saw lack of interest by original author (David Lorentsen) to adopting the patches.

--- [[user>glen|glen]] //2012/06/11 21:19//

==== Changes ====

{{rss>https://github.com/glensc/dokuwiki-plugin-pageredirect/commits/main.atom date}}

**Releases:**
{{rss>https://github.com/glensc/dokuwiki-plugin-pageredirect/releases.atom description author}}


=== Bugs / Feature Requests =====

Please report bugs or feature requests at the [[https://github.com/glensc/dokuwiki-plugin-pageredirect/issues|Bug tracker]].