Differences

This shows you the differences between two versions of the page.

--- plugin:randominc [2017-06-24 21:52] – [randominc Plugin] 2003:cb:abca:fa5:933:5106:3460:2b66
+++ plugin:randominc [2023-10-30 22:50] (current) – Klap-in
@@ Line 6: / Line 6: @@
 email      : rigazilla@gmail.com
 type       : syntax, helper
-lastupdate : 2017-06-15
+lastupdate : 2018-04-28
-compatible : 2006-11-06, Detritus; Frusterick Manners
+compatible : Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
-depends    :
+depends    : include
 conflicts  :
 similar    :
@@ Line 22: / Line 22: @@
 ===== Description =====
-This is a useful [[plugins|plugin]], if you want to include a randomly chosen page from a namespace, into the current one.
+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.
-This plugin is directly derived from [[include]] plugin, to which I added a random page selection derived from [[random_page]].
+==== Requirements ====
-Consider the use of Randominc if you want to change a static part of you page, to a randomly chosen part.
+This plugin uses the [[plugin:include|include plugin]] and therefore it requires the include plugin to be installed.
 ==== Syntax ====
@@ Line 56: / Line 56: @@
   * 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 [[plugin:include#configuration_and_flags|Include Plugin]]. E.g. ''%%{{randominc>:playground:test&link}}%%'' would make the first heading of the included page be rendered as a link.
 ===== Development =====
@@ Line 66: / Line 70: @@
 The plugin is translated into Russian, English, and German. Thanks a lot to the translators, new languages are very welcome!
-Please use the [[http://translate.dokuwiki.org/plugin/randominc|DokuWiki Localization Tool]].
+Please use the [[https://translate.dokuwiki.org/plugin/randominc|DokuWiki Localization Tool]].
 ===== Bugs =====
 To report bugs or suggest features, **please** use [[https://github.com/LarsGit223/dokuwiki-plugin-randominc/issues|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 =====