add PAGE_NAME constant to every page under src/.
[squirrelmail.git] / src / folders.php
index f34dc044639945a95e0ffdb98a2a0d910c200e98..60a8861daa8d7a31b3524254d0aabbab09152bdc 100644 (file)
@@ -1,59 +1,42 @@
 <?php
-
 /**
  * folders.php
  *
- * Copyright (c) 1999-2005 The SquirrelMail Project Team
- * Licensed under the GNU GPL. For full terms see the file COPYING.
- *
  * Handles all interaction between the user and the other folder
  * scripts which do most of the work. Also handles the Special
  * Folders.
  *
+ * @copyright &copy; 1999-2007 The SquirrelMail Project Team
+ * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  * @version $Id$
  * @package squirrelmail
  */
 
+/** This is the folders page */
+define('PAGE_NAME', 'folders');
+
 /**
- * Path for SquirrelMail required files.
- * @ignore
+ * Include the SquirrelMail initialization file.
  */
-define('SM_PATH','../');
+require('../include/init.php');
 
 /* SquirrelMail required files. */
-require_once(SM_PATH . 'include/validate.php');
-require_once(SM_PATH . 'functions/imap.php');
+require_once(SM_PATH . 'functions/imap_general.php');
 require_once(SM_PATH . 'functions/folder_manip.php');
-require_once(SM_PATH . 'functions/plugin.php');
-require_once(SM_PATH . 'functions/html.php');
 require_once(SM_PATH . 'functions/forms.php');
 
-displayPageHeader($color, 'None');
+displayPageHeader($color);
 
 /* get globals we may need */
-
-sqgetGlobalVar('username', $username, SQ_SESSION);
-sqgetGlobalVar('key', $key, SQ_COOKIE);
 sqgetGlobalVar('delimiter', $delimiter, SQ_SESSION);
-sqgetGlobalVar('onetimepad', $onetimepad, SQ_SESSION);
-
 sqgetGlobalVar('smaction', $action, SQ_POST);
 
 /* end of get globals */
 
-echo '<br />' .
-    html_tag( 'table', '', 'center', $color[0], 'width="95%" cellpadding="1" cellspacing="0" border="0"' ) .
-        html_tag( 'tr' ) .
-            html_tag( 'td', '', 'center' ) . '<b>' . _("Folders") . '</b>' .
-                html_tag( 'table', '', 'center', '', 'width="100%" cellpadding="5" cellspacing="0" border="0"' ) .
-                    html_tag( 'tr' ) .
-                        html_tag( 'td', '', 'center', $color[4] );
-
-$imapConnection = sqimap_login ($username, $key, $imapServerAddress, $imapPort, 0);
+$imapConnection = sqimap_login ($username, false, $imapServerAddress, $imapPort, 0);
 
 /* switch to the right function based on what the user selected */
 if ( sqgetGlobalVar('smaction', $action, SQ_POST) ) {
-
     switch ($action)
     {
         case 'create':
@@ -74,7 +57,7 @@ if ( sqgetGlobalVar('smaction', $action, SQ_POST) ) {
                 sqgetGlobalVar('orig',        $orig,     SQ_POST);
                 sqgetGlobalVar('old_name',    $old_name, SQ_POST);
                 folders_rename_do($imapConnection, $delimiter, $orig, $old_name, $new_name);
-                $td_str =  _("Renamed successfully!");
+                $td_str =  _("Renamed successfully.");
             }
             break;
         case 'delete':
@@ -99,49 +82,44 @@ if ( sqgetGlobalVar('smaction', $action, SQ_POST) ) {
             folders_unsubscribe($imapConnection, $folder_names);
             $td_str =  _("Unsubscribed successfully.");
             break;
-    } 
+        default:
+// TODO: this is a new hook for plugin action processing that has not been TESTED.
+            $td_str = do_hook('folder_action', $action);
+            break;
+    }
 
-    echo html_tag( 'table',
-                html_tag( 'tr',
-                     html_tag( 'td', '<b>' . $td_str . "</b><br />\n" .
-                               '<a href="../src/left_main.php" target="left">' .
-                               _("refresh folder list") . '</a>' ,
-                     'center' )
-                ) ,
-            'center', '', 'width="100%" cellpadding="4" cellspacing="0" border="0"' );
 }
 
-echo "\n<br />";
+if (isset($td_str)) {
+    $oTemplate->assign('note', htmlspecialchars($td_str));
+    $oTemplate->display('note.tpl');
+}
 
 $boxes = sqimap_mailbox_list($imapConnection,true);
 
 /** CREATING FOLDERS **/
