島根県安来市のフリーランスエンジニア_プログラマー画像1

WordPress公式プラグイン公開までの全手順|審査〜SVN設定・バナー反映・翻訳対応まで完全解説

WordPress公式プラグイン公開までのリアルな記録
「Eatransform SNS Auto Publisher for Twitter」が承認されるまで

気づけば意外と手間だった「審査メール」「SVN」「バナー画像」「日本語翻訳」…。 せっかくなので、同じように公式プラグイン公開を目指す人の参考になりそうなことを、ここにまとめておきます。

PLUGIN Eatransform SNS Auto Publisher for Twitter WordPress.org 公式ディレクトリ登録の記録

「[WordPress Plugin Directory] Eatransform SNS Auto Publisher for Twitter has been approved!」

この一文から、すべてが一気に動き出しました。 ここでは、プラグイン名の見直しから、SVN 初体験、バナー画像のハマりポイント、日本語翻訳(.potファイル)対応まで、実際にやったことを順番に振り返ります。

1. 審査メールが届くまでにやったこと

もともとこのプラグインは「Auto Post to Twitter」という名前で提出していましたが、 審査の過程で名前や説明文の調整が入り、最終的に 「Eatransform SNS Auto Publisher for Twitter」 という名前に落ち着きました。

プラグイン名・説明文・テキストドメインは、あとから変更が入る前提で、最初から少し余裕を持って決めておくと気持ちがラクです。
  • プラグイン名をガイドラインに沿う形に調整
  • ソースコード内のテキストドメインを eatransform-sns-publisher に統一
  • 旧バージョンからの設定移行ロジック(オプション名のマイグレーション)を用意
  • エラーや成功メッセージをすべて __() / esc_html__() で国際化対応

こうしてコード側の修正をひと通り終えたあと、 「Your review has been successfully completed.」というメールが届き、本番の勝負どころである SVN 作業に進むことになりました。

2. SVN 初体験と TortoiseSVN のセットアップ

正直、一番ハードルが高く感じたのが SVN まわりでした。 普段 Git を使っていると、Subversion というだけでちょっと身構えます。

今回やった SVN まわりの流れ
1
WordPress.org プロフィールから Two-Factor Authentication(2段階認証)を有効化
2
「SVN Password」を生成して、通常の WordPress.org ログインパスとは別のパスワードを用意
3
Windows に TortoiseSVN(64bit版)をインストール
4
任意のフォルダを右クリック → 「SVN チェックアウト」から https://plugins.svn.wordpress.org/eatransform-sns-publisher を指定
5
自動で trunk / tags / assets の3フォルダが作成されるのを確認

Git のように「とりあえず全部 push してから考える」というよりは、 「リリースしたい状態だけを SVN に置く」という感覚に近いです。

3. trunk / tags / assets の構成と最初のコミット

今回は最初の安定版として Version: 1.2.1 を公開したので、 ディレクトリ構成は次のように整理しました。

trunk/
├ eatransform-sns-auto-publisher.php
└ readme.txt
tags/
└ 1.2.1/
├ eatransform-sns-auto-publisher.php
└ readme.txt
assets/
├ icon-256×256.png
└ banner-772×250.png

ここで一度ハマったのが「タグフォルダ名のタイポ」です。 1.2.1 と書くべきところを 1.2,1(カンマ)にしてしまい、プラグインページに警告が表示されました。

「Stable tag: 1.2.1」と readme に書いたら、
/tags/1.2.1/ フォルダ名も必ずピリオドで揃える(数字や記号のミスは即エラーになる)。

フォルダ名を修正して再コミットすると、警告は無事に消え、正式な安定版として認識されました。

4. バナー画像とアイコンが反映されない問題

デザイン面では、まず icon-256×256.pngbanner-772×250.pngassets に配置してコミットしました。 しかし、すぐにはバナーが反映されず、少し悩むことになります。

  • SVN 上の assets フォルダを直接ブラウザで確認 → ファイル自体は正しくアップロードされている
  • ファイル名も banner-772x250.png で問題なし
  • 最終的に、画像の実サイズが 772×250 になっていなかったことが原因と判明

画像を正しいピクセル数にリサイズし直して再コミットしたところ、 しばらくしてから無事にバナーが反映されました。

WordPress.org のバナー画像は、ピクセル単位でサイズが厳密です。 772×250 から 1px でもズレていると、ファイル名が正しくても読み込まれません。

5. 「このプラグインはまだ日本語に翻訳されていません」への対応

プラグインページには最初、 「このプラグインはまだ日本語に翻訳されていません。翻訳を手伝いませんか。」 という表示が出ていました。

最初は「.po / .mo を全部作らないといけないのか?」と思いましたが、 実際には .pot のみ設置すればOK でした。

  • テキストドメインを eatransform-sns-publisher に統一
  • trunk/languages/eatransform-sns-publisher.pot を配置してコミット
  • 翻訳は GlotPress が自動生成し、ユーザーが翻訳に参加できる仕組み

6. やってみて感じたこと

最初は「SVN」「2段階認証」「翻訳ファイル」「バナー画像」など 一つひとつの要素が全部ハードルに見えていました。

ただ、実際にやり切ってみると、一度通ったルートは次からかなり楽です。 次に別のプラグインを公開するときは、今回の動線をなぞればよりスムーズにできそうです。

なにより、 自分の作ったプラグインが WordPress.org の公式ディレクトリに並ぶ というのは嬉しいものです。

Eatransform SNS Auto Publisher for Twitter について

WordPress で公開した記事を自動で Twitter/X に投稿するためのプラグインです。 API v2 対応、カード形式/従来形式の切り替え、デバッグログ表示にも対応しています。

公式ディレクトリのプラグインページを見る WordPress.org / Plugin Directory

個人サイトに某大手上場企業から「プレスリリース掲載依頼」が届いた話。地道な更新が報われた瞬間

WordPress自動投稿プラグイン | X(Twitter)へ自動シェア – 無料