sender.before_save

Приложения » Рассылки »

Срабатывает перед сохранением настроек отправителя. Позволяет плагину проверить значения настроек, прервать сохранение и показать пользователю сообщение об ошибке.

Доступно начиная с версии 2.0.0.

Рассылки

Входящие параметры (передаются по ссылке)

$params['sender_id'] int ID отправителя.
$params['sender'] array Массив основных свойств отправителя со следующими ключами:
$params['sender']['id'] int ID отправителя.
$params['sender']['name'] string Название.
$params['sender']['email'] string Email-адрес.
$params['sender_params'] array Массив ранее сохранённых дополнительных параметров отправителя со следующими ключами:
$params['sender_params']['type'] string Тип отправителя из списка: 'default' (по умолчанию), 'mail' (функция mail()), 'smtp' (SMTP-сервер), 'sendmail' (команда sendmail). Или другой тип отправителя, если он добавлен с помощью плагина.
$params['sender_params']['reply_to'] string Адрес Reply-To.
$params['sender_params']['dkim'] bool Флаг, означающий использование подписи DKIM.
$params['sender_params']['dkim_pub_key'] string Публичный ключ для использования подписи DKIM.
$params['sender_params']['dkim_pvt_key'] string Приватный ключ для использования подписи DKIM.
$params['sender_params']['encryption'] string Значение настройки «Шифрование» для отправителя типа «SMTP»: 'ssl' или 'tls'.
$params['sender_params']['options'] string Значение настройки «Параметры» для отправителя типа «PHP-функция mail()».
$params['sender_params']['server'] string Значение настройки «Сервер» для отправителя типа «SMTP».
$params['sender_params']['port'] int Значение настройки «Порт» для отправителя типа «SMTP».
$params['sender_params']['login'] string Значение настройки «Логин» для отправителя типа «SMTP».
$params['sender_params']['password'] string Значение настройки «Пароль» для отправителя типа «SMTP».
$params['sender_update'] array Массив новых свойств отправителя со следующими ключами:
$params['sender_update']['name'] string Название.
$params['sender_update']['email'] string Email-адрес.
$params['sender_params_update'] array Массив новых параметров отправителя. Структура аналогична массиву 'sender_params'.

… код плагина …

Результат работы плагина

$return

Массив сообщений об ошибках, которые нужно показать пользователю.

Рассылки

Пример кода плагина

PHP

public function senderBeforeSave(&$params)
{
    // if ($something_wrong) {
        return [
            _wp('Plugin’s error message.')
        ];
    // }
}