From d486ae88206d81cc93d8960a58cd9ba6ae9b322c Mon Sep 17 00:00:00 2001
From: Alexander Ebert <ebert@woltlab.com>
Date: Thu, 15 Jun 2017 11:04:23 +0200
Subject: [PATCH] Added basic settings and recipient management

See #2308
---
 com.woltlab.wcf/acpMenu.xml                   |   7 +
 com.woltlab.wcf/option.xml                    |   6 +
 com.woltlab.wcf/userGroupOption.xml           |   8 +
 constants.php                                 |   1 +
 .../acp/templates/contactRecipientAdd.tpl     |  96 ++++++++++
 .../files/acp/templates/contactSettings.tpl   |  49 +++++
 .../form/ContactRecipientAddForm.class.php    | 172 ++++++++++++++++++
 .../form/ContactRecipientEditForm.class.php   | 135 ++++++++++++++
 .../acp/page/ContactSettingsPage.class.php    |  57 ++++++
 .../recipient/ContactRecipient.class.php      |  51 ++++++
 .../ContactRecipientAction.class.php          |  56 ++++++
 .../ContactRecipientEditor.class.php          |  23 +++
 .../recipient/ContactRecipientList.class.php  |  29 +++
 wcfsetup/install/lang/de.xml                  |   4 +
 wcfsetup/install/lang/en.xml                  |   4 +
 wcfsetup/setup/db/install.sql                 |  14 ++
 16 files changed, 712 insertions(+)
 create mode 100644 wcfsetup/install/files/acp/templates/contactRecipientAdd.tpl
 create mode 100644 wcfsetup/install/files/acp/templates/contactSettings.tpl
 create mode 100644 wcfsetup/install/files/lib/acp/form/ContactRecipientAddForm.class.php
 create mode 100644 wcfsetup/install/files/lib/acp/form/ContactRecipientEditForm.class.php
 create mode 100644 wcfsetup/install/files/lib/acp/page/ContactSettingsPage.class.php
 create mode 100644 wcfsetup/install/files/lib/data/contact/recipient/ContactRecipient.class.php
 create mode 100644 wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientAction.class.php
 create mode 100644 wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientEditor.class.php
 create mode 100644 wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientList.class.php

diff --git a/com.woltlab.wcf/acpMenu.xml b/com.woltlab.wcf/acpMenu.xml
index 088191930d..d5ce451e71 100644
--- a/com.woltlab.wcf/acpMenu.xml
+++ b/com.woltlab.wcf/acpMenu.xml
@@ -76,6 +76,13 @@
 				<controller>wcf\acp\form\NotificationPresetSettingsForm</controller>
 				<permissions>admin.user.canEditUser</permissions>
 			</acpmenuitem>
+		
+			<acpmenuitem name="wcf.acp.menu.link.contact.settings">
+				<parent>wcf.acp.menu.link.other</parent>
+				<controller>wcf\acp\form\ContactSettingsPage</controller>
+				<options>module_contact_form</options>
+				<permissions>admin.contact.canManageContactForm</permissions>
+			</acpmenuitem>
 			
 			<acpmenuitem name="wcf.acp.menu.link.captcha.question.list">
 				<parent>wcf.acp.menu.link.other</parent>
diff --git a/com.woltlab.wcf/option.xml b/com.woltlab.wcf/option.xml
index 9d48ac3f53..fbfdfc5581 100644
--- a/com.woltlab.wcf/option.xml
+++ b/com.woltlab.wcf/option.xml
@@ -300,6 +300,12 @@
 				<defaultvalue>0</defaultvalue>
 			</option>
 			
+			<option name="module_contact_form">
+				<categoryname>module.system</categoryname>
+				<optiontype>boolean</optiontype>
+				<defaultvalue>0</defaultvalue>
+			</option>
+			
 			<option name="log_ip_address">
 				<categoryname>module.system</categoryname>
 				<optiontype>boolean</optiontype>
