カテゴリー: WordPress

はじめに

表題のように，編集画面のどこかにその投稿につけられたタグと同じタグを持つ投稿のURLを埋め込むPHPコードについて，copilotに教えてもらいました．このコードを使用するには十分に内容を確認して慎重に使用するようcopilotも言っています．

カスタムフィールドの使い方

概要

1. カスタムフィールドは，メタデータのこと．
2. メタデータは，フィールド名と値で構成される．
3. 記事内でフィールド名と値を1対として登録する．
4. 表示させるには，the_meta()テンプレートタグを使用する
   • 表示させるコード : <?php the_meta(); ?> 記事のどこかに配置する必要がある
   • 表示させる場所は，記事の最初/最後のメタデータセッションなどが多い．
   • スタイルシート(styles.css)にて修飾可能 : 追加コード「.post-meta { font-variant: small-caps; color: maroon; } .post-meta-key { color: green; font-weight: bold; font-size: 110%; }」
5. 高度なテクニック
   • メタデータを取得するコード : get_post_meta( $post_id, $key, $single );
6. など．．．

カスタムフィールドの使い方 – サポートフォーラム – WordPress.org 日本語

質問1

「wordpressにおいて投稿の編集画面に自動に表示させるPHPコードを教えて．その際，どのファイルにPHPコードを追加するのかも教えて」

回答1

AI で生成されたコード。ご確認のうえ、慎重にご使用ください。FAQ で詳細を確認。

// 投稿の編集画面にカスタムフィールドを追加する関数
function add_custom_field() {
    // 投稿タイプを指定する（post, page, custom_post_typeなど）
    $post_type = 'post';
    // カスタムフィールドのメタボックスのIDを指定する
    $meta_box_id = 'custom_field';
    // カスタムフィールドのメタボックスのタイトルを指定する
    $meta_box_title = 'カスタムフィールド';
    // カスタムフィールドのメタボックスを表示する場所を指定する（normal, side, advancedなど）
    $context = 'normal';
    // カスタムフィールドのメタボックスの優先度を指定する（high, low, defaultなど）
    $priority = 'high';
    // カスタムフィールドのメタボックスのコールバック関数を指定する
    $callback = 'show_custom_field';
    // カスタムフィールドのメタボックスを追加する
    add_meta_box($meta_box_id, $meta_box_title, $callback, $post_type, $context, $priority);
}

// カスタムフィールドのメタボックスのコールバック関数
function show_custom_field() {
    // グローバル変数$postを使えるようにする
    global $post;
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'custom_field_key';
    // カスタムフィールドの値を取得する
    $custom_field_value = get_post_meta($post->ID, $custom_field_key, true);
    // nonceフィールドを生成する（セキュリティ対策）
    wp_nonce_field('save_custom_field', 'custom_field_nonce');
    // カスタムフィールドの入力フォームを表示する
    echo '<label for="custom_field">カスタムフィールドの値</label>';
    echo '<input type="text" id="custom_field" name="custom_field" value="' . esc_attr($custom_field_value) . '" size="25" />';
}

// カスタムフィールドの値を保存する関数
function save_custom_field($post_id) {
    // nonceフィールドの値を取得する
    $nonce = isset($_POST['custom_field_nonce']) ? $_POST['custom_field_nonce'] : '';
    // nonceフィールドの値を検証する（セキュリティ対策）
    if (!wp_verify_nonce($nonce, 'save_custom_field')) {
        return $post_id;
    }
    // 自動保存の場合は処理をしない
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return $post_id;
    }
    // ユーザーが投稿を編集できる権限があるかチェックする
    if (!current_user_can('edit_post', $post_id)) {
        return $post_id;
    }
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'custom_field_key';
    // カスタムフィールドの値を取得する
    $custom_field_value = isset($_POST['custom_field']) ? $_POST['custom_field'] : '';
    // カスタムフィールドの値を保存する
    update_post_meta($post_id, $custom_field_key, $custom_field_value);
}

// アクションフックに関数を登録する
add_action('add_meta_boxes', 'add_custom_field');
add_action('save_post', 'save_custom_field');

