ManageMaillist::action_edit_parsers() - Code Metrics - elkarte/Elkarte - Measure and Improve Code Quality continuously with Scrutinizer

ManageMaillist::action_edit_parsers() F
last analyzed 2025-12-27 02:48 UTC

↳ Parent: ManageMaillist
Complexity

Conditions	20
Paths	12321
Size

Total Lines	105
Code Lines	53
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	0
CRAP Score	420
Importance

Changes
Metric	Value
cc	20
eloc	53
nc	12321
nop	0
dl	0
loc	105
ccs	0
cts	52
cp	0
crap	420
rs	0
c	0
b	0
f	0
How to fix Long Method Complexity

<?php

/**
 * This file contains maillist functions that are specifically done by administrators
 * and those with approve email permission
 *
 * @package   ElkArte Forum
 * @copyright ElkArte Forum contributors
 * @license   BSD http://opensource.org/licenses/BSD-3-Clause (see accompanying LICENSE.txt file)
 *
 * @version 2.0 Beta 1
 *
 */

namespace ElkArte\AdminController;

use BBC\ParserWrapper;
use ElkArte\AbstractController;
use ElkArte\Action;
use ElkArte\Cache\Cache;
use ElkArte\Converters\Html2Md;
use ElkArte\EventManager;
use ElkArte\Exceptions\Exception;
use ElkArte\Helper\DataValidator;
use ElkArte\Helper\Util;
use ElkArte\Languages\Txt;
use ElkArte\Maillist\MaillistPost;
use ElkArte\Maillist\MaillistPreview;
use ElkArte\SettingsForm\SettingsForm;
use ElkArte\User;

/**
 * This class is the administration maillist controller.
 *
 *  - Handles maillist configuration
 *  - Handles the showing, repairing, deleting, and bouncing failed emails
 *  - Handles the adding / editing / removing of both filters and parsers
 *
 * @package Maillist
 */
class ManageMaillist extends AbstractController
{
	/**
	 * Main dispatcher.
	 *
	 * This function checks permissions and passes control to the sub action.
	 *
	 * @event integrate_sa_manage_maillist Used to add more sub actions
	 * @see AbstractController::action_index()
	 * @uses Maillist template
	 */
	public function action_index()
	{
		global $context, $txt;

		// Template & language
		theme()->getTemplates()->load('Maillist');
		Txt::load('Maillist');

		// All the functions available
		$subActions = [
			'emaillist' => [$this, 'action_unapproved_email', 'permission' => 'approve_emails'],
			'approve' => [$this, 'action_approve_email', 'permission' => 'approve_emails'],
			'delete' => [$this, 'action_delete_email', 'permission' => 'approve_emails'],
			'bounce' => [$this, 'action_bounce_email', 'permission' => 'approve_emails'],
			'emailtemplates' => [$this, 'action_view_bounce_templates', 'permission' => 'approve_emails'],
			'view' => [$this, 'action_view_email', 'permission' => 'approve_emails'],
			'emailsettings' => [$this, 'action_settings', 'permission' => 'admin_forum'],
			'emailfilters' => [$this, 'action_list_filters', 'permission' => 'admin_forum'],
			'editfilter' => [$this, 'action_edit_filters', 'permission' => 'admin_forum'],
			'deletefilter' => [$this, 'action_delete_filters', 'permission' => 'admin_forum'],
			'emailparser' => [$this, 'action_list_parsers', 'permission' => 'admin_forum'],
			'editparser' => [$this, 'action_edit_parsers', 'permission' => 'admin_forum'],
			'deleteparser' => [$this, 'action_delete_parsers', 'permission' => 'admin_forum'],
			'sortparsers' => [$this, 'action_sort_parsers', 'permission' => 'admin_forum'],
			'sortfilters' => [$this, 'action_sort_filters', 'permission' => 'admin_forum'],
		];

		// Action Controller
		$action = new Action('manage_maillist');

		// Help is needed in most places, so load it up front
		require_once(SUBSDIR . '/Maillist.subs.php');

		// Default to sub action 'emaillist' if none was given, call integrate_sa_manage_maillist
		$subAction = $action->initialize($subActions, 'emaillist');

		// Final bits
		$context['page_title'] = $txt['ml_admin_configuration'];
		$context['sub_action'] = $subAction;

		// Create the tab area for the template.
		$context[$context['admin_menu_name']]['object']->prepareTabData([
			'title' => 'ml_admin_configuration',
			'help' => 'maillist_help_short',
			'description' => 'ml_configuration_desc',
			'tabs' => [
				'emailfilters' => [
					'description' => $txt['filters_title'],
				],
				'emailparser' => [
					'description' => $txt['parsers_title'],
				],
			]
		]);

		// If you have the permissions, then go Play
		$action->dispatch($subAction);
	}

	/**
	 * Main listing of failed emails.
	 *
	 * What it does
	 *
	 * - Shows the sender, key and subject of the email
	 * - Will show the found key if it was missing or possible sender if it was wrong
	 * - Icons/Actions to view, bounce, delete, or approve a failure
	 * - Accessed by ?action=admin;area=maillist;sa=emaillist
	 *
	 * @event integrate_list_view_email_errors
	 * @uses showlist sub template
	 */
	public function action_unapproved_email(): void
	{
		global $context, $modSettings, $txt;

		// Set an id if none was supplied
		$id = $this->_req->getQuery('e_id', 'intval', 0);
		if (empty($id) || $id <= 0)
		{
			$id = 0;
		}

		createToken('admin-ml', 'get');

		// Build the list option array to display the email data
		$listOptions = [
			'id' => 'view_email_errors',
			'title' => $txt['ml_emailerror'],
			'items_per_page' => $modSettings['defaultMaxMessages'],
			'no_items_label' => $txt['ml_emailerror_none'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist']),
			'default_sort_col' => 'id_email',
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort = '', int $id = 0): array => $this->list_maillist_unapproved($start, $items_per_page, $sort, $id),
				'params' => [
					$id,
				],
			],
			'get_count' => [
				'function' => 'list_maillist_count_unapproved',
			],
			'columns' => [
				'id_email' => [
					'header' => [
						'value' => $txt['id'],
						'class' => 'nowrap',
					],
					'data' => [
						'db' => 'id_email',
					],
					'sort' => [
						'default' => 'id_email ',
						'reverse' => 'id_email DESC',
					],
				],
				'error' => [
					'header' => [
						'value' => $txt['error'],
					],
					'data' => [
						'function' => static function ($rowData) {
							$error = $rowData['error_code'];
							if ($error === 'error_pm_not_found')
							{
								return '<span class="error">' . $rowData['error'] . '<span>';
							}

							return $rowData['error'];
						},
					],
					'sort' => [
						'default' => 'error ',
						'reverse' => 'error DESC',
					],
				],
				'subject' => [
					'header' => [
						'value' => $txt['subject'],
					],
					'data' => [
						'db' => 'subject',
					],
					'sort' => [
						'default' => 'subject',
						'reverse' => 'subject DESC',
					],
				],
				'key' => [
					'header' => [
						'value' => $txt['key'],
					],
					'data' => [
						'db' => 'key',
						'class' => 'wordbreak'
					],
					'sort' => [
						'default' => 'message_key',
						'reverse' => 'message_key DESC',
					],
				],
				'message' => [
					'header' => [
						'value' => $txt['message_id'],
					],
					'data' => [
						'sprintf' => [
							'format' => '<a href="%1$s">%2$s</a>',
							'params' => [
								'link' => true,
								'message' => true,
							],
						],
					],
					'sort' => [
						'default' => 'message_id',
						'reverse' => 'message_id DESC',
					],
				],
				'from' => [
					'header' => [
						'value' => $txt['from'],
					],
					'data' => [
						'db' => 'from',
					],
					'sort' => [
						'default' => 'email_from',
						'reverse' => 'email_from DESC',
					],
				],
				'type' => [
					'header' => [
						'value' => $txt['message_type'],
					],
					'data' => [
						'function' => static function ($rowData) {
							global $txt;

							// Do we have a type?
							if (empty($rowData['type']))
							{
								return $txt['not_applicable'];
							}

							// Personal?
							if ($rowData['type'] === 'p')
							{
								return $txt['personal_message'];
							}

							// New Topic?
							if ($rowData['type'] === 'x')
							{
								return $txt['new_topic'];
							}

							return $txt['topic'] . ' ' . $txt['reply'];
						},
					],
					'sort' => [
						'default' => 'message_type',
						'reverse' => 'message_type DESC',
					],
				],
				'action' => [
					'header' => [
						'value' => $txt['message_action'],
					],
					'data' => [
						'function' => static function ($rowData) {
							global $context, $txt;

							$id = $rowData['id_email'] . ';';
							$commands = [];
							$security = $context['session_var'] . '=' . $context['session_id'] . ';' . $context['admin-ml_token_var'] . '=' . $context['admin-ml_token'];

							if ($rowData['error_code'] === 'error_pm_not_found')
							{
								$commands[] = '<a href="?action=admin;area=maillist;sa=approve;item=' . $id . $security . '" onclick="return confirm(' . JavaScriptEscape($txt['pm_approve_warning']) . ') && submitThisOnce(this);"><i class="icon i-check" title="' . $txt['approve'] . '"></i></a>&nbsp;';
							}
							else
							{
								$commands[] = '<a href="?action=admin;area=maillist;sa=approve;item=' . $id . $security . '"><i class="icon i-check" title="' . $txt['approve'] . '"></i></a>&nbsp;';
							}

							$commands[] = '<a href="?action=admin;area=maillist;sa=delete;item=' . $id . $security . '" onclick="return confirm(' . JavaScriptEscape($txt['delete_warning']) . ') && submitThisOnce(this);" accesskey="d"><i class="icon i-delete" title="' . $txt['delete'] . '"></i></a><br />';
							$commands[] = '<a href="?action=admin;area=maillist;sa=bounce;item=' . $id . $security . '"><i class="icon i-sign-out" title="' . $txt['bounce'] . '"></i></a>&nbsp;';
							$commands[] = '<a href="?action=admin;area=maillist;sa=view;item=' . $id . $security . '"><i class="icon i-view" title="' . $txt['view'] . '"></i></a>';

							return implode('', $commands);
						},
					],
					'class' => 'listaction',
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emaillist']),
				'include_sort' => true,
				'include_start' => true,
			],
			'additional_rows' => [
				[
					'position' => 'after_title',
					'class' => isset($_SESSION['email_error'], $_SESSION['email_error_type']) ? 'successbox' : (isset($_SESSION['email_error']) ? 'errorbox' : 'description'),
					'value' => $this->_req->session->email_error ?? $txt['heading'],
				],
			],
		];

		// Clear any errors
		unset($_SESSION['email_error'], $_SESSION['email_error_type']);

		// Set the context values for the template
		$context['page_title'] = $txt['emailerror_title'];
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'view_email_errors';

		// Create the list.
		createList($listOptions);
	}

