Fix for FS#1598 - allow a plugin to be a singleton if it so desires

DokuWiki typically instantiates a plugin once and reuses
that instance whenever the plugin is required. However on
some occasions DokuWiki will request a new instantiation of
a plugin.  This particularly applies to render plugins.  This
patch allows a plugin to force DokuWiki to reuse the existing
instance.

If a plugin wishes to only be instantiated once then it
should implement an "isSingleton()" method and that
method should return boolean true.

darcs-hash:20090211143520-f07c6-5c1a33dbed55f0b196a204745fe3139f3c7c0aa9.gz

1 files changed, 8 insertions, 0 deletions

diff --git a/lib/plugins/syntax.php b/lib/plugins/syntax.php
index 7ded173cd..126e01952 100644
--- a/lib/plugins/syntax.php
+++ b/lib/plugins/syntax.php
@@ -266,5 +266,13 @@ class DokuWiki_Syntax_Plugin extends Doku_Parser_Mode {
     return $conf;
   }
 
+  /**
+   * Allow the plugin to prevent DokuWiki creating a second instance of itself
+   *
+   * @return bool   true if the plugin can not be instantiated more than once
+   */
+  function isSingleton() {
+    return false;
+  }
 }
 //Setup VIM: ex: et ts=4 enc=utf-8 :