このPHPコードを追加するファイルは、テーマのfunctions.phpになります。functions.phpは、テーマの機能やカスタマイズを行うためのファイルです。functions.phpは、テーマフォルダの中にあります。

1. wp-customize.net 2. ku-su.com 3. webroad.co.jp 4. goworkship.com 5. web.hazu.jp 6. ja.wikipedia.org

質問2

「wordpressにおいて投稿の編集画面にカスタムフィールドを設定したとして，このカスタムフィールドに，この投稿につけられたタグと同じタグを持つ投稿のURLを張り付けるPHPコードを教えてください」

回答2

まず、カスタムフィールドを追加するには、functions.phpに以下のようなコードを記述します。¹²

AI で生成されたコード。ご確認のうえ、慎重にご使用ください。FAQ で詳細を確認。

// カスタムフィールドのメタボックスを追加する関数
function add_related_posts_field() {
    // 投稿タイプを指定する（post, page, custom_post_typeなど）
    $post_type = 'post';
    // カスタムフィールドのメタボックスのIDを指定する
    $meta_box_id = 'related_posts';
    // カスタムフィールドのメタボックスのタイトルを指定する
    $meta_box_title = '関連記事';
    // カスタムフィールドのメタボックスを表示する場所を指定する（normal, side, advancedなど）
    $context = 'normal';
    // カスタムフィールドのメタボックスの優先度を指定する（high, low, defaultなど）
    $priority = 'high';
    // カスタムフィールドのメタボックスのコールバック関数を指定する
    $callback = 'show_related_posts_field';
    // カスタムフィールドのメタボックスを追加する
    add_meta_box($meta_box_id, $meta_box_title, $callback, $post_type, $context, $priority);
}

// カスタムフィールドのメタボックスのコールバック関数
function show_related_posts_field() {
    // グローバル変数$postを使えるようにする
    global $post;
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'related_posts';
    // カスタムフィールドの値を取得する
    $custom_field_value = get_post_meta($post->ID, $custom_field_key, true);
    // nonceフィールドを生成する（セキュリティ対策）
    wp_nonce_field('save_related_posts_field', 'related_posts_nonce');
    // カスタムフィールドの入力フォームを表示する
    echo '<label for="related_posts">関連記事のURLを入力してください（複数ある場合は改行で区切ってください）</label>';
    echo '<textarea id="related_posts" name="related_posts" rows="5" cols="50">' . esc_textarea($custom_field_value) . '</textarea>';
}

// カスタムフィールドの値を保存する関数
function save_related_posts_field($post_id) {
    // nonceフィールドの値を取得する
    $nonce = isset($_POST['related_posts_nonce']) ? $_POST['related_posts_nonce'] : '';
    // nonceフィールドの値を検証する（セキュリティ対策）
    if (!wp_verify_nonce($nonce, 'save_related_posts_field')) {
        return $post_id;
    }
    // 自動保存の場合は処理をしない
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return $post_id;
    }
    // ユーザーが投稿を編集できる権限があるかチェックする
    if (!current_user_can('edit_post', $post_id)) {
        return $post_id;
    }
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'related_posts';
    // カスタムフィールドの値を取得する
    $custom_field_value = isset($_POST['related_posts']) ? $_POST['related_posts'] : '';
    // カスタムフィールドの値を保存する
    update_post_meta($post_id, $custom_field_key, $custom_field_value);
}

// アクションフックに関数を登録する
add_action('add_meta_boxes', 'add_related_posts_field');
add_action('save_post', 'save_related_posts_field');
次に、このカスタムフィールドに、この投稿につけられたタグと同じタグを持つ投稿のURLを自動で張り付けるには、以下のようなコードをfunctions.phpに追加します。3

PHP
AI で生成されたコード。ご確認のうえ、慎重にご使用ください。FAQ で詳細を確認。

