WP Manifestindependent plugin directory
manifest / email / wp-gmail-plugin

WP Gmail Mailer (SMTP Replacement)

WordPress用Gmail APIによるメール送信プラグイン

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/junjiq/wp-gmail-plugin/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

WordPressサイトでGmailのSMTP機能を使用してメール送信を行うプラグインです。Gmail APIは使用せず、SMTPプロトコルを使用してWordPressのwp_mail()関数を完全に置き換えます。

概要

このプラグインは、WordPressのデフォルトメール送信機能を、より信頼性の高いGmail SMTPサーバーを使用した送信に置き換えます。Gmail APIではなく、従来のSMTPプロトコルを使用するため、シンプルで安定した動作を提供します。

主な機能

メール送信機能

  • wp_mail()関数の完全置換(pre_wp_mailフィルターを使用)
  • Gmail SMTPサーバー(smtp.gmail.com)を使用した送信
  • TLS(ポート587)およびSSL(ポート465)暗号化に対応
  • HTML/テキストメール、添付ファイル、CC/BCC、Reply-Toヘッダーに対応

認証・セキュリティ

  • Googleアプリパスワードを使用した認証
  • 設定保存時の自動SMTP接続検証
  • From アドレスの固定設定(セキュリティ向上)

ログ・監視機能

  • 送信ログの自動記録(成功/失敗)
  • ログファイルの保持日数・最大サイズ設定
  • ログローテーション機能
  • 管理画面でのエラー通知表示
  • ログの閲覧・ダウンロード・クリア機能

管理機能

  • 直感的な設定画面
  • テストメール送信機能
  • 多言語対応(日本語・英語)
  • WordPress標準のアイコン・バナー画像同梱

プロジェクト構成

wp-gmail-plugin/
├── wp-gmail-plugin.php          # メインプラグインファイル
├── README.md                    # プロジェクト説明書
├── BUILD.md                     # ビルド手順書
├── uninstall.php               # アンインストール処理
├── package.json                # Node.js依存関係
├── includes/                   # PHPクラスファイル - 将来の拡張用
│   ├── class-gmail-api-client.php      # Gmail API クライアント
│   ├── class-gmail-oauth.php           # OAuth認証処理
│   ├── class-gmail-email-manager.php   # メール管理
│   └── functions.php                   # 共通関数
├── templates/                  # テンプレートファイル - 将来の拡張用
│   ├── admin-main.php          # 管理画面メイン
│   ├── admin-settings.php      # 設定画面
│   ├── admin-inbox.php         # 受信箱表示
│   ├── admin-compose.php       # メール作成
│   ├── shortcode-inbox.php     # フロントエンド受信箱
│   └── shortcode-compose.php   # フロントエンドメール作成
├── assets/                     # 静的リソース
│   ├── css/                    # スタイルシート
│   │   ├── style.css           # フロントエンド用CSS
│   │   └── admin-style.css     # 管理画面用CSS
│   ├── js/                     # JavaScript
│   │   ├── script.js           # フロントエンド用JS
│   │   └── admin-script.js     # 管理画面用JS
│   ├── icon.svg               # プラグインアイコン
│   ├── banner-772x250.svg     # バナー画像(小)
│   └── banner-1544x500.svg    # バナー画像(大)
├── languages/                  # 多言語ファイル
│   ├── wp-gmail-plugin.pot     # 翻訳テンプレート
│   ├── en_US.po               # 英語翻訳
│   └── ja_JP.po               # 日本語翻訳
├── build-plugin.ps1           # PowerShellビルドスクリプト
├── build-plugin.bat           # Windowsバッチファイル
├── build-tool.js              # Node.jsビルドツール
└── dist/                       # ビルド出力(自動生成)
    └── wp-gmail-plugin-v*.zip # 配布用ZIPファイル

インストール方法

1. 手動インストール

  1. プロジェクトをダウンロードまたはクローン
  2. wp-gmail-pluginフォルダをwp-content/plugins/に配置
  3. WordPress管理画面 > プラグイン から「WP Gmail Mailer」を有効化

2. ZIPファイルからのインストール

  1. ビルドツールを使用してZIPファイルを作成(BUILD.md参照)
  2. WordPress管理画面 > プラグイン > 新規追加 > プラグインのアップロード
  3. 作成したZIPファイルを選択してインストール・有効化

初期設定

Gmail側の設定

  1. 2段階認証の有効化

    • Googleアカウント > セキュリティ > 2段階認証プロセス を有効化
  2. アプリパスワードの生成

    • Googleアカウント > セキュリティ > アプリパスワード
    • 新しいアプリパスワードを生成(16桁のパスワードが発行される)