	/**
	 * Show a failed email for review by the moderation team
	 *
	 * What it does:
	 *
	 * - Will not show a PM if it has been identified as such
	 * - Accessed by ?action=admin;area=maillist;sa=view;item=?
	 *
	 * @uses show_email sub template
	 */
	public function action_view_email(): void
	{
		global $txt, $context;

		checkSession('get');
		validateToken('admin-ml', 'get');

		$id = $this->_req->getQuery('item', 'intval');
		if (!empty($id))
		{
			// Load up the email details, no funny biz ;)
			$temp_email = list_maillist_unapproved($id);

			if (!empty($temp_email))
			{
				if ($temp_email[0]['type'] !== 'p' && allowedTo('approve_emails'))
				{
					// The raw email that failed
					$data = $temp_email[0]['body'];

					// Read/parse this message for viewing
					$controller = new MaillistPreview(new EventManager());
					$controller->setUser(User::$info);
					$result = $controller->action_pbe_preview($data);
					$text = $result['body'] ?? '';
					$email_to = $result['to'] ?? '';
				}
				else
				{
					// PM's mean just that ...
					$text = $txt['noaccess'];
					$email_to = $txt['private'];
				}
			}
			else
			{
				$text = $txt['badid'];
			}
		}
		else
		{
			$text = $txt['badid'];
		}

		$parser = ParserWrapper::instance();

		// Prep and show the template with what we found
		$context['body'] = $parser->parseEmail($text);
		$context['to'] = $email_to ?? '';
		$context['notice_subject'] = $temp_email[0]['subject'] ?? '';
		$context['notice_from'] = $temp_email[0]['from'] ?? '';
		$context['page_title'] = $txt['show_notice'];
		$context['error_code'] = isset($temp_email[0]['error_code'], $txt[$temp_email[0]['error_code']]) ? $txt[$temp_email[0]['error_code']] : '';

		$context['sub_template'] = 'show_email';
	}

	/**
	 * Deletes an entry from the database
	 *
	 * What it does:
	 *
	 * - Flushes the moderator menu to-do numbers so the menu numbers update
	 * - Accessed by ?action=admin;area=maillist;sa=delete;item=?
	 * - Redirects to ?action=admin;area=maillist;sa=emaillist
	 */
	public function action_delete_email(): void
	{
		checkSession('get');
		validateToken('admin-ml', 'get');

		$id = $this->_req->getQuery('item', 'intval');

		// Remove this entry
		if (!empty($id))
		{
			maillist_delete_error_entry($id);
		}

		// Flush the cache
		Cache::instance()->remove('num_menu_errors');

		// Back to the failed list we go
		redirectexit('action=admin;area=maillist;sa=emaillist');
	}

	/**
	 * Attempts to approve and post a failed email
	 *
	 * What it does:
	 *
	 * - Reviews the data to see if the email error function fixed typical issues like key and wrong id
	 * - Submits the fixed email to the main function which will post it or fail it again
	 * - If successful will remove the entry from the failed log.
	 * - Accessed by ?action=admin;area=maillist;sa=approve;item=?
	 * - Redirects to action=admin;area=maillist;sa=emaillist.
	 */
	public function action_approve_email(): void
	{
		global $txt;

		checkSession('get');
		validateToken('admin-ml', 'get');

		// Get the id to approve
		$id = $this->_req->getQuery('item', 'intval');

		if (!empty($id) && $id !== -1)
		{
			// Load up the email data
			$temp_email = list_maillist_unapproved($id);
			if (!empty($temp_email))
			{
				// Do we have the necessary data to approve this; after all, it failed for a reason yes?
				if (!empty($temp_email[0]['key']) && (!in_array($temp_email[0]['error_code'], ['error_no_message', 'error_not_find_board', 'error_topic_gone'])))
				{
					// Set up the details needed to get this posted
					$key = $temp_email[0]['key'] . '-' . $temp_email[0]['type'] . $temp_email[0]['message'];
					$data = $temp_email[0]['body'];

					// Unknown from email?  Update the message ONLY if we found an appropriate one during the error checking process
					if (in_array($temp_email[0]['error_code'], ['error_not_find_member', 'error_key_sender_match']))
					{
						// did we actually find a potential correct name, if so we post from the valid member?
						$check_emails = array_pad(explode('=>', $temp_email[0]['from']), 2, '');

						if (!empty($check_emails[1]))
						{
							$data = preg_replace('~(From: )(.*<)?(' . preg_quote(trim($check_emails[0]), '~') . ')(>)?(\n)~i', '$1$2' . trim($check_emails[1]) . '$4$5', $data);
						}
					}

					// Let's TRY AGAIN to make a post!
					$controller = new MaillistPost(new EventManager());
					$controller->setUser(User::$info);
					$text = $controller->action_pbe_post($data, true, $key);

					// Assuming all went well, remove this entry and file since we are done.
					if ($text)
					{
						maillist_delete_error_entry($id);

						// Flush the menu count cache
						Cache::instance()->remove('num_menu_errors');

						$_SESSION['email_error'] = $txt['approved'];
						$_SESSION['email_error_type'] = 1;
					}
					else
					{
						$_SESSION['email_error'] = $txt['error_approved'];
					}
				}
				else
				{
					$_SESSION['email_error'] = $txt['cant_approve'];
				}
			}
			else
			{
				$_SESSION['email_error'] = $txt['badid'];
			}
		}
		else
		{
			$_SESSION['email_error'] = $txt['badid'];
		}

		// back to the list we go
		redirectexit('action=admin;area=maillist;sa=emaillist');
	}