// カスタムフィールドに関連記事のURLを自動で張り付ける関数
function auto_related_posts_field($post_id) {
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'related_posts';
    // カスタムフィールドの値を取得する
    $custom_field_value = get_post_meta($post_id, $custom_field_key, true);
    // カスタムフィールドの値が空の場合のみ処理をする
    if (empty($custom_field_value)) {
        // この投稿につけられたタグのIDの配列を取得する
        $tags = wp_get_post_tags($post_id, array('fields' => 'ids'));
        // タグがある場合のみ処理をする
        if ($tags) {
            // この投稿と同じタグを持つ投稿のクエリを作成する
            $query = new WP_Query(array(
                'tag__in' => $tags, // タグのIDの配列
                'post__not_in' => array($post_id), // この投稿を除外する
                'posts_per_page' => 5, // 最大5件取得する
                'orderby' => 'rand', // ランダムに並べる
                'no_found_rows' => true, // ページネーションをしない
            ));
            // クエリにマッチした投稿がある場合のみ処理をする
            if ($query->have_posts()) {
                // 関連記事のURLの配列を作成する
                $related_posts = array();
                // クエリのループを開始する
                while ($query->have_posts()) {
                    // 投稿データをセットする
                    $query->the_post();
                    // 投稿のURLを取得して配列に追加する
                    $related_posts[] = get_permalink();
                }
                // クエリのループをリセットする
                wp_reset_postdata();
                // 配列を改行で区切って文字列にする
                $related_posts = implode("\n", $related_posts);
                // カスタムフィールドの値として保存する
                update_post_meta($post_id, $custom_field_key, $related_posts);
            }
        }
    }
}

// save_postフックに関数を登録する
add_action('save_post', 'auto_related_posts_field');

次に、このカスタムフィールドに、この投稿につけられたタグと同じタグを持つ投稿のURLを自動で張り付けるには、以下のようなコードをfunctions.phpに追加します。³

AI で生成されたコード。ご確認のうえ、慎重にご使用ください。FAQ で詳細を確認。

// カスタムフィールドに関連記事のURLを自動で張り付ける関数
function auto_related_posts_field($post_id) {
    // カスタムフィールドのキーを指定する
    $custom_field_key = 'related_posts';
    // カスタムフィールドの値を取得する
    $custom_field_value = get_post_meta($post_id, $custom_field_key, true);
    // カスタムフィールドの値が空の場合のみ処理をする
    if (empty($custom_field_value)) {
        // この投稿につけられたタグのIDの配列を取得する
        $tags = wp_get_post_tags($post_id, array('fields' => 'ids'));
        // タグがある場合のみ処理をする
        if ($tags) {
            // この投稿と同じタグを持つ投稿のクエリを作成する
            $query = new WP_Query(array(
                'tag__in' => $tags, // タグのIDの配列
                'post__not_in' => array($post_id), // この投稿を除外する
                'posts_per_page' => 5, // 最大5件取得する
                'orderby' => 'rand', // ランダムに並べる
                'no_found_rows' => true, // ページネーションをしない
            ));
            // クエリにマッチした投稿がある場合のみ処理をする
            if ($query->have_posts()) {
                // 関連記事のURLの配列を作成する
                $related_posts = array();
                // クエリのループを開始する
                while ($query->have_posts()) {
                    // 投稿データをセットする
                    $query->the_post();
                    // 投稿のURLを取得して配列に追加する
                    $related_posts[] = get_permalink();
                }
                // クエリのループをリセットする
                wp_reset_postdata();
                // 配列を改行で区切って文字列にする
                $related_posts = implode("\n", $related_posts);
                // カスタムフィールドの値として保存する
                update_post_meta($post_id, $custom_field_key, $related_posts);
            }
        }
    }
}

// save_postフックに関数を登録する
add_action('save_post', 'auto_related_posts_field');

1. ja.wordpress.org 2. shu-sait.com 3. miya-system-works.com 4. qiita.com

まとめ

プログラミング・コードに関する質問に対する答えは，短い質問であるものの回答はしっかりしてそうです．今後，実装して検証しますが，真に受けて安易に使用しないでくださいね．何時になるかわからんけど^^;

編集履歴

2023/11/26, MR.HARIKIRI
2023/11/28, 追記 (カスタムフィールドの使い方)

はじめに