WordPress側の設定

  1. WordPress管理画面 > 設定 > WP Gmail Mailer を開く

  2. 以下の項目を設定:

    • Gmail アドレス: 送信に使用するGmailアドレス
    • アプリ パスワード: 上記で生成した16桁のパスワード
    • From アドレス: 送信者アドレス(省略時はGmailアドレス)
    • From 名称: 送信者名
    • 暗号化方式: TLS(推奨)またはSSL
    • ポート: 自動設定(TLS:587, SSL:465)
    • ログ設定: 必要に応じて調整
  3. 設定の保存と検証

    • 「変更を保存」をクリック
    • 自動的にSMTP接続検証が実行される
    • 失敗した場合はエラーメッセージが表示され、設定がリセットされる
  4. 動作確認

    • 設定画面下部の「テスト送信」でメール送信をテスト
    • ログビューアで送信結果を確認

ログ機能

ログファイル

  • 保存場所: wp-content/uploads/wpgp-logs/wpgp-mail.log
  • 記録内容: メール送信の成功/失敗、エラー詳細、送信先情報
  • 設定項目:
    • 保持日数(0-365日、デフォルト14日)
    • 最大ファイルサイズ(32KB-10MB、デフォルト1MB)
    • サイズ超過時の自動ローテーション(.1拡張子で保存)

ログ管理機能

  • 設定画面での最新200行の表示
  • ログファイルのダウンロード機能
  • ログファイルのクリア機能
  • 管理画面でのエラー通知表示

多言語対応

サポート言語

  • 日本語(ja_JP)
  • 英語(en_US)

翻訳ファイル

  • テキストドメイン: wp-gmail-mailer
  • 翻訳テンプレート: languages/wp-gmail-plugin.pot
  • 言語ファイル:
    • languages/ja_JP.po - 日本語翻訳
    • languages/en_US.po - 英語翻訳

翻訳ファイルの生成

必要に応じて.moファイルを生成してください:

# 日本語
msgfmt -o languages/ja_JP.mo languages/ja_JP.po

# 英語
msgfmt -o languages/en_US.mo languages/en_US.po

技術仕様

システム要件

  • WordPress: 5.8以上
  • PHP: 7.2以上
  • 必要な拡張: PHPMailer(WordPress標準同梱)

使用技術

  • メール送信: PHPMailer + Gmail SMTP
  • 認証方式: Googleアプリパスワード
  • 暗号化: TLS/SSL
  • フィルター: pre_wp_mailによるwp_mail()の置換

注意事項・制限事項

Gmail側の制限

  • 送信制限: Googleアカウントの1日の送信制限に従う
  • From アドレス: Gmailアカウントと整合性のあるアドレス推奨
  • 独自ドメイン: DMARC/SPF/DKIM設定の整合性が必要

プラグインの制限

  • 受信機能: なし(送信専用)
  • Gmail API: 使用しない(SMTPのみ)
  • 他のSMTPプラグインとの競合: wp_mail()を置換するため競合の可能性

セキュリティ考慮事項

  • アプリパスワードは暗号化して保存
  • 送信失敗時のメール通知は実装しない(無限ループ防止)
  • 設定変更時の自動接続検証でセキュリティを確保

よくある質問(FAQ)

Q: Gmail APIを使用しますか?

A: いいえ、従来のSMTPプロトコルのみを使用します。

Q: 受信機能はありますか?

A: ありません。このプラグインは送信専用です。

Q: HTMLメールは送信できますか?

A: はい。wp_mail_content_typeフィルターでtext/htmlを指定すれば送信可能です。

Q: 添付ファイル、CC、BCC、Reply-Toは使用できますか?

A: はい。WordPressのwp_mail()と同様の指定方法で使用できます。

Q: 他のSMTPプラグインと併用できますか?

A: 推奨しません。wp_mail()を置換するため競合する可能性があります。

Q: 送信が失敗した場合はどうなりますか?

A: ログに記録され、設定に応じて管理画面に通知が表示されます。

バージョン履歴

v1.2.0

  • クラスベースアーキテクチャへの変更
  • 設定保存時の自動SMTP接続検証機能
  • 多言語対応(i18n)の実装
  • WordPress標準アセット(アイコン・バナー)の追加
  • README.mdの統合・改善

v1.1.0

  • ログ機能の実装
  • エラーレポート機能
  • ログ保持日数・最大サイズ設定
  • ログローテーション機能
  • 管理画面でのログビューア
  • エラー通知機能

v1.0.0

  • 初期リリース
  • Gmail SMTP による wp_mail() 完全置換
  • 基本設定画面
  • テストメール送信機能

開発・ビルド

このプラグインの開発環境構築とビルド方法については、BUILD.mdを参照してください。

クイックスタート

# Node.jsビルドツールを使用
npm install
npm run build

# PowerShellビルドツール(Windows)
.\build-plugin.ps1 -Version "1.2.0"

# 出力: dist/wp-gmail-plugin-v1.2.0.zip

ライセンス

GPL-2.0-or-later

サポート・貢献

  • バグレポート: GitHubのIssuesページ
  • 機能要望: GitHubのIssuesページ
  • プルリクエスト: 歓迎します

作者

Your Name