	/**
	 * Allows the admin to choose from predefined and custom templates
	 *
	 * What it does:
	 *
	 * - Uses the selected template to send a bounce notification with
	 * details as specified by the template.
	 * - Accessed by ?action=admin;area=maillist;sa=bounce;item=?
	 * - Redirects to action=admin;area=maillist;sa=bounced
	 * - Provides {MEMBER}, {SCRIPTURL}, {FORUMNAME}, {REGARDS}, {SUBJECT}, {ERROR},
	 * {FORUMNAMESHORT}, {EMAILREGARDS} replaceable values to the template.
	 *
	 * @uses bounce_email sub-template
	 */
	public function action_bounce_email(): void
	{
		global $context, $txt, $modSettings, $scripturl, $mbname;

		if ($this->_req->hasQuery('bounce'))
		{
			checkSession('get');
			validateToken('admin-ml', 'get');
		}

		require_once(SUBSDIR . '/Mail.subs.php');

		// We should have been sent an email ID
		$id = $this->_req->get('item', 'intval');
		if (!empty($id))
		{
			// Load up the email details, no funny biz y'all ;)
			$temp_email = list_maillist_unapproved($id);

			if (!empty($temp_email))
			{
				// Set the options
				$this->_req->post->item = (int) $temp_email[0]['id_email'];
				$fullerrortext = $txt[$temp_email[0]['error_code']];

				// Build the template selection area, first the standard ones
				$bounce = ['bounce', 'inform'];
				foreach ($bounce as $k => $type)
				{
					$context['bounce_templates'][$k]['body'] = $txt['ml_' . $type . '_body'];
					$context['bounce_templates'][$k]['subject'] = $txt['ml_' . $type . '_subject'];
					$context['bounce_templates'][$k]['title'] = $txt['ml_' . $type . '_title'];
				}

				// And now any custom ones available for this moderator
				$context['bounce_templates'] += array_merge($context['bounce_templates'], maillist_templates('bnctpl', $txt['ml_bounce_template_subject_default']));

				// Replace all the variables in the templates
				foreach ($context['bounce_templates'] as $k => $name)
				{
					$context['bounce_templates'][$k]['body'] = strtr($name['body'], [
						'{MEMBER}' => un_htmlspecialchars($temp_email[0]['name']),
						'{SCRIPTURL}' => $scripturl,
						'{FORUMNAME}' => $mbname,
						'{REGARDS}' => replaceBasicActionUrl($txt['regards_team']),
						'{SUBJECT}' => $temp_email[0]['subject'],
						'{ERROR}' => $fullerrortext,
						'{FORUMNAMESHORT}' => (empty($modSettings['maillist_sitename']) ? $mbname : $modSettings['maillist_sitename']),
						'{EMAILREGARDS}' => (empty($modSettings['maillist_sitename_regards']) ? '' : $modSettings['maillist_sitename_regards']),
					]);
				}
			}
			else
			{
				$context['settings_message'] = $txt['badid'];
			}
		}
		else
		{
			$context['settings_message'] = $txt['badid'];
		}

		// Check if they are sending the notice
		if (isset($this->_req->post->bounce, $temp_email))
		{
			checkSession();
			validateToken('admin-ml');

			// They did check the box, how else could they have posted
			if (isset($this->_req->post->warn_notify))
			{
				// let's make sure we have the items to send it
				$check_emails = explode('=>', $temp_email[0]['from']);
				$to = trim($check_emails[0]);
				$subject = trim($this->_req->post->warn_sub);
				$body = trim($this->_req->post->warn_body);

				if ($body === '' || $body === '0' || ($subject === '' || $subject === '0'))
				{
					$context['settings_message'] = $txt['bad_bounce'];
				}
				else
				{
					// Time for someone to get a "we're so sorry" message!
					$mark_down = new Html2Md($body);
					$body = $mark_down->get_markdown();
					sendmail($to, $subject, $body, null, null, false, 5);
					redirectexit('action=admin;area=maillist;bounced');
				}
			}
		}

		// Prepare and show the template
		createToken('admin-ml');
		$context['warning_data'] = ['notify' => '', 'notify_subject' => '', 'notify_body' => ''];
		$context['body'] = isset($fullerrortext) ? ParserWrapper::instance()->parseEmail($fullerrortext) : '';
		$context['item'] = $this->_req->hasPost('item') ?? '';
		$context['notice_to'] = $txt['to'] . ' ' . isset($temp_email[0]['from']) !== '' ? $temp_email[0]['from'] : '';

		$context['page_title'] = $txt['bounce_title'];
		$context['sub_template'] = 'bounce_email';
	}

	/**
	 * List all the filters in the system
	 *
	 * What it does:
	 *
	 * - Allows adding/editing or deleting filters.
	 * - Filters are used to alter text in a post, to remove crud that comes with emails.
	 * - Filters can be defined as regex, the system will check it for valid syntax.
	 * - Accessed by ?action=admin;area=maillist;sa=emailfilters;
	 *
	 * @event integrate_list_email_filter
	 */
	public function action_list_filters(): void
	{
		global $context, $txt, $modSettings;

		$id = 0;

		// Build the listoption array to display the filters
		$listOptions = [
			'id' => 'email_filter',
			'title' => $txt['filters'],
			'items_per_page' => $modSettings['defaultMaxMessages'],
			'no_items_label' => $txt['no_filters'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailfilters']),
			'default_sort_col' => 'name',
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort, int $id, string $style): array => $this->load_filter_parser($start, $items_per_page, $sort, $id, $style),
				'params' => [
					$id,
					'filter'
				],
			],
			'get_count' => [
				'function' => fn(int $id, string $style): int => $this->count_filter_parser($id, $style),
				'params' => [
					$id,
					'filter'
				],
			],
			'columns' => [
				'name' => [
					'header' => [
						'value' => $txt['filter_name'],
						'style' => 'white-space: nowrap;'
					],
					'data' => [
						'db' => 'filter_name',
					],
					'sort' => [
						'default' => 'filter_name, id_filter',
						'reverse' => 'filter_name DESC, id_filter DESC',
					],
				],
				'from' => [
					'header' => [
						'value' => $txt['filter_from'],
					],
					'data' => [
						'db' => 'filter_from',
					],
					'sort' => [
						'default' => 'filter_from, id_filter',
						'reverse' => 'filter_from DESC, id_filter DESC',
					],
				],
				'to' => [
					'header' => [
						'value' => $txt['filter_to'],
						'style' => 'width:10em;',
					],
					'data' => [
						'db' => 'filter_to',
					],
					'sort' => [
						'default' => 'filter_to, id_filter',
						'reverse' => 'filter_to DESC, id_filter DESC',
					],
				],
				'type' => [
					'header' => [
						'value' => $txt['filter_type'],
					],
					'data' => [
						'db' => 'filter_type',
					],
					'sort' => [
						'default' => 'filter_type, id_filter',
						'reverse' => 'filter_type DESC, id_filter DESC',
					],
				],
				'action' => [
					'header' => [
						'value' => $txt['message_action'],
						'class' => 'centertext',
					],
					'data' => [
						'sprintf' => [
							'format' => '
								<a href="?action=admin;area=maillist;sa=editfilter;f_id=%1$s;' . $context['session_var'] . '=' . $context['session_id'] . '">
									<i class="icon i-modify" title="' . $txt['modify'] . '"></i>
								</a>
								<a href="?action=admin;area=maillist;sa=deletefilter;f_id=%1$s;' . $context['session_var'] . '=' . $context['session_id'] . '" onclick="return confirm(' . JavaScriptEscape($txt['filter_delete_warning']) . ') && submitThisOnce(this);" accesskey="d">
									<i class="icon i-delete" title="' . $txt['delete'] . '"></i>
								</a>',
							'params' => [
								'id_filter' => true,
							],
						],
						'class' => 'centertext',
						'style' => 'white-space:nowrap;',
					],
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editfilter']),
				'include_sort' => true,
				'include_start' => true,
				'hidden_fields' => [
					$context['session_var'] => $context['session_id'],
				],
			],
			'additional_rows' => [
				[
					'position' => 'top_of_list',
					'class' => $this->_req->hasQuery('saved') ? 'successbox' : '',
					'value' => $this->_req->hasQuery('saved') ? $txt['saved'] : '',
				],
				[
					'position' => 'below_table_data',
					'class' => 'submitbutton',
					'value' => '
						<input type="submit" name="addfilter" value="' . $txt['add_filter'] . '" />
						<a class="linkbutton" href="' . getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortfilters']) . '">' . $txt['sort_filter'] . '</a>',
				],
			],
		];

		// Set the context values
		$context['page_title'] = $txt['filters'];
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'email_filter';

		// Create the list.
		createList($listOptions);
	}

