DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:randominc

randominc Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin Randomly select a page from a namespace and include it the current page

Last updated on
2018-04-28
Provides
Syntax, Helper
Repository
Source
Requires
include

Tagged with include, random

Description

This is a useful plugin, if you want to include a randomly chosen page from a namespace, into the current one. Consider the use of Randominc if you want to change a static part of a page, to a randomly chosen part.

Requirements

This plugin uses the include plugin and therefore it requires the include plugin to be installed.

Syntax

Enclose the namespace from where to select the page in double curly brackets. Refer to Include Plugin for detailed information here are only described the added functionallities.

{{randominc>[ns]#[section]&[flags]}}
[ns] namespace from which select the page to include

The plugin offers two syntaxes, {{randominc>...}} and {{randomincsec>...}}.

  • randominc works as page syntax of Include Plugin.
  • randomincsec should work as section syntax.

Arguments

You may use two arguments to control the presentation of the random content:

Name Value Effect Example
max-height A valid CSS size Content height limit max-height: 100px
max-width A valid CSS size Content width limit max-width: 200px

Examples

  • {{randominc>namespace1&max-height: 200px}}
  • you can include the random content into a box:<box 80% round blue | Random Content>{{randominc>namespace2&max-height: 250px}}</box>
  • {{randomincsec>:playground:test#abc&nofooter&noheader&noeditbtn}}
    where test is a folder and #abc is a headline

Additional Flags

From release 2017-08-04 on, the Random Include plugin also supports all flags which are supported by the Include Plugin. E.g. {{randominc>:playground:test&link}} would make the first heading of the included page be rendered as a link.

Development

Translations

The plugin is translated into Russian, English, and German. Thanks a lot to the translators, new languages are very welcome!

Please use the DokuWiki Localization Tool.

Bugs

To report bugs or suggest features, please use GitHub Issues. The author does not monitor this page.

Tips

  • If you don't want to use a specific NS, you can use {{randominc>*}}.
  • If you experience problems with caching, try adding ~~NOCACHE~~ to the page.

Discussion

Tested on Release 2014-09-29d “Hrun”, it's work perfectly. — Alinea 2015-07-17 22:14

Included on http://pe.hillschmidt.de under Release 2017-02-19b „Frusterick Manners“ - perfect!

plugin/randominc.txt · Last modified: 2023-10-30 22:50 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki