Daworks Outbound Mailer for Ncloud

説明

Daworks Outbound Mailer for Ncloud を使用すると、デフォルトの PHP メール関数の代わりに Ncloud Cloud Outbound Mailer API を通じてすべての WordPress メールを送信できます。

Daworks が開発 – プロフェッショナルな WordPress 開発。

注意: このプラグインは Daworks が開発したものであり、NAVER Cloud Platform または Ncloud とは提携関係になく、公式に承認または接続されているものでもありません。

機能

• WordPress 管理画面からの簡単な設定
• 複数リージョンのサポート (韓国、シンガポール、日本)
• HTML およびプレーンテキストメールのサポート
• CC および BCC のサポート
• 最新 100 件のメールログ記録
• 接続テストおよびテストメール送信機能
• 人気のプラグイン (Contact Form 7、WooCommerce など) との互換性あり

必要条件

• WordPress 5.6 以上
• PHP 7.4 以上
• Ncloud Cloud Outbound Mailer のサブスクリプション
• Ncloud API アクセスキーとシークレットキー

セットアップ

1. Ncloud Cloud Outbound Mailer サービスに登録します
2. Ncloud コンソールから API アクセスキーとシークレットキーを取得します
3. 送信ドメインを登録して確認します (下記のドメイン設定を参照)
4. WordPress 管理画面で 設定 > Ncloud Mailer に移動します
5. API 認証情報と送信者情報を入力します
6. メーラーを有効化し、テストメール機能でテストします

ドメイン設定

メールを送信する前に、Ncloud コンソールでドメインを登録して確認する必要があります。

ステップ 1: ドメインの登録

1. Ncloud コンソール > Cloud Outbound Mailer > ドメイン管理 に移動します
2. 「+ 도메인 등록」 (ドメインを追加) をクリックします
3. ドメイン名を入力します (例: example.com)

ステップ 2: ドメイン確認トークン

ドメインの所有権を確認するために TXT レコードを追加します:

1. ドメイン管理で、「인증 토큰」 (確認トークン) の横にある「보기」 (表示) をクリックします
2. 確認トークンの値をコピーします
3. DNS に TXT レコードを追加します:
   • ホスト: @ (またはお使いのドメイン)
   • タイプ: TXT
   • 値: (確認トークンを貼り付けてください)
4. 「새로 고침」 (更新) をクリックして確認します

ステップ 3: SPF レコード

SPF (Sender Policy Framework) は、お客様に代わって Ncloud がメールを送信することを承認します:

1. 「SPF 레코드」の横にある「보기」 (表示) をクリックします
2. SPF レコードの値をコピーします
3. DNS に TXT レコードを追加します:
   • ホスト: @
   • タイプ: TXT
   • 値: v=spf1 include:_spfblocka.ncloud.com ~all
4. 「사용」 (有効化) をクリックして SPF を有効にします

ステップ 4: DKIM レコード

DKIM (DomainKeys Identified Mail) はメールにデジタル署名を追加します:

1. 「DKIM」の横にある「보기」 (表示) をクリックします
2. DKIM レコードの値をコピーします
3. DNS に TXT レコードを追加します:
   • ホスト: (提供されたセレクター、例: ncloud._domainkey)
   • タイプ: TXT
   • 値: (DKIM 公開鍵を貼り付けてください)
4. 「사용」 (有効化) をクリックして DKIM を有効にします

ステップ 5: DMARC レコード (推奨)

DMARC は認証失敗時の処理方法を指定します:

1. DNS に TXT レコードを追加します:
   • ホスト: _dmarc
   • タイプ: TXT
   • 値: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com
2. 確認後は、ポリシーを p=quarantine または p=reject に変更することを検討してください

DNS レコードの概要

Type
Host
Value

TXT
@
(Verification Token)

TXT
@
v=spf1 include:_spfblocka.ncloud.com ~all

TXT
ncloud._domainkey
(DKIM Public Key)

TXT
_dmarc
v=DMARC1; p=none; rua=mailto:you@domain.com

注意: DNS の伝播には最大 24〜48 時間かかる場合があります。確認が完了すると、確認ステータスに「인증 완료」(確認済み) と表示されます。

