[
'label' => 'From-Email',
'type' => 'email',
'required' => true,
'placeholder' => 'you@example.com',
],
Settings::HOSTNAME_OPTION => [
'label' => 'SMTP-Hostname',
'type' => 'text',
'required' => true,
'placeholder' => 'smtp.example.com or localhost',
],
Settings::USERNAME_OPTION => [
'label' => 'SMTP-Username',
'type' => 'text',
'description' => 'Leave empty if your SMTP server does not require authentication.',
],
Settings::PASSWORD_OPTION => [
'label' => 'SMTP-Password',
'type' => 'password',
'description' => 'Leave empty if your SMTP server does not require authentication.',
],
Settings::PORT_OPTION => [
'label' => 'SMTP-Port',
'type' => 'number',
'required' => true,
'default' => 587,
],
Settings::TLS_OPTION => [
'label' => 'SMTP-TLS',
'type' => 'select',
'options' => ['yes' => 'Yes', 'no' => 'No'],
],
];
add_settings_section(
id: 'actra-smtp_main',
title: 'Connection Settings',
callback: [$this, 'render_settings_section'],
page: Settings::PAGE
);
foreach ($fields as $id => $args) {
$register_args = [
'type' => 'string',
'default' => $args['default'] ?? '',
];
switch ($args['type']) {
case 'email':
$register_args['sanitize_callback'] = [$this, 'sanitize_sender_email'];
break;
case 'number':
$register_args['type'] = 'integer';
$register_args['sanitize_callback'] = [$this, 'sanitize_port'];
break;
case 'password':
$register_args['sanitize_callback'] = [$this, 'sanitize_password'];
break;
case 'select':
$register_args['sanitize_callback'] = [$this, 'sanitize_tls'];
break;
default:
$register_args['sanitize_callback'] = [$this, 'sanitize_text'];
break;
}
register_setting(
option_group: Settings::GROUP,
option_name: $id,
args: $register_args
);
add_settings_field(
id: $id,
title: $args['label'],
callback: [$this, 'render_field'],
page: Settings::PAGE,
section: 'actra-smtp_main',
args: array_merge(['id' => $id], $args)
);
}
}
public function render_settings_section(): void
{
if (!SmtpConfigProvider::has_any_config_constant()) {
return;
}
echo 'One or more SMTP settings are defined in wp-config.php . Fields controlled by constants are disabled here, and the constant values take priority over database settings.
';
}
public function render_field(array $args): void
{
if ('password' === $args['type']) {
$this->render_password_field(args: $args);
return;
}
$value = get_option(option: $args['id'], default_value: $args['default'] ?? '');
$has_constant = SmtpConfigProvider::has_constant_for_option(option_name: $args['id']);
if ($has_constant) {
$value = $this->get_display_value_for_constant_field(args: $args);
}
if ('select' === $args['type']) {
$this->render_select_field(args: $args, value: (string)$value, disabled: $has_constant);
} else {
$this->render_input_field(args: $args, value: (string)$value, disabled: $has_constant);
}
if ($has_constant) {
echo 'This setting is defined in wp-config.php and cannot be changed here.
';
return;
}
if (!empty($args['description'])) {
printf('%s
', esc_html(text: $args['description']));
}
}
public function render_password_field(array $args): void
{
$has_constant = SmtpConfigProvider::has_constant_for_option(option_name: Settings::PASSWORD_OPTION);
$has_saved_password = '' !== (string)get_option(option: $args['id'], default_value: '');
if ($has_constant) {
printf(
'Password is defined in wp-config.php and cannot be changed here.
';
return;
}
printf(
'A password is saved. Leave this field empty to keep the current password, or enter a new one to overwrite it.
';
return;
}
if (!empty($args['description'])) {
printf('%s
', esc_html(text: $args['description']));
}
}
public function sanitize_sender_email($value): string
{
if (SmtpConfigProvider::has_constant_for_option(option_name: Settings::SENDER_EMAIL_OPTION)) {
return (string)get_option(option: Settings::SENDER_EMAIL_OPTION, default_value: '');
}
return sanitize_email(email: (string)$value);
}
public function sanitize_text($value): string
{
$option_name = $this->get_current_option_name();
if (null !== $option_name && SmtpConfigProvider::has_constant_for_option(option_name: $option_name)) {
return (string)get_option(option: $option_name, default_value: '');
}
return sanitize_text_field(str: (string)$value);
}
public function sanitize_password($value): string
{
$value = (string)$value;
if (SmtpConfigProvider::has_constant_for_option(option_name: Settings::PASSWORD_OPTION)) {
return (string)get_option(option: Settings::PASSWORD_OPTION, default_value: '');
}
if ('' === $value) {
return (string)get_option(option: Settings::PASSWORD_OPTION, default_value: '');
}
return Encryption::encrypt(value: $value);
}
public function sanitize_port($value): int
{
if (SmtpConfigProvider::has_constant_for_option(option_name: Settings::PORT_OPTION)) {
return (int)get_option(option: Settings::PORT_OPTION, default_value: 587);
}
return absint($value);
}
public function sanitize_tls($value): string
{
if (SmtpConfigProvider::has_constant_for_option(option_name: Settings::TLS_OPTION)) {
return (string)get_option(option: Settings::TLS_OPTION, default_value: 'yes');
}
return 'yes' === $value ? 'yes' : 'no';
}
public function render_settings_page(): void
{
?>
SMTP Settings
';
foreach ($args['options'] as $val => $label) {
echo '' . esc_html(text: $label) . ' ';
}
echo '';
}
private function render_input_field(array $args, string $value, bool $disabled): void
{
printf(
'