added event to all tools menues

main.php

@@ -63,19 +63,23 @@ $showSidebar = page_findnearest($conf['sidebar']) && ($ACT=='show');
                     <div id="dokuwiki__usertools">
                         <h3 class="a11y"><?php echo $lang['user_tools'] ?></h3>
                         <ul>
-                            <?php /* the optional second parameter of tpl_action() switches between a link and a button,
-                                     e.g. a button inside a <li> would be: tpl_action('edit', 0, 'li') */
+                            <?php
                                 if (!empty($_SERVER['REMOTE_USER'])) {
                                     echo '<li class="user">';
                                     tpl_userinfo(); /* 'Logged in as ...' */
                                     echo '</li>';
                                 }
-                                tpl_action('admin', 1, 'li');
-                                _tpl_action('userpage', 1, 'li');
-                                tpl_action('profile', 1, 'li');
-                                tpl_action('register', 1, 'li'); /* DW versions < 2011-02-20 need to use _tpl_action('register', 1, 'li') */
-                                tpl_action('login', 1, 'li');
                             ?>
+                            <?php /* the optional second parameter of tpl_action() switches between a link and a button,
+                                     e.g. a button inside a <li> would be: tpl_action('edit', 0, 'li') */
+                            ?>
+                            <?php _tpl_toolsevent('usertools', array(
+                                'admin'     => tpl_action('admin', 1, 'li', 1),
+                                'userpage'  => _tpl_action('userpage', 1, 'li', 1),
+                                'profile'   => tpl_action('profile', 1, 'li', 1),
+                                'register'  => tpl_action('register', 1, 'li', 1), /* DW versions < 2011-02-20 need to use _tpl_action('register', 1, 'li') */
+                                'login'     => tpl_action('login', 1, 'li', 1),
+                            )); ?>
                         </ul>
                     </div>
                 <?php endif ?>
@@ -85,11 +89,11 @@ $showSidebar = page_findnearest($conf['sidebar']) && ($ACT=='show');
                     <h3 class="a11y"><?php echo $lang['site_tools'] ?></h3>
                     <?php tpl_searchform() ?>
                     <ul>
-                        <?php
-                            tpl_action('recent', 1, 'li');
-                            tpl_action('media', 1, 'li');
-                            tpl_action('index', 1, 'li');
-                        ?>
+                        <?php _tpl_toolsevent('sitetools', array(
+                            'recent'    => tpl_action('recent', 1, 'li', 1),
+                            'media'     => tpl_action('media', 1, 'li', 1),
+                            'index'     => tpl_action('index', 1, 'li', 1),
+                        )); ?>
                     </ul>
                 </div>
 
@@ -145,15 +149,15 @@ $showSidebar = page_findnearest($conf['sidebar']) && ($ACT=='show');
                 <div id="dokuwiki__pagetools">
                     <h3 class="a11y"><?php echo $lang['page_tools'] ?></h3>
                     <ul>
-                        <?php
-                            tpl_action('edit', 1, 'li');
-                            _tpl_action('discussion', 1, 'li');
-                            tpl_action('revisions', 1, 'li');
-                            tpl_action('backlink', 1, 'li');
-                            tpl_action('subscribe', 1, 'li');
-                            tpl_action('revert', 1, 'li');
-                            tpl_action('top', 1, 'li');
-                        ?>
+                        <?php _tpl_toolsevent('pagetools', array(
+                            'edit'      => tpl_action('edit', 1, 'li', 1),
+                            'discussion'=> _tpl_action('discussion', 1, 'li', 1),
+                            'revisions' => tpl_action('revisions', 1, 'li', 1),
+                            'backlink'  => tpl_action('backlink', 1, 'li', 1),
+                            'subscribe' => tpl_action('subscribe', 1, 'li', 1),
+                            'revert'    => tpl_action('revert', 1, 'li', 1),
+                            'top'       => tpl_action('top', 1, 'li', 1),
+                        )); ?>
                     </ul>
                 </div>
             <?php endif; ?>

tpl_functions.php

@@ -62,30 +62,6 @@ function _tpl_userpage($userPage, $title, $link=0, $wrapper=0) {
     if ($wrapper) echo "</$wrapper>";
 }
 
-/**
- * Create link/button to register page
- * @deprecated DW versions > 2011-02-20 can use the core function tpl_action('register')
- *
- * @author Anika Henke <anika@selfthinker.org>
- */
-function _tpl_register($link=0, $wrapper=0) {
-    global $conf;
-    global $lang;
-    global $ID;
-    $lang_register = !empty($lang['btn_register']) ? $lang['btn_register'] : $lang['register'];
-
-    if (!empty($_SERVER['REMOTE_USER']) || !$conf['useacl'] || !actionOK('register')) return;
-
-    if ($wrapper) echo "<$wrapper>";
-
-    if ($link)
-        tpl_link(wl($ID, 'do=register'), $lang_register, 'class="action register" rel="nofollow"');
-    else
-        echo html_btn('register', $ID, '', array('do'=>'register'), 'get', 0, $lang_register);
-
-    if ($wrapper) echo "</$wrapper>";
-}
-
 /**
  * Wrapper around custom template actions
  *
@@ -109,6 +85,24 @@ function _tpl_action($type, $link=0, $wrapper=0) {
     }
 }
 
+/**
+ * Create event for tools menues
+ *
+ * @author Anika Henke <anika@selfthinker.org>
+ */
+function _tpl_toolsevent($toolsname, $items, $view='main') {
+    $data = array(
+        'view'  => $view,
+        'items' => $items
+    );
+
+    $hook = 'TEMPLATE_'.strtoupper($toolsname).'_DISPLAY';
+    $evt = new Doku_Event($hook, $data);
+    if($evt->advise_before()){
+        foreach($evt->data['items'] as $k => $html) echo $html;
+    }
+    $evt->advise_after();
+}
 
 
 /* fallbacks for things missing in older DokuWiki versions
@@ -282,3 +276,27 @@ if (!function_exists('tpl_classes')) {
         return join(' ', $classes);
     }
 }
+
+/**
+ * Create link/button to register page
+ * @deprecated DW versions > 2011-02-20 can use the core function tpl_action('register')
+ *
+ * @author Anika Henke <anika@selfthinker.org>
+ */
+function _tpl_register($link=0, $wrapper=0) {
+    global $conf;
+    global $lang;
+    global $ID;
+    $lang_register = !empty($lang['btn_register']) ? $lang['btn_register'] : $lang['register'];
+
+    if (!empty($_SERVER['REMOTE_USER']) || !$conf['useacl'] || !actionOK('register')) return;
+
+    if ($wrapper) echo "<$wrapper>";
+
+    if ($link)
+        tpl_link(wl($ID, 'do=register'), $lang_register, 'class="action register" rel="nofollow"');
+    else
+        echo html_btn('register', $ID, '', array('do'=>'register'), 'get', 0, $lang_register);
+
+    if ($wrapper) echo "</$wrapper>";
+}