DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:goto:tmp

This plugin redirects the current page to another page after a stipulated number of seconds. It requires the user to have JavaScript enabled in order to work to its fullest. However, a redirect link will still be displayed even without JavaScript.

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

The default pause time, before the redirect, and the minimum allowable pause time can be set in the configuration manager. See below for further details.

Syntax

You can put the GOTO string anywhere in the document, but it probably makes the most sense to put it at the top.

~~GOTO>wiki:syntax~~

The above will force the document to redirect to the syntax page after the default number of seconds. It comes set at three seconds. You can change the default number of seconds in the Configuration Manager.

It is possible to link to a subheading of the page:

~~GOTO>wiki:syntax#subheading~~

Pause before redirect

You can change the number of seconds before the redirect like so:

~~GOTO>wiki:syntax?15~~

This will redirect the page after a 15 second pause.

By default, users can't set the pause length to be faster than two seconds, but this can be changed in the Configuration Manager by setting a new value for the minSeconds option. The reason for the minimum pause length is that if it's too fast, it becomes difficult to hit the 'Edit Page' button before the redirect happens. If you can't edit the page, then it becomes tricky to remove the redirect.

Issues

  • The viewer's web browser must have JavaScript enabled in order to automatically redirect.
  • Currently, the plugin only works correctly for internal links.

Revision History

  • 2006-06-30 — Released.
  • 2006-07-19 — Made it easier to customize the displayed redirect message.
  • 2016-10-02 — Moved to GitHub, added compability for PHP 7, added redirection to headlines, integration of language files, integration of configuration manager for settings, avoid redirection while editing

Updated Version

There is an updated version of GOTO which has not yet been integrated into the main distribution. It has a feature which had been asked for an several occasions, the ability to redirect to external sites. It also contains an entirely new feature, which is the ability to automatically redirect to user pages on login.

For documentation and download, see the GOTO supplement

plugin/goto/tmp.txt · Last modified: 2019-03-16 00:45 by turnermm