Differences

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

--- plugin:randominc [2017-06-15 13:35] – Added development feed LarsDW223
+++ 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
+compatible : Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
-depends    :
+depends    : include
 conflicts  :
 similar    :
@@ Line 19: / Line 19: @@
 screenshot_img:
 ----
-<del>http://rigazilla.yalab.net/randominc-2008-01-08.tgz</del>
 ===== Description =====
-//This plugin is untested and is provided as is, I developed it just for my university project. Check it before use.//
+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 is a useful [[plugins|plugin]], if you want to include a randomly chosen page from a namespace, into the current one.
+==== Requirements ====
-This plugin is directly derived from [[include]] plugin, to which I added a random page selection derived from [[random_page]].
+This plugin uses the [[plugin:include|include plugin]] and therefore it requires the include plugin to be installed.
-Consider the use of Randominc if you want to change a static part of you page, to a randomly chosen part.
 ==== Syntax ====
@@ Line 60: / 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 65: / Line 65: @@
 Changes:
 {{rss>https://github.com/LarsGit223/dokuwiki-plugin-randominc/commits/master.atom}}
+===== Translations =====
+The plugin is translated into Russian, English, and German. Thanks a lot to the translators, new languages are very welcome!
+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 =====
 Tested on Release 2014-09-29d "Hrun", it's work perfectly.  --- [[user>alinea|Alinea]] //2015-07-17 22:14//
-Included on http://pe.hillschmidt.de under Detritus - perfect!
+Included on http://pe.hillschmidt.de under Release 2017-02-19b „Frusterick Manners“ - perfect!