WordPressプラグインを作って分かった、コードを書く以外の準備

2026年10月11日 11:20

WordPressの保守チェック用プラグインを作っています。準備には、予想していたより時間がかかりました。

作業時間を厳密に記録していたわけではありません。ただ、振り返ってみると、時間を使ったのはコードを書くことだけではありません。何をもって「問題なし」とするかを決めたり、人に配布するための名前や説明を整えたりする作業がありました。

現在は、自分の環境と実サイトで動作確認を行い、v0.3.0をWordPress.orgへ申請したところです。まだ承認・一般公開には至っていません。

完成してからの振り返りではなく、申請まで進めた段階で分かった、実装以外の準備について書きます。

情報が取れないとき、「問題なし」にしてよいのか

仕様を整理する中で時間をかけたのは、誤判定を防ぐための考え方でした。

たとえば、確認に必要な情報を取得できなかった場合です。「問題が見つからなかった」と「問題があるか確認できなかった」は違います。でも、この二つを同じ結果にしてしまうと、使う人には問題がないように見えてしまいます。

保守の確認を助けるものなら、分からない状態を分からないまま伝える必要があります。結果がきれいにそろうことより、その結果をどこまで判断の材料にできるかを先に考えました。

現在のバージョンと更新先のバージョンも、分けて判断する必要がありました。今入っているものについて確認した結果を、そのまま更新先にも当てはめてよいわけではありません。どの情報を、どのバージョンについて確認しているのかを整理しないと、表示だけはもっともらしくても判断がずれてしまいます。

ACFのように、外部の仕組みで更新情報を扱う製品では、「今確認している対象が、本当にそのプラグインなのか」を見分ける部分にも時間をかけました。どの製品の情報なのかを正しく確かめるところから考える必要があり、情報を集めて表示すれば終わり、とはいきませんでした。

こうした部分は、画面が表示されたかどうかだけでは確認できません。「取れた情報で何を言えるか」と「取れなかった情報から何を言ってはいけないか」を決める作業が、実装の前にも途中にもありました。

もう一つ、準備が多かったのはWordPress.orgへ申請するための対応です。

製品名やslug、翻訳、外部サービスを使う際の同意と説明、配布用ZIP、テスト。自分の環境で動かしている間には、つい後回しにしそうな部分も、配布を考えると整える必要がありました。

slugは、プラグインを識別するための名前です。名前を付けるだけの小さな作業に見えますが、公開先でどう扱われるかも関係します。コードの中だけで完結する話ではありません。

外部サービスの説明も同じです。作る側は、何のために使っているかを知っています。一方、インストールする人には、外部との通信があるのか、何を確認すればよいのかが分かるように伝える必要があります。

ここは説明文の体裁を整えるだけでなく、実際の動作と説明が合っているかを見直す工程でもありました。WordPress.orgの公式ガイドラインでも、外部サーバーとの通信や利用者の同意、外部サービス・データを利用する場合の説明について条件が示されています。

初めて作る人に先に伝えるなら、少なくとも次の三つは、コードと一緒に考えておきたいです。

すべてを最初から完璧に決めるというより、実装だけで完成扱いにしないための確認です。

申請後は、初回の指摘を修正して再提出しました。その後、ブランド・ドメインの所有確認を求められ、回答しています。

2026年10月11日時点では、返信は受領されていて、審査チームの対応待ちです。所有確認の承認や、その後のコード審査が再開したことまでは確認できていません。

自分の環境で動作確認ができたこと、申請できたこと、公開が承認されることは、それぞれ別の段階でした。

今の段階で「WordPressプラグインを公開しました」とは書けません。ただ、申請まで進めたことで、名前や説明、配布ファイルを整えるところまでが、開発の作業として具体的になりました。

有料版は、まだ導入していません。検討する中で、無料版にどのコードを含めるか、どう配布するか、更新をどう届けるかも考える対象になりました。

WordPress.orgのガイドラインでは、掲載するプラグインに含まれる機能を、支払いやアップグレードで解除する方式は認められていません。一方、有料の外部サービスや、WordPress.orgの外で配布する追加プラグインは別の扱いです。「有料機能はすべて禁止」と単純にはまとめられません。

販売方法を決めれば済む話ではなく、無料版と有料版の構成にも関わる。ここは実際に販売した経験ではなく、今、調べて考えていることです。

まずは申請中のプラグインを、一般公開まで進めたいと思っています。

今回、予想以上に時間がかかった準備は、コードを書き始める前だけの作業ではありませんでした。何を判定してよいかを決め、利用者への説明を整え、配布できる形にし、審査に対応する。コードを書く以外のこうした作業も、開発の一部でした。

まだ一般公開前なので、公開後に初めて分かることもあると思います。それはまた、実際に経験してから整理したいと思います。