diff --git a/com.woltlab.wcf/userGroupOption.xml b/com.woltlab.wcf/userGroupOption.xml
index 0a9a65af59..929ba44de0 100644
--- a/com.woltlab.wcf/userGroupOption.xml
+++ b/com.woltlab.wcf/userGroupOption.xml
@@ -163,6 +163,14 @@
 				<admindefaultvalue>1</admindefaultvalue>
 				<usersonly>1</usersonly>
 			</option>
+			<option name="admin.contact.canManageContactForm">
+				<categoryname>admin.configuration</categoryname>
+				<optiontype>boolean</optiontype>
+				<defaultvalue>0</defaultvalue>
+				<admindefaultvalue>1</admindefaultvalue>
+				<usersonly>1</usersonly>
+				<options>module_contact_form</options>
+			</option>
 			<option name="admin.configuration.canManageApplication">
 				<categoryname>admin.configuration.package</categoryname>
 				<optiontype>boolean</optiontype>
diff --git a/constants.php b/constants.php
index 993ded0f62..6cd03be089 100644
--- a/constants.php
+++ b/constants.php
@@ -224,3 +224,4 @@ define('ENABLE_AD_ROTATION', 1);
 define('ENABLE_POLLING', 1);
 define('ENABLE_DESKTOP_NOTIFICATIONS', 1);
 define('FB_SHARE_APP_ID', '');
