' . nl2br($e($text_value)) . '
';
};
$logo = !empty($company['logo_url']) && !empty($config_base_url)
? '' . $e($company_name) . '
';
$body = '';
if (array_key_exists('name', $email) && $email['name'] !== null) {
$body .= $paragraph(trim((string) $email['name']) !== '' ? 'Hello ' . $email['name'] . ',' : 'Hello,');
}
foreach ((array) ($email['intro'] ?? []) as $text_value) {
$body .= $paragraph($text_value);
}
if (trim(strip_tags((string) ($email['content'] ?? ''), '' . emailMessageHtml($email['content']) . '
';
}
if (trim((string) ($email['note'] ?? '')) !== '') {
$body .= '' . nl2br($e(trim($email['callout']))) . '
';
}
if (!empty($email['button']['url'])) {
$body .= 'Or copy this into your browser: ' . $e($email['button']['url']) . '
';
}
}
foreach ((array) ($email['after'] ?? []) as $text_value) {
$body .= '' . nl2br($e($text_value)) . '
';
}
// The earlier messages, quietly, after everything else - a grey edge for the client's side, blue for yours
if (!empty($email['history']['items'])) {
$items = '';
foreach ($email['history']['items'] as $item) {
if (isset($item['gap'])) {
$gap = intval($item['gap']);
$items .= '··· ' . $gap . ' earlier ' . ($gap === 1 ? 'message' : 'messages') . ' - see the ticket
';
continue;
}
$meta = '' . $e($email['preview']) . str_repeat(' ', 40) . '
'
: '';
return ']*\bstyle=)/i', '![]()
])(?![^>]*\bstyle=)/i', ']*>.*?#is', '', $html);
$pictures = preg_match_all('##i', '##i', '##i', '#]*>#i'], ["\n", "\n\n", "\n", '- '], $html);
$text = html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8');
// Non-breaking and zero-width spaces too - unless the text isn't valid UTF-8, where /u gives up
$text = preg_replace("/[ \t\x{00A0}\x{200B}\x{200C}]+/u", ' ', $text) ?? preg_replace("/[ \t]+/", ' ', $text);
$text = trim((string) preg_replace(["/ *\n */", "/\n{3,}/"], ["\n", "\n\n"], $text));
if ($text === '' && $pictures) {
return $pictures === 1 ? '[A picture]' : "[$pictures pictures]";
}
if ($limit > 0 && mb_strlen($text) > $limit) {
$cut = mb_substr($text, 0, $limit);
$space = mb_strrpos($cut, ' ');
$text = rtrim($space !== false && $space > $limit * 0.6 ? mb_substr($cut, 0, $space) : $cut, " \n,.;:-") . '…';
}
return $text;
}
/**
* Queue an email - one per recipient, each greeted by name, each address once.
* $recipients: [['email' => ..., 'name' => ..., 'greet' => name to greet (or
* '' for "Hello,", null for none), 'footnote' => why they get it], ...].
* $email is emailHtml()'s, its values raw. $opts:
* from ['email' => ..., 'name' => ...] - the system mailbox (emailFrom()) when not given
* attachments [['path' => app-relative, 'name' => ...], ...]
* cal_str a calendar file (iCalendar) to go with it - an invite or its cancellation
* queued_at when to send it, 'Y-m-d H:i:s' - now when not given
* always queue it even without mail set up, to go once it is - billing's Send
* windows have always done that (billingEmailQueue())
* ticket_reply_id the agent's ticket reply it carries - kept with each email
* (email_queue.email_ticket_reply_id), so the conversation says who
* it went to and whether it went (ticketReplyEmailed())
* Who it was queued to, "Name (email)". Nothing is queued without mail set up.
*/
function emailQueue(array $recipients, $subject, array $email, array $opts = []) {
global $mysqli;
if (!emailReady() && empty($opts['always'])) {
return [];
}
$from = $opts['from'] ?? emailFrom();
$queued_at = !empty($opts['queued_at']) && strtotime((string) $opts['queued_at']) ? date('Y-m-d H:i:s', strtotime((string) $opts['queued_at'])) : '';
$attachments = array_values(array_filter((array) ($opts['attachments'] ?? [])));
$data = [];
$sent = [];
foreach ($recipients as $recipient) {
$address = trim((string) ($recipient['email'] ?? ''));
if (!filter_var($address, FILTER_VALIDATE_EMAIL) || isset($sent[strtolower($address)])) {
continue;
}
$name = (string) ($recipient['name'] ?? '');
$html = emailHtml(array_merge($email, [
'name' => array_key_exists('greet', $recipient) ? $recipient['greet'] : $name,
], isset($recipient['footnote']) ? ['footnote' => $recipient['footnote']] : []));
$sent[strtolower($address)] = $name !== '' ? "$name ($address)" : $address;
if (emailCapturing()) {
$GLOBALS['itflow_email_capture'][] = ['to' => $address, 'to_name' => $name, 'from' => (string) $from['email'], 'from_name' => (string) $from['name'],
'subject' => (string) $subject, 'html' => $html, 'attachments' => $attachments, 'cal_str' => (string) ($opts['cal_str'] ?? '')];
continue;
}
$data[] = [
'from' => mysqli_real_escape_string($mysqli, (string) $from['email']),
'from_name' => mysqli_real_escape_string($mysqli, (string) $from['name']),
'recipient' => mysqli_real_escape_string($mysqli, $address),
'recipient_name' => mysqli_real_escape_string($mysqli, $name !== '' ? $name : $address),
'subject' => mysqli_real_escape_string($mysqli, (string) $subject),
'body' => mysqli_real_escape_string($mysqli, $html),
'attachments' => $attachments,
] + (!empty($opts['cal_str']) ? ['cal_str' => (string) $opts['cal_str']] : [])
+ ($queued_at !== '' ? ['queued_at' => $queued_at] : [])
+ (intval($opts['ticket_reply_id'] ?? 0) > 0 && ticketReplyEmailReady() ? ['ticket_reply_id' => intval($opts['ticket_reply_id'])] : []);
}
if ($data) {
addToMailQueue($data);
}
return array_values($sent);
}
/** The test email in Admin > Mail, from one of the mailboxes - system, ticket, invoice or quote. Who it went to - [] when it didn't. */
function emailTestSend($to, $mailbox) {
$box = ['ticket' => emailFrom('ticket'), 'invoice' => billingEmailFrom('invoice'), 'quote' => billingEmailFrom('quote')][$mailbox] ?? emailFrom();
$which = ['system' => 'the system mailbox', 'ticket' => 'the ticket mailbox', 'invoice' => 'the invoice mailbox', 'quote' => 'the quote mailbox'][$mailbox] ?? 'the system mailbox';
return emailQueue([['email' => trim((string) $to), 'greet' => '', 'footnote' => 'You get this because someone sent a test from Admin > Mail in ITFlow.']], 'Test email from ITFlow', [
'kind' => 'Test', 'tone' => 'success', 'preview' => "A test from $which",
'title' => 'Mail is working',
'intro' => ["This is a test email from ITFlow, sent from $which. If you are reading this, it worked."],
'summary' => ['From' => trim($box['name'] . ' <' . $box['email'] . '>'), 'To' => trim((string) $to), 'Sent' => date('D j M Y, g:i A')],
], ['from' => ['email' => $box['email'], 'name' => $box['name']]]);
}
/*
* Send an email from the contacts or clients list (agent/includes/bulk_email_fields.php)
* to $recipients (emailBulkSend()'s), $picked how many were asked for - then
* say what happened and go back. Refuses without mail set up, a mailbox, a
* subject or a message.
*/
function emailBulkPost(array $recipients, $picked) {
global $session_name;
$mailbox = (string) ($_POST['mailbox'] ?? '');
$subject = trim((string) ($_POST['subject'] ?? ''));
$body = (string) ($_POST['body'] ?? '');
$at = trim((string) ($_POST['queued_at'] ?? ''));
$queued_at = $at !== '' && strtotime($at) ? date('Y-m-d H:i:s', strtotime($at)) : '';
if (!emailReady()) {
flashAlert('Outgoing mail is not set up, so nothing was sent', 'error');
redirect();
}
if (!isset(emailMailboxes()[$mailbox])) {
flashAlert('Pick the mailbox it comes from', 'error');
redirect();
}
if ($subject === '' || trim(strip_tags($body, '![]()
')) === '') {
flashAlert('Give it a subject and a message - nothing was sent', 'error');
redirect();
}
$sent = emailBulkSend($recipients, $mailbox, $_POST['mail_from_name'] ?? '', $subject, $body, !empty($_POST['greet']), $queued_at);
$count = count($sent);
if (!$count) {
flashAlert('None of them has an email address, so nothing was sent', 'error');
redirect();
}
$later = $queued_at !== '' && strtotime($queued_at) > time() ? ' to go ' . date('M j \a\t g:i A', strtotime($queued_at)) : '';
logAudit("Bulk Mail", "Send", "$session_name sent " . escapeSql($subject) . " to $count " . ($count === 1 ? 'contact' : 'contacts') . " via bulk mail" . ($later !== '' ? escapeSql($later) : ''));
$left_out = max(0, intval($picked) - $count);
flashAlert("$count email" . ($count === 1 ? '' : 's') . " queued$later" . ($left_out ? " - $left_out left out with no email address, or the same one" : ''));
redirect();
}
/*
* An email an agent writes to many contacts - Email on the contacts or clients
* list - in the email look, with the logo and the company's details. Each
* $recipients entry: email, name and footnote (why they get it). $body is the
* agent's HTML; $greet starts it "Hello Name,"; $from_name '' keeps the
* mailbox's own; $queued_at when to send ('' for now). Who it was queued to.
*/
function emailBulkSend(array $recipients, $mailbox, $from_name, $subject, $body, $greet = false, $queued_at = '') {
$boxes = emailMailboxes();
// A preview shows it before any mailbox is set up
$box = $boxes[$mailbox] ?? (emailCapturing() ? emailFrom() : null);
if (!$box) {
return [];
}
$from_name = trim((string) $from_name);
if (!$greet) {
$recipients = array_map(function ($recipient) {
return ['greet' => null] + $recipient;
}, $recipients);
}
return emailQueue($recipients, trim((string) $subject), [
'title' => trim((string) $subject),
'preview' => mb_substr(trim(preg_replace('/\s+/', ' ', html_entity_decode(strip_tags((string) $body), ENT_QUOTES, 'UTF-8'))), 0, 140),
'content' => (string) $body,
], ['from' => ['email' => $box['email'], 'name' => $from_name !== '' ? $from_name : $box['name']], 'queued_at' => $queued_at]);
}