	/**
	 * Show a full list of all the filters in the system for drag/drop sorting
	 *
	 * @event integrate_list_sort_email_fp
	 */
	public function action_sort_filters(): void
	{
		global $context, $txt;

		$id = 0;
		$token = createToken('admin-sort');

		// build the listoption array to display the data
		$listOptions = [
			'id' => 'sort_email_fp',
			'title' => $txt['sort_filter'],
			'sortable' => true,
			'items_per_page' => 0,
			'no_items_label' => $txt['no_filters'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortfilters']),
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort, int $id, string $style): array => $this->load_filter_parser($start, $items_per_page, $sort, $id, $style),
				'params' => [
					$id,
					'filter'
				],
			],
			'get_count' => [
				'function' => fn(int $id, string $style): int => $this->count_filter_parser($id, $style),
				'params' => [
					$id,
					'filter'
				],
			],
			'columns' => [
				'filterorder' => [
					'header' => [
						'value' => '',
						'class' => 'hide',
					],
					'data' => [
						'db' => 'filter_order',
						'class' => 'hide',
					],
				],
				'name' => [
					'header' => [
						'value' => $txt['filter_name'],
						'style' => 'white-space: nowrap;width: 10em'
					],
					'data' => [
						'db' => 'filter_name',
					],
				],
				'from' => [
					'header' => [
						'value' => $txt['filter_from'],
					],
					'data' => [
						'db' => 'filter_from',
					],
				],
				'to' => [
					'header' => [
						'value' => $txt['filter_to'],
						'style' => 'width:10em;',
					],
					'data' => [
						'db' => 'filter_to',
					],
				],
				'type' => [
					'header' => [
						'value' => $txt['filter_type'],
					],
					'data' => [
						'db' => 'filter_type',
					],
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortfilters']),
				'hidden_fields' => [
					$context['session_var'] => $context['session_id'],
				],
			],
			'additional_rows' => [
				[
					'position' => 'after_title',
					'value' => $txt['filter_sort_description'],
				],
			],
			'javascript' => '
				$().elkSortable({
					sa: "parserorder",
					placeholder: "ui-state-highlight",
					containment: "#sort_email_fp",
					error: "' . $txt['admin_order_error'] . '",
					title: "' . $txt['admin_order_title'] . '",
					href: "?action=admin;area=maillist;sa=sortfilters",
					token: {token_var: "' . $token['admin-sort_token_var'] . '", token_id: "' . $token['admin-sort_token'] . '"}
				});
			',
		];

		// Set the context values
		$context['page_title'] = $txt['filters'];
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'sort_email_fp';

		// Create the list.
		createList($listOptions);
	}

	/**
	 * Returns the number of filters or parsers in the system
	 *
	 * - Callback for createList()
	 *
	 * @param int $id 0 for all of a certain style
	 * @param string $style either filter or parser
	 *
	 * @return int
	 */
	public function count_filter_parser(int $id, string $style): int
	{
		return list_count_filter_parser($id, $style);
	}

	/**
	 * Returns the details for the filters or parsers in the system
	 *
	 * - Callback for createList()
	 *
	 * @param int $start The item to start with (for pagination purposes)
	 * @param int $items_per_page The number of items to show per page
	 * @param string $sort A string indicating how to sort the results
	 * @param int $id
	 * @param string $style
	 *
	 * @return array
	 */
	public function load_filter_parser(int $start, int $items_per_page, string $sort, int $id, string $style): array
	{
		return list_get_filter_parser($start, $items_per_page, $sort, $id, $style);
	}

	/**
	 * Edit or Add a filter
	 *
	 * - If regex checks for proper syntax before saving to the database
	 *
	 * @event integrate_save_filter_settings
	 *
	 */
	public function action_edit_filters(): void
	{
		global $context, $txt, $modSettings;

		// Editing an existing filter?
		if ($this->_req->hasQuery('f_id'))
		{
			// Needs to be an int!
			$id = $this->_req->getQuery('f_id', 'intval', 0);
			if ($id <= 0)
			{
				throw new Exception('error_no_id_filter');
			}

			// Load it up and set it as the current values
			$row = maillist_load_filter_parser($id, 'filter');
			$modSettings['id_filter'] = $row['id_filter'];
			$modSettings['filter_type'] = $row['filter_type'];
			$modSettings['filter_to'] = $row['filter_to'];
			$modSettings['filter_from'] = $row['filter_from'];
			$modSettings['filter_name'] = $row['filter_name'];

			// Some items for the form
			$context['page_title'] = $txt['edit_filter'];
			$context['editing'] = true;
			$context['settings_message'] = [];
		}
		else
		{
			// Set up placeholders for adding a new one instead
			$modSettings['filter_type'] = '';
			$modSettings['filter_to'] = '';
			$modSettings['filter_from'] = '';
			$modSettings['filter_name'] = '';

			$context['page_title'] = $txt['add_filter'];
			$context['editing'] = false;
			$context['settings_message'] = [];
		}

		// Initialize the form
		$settingsForm = new SettingsForm(SettingsForm::DB_ADAPTER);

		// Initialize it with our settings
		$config_vars = $this->_filtersSettings();
		$settingsForm->setConfigVars($config_vars);

		// Saving the new or edited entry?
		if ($this->_req->hasQuery('save'))
		{
			checkSession();

			call_integration_hook('integrate_save_filter_settings');

			// Editing an entry?
			$editRaw = $this->_req->getQuery('edit', 'trim|strval', '');
			$isEdit = ($editRaw !== '' && $editRaw !== 'new');
			$editId = $isEdit ? (int) $editRaw : -1;
			$editName = $isEdit ? 'id_filter' : '';

			// If its regex we do a quick check for validity
			if ($this->_req->post->filter_type === 'regex')
			{
				$valid = @preg_replace($this->_req->post->filter_from, $this->_req->post->filter_to, 'ElkArte') !== null;
				if (!$valid)
				{
					// Seems bad ... reload the form, set the message
					$context['error_type'] = 'notice';
					$context['settings_message'][] = $txt['regex_invalid'];
					$modSettings['filter_type'] = $this->_req->post->filter_type;
					$modSettings['filter_to'] = $this->_req->post->filter_to;
					$modSettings['filter_from'] = $this->_req->post->filter_from;
					$modSettings['filter_name'] = $this->_req->post->filter_name;
				}
			}

			if (empty($this->_req->post->filter_type) || empty($this->_req->post->filter_from))
			{
				$context['error_type'] = 'notice';
				$context['settings_message'][] = $txt['filter_invalid'];
			}

			// if we are good to save, so save it ;)
			if (empty($context['settings_message']))
			{
				// And ... it's a filter
				$config_vars[] = ['text', 'filter_style'];
				$this->_req->post->filter_style = 'filter';

				MaillistSettings::saveTableSettings($config_vars, 'postby_emails_filters', $this->_req->post, ['id_filter'], $editId, $editName);
				redirectexit('action=admin;area=maillist;sa=emailfilters;saved');
			}
		}

		// Prepare some final context for the template
		$title = $this->_req->hasQuery('saved') ? 'saved_filter' : ($context['editing'] === true ? 'edit_filter' : 'add_filter');
		$context['post_url'] = getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editfilter', 'edit' => $context['editing'] ? $modSettings['id_filter'] : 'new', 'save']);
		$context['settings_title'] = $txt[$title];
		$context['breadcrumbs'][] = [
			'url' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editfilter']),
			'name' => ($context['editing']) ? $txt['edit_filter'] : $txt['add_filter'],
		];

		// Load and show
		$settingsForm->prepare();
		theme()->getTemplates()->load('Admin');
		loadCSSFile('admin.css');
		$context['sub_template'] = 'show_settings';
	}

