Differences

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

--- plugin:randominc [2015-08-26 15:01] – [Discussion] 194.45.150.17
+++ plugin:randominc [2023-10-30 22:50] (current) – Klap-in
@@ Line 1: / Line 1: @@
-====== randominc plugin ======
+====== randominc Plugin ======
 ---- plugin ----
-description: Randomly select a page from a namespace and include it the current page.
+description: Randomly select a page from a namespace and include it the current page
-author     : Vittorio Rigamonti
+author     : LarsDW223 (previous author: Vittorio Rigamonti)
 email      : rigazilla@gmail.com
 type       : syntax, helper
-lastupdate : 2007-12-31
+lastupdate : 2018-04-28
-compatible : 2006-11-06, Detritus
+compatible : Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
-depends    :
+depends    : include
 conflicts  :
 similar    :
 tags       : include, random
-downloadurl: http://comicslate.org/_media/wiki/dokuplug/randominc-2008-01-08.tgz
+downloadurl: https://github.com/LarsGit223/dokuwiki-plugin-randominc/archive/master.zip
+sourcerepo : https://github.com/LarsGit223/dokuwiki-plugin-randominc
+bugtracker : https://github.com/LarsGit223/dokuwiki-plugin-randominc/issues
+donationurl:
+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 40: / Line 40: @@
   * ''randominc'' works as ''[[include#syntax|page]]'' syntax of Include Plugin.
-  * ''randomincsec'' //should// works as ''[[include#syntax|section]]'' syntax.
+  * ''randomincsec'' //should// work as ''[[include#syntax|section]]'' syntax.
 ==== Arguments ====
@@ 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 =====
+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!