【実装記録】WordPressのアイキャッチを自動化したらXのクリック率が変わった—記事を公開するだけで、Xのカードに画像が自動で表示される仕組み

Xで投稿するたびに思っていた。

いいねはつく。でも記事がクリックされない。

原因を考えたとき、アイキャッチに行き着いた。全記事で似たような画像が並んでいる。タイムラインでスクロールを止める力が弱い。かといって記事ごとに手作業で作るのは続かない。

だから記事を公開するだけでSNSカード画像が自動生成される仕組みを作った。手作業ゼロ。タイトルが変わっても再生成される。

ただし私は——

• PHP：書いたことがない
• 画像生成の知識：ゼロ

こういう人間です。それでも完成させることができた。詰まった箇所も含めて全部書いています。

XとWordPressアイキャッチの関係——ここを知らないと損をする

Xでブログのリンクを投稿したとき、記事のタイトルと画像がカード形式で表示されることがある。これを「SNSカード画像」という（正式名称はOGP画像）。

このカードに表示される画像が、WordPressのアイキャッチ画像と連動している。

つまりアイキャッチを設定していない・全記事で同じ画像を使っている場合、Xのタイムラインでも毎回同じ画像が表示され続ける。スクロールを止める力がない。記事の内容がどれだけ良くても、画像で止まってもらえなければクリックされない。

なぜ自動化しようと思ったか——手作業では続かない

アイキャッチの重要性はわかっていた。でも実際には設定できていなかった。理由はシンプルだ。毎回作るのが面倒で続かなかった。

さらに自動化するとタイトル設計の重要性が上がる。画像の主役がタイトルになるので、数字・固有名詞・続きが気になる書き方がそのままXのクリック率に直結する。

仕組みの全体像——何がどう動くか

カテゴリごとに背景色を変えることで、Xのタイムラインで見たとき「どのカテゴリの記事か」が一目でわかる設計にした。タイトルが変わっても再生成される。記事を更新するたびに最新のタイトルで画像が作り直される。

つまずいた失敗——5つ正直に書く

失敗①：WordPressの管理画面からファイルを保存しようとしたらエラーが出た
テーマ編集画面で保存しようとしたら弾かれた。サーバーのセキュリティ設定が原因だ。テーマ編集画面を使うのをやめて、機能を別ファイルに分離してファイルマネージャーで直接アップロードする形に変えた。

失敗②：画像は生成されたのに、日本語の部分だけ□□□という謎の記号になっていた
フォントを指定しないと日本語が描画されない。英数字は表示されるのに日本語だけ□になる、という状態だった。日本語対応フォント（Noto Sans JP）をテーマに同梱して解決した。

失敗③：画像ファイルは生成されているのにXに反映されない
ファイルは生成されていた。でもXで確認すると古い画像が表示され続けていた。原因は「失敗④」だった。

失敗④（本丸）：SEOプラグインが独自の画像を出力していた
使っていたSEOプラグインが独自の画像タグを出力していた。自分が生成した画像より、プラグインの出力が優先されていた。「後から出力することで上書きできる」と思っていたが機能しなかった。SEOプラグインの公式の差し替え方法を使うのが正解だった。「上書き」ではなく「差し替え」。この違いがポイントだ。

失敗⑤：コードを修正してもXに変化がない
XはSNSカード画像をキャッシュ（一時保存）する。ファイルを更新しても古い画像が表示され続けていた。Xが提供するキャッシュ確認ツール（X Card Validator）でキャッシュを更新して解決した。

実装の詳細はnoteで公開予定

PHPの具体的なコード・フォント設定・カテゴリ色の設定方法・SEOプラグインとの競合解決の手順は、需要があれば記事化する予定だ。

→ 参考になった・試してみたいと思ったらnote記事をいいね、フォローしてください。反応を見て記事化します。

この記事のまとめ

ズルいくらい、うまくいく。