4 * setup.php -- Sent Subfolders Setup File
6 * Copyright (c) 1999-2002 The SquirrelMail Project Team
7 * Licensed under the GNU GPL. For full terms see the file COPYING.
9 * This is a standard Squirrelmail-1.2 API for plugins.
14 define('SMPREF_SENT_SUBFOLDERS_DISABLED', 0);
15 define('SMPREF_SENT_SUBFOLDERS_YEARLY', 1);
16 define('SMPREF_SENT_SUBFOLDERS_QUARTERLY', 2);
17 define('SMPREF_SENT_SUBFOLDERS_MONTHLY', 3);
18 define('SMOPT_GRP_SENT_SUBFOLDERS','SENT_SUBFOLDERS');
20 function squirrelmail_plugin_init_sent_subfolders() {
21 /* Standard initialization API. */
22 global $squirrelmail_plugin_hooks;
24 /* The hooks to make the sent subfolders display correctly. */
25 $squirrelmail_plugin_hooks
26 ['check_handleAsSent_result']['sent_subfolders'] =
27 'sent_subfolders_check_handleAsSent';
29 /* The hooks to automatically update sent subfolders. */
30 $squirrelmail_plugin_hooks
31 ['left_main_before']['sent_subfolders'] =
32 'sent_subfolders_update_sentfolder';
34 $squirrelmail_plugin_hooks
35 ['compose_send']['sent_subfolders'] =
36 'sent_subfolders_update_sentfolder';
38 /* The hook to load the sent subfolders prefs. */
39 $squirrelmail_plugin_hooks
40 ['loading_prefs']['sent_subfolders'] =
41 'sent_subfolders_load_prefs';
43 /* The hooks to handle sent subfolders options. */
44 $squirrelmail_plugin_hooks
45 ['optpage_loadhook_folder']['sent_subfolders'] =
46 'sent_subfolders_optpage_loadhook_folders';
49 function sent_subfolders_check_handleAsSent() {
50 global $handleAsSent_result, $sent_subfolders_base;
51 global $use_sent_subfolders;
52 $sent_subfolders_base = 'INBOX.Sent';
53 $args = func_get_arg(0);
55 /* Only check the folder string if we have been passed a mailbox. */
56 if ($use_sent_subfolders && (count($args) > 1)) {
57 /* Chop up the folder strings as needed. */
58 $base_str = $sent_subfolders_base . $delimiter;
59 $mbox_str = substr($args[1], 0, strlen($base_str));
61 /* Perform the comparison. */
62 $handleAsSent_result =
63 ( $handleAsSent_result
64 ||
($base_str == $mbox_str)
65 ||
($sent_subfolders_base == $args[1])
70 function sent_subfolders_load_prefs() {
71 global $use_sent_subfolders;
72 global $sent_subfolders_setting, $sent_subfolders_base;
74 $use_sent_subfolders = getPref
75 ($data_dir, $username, 'use_sent_subfolders', SMPREF_OFF
);
77 $sent_subfolders_setting = getPref
78 ($data_dir, $username, 'sent_subfolders_setting', SMPREF_SENT_SUBFOLDERS_DISABLED
);
80 $sent_subfolders_base = getPref
81 ($data_dir, $username, 'sent_subfolders_base', SMPREF_NONE
);
84 function sent_subfolders_optpage_loadhook_folders() {
85 global $optpage_data, $username, $key, $imapServerAddress, $imapPort;
87 /* Get some imap data we need later. */
89 sqimap_login($username, $key, $imapServerAddress, $imapPort, 0);
90 $boxes = sqimap_mailbox_list($imapConnection);
91 sqimap_logout($imapConnection);
93 /* Load the Sent Subfolder Options into an array. */
94 $optgrp = _("Sent Subfolders Options");
98 'name' => 'sent_subfolders_setting',
99 'caption' => _("Use Sent Subfolders"),
100 'type' => SMOPT_TYPE_STRLIST
,
101 'refresh' => SMOPT_REFRESH_FOLDERLIST
,
102 'posvals' => array(SMPREF_SENT_SUBFOLDERS_DISABLED
=> _("Disabled"),
103 SMPREF_SENT_SUBFOLDERS_MONTHLY
=> _("Monthly"),
104 SMPREF_SENT_SUBFOLDERS_QUARTERLY
=> _("Quarterly"),
105 SMPREF_SENT_SUBFOLDERS_YEARLY
=> _("Yearly")),
106 'save' => 'save_option_sent_subfolders_setting'
109 $sent_subfolders_base_values = array();
110 foreach ($boxes as $folder) {
111 if (strtolower($folder['unformatted']) != 'inbox') {
112 $real_value = $folder['unformatted-dm'];
113 $disp_value = str_replace(' ', ' ', $folder['formatted']);
114 $sent_subfolders_base_values[$real_value] = $disp_value;
119 'name' => 'sent_subfolders_base',
120 'caption' => _("Base Sent Folder"),
121 'type' => SMOPT_TYPE_STRLIST
,
122 'refresh' => SMOPT_REFRESH_FOLDERLIST
,
123 'posvals' => $sent_subfolders_base_values
126 /* Add our option data to the global array. */
127 $optpage_data['grps'][SMOPT_GRP_SENT_SUBFOLDERS
] = $optgrp;
128 $optpage_data['vals'][SMOPT_GRP_SENT_SUBFOLDERS
] = $optvals;
131 function save_option_sent_subfolders_setting($option) {
132 global $data_dir, $username, $use_sent_subfolders;
134 /* Set use_sent_subfolders as either on or off. */
135 if ($option->new_value
== SMPREF_SENT_SUBFOLDERS_DISABLED
) {
136 setPref($data_dir, $username, 'use_sent_subfolders', SMPREF_OFF
);
138 setPref($data_dir, $username, 'use_sent_subfolders', SMPREF_ON
);
139 setPref($data_dir, $username, 'move_to_sent', SMPREF_ON
);
142 /* Now just save the option as normal. */
143 save_option($option);
146 function sent_subfolders_update_sentfolder() {
147 global $sent_folder, $delimiter, $auto_create_special, $auto_create_done;
148 global $sent_subfolders_base, $sent_subfolders_setting;
149 global $username, $data_dir, $key, $imapServerAddress, $imapPort;
150 global $use_sent_subfolders, $move_to_sent, $imap_server_type;
152 if ($use_sent_subfolders ||
$move_to_sent) {
155 $quarter = sent_subfolder_getQuarter($month);
158 Regarding the structure we've got three main possibilities.
159 One sent holder. level 0.
160 Multiple year holders with messages in it. level 1.
161 Multiple year folders with holders in it. level 2.
164 if( $imap_server_type == 'uw' ) {
167 $cnd_delimiter = $delimiter;
170 switch ($sent_subfolders_setting) {
171 case SMPREF_SENT_SUBFOLDERS_YEARLY
:
173 $sent_subfolder = $sent_subfolders_base . $cnd_delimiter
176 case SMPREF_SENT_SUBFOLDERS_QUARTERLY
:
178 $sent_subfolder = $sent_subfolders_base . $cnd_delimiter
180 . $delimiter . $quarter;
181 $year_folder = $sent_subfolders_base
184 case SMPREF_SENT_SUBFOLDERS_MONTHLY
:
186 $sent_subfolder = $sent_subfolders_base . $cnd_delimiter
188 . $delimiter . $month;
189 $year_folder = $sent_subfolders_base . $year;
191 case SMPREF_SENT_SUBFOLDERS_DISABLED
:
194 $sent_subfolder = $sent_folder;
195 $year_folder = $sent_folder;
198 /* If this folder is NOT the current sent folder, update stuff. */
199 if ($sent_subfolder != $sent_folder) {
200 /* First, update the sent folder. */
202 setPref($data_dir, $username, 'sent_folder', $sent_subfolder);
203 setPref($data_dir, $username, 'move_to_sent', SMPREF_ON
);
204 $sent_folder = $sent_subfolder;
205 $move_to_sent = SMPREF_ON
;
207 /* Auto-create folders, if they do not yet exist. */
208 if ($sent_folder != 'none') {
209 /* Create the imap connection. */
211 ($username, $key, $imapServerAddress, $imapPort, 10);
213 /* Auto-create the year folder, if it does not yet exist. */
214 if (!sqimap_mailbox_exists($ic, $year_folder)) {
215 sqimap_mailbox_create($ic, $year_folder, ($level==1)?
'':'noselect');
216 } else if (!sqimap_mailbox_is_subscribed($ic, $year_folder)) {
217 sqimap_subscribe($ic, $year_folder);
220 /* Auto-create the subfolder, if it does not yet exist. */
221 if (!sqimap_mailbox_exists($ic, $sent_folder)) {
222 sqimap_mailbox_create($ic, $sent_folder, '');
223 } else if (!sqimap_mailbox_is_subscribed($ic, $sent_subfolder)) {
224 sqimap_subscribe($ic, $sent_subfolder);
227 /* Close the imap connection. */
234 function sent_subfolder_getQuarter($month) {
260 /* Return the current quarter. */
261 return ('Q' . $result);