]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/plugins/conditional.mdwn
editpage: New core plugin factoring out page editing to allow disabling it if desired.
[git.ikiwiki.info.git] / doc / plugins / conditional.mdwn
index 42eb4e62dd09471cf4f19b59d0b787f53502b40b..5793cb30e61cd7dd92f736fff78f6948c7c45328 100644 (file)
@@ -1,12 +1,12 @@
-[[template id=plugin name=conditional core=1 author="[[Joey]]"]]
-[[tag type/format]]
+[[!template id=plugin name=conditional core=1 author="[[Joey]]"]]
+[[!tag type/format]]
 
 With this plugin, you can make text be conditionally displayed on a page.
 For example:
 
-       \[[if test="enabled(smiley)"
-       then="The smiley plugin is enabled :-)"
-       else="No smiley plugin here.."]]
+       \[[!if test="enabled(smiley)"
+             then="The smiley plugin is enabled :-)"
+             else="No smiley plugin here.."]]
 
 If the specified `test` succeeds, the `then` text will be displayed,
 otherwise the `else` text will be displayed. The `else` part is optional.
@@ -15,10 +15,16 @@ The `then` and `else` values can include any markup that would be allowed
 in the wiki page outside the template. Triple-quoting the values even allows
 quotes to be included.
 
-The `test` is a [[PageSpec]]; if it matches any page in the wiki then it
-succeeds. So you can do things like testing for the existence of a page or
-pages, testing to see if any pages were created in a given month, and so
-on. The regular [[PageSpec]] syntax is expanded with the following
+The `test` is a [[ikiwiki/PageSpec]]; if it matches any page in the wiki
+then it succeeds. So you can do things like testing for the existence of a
+page or pages, testing to see if any pages were created in a given month,
+and so on.
+
+If you want the [[ikiwiki/PageSpec]] to only match against the page that
+contains the conditional, rather than matching against all pages in the
+wiki, set the "all" parameter to "no".
+
+The regular [[ikiwiki/PageSpec]] syntax is expanded with the following
 additional tests:
 
 * enabled(plugin)