外部サービス

このプラグインは、メールを送信するためにサードパーティの外部サービスとして NAVER Cloud Platform の Cloud Outbound Mailer API を利用しています。このサービスなしにはメールを送信できません。

NAVER Cloud Platform – Cloud Outbound Mailer

サービスプロバイダー: NAVER Cloud Corp.
サービスウェブサイト: https://www.ncloud.com/product/applicationService/cloudOutboundMailer
利用規約: https://www.ncloud.com/policy/terms/service
プライバシーポリシー: https://www.ncloud.com/policy/privacy/privacy

このサービスの機能:
このプラグインは、すべての WordPress メール (ユーザー登録、パスワードリセット、コンタクトフォームの送信、WooCommerce 通知、および wp_mail() 経由で送信されるすべてのメール) を、デフォルトの PHP メール関数の代わりに NAVER Cloud Platform Cloud Outbound Mailer API を通じて送信します。

このサービスに送信されるデータ:
WordPress がメールを送信するたびに、以下のデータが NAVER Cloud Platform API に送信されます:

• 送信者のメールアドレスと名前 (プラグイン設定で構成)
• 受信者のメールアドレス (To、CC、BCC)
• メールの件名
• メール本文の内容 (HTML またはプレーンテキスト)
• Reply-To アドレス (指定された場合)

データが送信されるタイミング:
このプラグインが有効な間、WordPress が wp_mail() 関数を通じてメールを送信するたびにデータが送信されます。これには、ユーザー登録メール、パスワードリセットメール、コメント通知、プラグイン・テーマの更新通知、WooCommerce の注文メール、Contact Form 7 の送信などが含まれますが、これらに限りません。

API エンドポイント (NAVER Cloud Platform の API ゲートウェイドメインである ntruss.com でホストされています):

• 韓国: https://mail.apigw.ntruss.com/api/v1
• シンガポール: https://mail.apigw.ntruss.com/api/v1-sgn
• 日本: https://mail.apigw.ntruss.com/api/v1-jpn

このプラグインを使用することにより、NAVER Cloud Platform の 利用規約および プライバシーポリシーに同意したものとみなされます。

開発者向けドキュメント

フィルター

ncloud_mailer_before_send
送信前にメールデータを変更します。

add_filter( 'ncloud_mailer_before_send', function( $body, $mail_data ) {
    // Modify $body array before sending
    return $body;
}, 10, 2 );

ncloud_mailer_fallback_on_error
エラー発生時にデフォルトの wp_mail へのフォールバックを有効化します。

add_filter( 'ncloud_mailer_fallback_on_error', '__return_true' );

ncloud_mailer_enable_logging
メールログを無効化します。

add_filter( 'ncloud_mailer_enable_logging', '__return_false' );

アクション

ncloud_mailer_init
プラグインの初期化が完了した後に実行されます。

ncloud_mailer_after_send
メールの送信が成功した後に実行されます。

ncloud_mailer_error
メール送信中にエラーが発生したときに実行されます。

デバッグ

メールログ

このプラグインは最新の 100 件のメールログを WordPress トランジェント (ncloud_mailer_logs) に保存します。ログはプログラムから取得することもできます:

$logs = get_transient( 'ncloud_mailer_logs' );
foreach ( $logs as $log ) {
    echo $log['time'] . ' - ' . $log['status'] . ' - ' . $log['subject'];
}

各ログエントリには以下の情報が含まれます:
* time – メールのタイムスタンプ
* status – ‘success’ または ‘error’
* to – 受信者のメールアドレス
* subject – メールの件名
* request_id – Ncloud リクエスト ID (成功時のみ)
* code – エラーコード (エラー時のみ)
* message – エラーメッセージ (エラー時のみ)

WordPress デバッグログ

WP_DEBUG が有効な場合、エラーは wp-content/debug.log にも記録されます:

// In wp-config.php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

ログフォーマット: [Ncloud Mailer Error] {code}: {message} (To: {recipients}, Subject: {subject})

ログの無効化

ログを完全に無効にするには:

add_filter( 'ncloud_mailer_enable_logging', '__return_false' );