WordPressのアイキャッチ画像を一括で設定・変更するプラグイン

WordPress でアイキャッチ画像の「設定・変更」を一括で行うプラグインを作りました。

一部投稿のアイキャッチ画像を変更する必要が出てきたのでコツコツ頑張ってみましたが、これが結構大変で早々に心が折れました。一記事毎に画面遷移させながら設定するの面倒臭すぎ！

変更する対象をある程度絞り込んで、ボタンひとつで更新できたら楽なのに…

とこの時思ったので、これを要件にしてプラグインを作ってみました。

思いつきの割には良く出来たと思うので、プラグイン本体も含め下記事項を書き残しておきます。

スポンサーリンク

プラグインのインストールと使い方

このプラグインでは下記の事が出来ます。

プラグインは下記 URL で公開しています。

インストールは通常の WordPress プラグインと同じで、ダウンロードした zip ファイルを管理画面からインストールするか、zip を展開して出てきたフォルダを FTP 等で サーバ上の plugins ディレクトリにアップロードすると OK です。

プラグインを有効化すると、管理画面に「画像一括変更」というメニューが追加され下記のようなプラグイン管理画面が表示できます。

使い方は、

1. カテゴリ・タグから対象範囲を絞り込む
2. 画像を上書きするかどうか決める
3. 設定するアイキャッチ画像を選ぶ
4. 更新ボタンを押す

という感じです。

プラグインの実行例

例として下記パターンの実行例を掲載します。

• アイキャッチ画像が設定されていない記事を更新
• アイキャッチ画像が設定されている記事を上書き更新
• その他、プラグインのメッセージ等

アイキャッチ画像が設定されていない記事を更新

アイキャッチ画像が設定されていない記事に画像を設定する例です。

対象はカテゴリ名を「nothumbnail」として登録した記事です。

管理画面のセレクトボックスよりカテゴリ名「nothumbnail」を選び、設定する画像をメディアアップローダーより選択します。

選択された画像は上記のようにプレビュー表示されますが、thumbnail サイズの画像が WordPress に登録されている必要があります。

問題なければこのまま「一括更新」を押します。

処理に成功すると「処理結果」の所にメッセージが表示されます。もし、更新対象が存在しない場合には下記のようなメッセージを表示します。

処理成功後、下記のように対象記事のアイキャッチ画像が更新されます。

アイキャッチ画像が設定されている記事を上書き更新

次は、アイキャッチ画像が既に設定されている記事を上書き更新する例です。

先ほどアイキャッチ画像を設定した記事の一つに、タグ名「nothumbnail」を追加してみます。

タグのセレクトボックスは、カテゴリのセレクトボックスに連動して表示されるため「投稿が存在するタグ名」しか表示されません。

タグのセレクトボックスで「nothumbnail」を選択し、「上書きする」にチェックを入れます。後は、利用するアイキャッチ画像を適当なものに変えて更新してみます。

こんな感じで、カテゴリ名「nothumbnail」かつ、タグ名「nothumbnail」の記事のみが更新できます。

その他、プラグインのメッセージ等

プラグインで「全てのカテゴリ・タグ」を選択した場合は、下記のような確認ダイアログを表示するようにしています。

こっちはさらに「上書きする」を選択した場合。

このプラグインには「元のアイキャッチ画像に復元」という機能はないので、全記事を更新する場合には注意が必要です。(DB のバックアップがあれば戻せますけど)

また、画像を選択しない場合には下記のようなメッセージが表示されます。

プラグインの内部について

プラグインで「更新ボタン」を押した時の一連動作としてはこんな感じになっています。

1. プラグインのフォームに入力された値を読み取り
2. 読み取った値を Ajax で WordPress に送信
3. 受け取ったカテゴリ・タグ名より対象範囲を抽出
4. 抽出したデータから投稿 ID を抽出
5. 抽出した投稿 ID とフォームから読み取った画像 ID でテーブルを更新

実の所、8 割以上がこれまでに書いたコードのコピペで構成されているので特に目新しいところもなかったりします。

このプラグインは管理画面上のデータを WordPress の DB に保存するような事はしていませんが、プラグインをインストールした時に下記データを wp_options テーブルに保存します。

mysql> SELECT * FROM wp_options WHERE option_name = "wptc_nonce_key";
+-----------+----------------+----------------------------------+----------+
| option_id | option_name    | option_value                     | autoload |
+-----------+----------------+----------------------------------+----------+
|      6810 | wptc_nonce_key | 1259bcfa8f0ffd9de03c986cad7b0770 | yes      |
+-----------+----------------+----------------------------------+----------+

データの参照は WordPress に問い合わせする形になるのでそのためのセキュリティの一貫です。

この値は乱数を使い自動設定するので変更は不要です。プラグインの動作にはこれがないとエラーになるので、間違って消した場合には「停止」->「有効」をすることで再作成できます。

また、このデータはプラグインを「停止・削除」する事で自動で消えるようになっています。

最後に、アイキャッチ画像の設定 (画像 ID) を更新するテーブルは下記です。

mysql> SHOW COLUMNS FROM wp_postmeta;
+------------+---------------------+------+-----+---------+----------------+
| Field      | Type                | Null | Key | Default | Extra          |
+------------+---------------------+------+-----+---------+----------------+
| meta_id    | bigint(20) unsigned | NO   | PRI | NULL    | auto_increment |
| post_id    | bigint(20) unsigned | NO   | MUL | 0       |                |
| meta_key   | varchar(255)        | YES  | MUL | NULL    |                |
| meta_value | longtext            | YES  |     | NULL    |                |
+------------+---------------------+------+-----+---------+----------------+

このテーブルにこんなデータが入っています。

mysql> SELECT * FROM wp_postmeta WHERE meta_key = '_thumbnail_id' AND post_id = 33;
+---------+---------+---------------+------------+
| meta_id | post_id | meta_key      | meta_value |
+---------+---------+---------------+------------+
|      77 |      33 | _thumbnail_id | 32         |
+---------+---------+---------------+------------+

で、ここに対して WordPress 関数 update_post_meta で更新をかけてあげています。

Usage: update_post_meta( $post_id, ‘_thumbnail_id’, $thumbnail_id );

実際には、こんな SQL が実行されます。

INSERT INTO wp_postmeta (post_id,meta_key,meta_value) VALUES (33,’_thumbnail_id’,’3786′);

大体ですが、以上がプラグインの内部的な説明です。

これまで、アイキャッチ画像のサイズ合わずに断念したカスタマイズとかもあったりしたので、これで解消できるんじゃないかと密かに期待してます。

長くなりましたが「WordPressのアイキャッチ画像を一括で設定・変更するプラグイン」についてはこれでおしまいです。

更新履歴

日付	バージョン	概要
2014/01/17	1.0.0	プラグイン公開
2018/11/23	1.0.1	不具合を数件修正