-echo html_tag( 'table', '', 'center', '', 'width="70%" cellpadding="4" cellspacing="0" border="0"' ) .
-            html_tag( 'tr',
-                html_tag( 'td', '<b>' . _("Create Folder") . '</b>', 'center', $color[9] )
-            ) .
-            html_tag( 'tr' ) .
-                html_tag( 'td', '', 'center', $color[0] ) .
-     addForm('folders.php', 'post', 'cf').
-     addHidden('smaction','create').
-     addInput('folder_name', '', 25).
-     "<br />\n". _("as a subfolder of"). '<br />'.
-     "<tt><select name=\"subfolder\">\n";
 
 $show_selected = array();
 $skip_folders = array();
 $server_type = strtolower($imap_server_type);
+
+// Special handling for courier
 if ( $server_type == 'courier' ) {
-  array_push($skip_folders, 'inbox.trash');
-  if ( $default_folder_prefix == 'INBOX.' ) {
-    array_push($skip_folders, 'INBOX');
-  }
+    if ( $default_folder_prefix == 'INBOX.' ) {
+        // We don't need INBOX, since it is top folder
+        array_push($skip_folders, 'INBOX');
+    }
+} elseif ( $server_type == 'bincimap' ) {
+    if ( $default_folder_prefix == 'INBOX/' ) {
+        // We don't need INBOX, since it is top folder
+        array_push($skip_folders, 'INBOX');
+    }
 }
 
 if ( $default_sub_of_inbox == false ) {
-    echo '<option selected="selected" value="">[ '._("None")." ]</option>\n";
+    $mbx_option_list = '<option selected="selected" value="">[ '._("None")." ]</option>\n";
 } else {
-    echo '<option value="">[ '._("None")." ]</option>\n";
+    $mbx_option_list = '<option value="">[ '._("None")." ]</option>\n";
     $show_selected = array('inbox');
 }
 
