Skip to content

feat: complete OCI transactional email setup #1445

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
superdav42 merged 1 commit into from
Jun 16, 2026
Merged

feat: complete OCI transactional email setup #1445

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 35 additions & 10 deletions inc/integrations/providers/oci-email/class-oci-email-integration.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ class OCI_Email_Integration extends Integration {
* @since 2.5.0
* @var string
*/
private const API_BASE = 'https://email.%s.oci.oraclecloud.com/20170907/';
private const API_BASE = 'https://ctrl.email.%s.oci.oraclecloud.com/20170907/';

/**
* Constructor.
Expand All @@ -45,7 +45,14 @@ public function __construct() {
$this->set_logo(function_exists('wu_get_asset') ? wu_get_asset('oracle-oci.svg', 'img/hosts') : '');
$this->set_tutorial_link('https://ultimatemultisite.com/docs/user-guide/host-integrations/oracle-oci-email-delivery');
$this->set_constants(['WU_OCI_TENANCY_OCID', 'WU_OCI_USER_OCID', 'WU_OCI_KEY_FINGERPRINT', 'WU_OCI_PRIVATE_KEY', 'WU_OCI_COMPARTMENT_OCID']);
$this->set_optional_constants(['WU_OCI_REGION', 'WU_OCI_EMAIL_SPF_INCLUDE', 'WU_OCI_EMAIL_DOMAIN_ENDPOINT']);
$this->set_optional_constants(
[
'WU_OCI_REGION',
'WU_OCI_EMAIL_SPF_INCLUDE',
'WU_OCI_EMAIL_DOMAIN_ENDPOINT',
'WU_OCI_EMAIL_APPROVED_SENDER_LOCAL_PART',
]
);
}

/**
Expand Down Expand Up @@ -99,6 +106,19 @@ public function get_spf_include(): string {
return $spf_include ?: 'rp.oracleemaildelivery.com';
}

/**
* Returns the default local part used for OCI approved senders.
*
* @since 2.5.0
* @return string
*/
public function get_approved_sender_local_part(): string {

$local_part = sanitize_key($this->get_credential('WU_OCI_EMAIL_APPROVED_SENDER_LOCAL_PART'));

return $local_part ?: 'support';
}

/**
* Returns the configured OCI compartment OCID.
*
Expand Down Expand Up @@ -208,44 +228,49 @@ public function test_connection() {
public function get_fields(): array {

return [
'WU_OCI_TENANCY_OCID' => [
'WU_OCI_TENANCY_OCID' => [
'title' => __('OCI Tenancy OCID', 'ultimate-multisite'),
'placeholder' => __('e.g. ocid1.tenancy.oc1..aaaa...', 'ultimate-multisite'),
],
'WU_OCI_USER_OCID' => [
'WU_OCI_USER_OCID' => [
'title' => __('OCI User OCID', 'ultimate-multisite'),
'placeholder' => __('e.g. ocid1.user.oc1..aaaa...', 'ultimate-multisite'),
],
'WU_OCI_KEY_FINGERPRINT' => [
'WU_OCI_KEY_FINGERPRINT' => [
'title' => __('OCI API Key Fingerprint', 'ultimate-multisite'),
'placeholder' => __('e.g. 12:34:56:...', 'ultimate-multisite'),
],
'WU_OCI_PRIVATE_KEY' => [
'WU_OCI_PRIVATE_KEY' => [
'title' => __('OCI API Private Key', 'ultimate-multisite'),
'type' => 'textarea',
'desc' => __('Paste the PEM private key for the OCI API key. Newline escape sequences are supported.', 'ultimate-multisite'),
'html_attr' => [
'autocomplete' => 'new-password',
],
],
'WU_OCI_COMPARTMENT_OCID' => [
'WU_OCI_COMPARTMENT_OCID' => [
'title' => __('OCI Compartment OCID', 'ultimate-multisite'),
'placeholder' => __('e.g. ocid1.compartment.oc1..aaaa...', 'ultimate-multisite'),
],
'WU_OCI_REGION' => [
'WU_OCI_REGION' => [
'title' => __('OCI Region', 'ultimate-multisite'),
'placeholder' => __('e.g. eu-zurich-1', 'ultimate-multisite'),
'desc' => __('Optional. The OCI region for Email Delivery. Defaults to eu-zurich-1.', 'ultimate-multisite'),
],
'WU_OCI_EMAIL_SPF_INCLUDE' => [
'WU_OCI_EMAIL_SPF_INCLUDE' => [
'title' => __('OCI SPF Include Host', 'ultimate-multisite'),
'placeholder' => __('rp.oracleemaildelivery.com', 'ultimate-multisite'),
'desc' => __('Optional. Override only if Oracle changes the SPF include host for your tenancy or region.', 'ultimate-multisite'),
],
'WU_OCI_EMAIL_DOMAIN_ENDPOINT' => [
'WU_OCI_EMAIL_DOMAIN_ENDPOINT' => [
'title' => __('OCI Email API Endpoint Override', 'ultimate-multisite'),
'desc' => __('Optional. Advanced use only; overrides the generated Email Delivery API endpoint.', 'ultimate-multisite'),
],
'WU_OCI_EMAIL_APPROVED_SENDER_LOCAL_PART' => [
'title' => __('OCI Approved Sender Local Part', 'ultimate-multisite'),
'placeholder' => __('support', 'ultimate-multisite'),
'desc' => __('Optional. Used to create or reuse an OCI approved sender such as support@example.com when a domain is verified.', 'ultimate-multisite'),
],
];
}

Expand Down
Loading
Loading