	/**
	 * Initialize Mailist settings form.
	 *
	 * @event integrate_modify_maillist_filter_settings Add new settings to the maillist filter area
	 */
	private function _filtersSettings()
	{
		global $txt;

		$config_vars = [
			['text', 'filter_name', 25, 'subtext' => $txt['filter_name_desc']],
			['select', 'filter_type',
				[
					'standard' => $txt['option_standard'],
					'regex' => $txt['option_regex'],
				],
			],
			['large_text', 'filter_from', 4, 'subtext' => $txt['filter_from_desc']],
			['text', 'filter_to', 25, 'subtext' => $txt['filter_to_desc']],
		];

		call_integration_hook('integrate_modify_maillist_filter_settings', [&$config_vars]);

		return $config_vars;
	}

	/**
	 * Return the form settings for use in admin search
	 */
	public function filter_search()
	{
		global $modSettings;

		if (empty($modSettings['maillist_enabled']))
		{
			return ['check', 'filter_name'];
		}

		return $this->_filtersSettings();
	}

	/**
	 * Deletes a filter from the system / database
	 */
	public function action_delete_filters(): void
	{
		// Removing the filter?
		if ($this->_req->hasQuery('f_id'))
		{
			checkSession('get');
			$id = $this->_req->getQuery('f_id', 'intval', 0);

			maillist_delete_filter_parser($id);
			redirectexit('action=admin;area=maillist;sa=emailfilters;deleted');
		}
	}

	/**
	 * Show a list of all the parsers in the system
	 *
	 * What it does:
	 *
	 * - Allows adding/editing or deleting parsers
	 * - Parsers are used to split a message at a line of text
	 * - Parsers can only be defined as regex, the system will check it for valid syntax
	 * - Accessed by ?action=admin;area=maillist;sa=emailparser;
	 *
	 * @event integrate_list_email_parser
	 */
	public function action_list_parsers(): void
	{
		global $context, $txt, $modSettings;

		$id = 0;

		// Build the listoption array to display the data
		$listOptions = [
			'id' => 'email_parser',
			'title' => $txt['parsers'],
			'items_per_page' => $modSettings['defaultMaxMessages'],
			'no_items_label' => $txt['no_parsers'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailparser']),
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort, int $id, string $style): array => $this->load_filter_parser($start, $items_per_page, $sort, $id, $style),
				'params' => [
					$id,
					'parser'
				],
			],
			'get_count' => [
				'function' => fn(int $id, string $style): int => $this->count_filter_parser($id, $style),
				'params' => [
					$id,
					'parser'
				],
			],
			'columns' => [
				'name' => [
					'header' => [
						'value' => $txt['parser_name'],
						'style' => 'white-space: nowrap;'
					],
					'data' => [
						'db' => 'filter_name',
					],
					'sort' => [
						'default' => 'filter_name',
						'reverse' => 'filter_name DESC',
					],
				],
				'from' => [
					'header' => [
						'value' => $txt['parser_from'],
					],
					'data' => [
						'db' => 'filter_from',
					],
					'sort' => [
						'default' => 'filter_from',
						'reverse' => 'filter_from DESC',
					],
				],
				'type' => [
					'header' => [
						'value' => $txt['parser_type'],
					],
					'data' => [
						'db' => 'filter_type',
					],
					'sort' => [
						'default' => 'filter_type',
						'reverse' => 'filter_type DESC',
					],
				],
				'action' => [
					'header' => [
						'value' => $txt['message_action'],
						'class' => 'centertext',
					],
					'data' => [
						'sprintf' => [
							'format' => '
								<a href="?action=admin;area=maillist;sa=editparser;f_id=%1$s;' . $context['session_var'] . '=' . $context['session_id'] . '">
									<i class="icon i-modify" title="' . $txt['modify'] . '"></i>
								</a>
								<a href="?action=admin;area=maillist;sa=deleteparser;f_id=%1$s;' . $context['session_var'] . '=' . $context['session_id'] . '" onclick="return confirm(' . JavaScriptEscape($txt['parser_delete_warning']) . ') && submitThisOnce(this);" accesskey="d">
									<i class="icon i-delete" title="' . $txt['delete'] . '"></i>
								</a>',
							'params' => [
								'id_filter' => true,
							],
						],
						'class' => 'centertext',
						'style' => 'white-space:nowrap;',
					],
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editparser']),
				'include_sort' => true,
				'include_start' => true,
				'hidden_fields' => [
					$context['session_var'] => $context['session_id'],
				],
			],
			'additional_rows' => [
				[
					'position' => 'top_of_list',
					'class' => $this->_req->hasQuery('saved') ? 'successbox' : '',
					'value' => $this->_req->hasQuery('saved') ? $txt['saved'] : '',
				],
				[
					'position' => 'below_table_data',
					'class' => 'submitbutton',
					'value' => '
                        <input type="submit" name="addparser" value="' . $txt['add_parser'] . '" />
                        <a class="linkbutton" href="' . getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortparsers']) . '">' . $txt['sort_parser'] . '</a>',
				],
			],
		];

		// Set the context values
		$context['page_title'] = $txt['parsers'];
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'email_parser';

		// Create the list.
		createList($listOptions);
	}