@@ -149,224 +127,72 @@ if ( $default_sub_of_inbox == false ) {
 // the arrays of folders to include or skip (assembled above),
 // use 'noinferiors' as a mailbox filter to leave out folders that can not contain other folders.
 // use the long format to show subfolders in an intelligible way if parent is missing (special folder)
-echo sqimap_mailbox_option_list($imapConnection, $show_selected, $skip_folders, $boxes, 'noinferiors', true);
+$mbx_option_list .= sqimap_mailbox_option_list($imapConnection, $show_selected, $skip_folders, $boxes, 'noinferiors', true);
 
-echo "</select></tt>\n";
-if ($show_contain_subfolders_option) {
-    echo '<br />'.
-         addCheckBox('contain_subs', FALSE, '1') .' &nbsp;'
-       . _("Let this folder contain subfolders")
-       . '<br />';
-}
-echo "<input type=\"submit\" value=\""._("Create")."\" />\n";
-echo "</form></td></tr>\n";
-
-echo html_tag( 'tr',
-            html_tag( 'td', '&nbsp;', 'left', $color[4] )
-        ) ."\n";
 
 /** count special folders **/
-
-// FIX ME, why not check if the folders are defined IMHO move_to_sent, move_to_trash has nothing todo with it
-$count_special_folders = 0;
-$num_max = 1;
-if (strtolower($imap_server_type) == "courier" || $move_to_trash) {
-    $num_max++;
-}
-if ($move_to_sent) {
-    $num_max++;
-}
-if ($save_as_draft) {
-    $num_max++;
-}
-
-// What if move_to_sent = false and $sent_folder is set? Should it still be skipped?
-
-for ($p = 0, $cnt = count($boxes); $p < $cnt && $count_special_folders < $num_max; $p++) {
-    switch ($boxes[$p]['unformatted']) {
-        case (strtoupper($boxes[$p]['unformatted']) == 'INBOX'):
-            ++$count_special_folders;
-            $skip_folders[] = $boxes[$p]['unformatted'];
-            break;
-        // FIX ME inbox.trash should be set in conf.pl
-        case 'inbox.trash':
-            if (strtolower($imap_server_type) == 'courier') {
-                ++$count_special_folders;
-            }
-            break;
-        case $trash_folder:
-            ++$count_special_folders;
-            $skip_folders[] = $trash_folder;
-            break;
-        case $sent_folder:
-            ++$count_special_folders;
-            $skip_folders[] = $sent_folder;
-            break;
-        case $draft_folder:
-            ++$count_special_folders;
-            $skip_folders[] = $draft_folder;
-            break;
-        default: break;
+foreach ($boxes as $index => $aBoxData) {
+    if (isSpecialMailbox($aBoxData['unformatted'],false) &&
+        ! in_array($aBoxData['unformatted'],$skip_folders)) {
+        $skip_folders[] = $aBoxData['unformatted'];
     }
 }
 
+/**
+ * Retrieve list of folders when special folders are excluded. Special folders
+ * should be unavailable in rename/delete/unsubscribe. Theoretically user can
+ * modify form and perform these operations with special folders, but if user
+ * manages to delete/rename/unsubscribe special folder by hacking form...
+ *
+ * If script or program depends on special folder, they should not assume that
+ * folder is available.
+ *
+ * $filtered_folders contains empty string or html formated option list.
+ */
+$rendel_folder_list = sqimap_mailbox_option_list($imapConnection, 0, $skip_folders, $boxes, NULL, true);
 
-/** RENAMING FOLDERS **/
-echo html_tag( 'tr',
-            html_tag( 'td', '<b>' . _("Rename a Folder") . '</b>', 'center', $color[9] )
-        ) .
-        html_tag( 'tr' ) .
-        html_tag( 'td', '', 'center', $color[0] );
-
-/* show only if we have folders to rename */
-if ($count_special_folders < count($boxes)) {
-    echo addForm('folders.php')
-       . addHidden('smaction', 'rename')
-       . "<tt><select name=\"old_name\">\n"
-       . '         <option value="">[ ' . _("Select a folder") . " ]</option>\n";
-
-    // use existing IMAP connection, we have no special values to show,
-    // but we do include values to skip. Use the pre-created $boxes to save an IMAP query.
-    // send NULL for the flag - ALL folders are eligible for rename!
-    // use long format to make sure folder names make sense when parents may be missing.
-    echo sqimap_mailbox_option_list($imapConnection, 0, $skip_folders, $boxes, NULL, true);
 
-    echo "</select></tt>\n".
-         '<input type="submit" value="'.
-         _("Rename").
-         "\" />\n".
-         "</form></td></tr>\n";
-} else {
-    echo _("No folders found") . '<br /><br /></td></tr>';
-}
+$subbox_option_list = array();
 
-echo html_tag( 'tr',
-            html_tag( 'td', '&nbsp;', 'left', $color[4] )
-        ) ."\n";
+if ($show_only_subscribed_folders && !$no_list_for_subscribe) {
+    // FIXME: fix subscription options when top folder is not subscribed and sub folder is subscribed
 
-/** DELETING FOLDERS **/
-echo html_tag( 'tr',
-            html_tag( 'td', '<b>' . _("Delete Folder") . '</b>', 'center', $color[9] )
-        ) .
-        html_tag( 'tr' ) .
-        html_tag( 'td', '', 'center', $color[0] );
+    // TODO: use checkboxes instead of select options.
+    // DONE Steve Brown 2006-08-08
 
-/* show only if we have folders to delete */
-if ($count_special_folders < count($boxes)) {
-    echo addForm('folders.php')
-       . addHidden('smaction', 'delete')
-       . "<tt><select name=\"folder_name\">\n"
-       . '         <option value="">[ ' . _("Select a folder") . " ]</option>\n";
+    /** SUBSCRIBE TO FOLDERS **/
+    $boxes_all = sqimap_mailbox_list_all ($imapConnection);
 
-    // send NULL for the flag - ALL folders are eligible for delete (except what we've got in skiplist)
-    // use long format to make sure folder names make sense when parents may be missing.
-    echo sqimap_mailbox_option_list($imapConnection, 0, $skip_folders, $boxes, NULL, true);
+    // here we filter out all boxes we're already subscribed to,
+    // so we keep only the unsubscribed ones.
+    foreach ($boxes_all as $box_a) {
 
-    echo "</select></tt>\n"
-       . '<input type="submit" value="'
-       . _("Delete")
-       . "\" />\n"
-       . "</form></td></tr>\n";
-} else {
-    echo _("No folders found") . "<br /><br /></td></tr>";
+       $use_folder = true;
+       foreach ( $boxes as $box ) {
+           if ($box_a['unformatted'] == $box['unformatted'] ||
+               $box_a['unformatted-dm'] == $folder_prefix ) {
+               $use_folder = false;
+           }
+       }
+    
+       if ($use_folder) {
+           $box_enc  = htmlspecialchars($box_a['unformatted-dm']);
+           $box_disp = htmlspecialchars(imap_utf7_decode_local($box_a['unformatted-disp']));
+            $subbox_option_list[] = array( 'Value' => $box_enc, 'Display' => $box_disp);
+       }
+    }
 }
 
-echo html_tag( 'tr',
-            html_tag( 'td', '&nbsp;', 'left', $color[4] )
-        ) ."</table>\n";
-
-
-if ($show_only_subscribed_folders) {
-
-        /** UNSUBSCRIBE FOLDERS **/
-        echo html_tag( 'table', '', 'center', '', 'width="70%" cellpadding="4" cellspacing="0" border="0"' ) .
-                    html_tag( 'tr',
-                        html_tag( 'td', '<b>' . _("Unsubscribe") . '/' . _("Subscribe") . '</b>', 'center', $color[9], 'colspan="2"' )
-                    ) .
-                    html_tag( 'tr' ) .
-                        html_tag( 'td', '', 'center', $color[0], 'width="50%"' );
-
-        if ($count_special_folders < count($boxes)) {
-            echo addForm('folders.php')
-               . addHidden('smaction', 'unsubscribe')
-               . "<tt><select name=\"folder_names[]\" multiple=\"multiple\" size=\"8\">\n";
-           foreach ( $boxes as $box ) {
-                $use_folder = true;
-                if ((strtolower($box["unformatted"]) != "inbox") &&
-                    ($box['unformatted'] != $trash_folder) &&
-                    ($box['unformatted'] != $sent_folder) &&
-                    ($box['unformatted'] != $draft_folder)) {
-                    $box_enc  = htmlspecialchars($box['unformatted-dm']);
-                    $box_disp = str_replace(' ', '&nbsp;',
-                                        htmlspecialchars(imap_utf7_decode_local($box["unformatted-disp"])));
-                    echo "         <option value=\"$box_enc\">$box_disp</option>\n";
-                }
-            }
-            echo "</select></tt><br /><br />\n"
-               . '<input type="submit" value="'
-               . _("Unsubscribe")
-               . "\" />\n"
-               . "</form></td>\n";
-        } else {
-            echo _("No folders were found to unsubscribe from!") . '</td>';
-        }
-
-        /** SUBSCRIBE TO FOLDERS **/
-        echo html_tag( 'td', '', 'center', $color[0], 'width="50%"' );
-        if(!$no_list_for_subscribe) {
-            $boxes_all = sqimap_mailbox_list_all ($imapConnection);
+sqimap_logout($imapConnection);
 
-            $subboxes = array();
-            // here we filter out all boxes we're already subscribed to,
-            // so we keep only the unsubscribed ones.
-            foreach ($boxes_all as $box_a) {
-            
-                $use_folder = true;
-                foreach ( $boxes as $box ) {
-                    if ($box_a['unformatted'] == $box['unformatted'] ||
-                        $box_a['unformatted-dm'] == $folder_prefix ) {
-                        $use_folder = false;
-                    }
-                }
-            
-                if ($use_folder == true) {
-                       $box_enc  = htmlspecialchars($box_a['unformatted-dm']);
-                    $box_disp = htmlspecialchars(imap_utf7_decode_local($box_a['unformatted-disp']));
-                    $subboxes[$box_enc] = $box_disp;
-                }
-            }
-            
-            if ( count($subboxes) > 0 ) {
-                echo addForm('folders.php')
-                 . addHidden('smaction', 'subscribe')
-                 . '<tt><select name="folder_names[]" multiple="multiple" size="8">';
+$oTemplate->assign('show_subfolders_option', $show_contain_subfolders_option);
+$oTemplate->assign('show_only_subscribed_folders', $show_only_subscribed_folders==1);
+$oTemplate->assign('no_list_for_subscribe', $no_list_for_subscribe);
 
-                foreach($subboxes as $subbox_enc => $subbox_disp) {
-                    echo '         <option value="' . $subbox_enc . '">'.$subbox_disp."</option>\n";
-                }
+$oTemplate->assign('mbx_option_list', $mbx_option_list);
+$oTemplate->assign('rendel_folder_list', $rendel_folder_list);
+$oTemplate->assign('subbox_option_list', $subbox_option_list);
 
-                echo '</select></tt><br /><br />'
-                 . '<input type="submit" value="'. _("Subscribe") . "\" />\n"
-                 . "</form></td></tr></table><br />\n";
-            } else {
-                echo _("No folders were found to subscribe to.") . '</td></tr></table>';
-            }
-        } else {
-            /* don't perform the list action -- this is much faster */
-            echo addForm('folders.php')
-             . addHidden('smaction', 'subscribe')
-             . _("Subscribe to:") . '<br />'
-             . '<tt><input type="text" name="folder_names[]" size="35" />'
-             . '<input type="submit" value="'. _("Subscribe") . "\" />\n"
-             . "</form></td></tr></table><br />\n";
-        }
-}
+$oTemplate->display('folder_manip.tpl');
 
-do_hook('folders_bottom');
-sqimap_logout($imapConnection);
-?>
-    </td></tr>
-    </table>
-</td></tr>
-</table>
-</body></html>
+$oTemplate->display('footer.tpl');