WordPressには沢山のpluginがあります．e-mailを飛ばすにもWP Mail SMTPというpluginがあります．現在，このプラグインを使っていますが，自分でもphpを書けないかと思い立ちました．

blogを始めた当初は，珍しさもあって必要以上に複数のpluginを並行してつかっていました．有料のpluginも4つほど試しました．

月日が経つと飽きてきます．セキュリティ的にも複数のpluginは，それぞれでリスクがあるため，pluginのスンストール数が増えれば増えるほどリスクが高まります．例えば，1つのプラグインにリスクがあるため，安全性が99%だと仮定します．1つでも安全性がとこなわれると，それはもう安全ではないので直列のイメージで計算します．すなわち，4つのプラグインがあると99%の4乗が安全率になります．1つのプラグインの場合99%安全，2つのプラグインの場合99^2% = 98%，同様に3つで97%，4つで96%というように，プラグイン数が多くなると安全性が低下していくのが理解できます．

「Simple is best」がやかりよろしかろう，ということですね．すでに，pluginは極力減らすという方針を立てているので実践していきましょうか．今日は，情報収集まで．．．

構築手順の概要

1. メールサーバーのsmtp設定
   • MRHARIKIRのサイトは，Synology NASなのでそれを立ち上げるか，gmailでもいい
2. phpコードを書く
   • phpにはsmptに関するAPIがあるので，それを使う．
3. それを使ってメールを送信
   • phpコードにメッセージを送ってもらう．

1. smtp設定

コードは，functions.php内に配置する．

function my_phpmailer_example( $phpmailer ) {
    $phpmailer->isSMTP();     
    $phpmailer->Host = 'smtp.example.com';
    $phpmailer->SMTPAuth = true; // Ask it to use authenticate using the Username and Password properties
    $phpmailer->Port = 25;
    $phpmailer->Username = 'yourusername';
    $phpmailer->Password = 'yourpassword';

    // Additional settings…
    //$phpmailer->SMTPSecure = 'tls'; // Choose 'ssl' for SMTPS on port 465, or 'tls' for SMTP+STARTTLS on port 25 or 587
    //$phpmailer->From = "you@yourdomail.com";
    //$phpmailer->FromName = "Your Name";
}
add_action( 'phpmailer_init', 'my_phpmailer_example' );

Developer Resources / by Steven Lin

phpmailer_init | Hook | WordPress Developer Resources

WordPressからsmtpでメール送信する２つの設定方法を解説

WordPressからsmtpでメール送信する２つの設定方法を解説 | Fukuro Press (fukuro-press.com)

2. メール送信phpコード

メールとして送信したい文字列をwp_mail()を使ってコードを書く

wp_mail()関数の書式

wp_mail( $to, $subject, $message, $headers, $attachments );

メール送信コード