	/**
	 * Show a full list of all the parsers in the system for drag/drop sorting
	 *
	 * @event integrate_list_email_parser
	 */
	public function action_sort_parsers(): void
	{
		global $context, $txt;

		$id = 0;
		$token = createToken('admin-sort');

		// Build the listoption array to display the data
		$listOptions = [
			'id' => 'sort_email_fp',
			'title' => $txt['sort_parser'],
			'sortable' => true,
			'items_per_page' => 0,
			'no_items_label' => $txt['no_parsers'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortparsers']),
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort, int $id, string $style): array => $this->load_filter_parser($start, $items_per_page, $sort, $id, $style),
				'params' => [
					$id,
					'parser'
				],
			],
			'get_count' => [
				'function' => fn(int $id, string $style): int => $this->count_filter_parser($id, $style),
				'params' => [
					$id,
					'parser'
				],
			],
			'columns' => [
				'filterorder' => [
					'header' => [
						'value' => '',
						'class' => 'hide',
					],
					'data' => [
						'db' => 'filter_order',
						'class' => 'hide',
					],
				],
				'name' => [
					'header' => [
						'value' => $txt['parser_name'],
						'style' => 'white-space: nowrap;width: 10em'
					],
					'data' => [
						'db' => 'filter_name',
					],
				],
				'from' => [
					'header' => [
						'value' => $txt['parser_from'],
					],
					'data' => [
						'db' => 'filter_from',
					],
				],
				'type' => [
					'header' => [
						'value' => $txt['parser_type'],
					],
					'data' => [
						'db' => 'filter_type',
					],
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'sortparsers']),
				'hidden_fields' => [
					$context['session_var'] => $context['session_id'],
				],
			],
			'additional_rows' => [
				[
					'position' => 'after_title',
					'value' => $txt['parser_sort_description'],
				],
			],
			'javascript' => '
				$().elkSortable({
					sa: "parserorder",
					placeholder: "ui-state-highlight",
					containment: "#sort_email_fp",
					error: "' . $txt['admin_order_error'] . '",
					title: "' . $txt['admin_order_title'] . '",
					href: "?action=admin;;area=maillist;sa=sortparsers",
					token: {token_var: "' . $token['admin-sort_token_var'] . '", token_id: "' . $token['admin-sort_token'] . '"}
				});
			',
		];

		// Set the context values
		$context['page_title'] = $txt['parsers'];
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'sort_email_fp';

		// Create the list.
		createList($listOptions);
	}

	/**
	 * Adds or Edits an existing parser
	 *
	 * - All parsers are assumed regex
	 *
	 * @event integrate_save_parser_settings
	 */
	public function action_edit_parsers(): void
	{
		global $context, $txt, $modSettings;

		// Editing an existing filter?
		if ($this->_req->hasQuery('f_id'))
		{
			// Needs to be an int!
			$id = $this->_req->getQuery('f_id', 'intval', 0);
			if ($id <= 0)
			{
				throw new Exception('error_no_id_filter');
			}

			// Load this filter so we can edit it
			$row = maillist_load_filter_parser($id, 'parser');

			$modSettings['id_filter'] = $row['id_filter'];
			$modSettings['filter_type'] = $row['filter_type'];
			$modSettings['filter_from'] = $row['filter_from'];
			$modSettings['filter_name'] = $row['filter_name'];

			$context['page_title'] = $txt['edit_parser'];
			$context['editing'] = true;
		}
		else
		{
			// Set up placeholders for adding a new one instead
			$modSettings['filter_type'] = '';
			$modSettings['filter_name'] = '';
			$modSettings['filter_from'] = '';

			// To the template we go
			$context['page_title'] = $txt['add_parser'];
			$context['editing'] = false;
		}

		// Initialize the form
		$settingsForm = new SettingsForm(SettingsForm::DB_ADAPTER);

		// Initialize it with our settings
		$config_vars = $this->_parsersSettings();
		$settingsForm->setConfigVars($config_vars);

		// Check if they are saving the changes
		if ($this->_req->hasQuery('save'))
		{
			checkSession();

			call_integration_hook('integrate_save_parser_settings');

			// Editing a parser?
			$editRaw = $this->_req->hasQuery('edit') ? $this->_req->getQuery('edit', 'trim|strval', '') : '';
			$editId = ($editRaw !== '' && $editRaw !== 'new') ? (int) $editRaw : -1;
			$editName = ($editRaw !== '' && $editRaw !== 'new') ? 'id_filter' : '';

			// Test the regex
			if ($this->_req->post->filter_type === 'regex' && !empty($this->_req->post->filter_from))
			{
				$valid = preg_replace($this->_req->post->filter_from, '', 'ElkArte') !== null;
				if (!$valid)
				{
					// Regex did not compute ... Danger, Will Robinson
					$context['settings_message'] = $txt['regex_invalid'];
					$context['error_type'] = 'notice';

					$modSettings['filter_type'] = $this->_req->post->filter_type;
					$modSettings['filter_from'] = $this->_req->post->filter_from;
					$modSettings['filter_name'] = $this->_req->post->filter_name;
				}
			}

			if (empty($this->_req->post->filter_type) || empty($this->_req->post->filter_from))
			{
				$context['error_type'] = 'notice';
				$context['settings_message'][] = $txt['filter_invalid'];
			}

			// All clear to save?
			if (empty($context['settings_message']))
			{
				// Shhh ... it's really a parser
				$config_vars[] = ['text', 'filter_style'];
				$this->_req->post->filter_style = 'parser';

				// Save, log, show
				MaillistSettings::saveTableSettings($config_vars, 'postby_emails_filters', $this->_req->post, ['id_filter'], $editId, $editName);
				redirectexit('action=admin;area=maillist;sa=emailparser;saved');
			}
		}

		// Prepare the context for viewing
		$title = ($this->_req->hasQuery('saved') && $this->_req->getQuery('saved', 'trim|strval', '') == '1') ? 'saved_parser' : ($context['editing'] === true ? 'edit_parser' : 'add_parser');
		$context['settings_title'] = $txt[$title];
		$context['post_url'] = getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editparser', 'edit' => $context['editing'] ? $modSettings['id_filter'] : 'new', 'save']);
		$context['breadcrumbs'][] = [
			'url' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'editparser']),
			'name' => ($context['editing']) ? $txt['edit_parser'] : $txt['add_parser'],
		];

		// prep it, load it, show it
		$settingsForm->prepare();
		theme()->getTemplates()->load('Admin');
		loadCSSFile('admin.css');
		$context['sub_template'] = 'show_settings';
	}

	/**
	 * Initialize Mailist settings form.
	 *
	 * @event integrate_modify_maillist_parser_settings Add settings to the maillist parser screen
	 */
	private function _parsersSettings()
	{
		global $txt;

		$config_vars = [
			['text', 'filter_name', 25, 'subtext' => $txt['parser_name_desc']],
			['select', 'filter_type', 'subtext' => $txt['parser_type_desc'],
				[
					'regex' => $txt['option_regex'],
					'standard' => $txt['option_standard'],
				],
			],
			['large_text', 'filter_from', 4, 'subtext' => $txt['parser_from_desc']],
		];

		call_integration_hook('integrate_modify_maillist_parser_settings', [&$config_vars]);

		return $config_vars;
	}

	/**
	 * Return the form settings for use in admin search
	 */
	public function parser_search()
	{
		global $modSettings;

		if (empty($modSettings['maillist_enabled']))
		{
			return ['check', 'filter_name'];
		}

		return $this->_parsersSettings();
	}

	/**
	 * Removes a parser from the system and database
	 */
	public function action_delete_parsers(): void
	{
		// Removing the filter?
		if ($this->_req->hasQuery('f_id'))
		{
			checkSession('get');
			$id = $this->_req->getQuery('f_id', 'intval', 0);

			maillist_delete_filter_parser($id);
			redirectexit('action=admin;area=maillist;sa=emailparser;deleted');
		}
	}

	/**
	 * All the post by email settings, used to control how the feature works
	 *
	 * @event integrate_save_maillist_settings
	 * @uses Admin language
	 */
	public function action_settings(): void
	{
		global $context, $txt, $modSettings;

		// Be nice, show them we did something
		if ($this->_req->hasQuery('saved'))
		{
			$context['settings_message'] = $txt['saved'];
		}

		// Templates and language
		Txt::load('Admin');
		theme()->getTemplates()->load('Admin');
		loadCSSFile('admin.css');

		// Load any existing email => board values used for new topic creation
		$context['maillist_from_to_board'] = [];
		$data = (empty($modSettings['maillist_receiving_address'])) ? [] : Util::unserialize($modSettings['maillist_receiving_address']);
		foreach ($data as $key => $addr)
		{
			$context['maillist_from_to_board'][$key] = [
				'id' => $key,
				'emailfrom' => $addr[0],
				'boardto' => $addr[1],
			];
		}

		// Initialize the maillist settings form
		$settingsForm = new SettingsForm(SettingsForm::DB_ADAPTER);

		// Initialize it with our settings
		$settingsForm->setConfigVars($this->_settings());

		// Saving settings?
		if ($this->_req->hasQuery('save'))
		{
			checkSession();

			call_integration_hook('integrate_save_maillist_settings');

			$email_error = false;
			$board_error = false;
			$maillist_receiving_address = [];

			// Basic checking of the email addresses
			if (!DataValidator::is_valid($this->_req->post, ['maillist_sitename_address' => 'valid_email'], ['maillist_sitename_address' => 'trim']))
			{
				$email_error = $this->_req->post->maillist_sitename_address;
			}

			if (!DataValidator::is_valid($this->_req->post, ['maillist_sitename_help' => 'valid_email'], ['maillist_sitename_help' => 'trim']))
			{
				$email_error = $this->_req->post->maillist_sitename_help;
			}

			if (!DataValidator::is_valid($this->_req->post, ['maillist_mail_from' => 'valid_email'], ['maillist_mail_from' => 'trim']))
			{
				$email_error = $this->_req->post->maillist_mail_from;
			}

			// Inbound email set up, then we need to check for both valid email and valid board
			if (!$email_error && !empty($this->_req->post->emailfrom))
			{
				// Get the board ids for a quick check
				$boards = maillist_board_list();

				// Check the receiving emails and the board id as well
				$boardtocheck = empty($this->_req->post->boardto) ? [] : $this->_req->post->boardto;
				$addresstocheck = empty($this->_req->post->emailfrom) ? [] : $this->_req->post->emailfrom;

				foreach ($addresstocheck as $key => $checkme)
				{
					// Valid email syntax
					if (!DataValidator::is_valid($addresstocheck, [$key => 'valid_email'], [$key => 'trim']))
					{
						$email_error = $checkme;
						$context['error_type'] = 'notice';
						continue;
					}

					// Valid board id?
					if (!isset($boardtocheck[$key], $boards[$key]))
					{
						$board_error = $checkme;
						$context['error_type'] = 'notice';
						continue;
					}

					// Decipher as [0] emailaddress and [1] board id
					$maillist_receiving_address[] = [$checkme, $boardtocheck[$key]];
				}
			}

			// Enable or disable the fake cron
			enable_maillist_imap_cron(!empty($this->_req->post->maillist_imap_cron));

			// Check and set any errors or give the go-ahead to save
			if ($email_error)
			{
				$context['settings_message'] = sprintf($txt['email_not_valid'], $email_error);
			}
			elseif ($board_error)
			{
				$context['settings_message'] = sprintf($txt['board_not_valid'], $board_error);
			}
			else
			{
				// Clear the moderation count cache
				Cache::instance()->remove('num_menu_errors');

				// Should be off if mail posting is on, we ignore it anyway, but this at least updates the ACP
				if (!empty($this->_req->post->maillist_enabled))
				{
					updateSettings(['disallow_sendBody' => '']);
				}

				updateSettings(['maillist_receiving_address' => serialize($maillist_receiving_address)]);
				$settingsForm->setConfigValues((array) $this->_req->post);
				$settingsForm->save();
				writeLog();
				redirectexit('action=admin;area=maillist;sa=emailsettings;saved');
			}
		}

		// JavaScript vars for the "add more" buttons in the receive_email callback
		$board_list = maillist_board_list();
		$script = '';
		$i = 0;

		// Create the board selection list
		foreach ($board_list as $board_id => $board_name)
		{
			$script .= $i++ . ': {id:' . $board_id . ', name:' . JavaScriptEscape($board_name) . '},';
		}

		theme()->addInlineJavascript('
		var sEmailParent = \'add_more_email_placeholder\',
			oEmailOptionsdt = {size: \'50\', name: \'emailfrom[]\', class: \'input_text\'},
			oEmailOptionsdd = {size: \'1\', type: \'select\', name: \'boardto[]\', class: \'input_select\'},
			oEmailSelectData = {' . $script . '};

			document.getElementById(\'add_more_board_div\').style.display = \'block\';', true
		);

		$context['boards'] = $board_list;
		$context['settings_title'] = $txt['ml_emailsettings'];
		$context['page_title'] = $txt['ml_emailsettings'];
		$context['post_url'] = getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailsettings', 'save']);
		$context['sub_template'] = 'show_settings';
		$settingsForm->prepare();
	}

	/**
	 * Load up the config var array for settings display etc.
	 *
	 * @event integrate_modify_maillist_settings
	 */
	private function _settings()
	{
		global $txt;

		// Define the menu
		$config_vars = [
			['desc', 'maillist_help'],
			['check', 'maillist_enabled'],
			['check', 'pbe_post_enabled'],
			['check', 'pbe_pm_enabled'],
			['check', 'pbe_no_mod_notices', 'subtext' => $txt['pbe_no_mod_notices_desc'], 'postinput' => $txt['recommended']],
			['check', 'pbe_bounce_detect', 'subtext' => $txt['pbe_bounce_detect_desc'], 'postinput' => $txt['experimental']],
			['check', 'pbe_bounce_record', 'subtext' => $txt['pbe_bounce_record_desc'], 'postinput' => $txt['experimental']],
			['title', 'maillist_outbound'],
			['desc', 'maillist_outbound_desc'],
			['check', 'maillist_group_mode'],
			['check', 'maillist_digest_enabled'],
			['text', 'maillist_sitename', 40, 'subtext' => $txt['maillist_sitename_desc'], 'postinput' => $txt['maillist_sitename_post']],
			['text', 'maillist_sitename_address', 40, 'subtext' => $txt['maillist_sitename_address_desc'], 'postinput' => $txt['maillist_sitename_address_post']],
			['text', 'maillist_mail_from', 40, 'subtext' => $txt['maillist_mail_from_desc'], 'postinput' => $txt['maillist_mail_from_post']],
			['text', 'maillist_sitename_help', 40, 'subtext' => $txt['maillist_sitename_help_desc'], 'postinput' => $txt['maillist_sitename_help_post']],
			['text', 'maillist_sitename_regards', 40, 'subtext' => $txt['maillist_sitename_regards_desc']],
			['title', 'maillist_inbound'],
			['desc', 'maillist_inbound_desc'],
			['check', 'maillist_newtopic_change'],
			['check', 'maillist_newtopic_needsapproval', 'subtext' => $txt['maillist_newtopic_needsapproval_desc'], 'postinput' => $txt['recommended']],
			['callback', 'maillist_receive_email_list'],
			['title', 'misc'],
			['check', 'maillist_allow_attachments'],
			['int', 'maillist_key_active', 4, 'subtext' => $txt['maillist_key_active_desc']],
			'',
			['text', 'maillist_leftover_remove', 40, 'subtext' => $txt['maillist_leftover_remove_desc']],
			['text', 'maillist_sig_keys', 40, 'subtext' => $txt['maillist_sig_keys_desc']],
			['int', 'maillist_short_line', 4, 'subtext' => $txt['maillist_short_line_desc']],
		];

		// Imap?
		if (!function_exists('imap_open'))
		{
			$config_vars = array_merge($config_vars,
				[
					['title', 'maillist_imap_missing'],
				]
			);
		}
		else
		{
			$config_vars = array_merge($config_vars, [
				['title', 'maillist_imap'],
				['desc', 'maillist_imap_reason'],
				['text', 'maillist_imap_host', 45, 'subtext' => $txt['maillist_imap_host_desc'], 'disabled' => !function_exists('imap_open')],
				['text', 'maillist_imap_mailbox', 20, 'postinput' => $txt['maillist_imap_mailbox_desc'], 'disabled' => !function_exists('imap_open')],
				['text', 'maillist_imap_uid', 20, 'postinput' => $txt['maillist_imap_uid_desc'], 'disabled' => !function_exists('imap_open')],
				['password', 'maillist_imap_pass', 20, 'postinput' => $txt['maillist_imap_pass_desc'], 'disabled' => !function_exists('imap_open')],
				['select', 'maillist_imap_connection',
					[
						'imap' => $txt['maillist_imap_unsecure'],
						'pop3' => $txt['maillist_pop3_unsecure'],
						'imaptls' => $txt['maillist_imap_tls'],
						'imapssl' => $txt['maillist_imap_ssl'],
						'pop3tls' => $txt['maillist_pop3_tls'],
						'pop3ssl' => $txt['maillist_pop3_ssl']
					], 'postinput' => $txt['maillist_imap_connection_desc'], 'disabled' => !function_exists('imap_open'),
				],
				['check', 'maillist_imap_delete', 20, 'subtext' => $txt['maillist_imap_delete_desc'], 'disabled' => !function_exists('imap_open')],
				['check', 'maillist_imap_cron', 20, 'subtext' => $txt['maillist_imap_cron_desc'], 'disabled' => !function_exists('imap_open')],
			]);
		}

		call_integration_hook('integrate_modify_maillist_settings', [&$config_vars]);

		return $config_vars;
	}

	/**
	 * Return the form settings for use in admin search
	 */
	public function settings_search()
	{
		global $modSettings;

		if (empty($modSettings['maillist_enabled']))
		{
			return ['check', 'maillist_enabled'];
		}

		return $this->_settings();
	}

	/**
	 * View all the custom email bounce templates.
	 *
	 * What it does:
	 *
	 * - Shows all the bounce templates in the system available to this user
	 * - Provides for actions to add or delete them
	 * - Accessed by ?action=admin;area=maillist;sa=emailtemplates;
	 *
	 * @event integrate_list_bounce_template_list
	 */
	public function action_view_bounce_templates(): ?bool
	{
		global $modSettings, $context, $txt;

		// We'll need this because bounce templates are stored with warning templates.
		require_once(SUBSDIR . '/Moderation.subs.php');

		// Submitting a new one or editing an existing one then pass this request off
		if ($this->_req->hasPost('add') || $this->_req->hasPost('save') || $this->_req->hasQuery('tid'))
		{
			return $this->action_modify_bounce_templates();
		}

		// Deleting and existing one
		if (isset($this->_req->post->delete) && !empty($this->_req->post->deltpl))
		{
			checkSession();
			validateToken('mod-mlt');
			removeWarningTemplate($this->_req->post->deltpl, 'bnctpl');
		}

		// This is all the information required for showing the email templates.
		$listOptions = [
			'id' => 'email_bounce_template_list',
			'title' => $txt['ml_bounce_templates_title'],
			'items_per_page' => $modSettings['defaultMaxMessages'],
			'no_items_label' => $txt['ml_bounce_templates_none'],
			'base_href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailtemplates', '{session_data}']),
			'default_sort_col' => 'title',
			'get_items' => [
				'function' => fn(int $start, int $items_per_page, string $sort): array => $this->list_getBounceTemplates($start, $items_per_page, $sort),
			],
			'get_count' => [
				'function' => fn() => $this->list_getBounceTemplateCount(),
				'params' => ['bnctpl'],
			],
			'columns' => [
				'title' => [
					'header' => [
						'value' => $txt['ml_bounce_templates_name'],
					],
					'data' => [
						'sprintf' => [
							'format' => '<a href="' . getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailtemplates', 'tid' => '%1$d']) . '">%2$s</a>',
							'params' => [
								'id_comment' => false,
								'title' => false,
								'body' => false,
							],
						],
					],
					'sort' => [
						'default' => 'template_title',
						'reverse' => 'template_title DESC',
					],
				],
				'creator' => [
					'header' => [
						'value' => $txt['ml_bounce_templates_creator'],
					],
					'data' => [
						'db' => 'creator',
					],
					'sort' => [
						'default' => 'creator_name',
						'reverse' => 'creator_name DESC',
					],
				],
				'time' => [
					'header' => [
						'value' => $txt['ml_bounce_templates_time'],
					],
					'data' => [
						'db' => 'time',
					],
					'sort' => [
						'default' => 'lc.log_time DESC',
						'reverse' => 'lc.log_time',
					],
				],
				'delete' => [
					'header' => [
						'value' => '<input type="checkbox" class="input_check" onclick="invertAll(this, this.form);" />',
						'style' => 'width: 4%;',
						'class' => 'centertext',
					],
					'data' => [
						'function' => static fn($rowData) => '<input type="checkbox" name="deltpl[]" value="' . $rowData['id_comment'] . '" class="input_check" />',
						'class' => 'centertext',
					],
				],
			],
			'form' => [
				'href' => getUrl('admin', ['action' => 'admin', 'area' => 'maillist', 'sa' => 'emailtemplates']),
				'token' => 'mod-mlt',
			],
			'additional_rows' => [
				[
					'class' => 'submitbutton',
					'position' => 'below_table_data',
					'value' => '
						<input type="submit" name="delete" value="' . $txt['ml_bounce_template_delete'] . '" onclick="return confirm(\'' . $txt['ml_bounce_template_delete_confirm'] . '\');" />
						<input type="submit" name="add" value="' . $txt['ml_bounce_template_add'] . '" />',
				],
			],
		];

		// Create the template list.
		$context['page_title'] = $txt['ml_bounce_templates_title'];
		createToken('mod-mlt');

		createList($listOptions);

		// Show the list
		$context['sub_template'] = 'show_list';
		$context['default_list'] = 'email_bounce_template_list';

		return null;
	}

	/**
	 * Edit the 'it bounced' template.
	 *
	 * @uses bounce_template sub template
	 */
	public function action_modify_bounce_templates(): bool
	{
		global $context, $txt;

		require_once(SUBSDIR . '/Moderation.subs.php');

		$context['id_template'] = $this->_req->getQuery('tid', 'intval', 0);
		$context['is_edit'] = (bool) $context['id_template'];

		// Standard template things, you know the drill
		$context['page_title'] = $context['is_edit'] ? $txt['ml_bounce_template_modify'] : $txt['ml_bounce_template_add'];
		$context['sub_template'] = 'bounce_template';

		//$context[$context['admin_menu_name']]['current_subsection'] = 'templates';

		// Defaults to show
		$context['template_data'] = [
			'title' => '',
			'body' => $txt['ml_bounce_template_body_default'],
			'subject' => $txt['ml_bounce_template_subject_default'],
			'personal' => false,
			'can_edit_personal' => true,
		];

		// If it's an edit, load it.
		if ($context['is_edit'])
		{
			modLoadTemplate($context['id_template'], 'bnctpl');
		}

		// Wait, we are saving?
		if ($this->_req->hasPost('save'))
		{
			checkSession();
			validateToken('mod-mlt');

			// To check the BBC is good...
			require_once(SUBSDIR . '/Post.subs.php');

			// A bit of cleaning!
			$template_body = trim($this->_req->post->template_body);
			$template_title = trim($this->_req->post->template_title);

			// Need something in both boxes.
			if ($template_body !== '' && $template_body !== '0' && ($template_title !== '' && $template_title !== '0'))
			{
				// Safety first.
				$template_title = Util::htmlspecialchars($template_title);

				// Clean up BBC.
				preparsecode($template_body);

				// But put line breaks back!
				$template_body = strtr($template_body, ['<br />' => "\n"]);

				// Is this personal?
				$recipient_id = empty($this->_req->post->make_personal) ? 0 : $this->user->id;

				// Updating or adding ?
				if ($context['is_edit'])
				{
					// Simple update...
					modAddUpdateTemplate($recipient_id, $template_title, $template_body, $context['id_template'], true, 'bnctpl');

					// If it wasn't visible and now is, they've effectively added it.
					if ($context['template_data']['personal'] && !$recipient_id)
					{
						logAction('add_bounce_template', ['template' => $template_title]);
					}
					// Conversely, if they made it personal, then delete.
					elseif (!$context['template_data']['personal'] && $recipient_id)
					{
						logAction('delete_bounce_template', ['template' => $template_title]);
					}
					// Otherwise just an edit.
					else
					{
						logAction('modify_bounce_template', ['template' => $template_title]);
					}
				}
				else
				{
					modAddUpdateTemplate($recipient_id, $template_title, $template_body, $context['id_template'], false, 'bnctpl');
					logAction('add_bounce_template', ['template' => $template_title]);
				}

				// Get out of town...
				redirectexit('action=admin;area=maillist;sa=emailtemplates');
			}
			else
			{
				$context['warning_errors'] = [];
				$context['template_data']['title'] = empty($template_title) ? '' : $template_title;
				$context['template_data']['body'] = empty($template_body) ? $txt['ml_bounce_template_body_default'] : $template_body;
				$context['template_data']['personal'] = !empty($this->_req->post->make_personal);

				if (empty($template_title))
				{
					$context['warning_errors'][] = $txt['ml_bounce_template_error_no_title'];
				}

				if (empty($template_body))
				{
					$context['warning_errors'][] = $txt['ml_bounce_template_error_no_body'];
				}
			}
		}

		createToken('mod-mlt');

		return true;
	}

	/**
	 * Get all the bounce templates from the system
	 *
	 * - Callback for createList()
	 *
	 * @param int $start The item to start with (for pagination purposes)
	 * @param int $items_per_page The number of items to show per page
	 * @param string $sort A string indicating how to sort the results
	 *
	 * @return array
	 */
	public function list_getBounceTemplates(int $start, int $items_per_page, string $sort): array
	{
		return warningTemplates($start, $items_per_page, $sort, 'bnctpl');
	}

	/**
	 * Get the number of bounce templates in the system
	 *
	 * - Callback for createList() to warningTemplateCount
	 */
	public function list_getBounceTemplateCount(): int
	{
		return warningTemplateCount('bnctpl');
	}

	/**
	 * Get the number of unapproved emails
	 *
	 * - Callback for createList() to list_maillist_unapproved
	 *
	 * @param int $start The item to start with (for pagination purposes)
	 * @param int $items_per_page The number of items to show per page
	 * @param string $sort A string indicating how to sort the results
	 * @param int $id = 0
	 *
	 * @return array
	 */
	public function list_maillist_unapproved(int $start, int $items_per_page, string $sort = '', int $id = 0): array
	{
		return list_maillist_unapproved($id, $start, $items_per_page, $sort);
	}
}

elkarte / Elkarte

ManageMaillist::action_edit_parsers() F last analyzed 2025-12-27 02:48 UTC

Complexity

Size

Duplication

Code Coverage

Importance

How to fix Long Method Complexity

Long Method

Duplication Side-by-Side

Filter issues like

ManageMaillist::action_edit_parsers() F
last analyzed 2025-12-27 02:48 UTC
