6 * Implementation of RFC 2369 for SquirrelMail.
7 * When viewing a message from a mailinglist complying with this RFC,
8 * this plugin displays a menu which gives the user a choice of mailinglist
9 * commands such as (un)subscribe, help and list archives.
11 * @copyright 1999-2020 The SquirrelMail Project Team
12 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
15 * @subpackage listcommands
19 * Get current list of subscribed non-RFC-compliant mailing lists for logged-in user
21 * @return array The list of mailing list addresses, keyed by integer index
23 function get_non_rfc_lists() {
24 global $username, $data_dir;
25 $lists = getPref($data_dir, $username, 'non_rfc_lists', array());
28 $lists = explode(':', $lists);
29 foreach ($lists as $list) {
30 list($index, $list_addr) = explode('_', $list);
31 if ((!empty($index) ||
$index === '0') && !empty($list_addr))
32 $new_lists[$index] = $list_addr;
41 * Show mailing list management option section on options page
43 function plugin_listcommands_optpage_register_block_do()
45 global $optpage_blocks, $listcommands_allow_non_rfc_list_management;
47 // only allow management of non-RFC lists if admin deems necessary
49 @include_once
(SM_PATH
. 'plugins/listcommands/config.php');
50 if (!$listcommands_allow_non_rfc_list_management)
53 $optpage_blocks[] = array(
54 'name' => _("Mailing Lists"),
55 'url' => '../plugins/listcommands/options.php',
56 'desc' => _("Manage the (non-RFC-compliant) mailing lists that you are subscribed to for the purpose of providing one-click list replies when responding to list messages."),
63 * internal function that builds mailing list links
65 function plugin_listcommands_menu_do() {
66 global $passed_id, $passed_ent_id, $mailbox, $message,
67 $startMessage, $oTemplate, $listcommands_allow_non_rfc_list_management;
69 @include_once
(SM_PATH
. 'plugins/listcommands/config.php');
72 * Array of commands we can deal with from the header. The Reply option
73 * is added later because we generate it using the Post information.
75 $fieldsdescr = listcommands_fieldsdescr();
78 foreach ($message->rfc822_header
->mlist
as $cmd => $actions) {
80 /* I don't know this action... skip it */
81 if ( !array_key_exists($cmd, $fieldsdescr) ) {
85 /* proto = {mailto,href} */
86 $aActions = array_keys($actions);
87 // note that we only use the first cmd/action, ignore the rest
88 $proto = array_shift($aActions);
89 $act = array_shift($actions);
91 if ($proto == 'mailto') {
95 if (($cmd == 'post') ||
($cmd == 'owner')) {
96 $url = 'src/compose.php?'.
97 (isset($startMessage)?
'startMessage='.$startMessage.'&':'');
99 $url = "plugins/listcommands/mailout.php?action=$cmd&";
101 // try to find which identity the mail should come from
102 include_once(SM_PATH
. 'functions/identity.php');
103 $idents = get_identities();
104 // ripped from src/compose.php
105 $identities = array();
106 if (count($idents) > 1) {
107 foreach($idents as $nr=>$data) {
108 $enc_from_name = '"'.$data['full_name'].'" <'. $data['email_address'].'>';
109 $identities[] = $enc_from_name;
112 $identity_match = $message->rfc822_header
->findAddress($identities);
113 if ($identity_match !== FALSE) {
114 $identity = $identity_match;
119 // if things like subject are given, peel them off and give
120 // them to src/compose.php as is (not encoded)
121 if (strpos($act, '?') > 0) {
122 list($act, $parameters) = explode('?', $act, 2);
123 $parameters = '&identity=' . $identity . '&' . $parameters;
125 $parameters = '&identity=' . $identity;
128 $url .= 'send_to=' . urlencode($act) . $parameters;
130 $links[$cmd] = makeComposeLink($url, $fieldsdescr[$cmd]);
132 if ($cmd == 'post') {
133 if (!isset($mailbox))
135 $url .= '&passed_id='.$passed_id.
136 '&mailbox='.urlencode($mailbox).
137 (isset($passed_ent_id)?
'&passed_ent_id='.$passed_ent_id:'');
138 $url .= '&smaction=reply';
140 $links['reply'] = makeComposeLink($url, $fieldsdescr['reply']);
142 } else if ($proto == 'href') {
143 $links[$cmd] = create_hyperlink($act, $fieldsdescr[$cmd], '_blank');
148 // allow non-rfc reply link if admin allows and message is from
149 // non-rfc list the user has configured
151 if ($listcommands_allow_non_rfc_list_management) {
153 $non_rfc_lists = get_non_rfc_lists();
155 $recipients = formatRecipientString($message->rfc822_header
->to
, "to") . ' '
156 . formatRecipientString($message->rfc822_header
->cc
, "cc") . ' '
157 . formatRecipientString($message->rfc822_header
->bcc
, "bcc");
159 if (!in_array('post', array_keys($links))) {
161 foreach ($non_rfc_lists as $non_rfc_list) {
162 if (preg_match('/(^|,|<|\s)' . preg_quote($non_rfc_list) . '($|,|>|\s)/', $recipients)) {
163 $url = 'src/compose.php?'
164 . (isset($startMessage)?
'startMessage='.$startMessage.'&':'')
165 . 'send_to=' . str_replace('?','&', $non_rfc_list);
167 $links['post'] = makeComposeLink($url, $fieldsdescr['post']);
175 if (!in_array('reply', array_keys($links))) {
177 foreach ($non_rfc_lists as $non_rfc_list) {
178 if (preg_match('/(^|,|\s)' . preg_quote($non_rfc_list) . '($|,|\s)/', $recipients)) {
179 if (!isset($mailbox))
181 $url = 'src/compose.php?'
182 . (isset($startMessage)?
'startMessage='.$startMessage.'&':'')
183 . 'send_to=' . str_replace('?','&', $non_rfc_list)
184 . '&passed_id='.$passed_id
185 . '&mailbox='.urlencode($mailbox)
186 . (isset($passed_ent_id)?
'&passed_ent_id='.$passed_ent_id:'')
187 . '&smaction=reply';
189 $links['reply'] = makeComposeLink($url, $fieldsdescr['reply']);
200 if (count($links) > 0) {
201 $oTemplate->assign('links', $links);
202 $output = $oTemplate->fetch('plugins/listcommands/read_body_header.tpl');
203 return array('read_body_header' => $output);
209 * Returns an array with the actions as translated strings.
210 * @return array action as key, translated string as value
212 function listcommands_fieldsdescr() {
213 return array('post' => _("Post to List"),
214 'reply' => _("Reply to List"),
215 'subscribe' => _("Subscribe"),
216 'unsubscribe' => _("Unsubscribe"),
217 'archive' => _("List Archives"),
218 'owner' => _("Contact Listowner"),
219 'help' => _("Help"));