+define('MODULE_CONTACT_FORM', 0);
diff --git a/wcfsetup/install/files/acp/templates/contactRecipientAdd.tpl b/wcfsetup/install/files/acp/templates/contactRecipientAdd.tpl
new file mode 100644
index 0000000000..f6205cb295
--- /dev/null
+++ b/wcfsetup/install/files/acp/templates/contactRecipientAdd.tpl
@@ -0,0 +1,96 @@
+{include file='header' pageTitle='wcf.acp.contact.recipient.'|concat:$action}
+
+<header class="contentHeader">
+	<div class="contentHeaderTitle">
+		<h1 class="contentTitle">{lang}wcf.acp.contact.recipient.{@$action}{/lang}</h1>
+	</div>
+	
+	<nav class="contentHeaderNavigation">
+		<ul>
+			<li><a href="{link controller='ContactSettings'}{/link}" class="button"><span class="icon icon16 fa-list"></span> <span>{lang}wcf.acp.menu.link.contact.settings{/lang}</span></a></li>
+			
+			{event name='contentHeaderNavigation'}
+		</ul>
+	</nav>
+</header>
+
+{include file='formError'}
+
+{if $success|isset}
+	<p class="success">{lang}wcf.global.success.{@$action}{/lang}</p>
+{/if}
+
+<form method="post" action="{if $action === 'add'}{link controller='ContactRecipientAdd'}{/link}{else}{link controller='ContactRecipientEdit' id=$recipientID}{/link}{/if}">
+	<div class="section">
+		<dl{if $errorField === 'name'} class="formError"{/if}>
+			<dt><label for="name">{lang}wcf.acp.contact.recipient.name{/lang}</label></dt>
+			<dd>
+				<input type="text" id="name" name="name" value="{$i18nPlainValues['name']}" autofocus class="medium">
+				{if $errorField === 'name'}
+					<small class="innerError">
+						{if $errorType === 'empty'}
+							{lang}wcf.global.form.error.empty{/lang}
+						{elseif $errorType === 'multilingual'}
+							{lang}wcf.global.form.error.multilingual{/lang}
+						{else}
+							{lang}wcf.acp.contact.recipient.name.error.{@$errorType}{/lang}
+						{/if}
+					</small>
+				{/if}
+				
+				{include file='multipleLanguageInputJavascript' elementIdentifier='name' forceSelection=false}
+			</dd>
+		</dl>
+		
+		<dl{if $errorField === 'email'} class="formError"{/if}>
+			<dt><label for="email">{lang}wcf.acp.contact.recipient.email{/lang}</label></dt>
+			<dd>
+				{if $action === 'edit' && $recipient->isAdministrator}
+					<span>{$i18nPlainValues['email']}</span>
+					<input type="hidden" name="email" value="{$i18nPlainValues['email']}">
+				{else}
+					<input type="text" id="email" name="email" value="{$i18nPlainValues['email']}" class="medium">
+					{if $errorField === 'email'}
+						<small class="innerError">
+							{if $errorType === 'empty'}
+								{lang}wcf.global.form.error.empty{/lang}
+							{elseif $errorType === 'multilingual'}
+								{lang}wcf.global.form.error.multilingual{/lang}
+							{else}
+								{lang}wcf.acp.contact.recipient.email.error.{@$errorType}{/lang}
+							{/if}
+						</small>
+					{/if}
+					
+					{include file='multipleLanguageInputJavascript' elementIdentifier='email' forceSelection=false}
+				{/if}
+			</dd>
+		</dl>
+		
+		<dl>
+			<dt><label for="showOrder">{lang}wcf.global.showOrder{/lang}</label></dt>
+			<dd>
+				<input type="number" id="showOrder" name="showOrder" value="{$showOrder}" class="tiny" min="0">
+			</dd>
+		</dl>
+		
+		<dl>
+			<dt></dt>
+			<dd>
+				<label><input type="checkbox" name="isDisabled" value="1"{if $isDisabled} checked{/if}> {lang}wcf.acp.contact.recipient.isDisabled{/lang}</label>
+			</dd>
+		</dl>
+		
+		{event name='dataFields'}
+	</div>
+	
+	{event name='sections'}
+	
+	<div class="formSubmit">
+		<input type="submit" value="{lang}wcf.global.button.submit{/lang}" accesskey="s">
+		<input type="hidden" name="action" value="{@$action}">
+		{@SECURITY_TOKEN_INPUT_TAG}
+	</div>
+</form>
+
+{include file='footer'}
diff --git a/wcfsetup/install/files/acp/templates/contactSettings.tpl b/wcfsetup/install/files/acp/templates/contactSettings.tpl
new file mode 100644
index 0000000000..bf6411bb28
--- /dev/null
+++ b/wcfsetup/install/files/acp/templates/contactSettings.tpl
@@ -0,0 +1,49 @@
+{include file='header' pageTitle='wcf.acp.contact.settings'}
+
+<header class="contentHeader">
+	<div class="contentHeaderTitle">
+		<h1 class="contentTitle">{lang}wcf.acp.contact.settings{/lang}</h1>
+	</div>
+	
+	<nav class="contentHeaderNavigation">
+		<ul>
+			<li><a href="{link controller='ContactRecipientAdd'}{/link}" class="button"><span class="icon icon16 fa-plus"></span> <span>{lang}wcf.acp.contact.recipient.add{/lang}</span></a></li>
+			<li><a href="{link controller='ContactOptionAdd'}{/link}" class="button"><span class="icon icon16 fa-plus"></span> <span>{lang}wcf.acp.contact.option.add{/lang}</span></a></li>
+			
+			{event name='contentHeaderNavigation'}
+		</ul>
+	</nav>
+</header>
+
+<section class="section">
+	<h2 class="sectionTitle">{lang}wcf.acp.contact.options{/lang}</h2>
+</section>
+
+<section class="section">
+	<h2 class="sectionTitle">{lang}wcf.acp.contact.recipients{/lang}</h2>
+	
+	<div id="recipientList" class="sortableListContainer">
+		<ol class="sortableList">
+			{foreach from=$recipientList item=recipient}
+				<li class="sortableNode sortableNoNesting" data-object-id="{@$recipient->recipientID}">
+					<span class="sortableNodeLabel">
+						<a href="{link controller='ContactRecipientEdit' id=$recipient->recipientID}{/link}">{lang}{$recipient}{/lang}</a>
+						
+						<span class="statusDisplay sortableButtonContainer">
+							<span class="icon icon16 fa-arrows sortableNodeHandle"></span>
+							<a href="{link controller='ContactRecipientEdit' id=$recipient->recipientID}{/link}"><span title="{lang}wcf.global.button.edit{/lang}" class="jsTooltip icon icon16 fa-pencil"></a>
+							<span title="{lang}wcf.global.button.delete{/lang}" class="jsDeleteButton jsTooltip icon icon16 fa-times" data-object-id="{@$recipient->recipientID}" data-confirm-message-html="{lang __encode=true}wcf.acp.contact.recipient.delete.confirmMessage{/lang}">
+							
+							{event name='itemButtons'}
+						</span>
+					</span>
+				</li>
+			{/foreach}
+		</ol>
+		<div class="formSubmit">
+			<button class="button" data-type="submit">{lang}wcf.global.button.saveSorting{/lang}</button>
+		</div>
+	</div>
+</section>
+
+{include file='footer'}
diff --git a/wcfsetup/install/files/lib/acp/form/ContactRecipientAddForm.class.php b/wcfsetup/install/files/lib/acp/form/ContactRecipientAddForm.class.php
new file mode 100644
index 0000000000..c7a1d1a168
--- /dev/null
+++ b/wcfsetup/install/files/lib/acp/form/ContactRecipientAddForm.class.php
@@ -0,0 +1,172 @@
+<?php
+namespace wcf\acp\form;
+use wcf\data\contact\recipient\ContactRecipient;
+use wcf\data\contact\recipient\ContactRecipientAction;
+use wcf\data\contact\recipient\ContactRecipientEditor;
+use wcf\form\AbstractForm;
+use wcf\system\exception\UserInputException;
+use wcf\system\language\I18nHandler;
+use wcf\system\WCF;
+
+/**
+ * Shows the form to create a new contact form recipient.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Acp\Form
+ */
+class ContactRecipientAddForm extends AbstractForm {
+	/**
+	 * @inheritDoc
+	 */
+	public $activeMenuItem = 'wcf.acp.menu.link.contact.settings';
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededModules = ['MODULE_CONTACT_FORM'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededPermissions = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * email address
+	 * @var string
+	 */
+	public $email = '';
+	
+	/**
+	 * display name
+	 * @var string
+	 */
+	public $name = '';
+	
+	/**
+	 * 1 if the recipient is disabled
+	 * @var	integer
+	 */
+	public $isDisabled = 0;
+	
+	/**
+	 * order used to the show the recipients
+	 * @var	integer
+	 */
+	public $showOrder = 0;
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function readParameters() {
+		parent::readParameters();
+		
+		I18nHandler::getInstance()->register('email');
+		I18nHandler::getInstance()->register('name');
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function readFormParameters() {
+		parent::readFormParameters();
+		
+		I18nHandler::getInstance()->readValues();
+		
+		if (I18nHandler::getInstance()->isPlainValue('email')) $this->email = I18nHandler::getInstance()->getValue('email');
+		if (I18nHandler::getInstance()->isPlainValue('name')) $this->name = I18nHandler::getInstance()->getValue('name');
+		
+		if (isset($_POST['isDisabled'])) $this->isDisabled = intval($_POST['isDisabled']);
+		if (isset($_POST['showOrder'])) $this->showOrder = intval($_POST['showOrder']);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function validate() {
+		parent::validate();
+		
+		if (!I18nHandler::getInstance()->validateValue('email')) {
+			if (I18nHandler::getInstance()->isPlainValue('email')) {
+				throw new UserInputException('email');
+			}
+			else {
+				throw new UserInputException('email', 'multilingual');
+			}
+		}
+		
+		if (!I18nHandler::getInstance()->validateValue('name')) {
+			if (I18nHandler::getInstance()->isPlainValue('name')) {
+				throw new UserInputException('name');
+			}
+			else {
+				throw new UserInputException('name', 'multilingual');
+			}
+		}
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function save() {
+		parent::save();
+		
+		$this->objectAction = new ContactRecipientAction([], 'create', [
+			'data' => array_merge($this->additionalFields, [
+				'name' => $this->name,
+				'email' => $this->email,
+				'isDisabled' => ($this->isDisabled ? 1 : 0),
+				'showOrder' => $this->showOrder
+			])
+		]);
+		/** @var ContactRecipient $recipient */
+		$recipient = $this->objectAction->executeAction()['returnValues'];
+		$recipientID = $recipient->recipientID;
+		$data = [];
+		
+		if (!I18nHandler::getInstance()->isPlainValue('email')) {
+			I18nHandler::getInstance()->save('email', 'wcf.contact.recipient.email'.$recipientID, 'wcf.contact', 1);
+			
+			$data['email'] = 'wcf.contact.recipient.email'.$recipientID;
+		}
+		if (!I18nHandler::getInstance()->isPlainValue('name')) {
+			I18nHandler::getInstance()->save('name', 'wcf.contact.recipient.name'.$recipientID, 'wcf.contact', 1);
+			
+			$data['name'] = 'wcf.contact.recipient.name'.$recipientID;
+		}
+		
+		// update i18n values
+		if (!empty($data)) {
+			(new ContactRecipientEditor($recipient))->update($data);
+		}
+		
+		$this->saved();
+		
+		// show success message
+		WCF::getTPL()->assign('success', true);
+		
+		// reset values
+		$this->email = $this->name = 0;
+		$this->isDisabled = $this->showOrder = 0;
+		
+		I18nHandler::getInstance()->reset();
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function assignVariables() {
+		parent::assignVariables();
+		
+		I18nHandler::getInstance()->assignVariables();
+		
+		WCF::getTPL()->assign([
+			'action' => 'add',
+			'email' => $this->email,
+			'name' => $this->name,
+			'isDisabled' => $this->isDisabled,
+			'showOrder' => $this->showOrder
+		]);
+	}
+}
diff --git a/wcfsetup/install/files/lib/acp/form/ContactRecipientEditForm.class.php b/wcfsetup/install/files/lib/acp/form/ContactRecipientEditForm.class.php
new file mode 100644
index 0000000000..f99a49cd37
--- /dev/null
+++ b/wcfsetup/install/files/lib/acp/form/ContactRecipientEditForm.class.php
@@ -0,0 +1,135 @@
+<?php
+namespace wcf\acp\form;
+use wcf\data\contact\recipient\ContactRecipient;
+use wcf\data\contact\recipient\ContactRecipientAction;
+use wcf\data\contact\recipient\ContactRecipientEditor;
+use wcf\form\AbstractForm;
+use wcf\system\exception\IllegalLinkException;
+use wcf\system\exception\UserInputException;
+use wcf\system\language\I18nHandler;
+use wcf\system\WCF;
+
+/**
+ * Shows the form to update a contact form recipient.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Acp\Form
+ */
+class ContactRecipientEditForm extends ContactRecipientAddForm {
+	/**
+	 * @inheritDoc
+	 */
+	public $activeMenuItem = 'wcf.acp.menu.link.contact.settings';
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededModules = ['MODULE_CONTACT_FORM'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededPermissions = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * @var ContactRecipient
+	 */
+	public $recipient;
+	
+	/**
+	 * @var integer
+	 */
+	public $recipientID = 0;
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function readParameters() {
+		parent::readParameters();
+		
+		if (isset($_REQUEST['id'])) $this->recipientID = intval($_REQUEST['id']);
+		$this->recipient = new ContactRecipient($this->recipientID);
+		if (!$this->recipient->recipientID) {
+			throw new IllegalLinkException();
+		}
+	}
+	
+	public function readData() {
+		parent::readData();
+		
+		if (empty($_POST)) {
+			I18nHandler::getInstance()->setOptions('name', 1, $this->recipient->name, 'wcf.contact.recipient.name\d+');
+			I18nHandler::getInstance()->setOptions('email', 1, $this->recipient->email, 'wcf.contact.recipient.email\d+');
+			
+			$this->name = $this->recipient->name;
+			$this->email = $this->recipient->email;
+			$this->isDisabled = $this->recipient->isDisabled;
+			$this->showOrder = $this->recipient->showOrder;
+			
+			if ($this->recipient->isAdministrator) {
+				$this->email = MAIL_ADMIN_ADDRESS;
+			}
+		}
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function save() {
+		AbstractForm::save();
+		
+		$this->name = 'wcf.contact.recipient.name'.$this->recipient->recipientID;
+		if (I18nHandler::getInstance()->isPlainValue('name')) {
+			I18nHandler::getInstance()->remove($this->name);
+			$this->name = I18nHandler::getInstance()->getValue('name');
+		}
+		else {
+			I18nHandler::getInstance()->save('name', $this->name, 'wcf.contact', 1);
+		}
+		$this->email = 'wcf.contact.recipient.email'.$this->recipient->recipientID;
+		if (!$this->recipient->isAdministrator) {
+			if (I18nHandler::getInstance()->isPlainValue('email')) {
+				I18nHandler::getInstance()->remove($this->email);
+				$this->email = I18nHandler::getInstance()->getValue('email');
+			}
+			else {
+				I18nHandler::getInstance()->save('email', $this->email, 'wcf.contact', 1);
+			}
+		}
+		
+		$data = [
+			'name' => $this->name,
+			'isDisabled' => $this->isDisabled ? 1 : 0,
+			'showOrder' => $this->showOrder
+		];
+		if (!$this->recipient->isAdministrator) {
+			$data['email'] = $this->email;
+		}
+		
+		$this->objectAction = new ContactRecipientAction([$this->recipient], 'update', [
+			'data' => array_merge($this->additionalFields, $data)
+		]);
+		$this->objectAction->executeAction();
+		$this->saved();
+		
+		// show success message
+		WCF::getTPL()->assign('success', true);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function assignVariables() {
+		parent::assignVariables();
+		
+		I18nHandler::getInstance()->assignVariables(!empty($_POST));
+		
+		WCF::getTPL()->assign([
+			'recipientID' => $this->recipientID,
+			'recipient' => $this->recipient,
+			'action' => 'edit'
+		]);
+	}
+}
diff --git a/wcfsetup/install/files/lib/acp/page/ContactSettingsPage.class.php b/wcfsetup/install/files/lib/acp/page/ContactSettingsPage.class.php
new file mode 100644
index 0000000000..4b5b2762f8
--- /dev/null
+++ b/wcfsetup/install/files/lib/acp/page/ContactSettingsPage.class.php
@@ -0,0 +1,57 @@
+<?php
+namespace wcf\acp\page;
+use wcf\data\contact\recipient\ContactRecipientList;
+use wcf\page\AbstractPage;
+use wcf\system\WCF;
+
+/**
+ * Shows the contact form configuration page.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Acp\Page
+ * @since	3.1
+ */
+class ContactSettingsPage extends AbstractPage {
+	/**
+	 * @inheritDoc
+	 */
+	public $activeMenuItem = 'wcf.acp.menu.link.contact.settings';
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededModules = ['MODULE_CONTACT_FORM'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $neededPermissions = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * @var ContactRecipientList
+	 */
+	public $recipientList;
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function readData() {
+		parent::readData();
+		
+		$this->recipientList = new ContactRecipientList();
+		$this->recipientList->readObjects();
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function assignVariables() {
+		parent::assignVariables();
+		
+		WCF::getTPL()->assign([
+			'recipientList' => $this->recipientList
+		]);
+	}
+}
diff --git a/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipient.class.php b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipient.class.php
new file mode 100644
index 0000000000..cb78bc7865
--- /dev/null
+++ b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipient.class.php
@@ -0,0 +1,51 @@
+<?php
+namespace wcf\data\contact\recipient;
+use wcf\data\DatabaseObject;
+
+/**
+ * Represents a contact recipient.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Data\Contact\Recipient
+ * @since	3.1
+ * 
+ * @property-read	integer		$recipientID		unique id of the recipient
+ * @property-read	string		$name			name of the recipient
+ * @property-read	string		$email			email address of the recipient
+ * @property-read	integer		$showOrder		position of the recipient in relation to other recipients
+ * @property-read	integer		$isAdministrator	is `1` if the recipient is the administrator and the `email` value equals `MAIL_ADMIN_ADDRESS`, otherwise `0`
+ * @property-read	integer		$isDisabled		is `1` if the recipient is disabled and thus is not available for selection, otherwise `0`
+ * @property-read	integer		$originIsSystem		is `1` if the recipient has been delivered by a package, otherwise `0` (i.e. the recipient has been created in the ACP)
+ */
+class ContactRecipient extends DatabaseObject {
+	/**
+	 * @inheritDoc
+	 */
+	protected function handleData($data) {
+		// dynamically set email address for the administrator
+		if (!empty($data['isAdministrator'])) {
+			$data['email'] = MAIL_ADMIN_ADDRESS;
+		}
+		
+		parent::handleData($data);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function __toString() {
+		return $this->name;
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function __wakeup() {
+		// update the administrator's email address on de-serialization, avoids outdated caches
+		if (!empty($this->data['isAdministrator'])) {
+			$this->data['isAdministrator'] = MAIL_ADMIN_ADDRESS;
+		}
+	}
+}
diff --git a/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientAction.class.php b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientAction.class.php
new file mode 100644
index 0000000000..659eb1fcf2
--- /dev/null
+++ b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientAction.class.php
@@ -0,0 +1,56 @@
+<?php
+namespace wcf\data\contact\recipient;
+use wcf\data\AbstractDatabaseObjectAction;
+use wcf\system\exception\PermissionDeniedException;
+
+/**
+ * Executes contact recipient related actions.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Data\Contact\Recipient
+ * @since	3.1
+ * 
+ * @method	ContactRecipient[]	getObjects()
+ * @method	ContactRecipient	getSingleObject()
+ */
+class ContactRecipientAction extends AbstractDatabaseObjectAction {
+	/**
+	 * @inheritDoc
+	 */
+	protected $className = ContactRecipientEditor::class;
+	
+	/**
+	 * @inheritDoc
+	 */
+	protected $permissionsCreate = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	protected $permissionsDelete = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	protected $permissionsUpdate = ['admin.contact.canManageContactForm'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	protected $requireACP = ['create', 'delete', 'update'];
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function validateDelete() {
+		parent::validateDelete();
+		
+		foreach ($this->getObjects() as $object) {
+			if ($object->originIsSystem) {
+				throw new PermissionDeniedException();
+			}
+		}
+	}
+}
diff --git a/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientEditor.class.php b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientEditor.class.php
new file mode 100644
index 0000000000..1901d23e8c
--- /dev/null
+++ b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientEditor.class.php
@@ -0,0 +1,23 @@
+<?php
+namespace wcf\data\contact\recipient;
+use wcf\data\DatabaseObjectEditor;
+
+/**
+ * Provides functions to edit contact recipients.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Data\Contact\Recipient
+ * @since	3.1
+ * 
+ * @method static	ContactRecipient	create(array $parameters = [])
+ * @method		ContactRecipient	getDecoratedObject()
+ * @mixin		ContactRecipient
+ */
+class ContactRecipientEditor extends DatabaseObjectEditor {
+	/**
+	 * @inheritDoc
+	 */
+	protected static $baseClass = ContactRecipient::class;
+}
diff --git a/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientList.class.php b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientList.class.php
new file mode 100644
index 0000000000..bad34e92fc
--- /dev/null
+++ b/wcfsetup/install/files/lib/data/contact/recipient/ContactRecipientList.class.php
@@ -0,0 +1,29 @@
+<?php
+namespace wcf\data\contact\recipient;
+use wcf\data\DatabaseObjectList;
+
+/**
+ * Represents a list of contact recipients.
+ * 
+ * @author	Alexander Ebert
+ * @copyright	2001-2017 WoltLab GmbH
+ * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @package	WoltLabSuite\Core\Data\Contact\Recipient
+ * @since	3.1
+ *
+ * @method	ContactRecipient		current()
+ * @method	ContactRecipient[]		getObjects()
+ * @method	ContactRecipient|null		search($objectID)
+ * @property	ContactRecipient[]		$objects
+ */
+class ContactRecipientList extends DatabaseObjectList {
+	/**
+	 * @inheritDoc
+	 */
+	public $className = ContactRecipient::class;
+	
+	/**
+	 * @inheritDoc
+	 */
+	public $sqlOrderBy = 'showOrder';
+}
diff --git a/wcfsetup/install/lang/de.xml b/wcfsetup/install/lang/de.xml
index c37b012f21..53f1445640 100644
--- a/wcfsetup/install/lang/de.xml
+++ b/wcfsetup/install/lang/de.xml
@@ -2291,6 +2291,10 @@ Fehler sind beispielsweise:
 		<item name="wcf.condition.timestamp.error.invalidStart"><![CDATA[Das Startdatum ist ungültig.]]></item>
 	</category>
 	
+	<category name="wcf.contact">
+		<item name="wcf.contact.recipient.name1"><![CDATA[Administrator]]></item>
+	</category>
+	
 	<category name="wcf.date">
 		<item name="wcf.date.dateFormat"><![CDATA[j. F Y]]></item>
 		<item name="wcf.date.timeFormat"><![CDATA[H:i]]></item>
diff --git a/wcfsetup/install/lang/en.xml b/wcfsetup/install/lang/en.xml
index 456d6f53cc..31f2f045ee 100644
--- a/wcfsetup/install/lang/en.xml
+++ b/wcfsetup/install/lang/en.xml
@@ -2235,6 +2235,10 @@ Errors are:
 		<item name="wcf.condition.timestamp.error.invalidStart"><![CDATA[The start date is invalid.]]></item>
 	</category>
 	
+	<category name="wcf.contact">
+		<item name="wcf.contact.recipient.name1"><![CDATA[Administrator]]></item>
+	</category>
+	
 	<category name="wcf.date">
 		<item name="wcf.date.dateFormat"><![CDATA[M jS Y]]></item>
 		<item name="wcf.date.timeFormat">g:i&#xa0;a</item>
diff --git a/wcfsetup/setup/db/install.sql b/wcfsetup/setup/db/install.sql
index de90d01626..d1885d0900 100644
--- a/wcfsetup/setup/db/install.sql
+++ b/wcfsetup/setup/db/install.sql
@@ -413,6 +413,17 @@ CREATE TABLE wcf1_condition (
 	conditionData MEDIUMTEXT
 );
 
+DROP TABLE IF EXISTS wcf1_contact_recipient;
+CREATE TABLE wcf1_contact_recipient (
+	recipientID INT(10) NOT NULL AUTO_INCREMENT PRIMARY KEY,
+	name VARCHAR(255) NOT NULL,
+	email VARCHAR(255) NOT NULL,
+	showOrder INT(10) NOT NULL DEFAULT 0,
+	isAdministrator TINYINT(1) NOT NULL DEFAULT 0,
+	isDisabled TINYINT(1) NOT NULL DEFAULT 0,
+	originIsSystem TINYINT(1) NOT NULL DEFAULT 0
+);
+
 DROP TABLE IF EXISTS wcf1_core_object;
 CREATE TABLE wcf1_core_object (
 	objectID INT(10) NOT NULL AUTO_INCREMENT PRIMARY KEY,
@@ -2213,3 +2224,6 @@ INSERT INTO wcf1_user_rank (groupID, requiredPoints, rankTitle, cssClassName) VA
 	(3, 3000, 'wcf.user.rank.user3', ''),
 	(3, 9000, 'wcf.user.rank.user4', ''),
 	(3, 15000, 'wcf.user.rank.user5', '');
+
+-- default recipient: site administrator
+INSERT INTO wcf1_contact_recipient (recipientID, name, email, isAdministrator, originIsSystem) VALUES (1, 'wcf.contact.recipient.name1', '', 1, 1);
-- 
2.20.1