3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
15 * @copyright CiviCRM LLC https://civicrm.org/licensing
17 class CRM_Core_BAO_MailSettings
extends CRM_Core_DAO_MailSettings
{
20 * Get a list of setup-actions.
23 * List of available actions. See description in the hook-docs.
24 * @see CRM_Utils_Hook::mailSetupActions()
26 public static function getSetupActions() {
28 $setupActions['standard'] = [
29 'title' => ts('Standard Mail Account'),
30 'callback' => ['CRM_Core_BAO_MailSettings', 'setupStandardAccount'],
33 CRM_Utils_Hook
::mailSetupActions($setupActions);
37 public static function setupStandardAccount($setupAction) {
39 'url' => CRM_Utils_System
::url('civicrm/admin/mailSettings', 'action=add&reset=1', TRUE, NULL, FALSE),
44 * Return the DAO object containing to the default row of
45 * civicrm_mail_settings and cache it for further calls
49 * @return CRM_Core_BAO_MailSettings
50 * DAO with the default mail settings set
52 public static function defaultDAO($reset = FALSE) {
53 static $mailSettings = [];
54 $domainID = CRM_Core_Config
::domainID();
55 if (empty($mailSettings[$domainID]) ||
$reset) {
58 $dao->domain_id
= $domainID;
60 $mailSettings[$domainID] = $dao;
62 return $mailSettings[$domainID];
66 * Return the domain from the default set of settings.
71 public static function defaultDomain() {
72 return self
::defaultDAO()->domain
;
76 * Return the localpart from the default set of settings.
81 public static function defaultLocalpart() {
82 return self
::defaultDAO()->localpart
;
86 * Return the return path from the default set of settings.
91 public static function defaultReturnPath() {
92 return self
::defaultDAO()->return_path
;
96 * Return the "include message ID" flag from the default set of settings.
99 * default include message ID
101 public static function includeMessageId() {
102 return Civi
::settings()->get('include_message_id');
106 * Retrieve DB object and copy to defaults array.
108 * @param array $params
109 * Array of criteria values.
110 * @param array $defaults
111 * Array to be populated with found values.
114 * The DAO object, if found.
118 public static function retrieve($params, &$defaults) {
119 return self
::commonRetrieve(self
::class, $params, $defaults);
123 * Add new mail Settings.
125 * @param array $params
126 * Reference array contains the values submitted by the form.
129 * @return CRM_Core_DAO_MailSettings
131 public static function add(&$params) {
133 if (empty($params)) {
137 if (empty($params['id'])) {
138 $params['is_ssl'] = CRM_Utils_Array
::value('is_ssl', $params, FALSE);
139 $params['is_default'] = CRM_Utils_Array
::value('is_default', $params, FALSE);
143 if (!empty($params['is_default'])) {
144 $query = 'UPDATE civicrm_mail_settings SET is_default = 0 WHERE domain_id = %1';
145 $queryParams = [1 => [CRM_Core_Config
::domainID(), 'Integer']];
146 CRM_Core_DAO
::executeQuery($query, $queryParams);
149 $mailSettings = new CRM_Core_DAO_MailSettings();
150 $mailSettings->copyValues($params);
151 $result = $mailSettings->save();
157 * Takes an associative array and creates a mail settings object.
159 * @param array $params
160 * (reference ) an assoc array of name/value pairs.
162 * @return CRM_Core_DAO_MailSettings|CRM_Core_Error
164 public static function create(&$params) {
165 $transaction = new CRM_Core_Transaction();
167 $mailSettings = self
::add($params);
168 if (is_a($mailSettings, 'CRM_Core_Error')) {
169 $mailSettings->rollback();
170 return $mailSettings;
173 $transaction->commit();
174 CRM_Core_BAO_MailSettings
::defaultDAO(TRUE);
175 return $mailSettings;
179 * Delete the mail settings.
186 public static function deleteMailSettings($id) {
188 $transaction = new CRM_Core_Transaction();
190 $mailSettings = new CRM_Core_DAO_MailSettings();
191 $mailSettings->id
= $id;
192 $results = $mailSettings->delete();
194 $transaction->commit();