function wp_mail( $to, $subject, $message, $headers = '', $attachments = array() ) {
	// Compact the input, apply the filters, and extract them back out.

	/**
	 * Filters the wp_mail() arguments.
	 *
	 * @since 2.2.0
	 *
	 * @param array $args {
	 *     Array of the `wp_mail()` arguments.
	 *
	 *     @type string|string[] $to          Array or comma-separated list of email addresses to send message.
	 *     @type string          $subject     Email subject.
	 *     @type string          $message     Message contents.
	 *     @type string|string[] $headers     Additional headers.
	 *     @type string|string[] $attachments Paths to files to attach.
	 * }
	 */
	$atts = apply_filters( 'wp_mail', compact( 'to', 'subject', 'message', 'headers', 'attachments' ) );

	/**
	 * Filters whether to preempt sending an email.
	 *
	 * Returning a non-null value will short-circuit {@see wp_mail()}, returning
	 * that value instead. A boolean return value should be used to indicate whether
	 * the email was successfully sent.
	 *
	 * @since 5.7.0
	 *
	 * @param null|bool $return Short-circuit return value.
	 * @param array     $atts {
	 *     Array of the `wp_mail()` arguments.
	 *
	 *     @type string|string[] $to          Array or comma-separated list of email addresses to send message.
	 *     @type string          $subject     Email subject.
	 *     @type string          $message     Message contents.
	 *     @type string|string[] $headers     Additional headers.
	 *     @type string|string[] $attachments Paths to files to attach.
	 * }
	 */
	$pre_wp_mail = apply_filters( 'pre_wp_mail', null, $atts );

	if ( null !== $pre_wp_mail ) {
		return $pre_wp_mail;
	}

	if ( isset( $atts['to'] ) ) {
		$to = $atts['to'];
	}

	if ( ! is_array( $to ) ) {
		$to = explode( ',', $to );
	}

	if ( isset( $atts['subject'] ) ) {
		$subject = $atts['subject'];
	}

	if ( isset( $atts['message'] ) ) {
		$message = $atts['message'];
	}

	if ( isset( $atts['headers'] ) ) {
		$headers = $atts['headers'];
	}

	if ( isset( $atts['attachments'] ) ) {
		$attachments = $atts['attachments'];
	}

	if ( ! is_array( $attachments ) ) {
		$attachments = explode( "\n", str_replace( "\r\n", "\n", $attachments ) );
	}
	global $phpmailer;

	// (Re)create it, if it's gone missing.
	if ( ! ( $phpmailer instanceof PHPMailer\PHPMailer\PHPMailer ) ) {
		require_once ABSPATH . WPINC . '/PHPMailer/PHPMailer.php';
		require_once ABSPATH . WPINC . '/PHPMailer/SMTP.php';
		require_once ABSPATH . WPINC . '/PHPMailer/Exception.php';
		$phpmailer = new PHPMailer\PHPMailer\PHPMailer( true );

		$phpmailer::$validator = static function ( $email ) {
			return (bool) is_email( $email );
		};
	}

	// Headers.
	$cc       = array();
	$bcc      = array();
	$reply_to = array();

	if ( empty( $headers ) ) {
		$headers = array();
	} else {
		if ( ! is_array( $headers ) ) {
			/*
			 * Explode the headers out, so this function can take
			 * both string headers and an array of headers.
			 */
			$tempheaders = explode( "\n", str_replace( "\r\n", "\n", $headers ) );
		} else {
			$tempheaders = $headers;
		}
		$headers = array();

		// If it's actually got contents.
		if ( ! empty( $tempheaders ) ) {
			// Iterate through the raw headers.
			foreach ( (array) $tempheaders as $header ) {
				if ( ! str_contains( $header, ':' ) ) {
					if ( false !== stripos( $header, 'boundary=' ) ) {
						$parts    = preg_split( '/boundary=/i', trim( $header ) );
						$boundary = trim( str_replace( array( "'", '"' ), '', $parts[1] ) );
					}
					continue;
				}
				// Explode them out.
				list( $name, $content ) = explode( ':', trim( $header ), 2 );

				// Cleanup crew.
				$name    = trim( $name );
				$content = trim( $content );

				switch ( strtolower( $name ) ) {
					// Mainly for legacy -- process a "From:" header if it's there.
					case 'from':
						$bracket_pos = strpos( $content, '<' );
						if ( false !== $bracket_pos ) {
							// Text before the bracketed email is the "From" name.
							if ( $bracket_pos > 0 ) {
								$from_name = substr( $content, 0, $bracket_pos );
								$from_name = str_replace( '"', '', $from_name );
								$from_name = trim( $from_name );
							}

							$from_email = substr( $content, $bracket_pos + 1 );
							$from_email = str_replace( '>', '', $from_email );
							$from_email = trim( $from_email );

							// Avoid setting an empty $from_email.
						} elseif ( '' !== trim( $content ) ) {
							$from_email = trim( $content );
						}
						break;
					case 'content-type':
						if ( str_contains( $content, ';' ) ) {
							list( $type, $charset_content ) = explode( ';', $content );
							$content_type                   = trim( $type );
							if ( false !== stripos( $charset_content, 'charset=' ) ) {
								$charset = trim( str_replace( array( 'charset=', '"' ), '', $charset_content ) );
							} elseif ( false !== stripos( $charset_content, 'boundary=' ) ) {
								$boundary = trim( str_replace( array( 'BOUNDARY=', 'boundary=', '"' ), '', $charset_content ) );
								$charset  = '';
							}

							// Avoid setting an empty $content_type.
						} elseif ( '' !== trim( $content ) ) {
							$content_type = trim( $content );
						}
						break;
					case 'cc':
						$cc = array_merge( (array) $cc, explode( ',', $content ) );
						break;
					case 'bcc':
						$bcc = array_merge( (array) $bcc, explode( ',', $content ) );
						break;
					case 'reply-to':
						$reply_to = array_merge( (array) $reply_to, explode( ',', $content ) );
						break;
					default:
						// Add it to our grand headers array.
						$headers[ trim( $name ) ] = trim( $content );
						break;
				}
			}
		}
	}

	// Empty out the values that may be set.
	$phpmailer->clearAllRecipients();
	$phpmailer->clearAttachments();
	$phpmailer->clearCustomHeaders();
	$phpmailer->clearReplyTos();
	$phpmailer->Body    = '';
	$phpmailer->AltBody = '';

	// Set "From" name and email.

	// If we don't have a name from the input headers.
	if ( ! isset( $from_name ) ) {
		$from_name = 'WordPress';
	}

	/*
	 * If we don't have an email from the input headers, default to wordpress@$sitename
	 * Some hosts will block outgoing mail from this address if it doesn't exist,
	 * but there's no easy alternative. Defaulting to admin_email might appear to be
	 * another option, but some hosts may refuse to relay mail from an unknown domain.
	 * See https://core.trac.wordpress.org/ticket/5007.
	 */
	if ( ! isset( $from_email ) ) {
		// Get the site domain and get rid of www.
		$sitename   = wp_parse_url( network_home_url(), PHP_URL_HOST );
		$from_email = 'wordpress@';

		if ( null !== $sitename ) {
			if ( str_starts_with( $sitename, 'www.' ) ) {
				$sitename = substr( $sitename, 4 );
			}

			$from_email .= $sitename;
		}
	}

	/**
	 * Filters the email address to send from.
	 *
	 * @since 2.2.0
	 *
	 * @param string $from_email Email address to send from.
	 */
	$from_email = apply_filters( 'wp_mail_from', $from_email );

	/**
	 * Filters the name to associate with the "from" email address.
	 *
	 * @since 2.3.0
	 *
	 * @param string $from_name Name associated with the "from" email address.
	 */
	$from_name = apply_filters( 'wp_mail_from_name', $from_name );

	try {
		$phpmailer->setFrom( $from_email, $from_name, false );
	} catch ( PHPMailer\PHPMailer\Exception $e ) {
		$mail_error_data                             = compact( 'to', 'subject', 'message', 'headers', 'attachments' );
		$mail_error_data['phpmailer_exception_code'] = $e->getCode();

		/** This filter is documented in wp-includes/pluggable.php */
		do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_error_data ) );

		return false;
	}

	// Set mail's subject and body.
	$phpmailer->Subject = $subject;
	$phpmailer->Body    = $message;

	// Set destination addresses, using appropriate methods for handling addresses.
	$address_headers = compact( 'to', 'cc', 'bcc', 'reply_to' );

	foreach ( $address_headers as $address_header => $addresses ) {
		if ( empty( $addresses ) ) {
			continue;
		}

		foreach ( (array) $addresses as $address ) {
			try {
				// Break $recipient into name and address parts if in the format "Foo <bar@baz.com>".
				$recipient_name = '';

				if ( preg_match( '/(.*)<(.+)>/', $address, $matches ) ) {
					if ( count( $matches ) === 3 ) {
						$recipient_name = $matches[1];
						$address        = $matches[2];
					}
				}

				switch ( $address_header ) {
					case 'to':
						$phpmailer->addAddress( $address, $recipient_name );
						break;
					case 'cc':
						$phpmailer->addCc( $address, $recipient_name );
						break;
					case 'bcc':
						$phpmailer->addBcc( $address, $recipient_name );
						break;
					case 'reply_to':
						$phpmailer->addReplyTo( $address, $recipient_name );
						break;
				}
			} catch ( PHPMailer\PHPMailer\Exception $e ) {
				continue;
			}
		}
	}

	// Set to use PHP's mail().
	$phpmailer->isMail();

	// Set Content-Type and charset.

	// If we don't have a Content-Type from the input headers.
	if ( ! isset( $content_type ) ) {
		$content_type = 'text/plain';
	}

	/**
	 * Filters the wp_mail() content type.
	 *
	 * @since 2.3.0
	 *
	 * @param string $content_type Default wp_mail() content type.
	 */
	$content_type = apply_filters( 'wp_mail_content_type', $content_type );

	$phpmailer->ContentType = $content_type;

	// Set whether it's plaintext, depending on $content_type.
	if ( 'text/html' === $content_type ) {
		$phpmailer->isHTML( true );
	}

	// If we don't have a charset from the input headers.
	if ( ! isset( $charset ) ) {
		$charset = get_bloginfo( 'charset' );
	}

	/**
	 * Filters the default wp_mail() charset.
	 *
	 * @since 2.3.0
	 *
	 * @param string $charset Default email charset.
	 */
	$phpmailer->CharSet = apply_filters( 'wp_mail_charset', $charset );

	// Set custom headers.
	if ( ! empty( $headers ) ) {
		foreach ( (array) $headers as $name => $content ) {
			// Only add custom headers not added automatically by PHPMailer.
			if ( ! in_array( $name, array( 'MIME-Version', 'X-Mailer' ), true ) ) {
				try {
					$phpmailer->addCustomHeader( sprintf( '%1$s: %2$s', $name, $content ) );
				} catch ( PHPMailer\PHPMailer\Exception $e ) {
					continue;
				}
			}
		}

		if ( false !== stripos( $content_type, 'multipart' ) && ! empty( $boundary ) ) {
			$phpmailer->addCustomHeader( sprintf( 'Content-Type: %s; boundary="%s"', $content_type, $boundary ) );
		}
	}

	if ( ! empty( $attachments ) ) {
		foreach ( $attachments as $filename => $attachment ) {
			$filename = is_string( $filename ) ? $filename : '';

			try {
				$phpmailer->addAttachment( $attachment, $filename );
			} catch ( PHPMailer\PHPMailer\Exception $e ) {
				continue;
			}
		}
	}

	/**
	 * Fires after PHPMailer is initialized.
	 *
	 * @since 2.2.0
	 *
	 * @param PHPMailer $phpmailer The PHPMailer instance (passed by reference).
	 */
	do_action_ref_array( 'phpmailer_init', array( &$phpmailer ) );

	$mail_data = compact( 'to', 'subject', 'message', 'headers', 'attachments' );

	// Send!
	try {
		$send = $phpmailer->send();

		/**
		 * Fires after PHPMailer has successfully sent an email.
		 *
		 * The firing of this action does not necessarily mean that the recipient(s) received the
		 * email successfully. It only means that the `send` method above was able to
		 * process the request without any errors.
		 *
		 * @since 5.9.0
		 *
		 * @param array $mail_data {
		 *     An array containing the email recipient(s), subject, message, headers, and attachments.
		 *
		 *     @type string[] $to          Email addresses to send message.
		 *     @type string   $subject     Email subject.
		 *     @type string   $message     Message contents.
		 *     @type string[] $headers     Additional headers.
		 *     @type string[] $attachments Paths to files to attach.
		 * }
		 */
		do_action( 'wp_mail_succeeded', $mail_data );

		return $send;
	} catch ( PHPMailer\PHPMailer\Exception $e ) {
		$mail_data['phpmailer_exception_code'] = $e->getCode();

		/**
		 * Fires after a PHPMailer\PHPMailer\Exception is caught.
		 *
		 * @since 4.4.0
		 *
		 * @param WP_Error $error A WP_Error object with the PHPMailer\PHPMailer\Exception message, and an array
		 *                        containing the mail recipient, subject, message, headers, and attachments.
		 */
		do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_data ) );

		return false;
	}
}

Developer Resources

wp_mail() | Function | WordPress Developer Resources

編集履歴

2023/11/24 MRHARIKIR (情報収集のところまで)