X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=functions%2Ftemplate%2Ffolder_list_util.php;h=61c4322acf1013df5e7896e673a2faf2fd311c46;hp=42a29eee9794357ec78e6482dde3b67638babe72;hb=e883b46ee74c1f2d5ea382bded08a3e728cc47d5;hpb=bd116f83cc7235e0156ea60340b905a71dad5b2a

diff --git a/functions/template/folder_list_util.php b/functions/template/folder_list_util.php
index 42a29eee..61c4322a 100644
--- a/functions/template/folder_list_util.php
+++ b/functions/template/folder_list_util.php
@@ -47,6 +47,7 @@ function getMessageCount ($boxes, $type='total') {
 /**
  * Recursively iterates a mailboxes object to build a data structure that is
  * easy for template authors to work with.
+FIXME: well.... why not document that data structure here?
  * 
  * @param object $boxes Object of the class mailboxes
  * @author Steve Brown
@@ -115,5 +116,16 @@ function getBoxStructure ($boxes) {
         $box['ChildBoxes'][] = getBoxStructure($boxes->mbxs[$i]);
     }
     
+    // if plugins want to add some text or link after the folder name in
+    // the folder list, they should add to the "ExtraOutput" array element
+    // in $box (remember, it's passed through the hook by reference) -- making
+    // sure to play nice with other plugins by *concatenating* to "ExtraOutput"
+    // and NOT by overwriting it
+    //
+    // known users of this hook:
+    // empty_folders
+    //
+    do_hook('left_main_after_each_folder', $box);
+
     return $box;
 }