XO Featured Image Tools プラグイン

投稿やカスタム投稿の記事内の画像より、アイキャッチ画像を自動生成するプラグインです。外部画像(添付ファイル以外の画像)にも対応しています。

機能

  • アイキャッチ画像を一括生成します。
  • 投稿の保存時にアイキャッチ画像を自動生成します。
  • 投稿のアイキャッチ画像を一括削除します。
  • 投稿一覧および固定ページ一覧にアイキャッチ画像項目およびアイキャッチ画像の未設定フィルターを追加します。

スクリーンショット

一括生成

投稿一覧

使い方

一括生成

管理画面より [ツール]-[アイキャッチ画像ツール] メニューを選択します。アイキャッチ画像ページが表示されます。

[投稿タイプ] を選択し、[すべてのアイキャッチ画像を生成] ボタンをクリックします。

実行中は進行状況が表示されます。実行中はページを移動しないでください。

インストール

  1. WordPress 管理画面->[プラグイン]->[新規追加] メニューより、[プラグインを追加] ページを開きます。
  2. 検索ボックスに、”XO Featured Image Tools” と入力し検索します。
  3. XO Featured Image Tools が見つかったら、[今すぐインストール] をクリックします。
  4. インストールが完了したら “プラグインを有効化” をクリックします。

WordPress 公式ディレクトリ

仕様

  • 投稿タイプごとに一括生成します。
  • 既にアイキャッチ画像が設定されている投稿は、アイキャッチ画像を生成(更新)しません。
  • disable_featured_image カスタムフィールドが設定されている投稿は、アイキャッチ画像を生成しません。
  • 対象の画像は、記事内の最初の画像です。外部画像を対象としていない場合は、最初の画像ではなく、最初の添付ファイル(メディアライブラリの画像)の画像となります。
  • 投稿の保存時(更新時)にアイキャッチ画像を自動生成します。
  • 投稿一覧にアイキャッチ画像項目およびアイキャッチ画像フィルターを追加します。
  • デフォルト画像(記事内に画像がない場合の画像)を設定することができます。
  • 小さいサイズの画像を除外することができます。最初の画像が除外対象の小さい画像の場合は、次の画像が対象となります。
  • 特定のファイル名の画像を除外することができます。
  • 外部画像(添付ファイル以外の画像)に対応しています。

説明

小さい画像を除外

小さいサイズの画像を除外します。幅または高さが指定したサイズ以下の画像を除外します。

特定のファイル名を除外

特定のファイル名の画像を除外します。複数のファイルを指定する場合は、カンマ区切りで指定します。ワイルドカード (“*”, “?”) が使用できます。

例: *.gif, *.ico

フック

注意事項

下記の外部画像には対応していません。

  • 相対 URL
  • 短縮 URL などのリダイレクトを伴う URL
  • ローカル ホストの画像

FAQ

ローカル ホストの外部画像が取得できない

ローカル ホストの外部画像は、安全対策のため取得しないようにしています。下記コードを、テーマの functions.php に追記することで、取得できるようになります。

add_filter( 'http_request_host_is_external', function( $external, $host, $url ) {
	if ( 'sample.com' === $host ) {
		$external = true;
	}
	return $external;
}, 10, 3 );

ショートコードの画像がアイキャッチ画像に設定されない

ギャラリー ショートコード以外のショートコードの画像には対応していません。下記コードを、テーマの functions.php に追記することで、ギャラリー ショートコードを含むすべてのショートコードの画像も対象となります。

add_filter( 'xo_featured_image_tools_post_content', function( $content ) {
	return do_shortcode( $content );
} );

※ バージョン1.13.0よりショートコードの画像に対応しました。

更新履歴

バージョン説明
0.1.0最初のリリース。
0.2.0投稿の保存時にアイキャッチ画像を自動生成する機能を追加しました。
0.3.0投稿一覧にアイキャッチ画像項目およびアイキャッチ画像フィルターを追加しました。
1.0.0公式ディレクトリに登録しました。
ローカライズに対応しました。
1.1.0外部画像に対応しました。
1.2.0言語パックを translate.wordpress.org (GlotPress) へ移行しました。
1.3.0デフォルト画像(記事に画像がない場合の画像)を設定するオプションを追加しました。
1.4.0一括処理を高速化するためにアイキャッチ画像が設定されていない投稿のみを処理するように変更しました。
1.5.0小さいサイズの画像を除外するオプションを追加しました。
1.6.0ギャラリー(ブロック、ショートコード)に対応しました。
1.7.0小さい画像のスキップ時に、アイキャッチ画像が正しく設定されない不具合を修正しました。
WebP の外部画像に対応しました。
1.8.0アイキャッチ画像を一括削除する機能を追加しました。
アイキャッチ画像を一括生成する投稿ステータスを変更しました。
セキュリティを強化するために、複数の翻訳テキストにエスケープ処理を追加しました。
1.9.0xo_featured_image_tools_image_url フィルターフックを追加しました。
URL クエリ パラメータ付きの画像に対応しました。
1.10.0下書き投稿を除外するオプションを追加しました。
コードをリファクタリングしました。
1.11.0xo_featured_image_tools_post_content フィルターフックを追加しました。
1.11.1投稿を削除する際に、警告メッセージが表示される不具合を修正しました。
1.12.0外部画像など一部の画像が取得できない場合がある不具合を修正しました。
アイキャッチ画像を取得する精度が向上しました。
プラグインアクションリンクを追加しました。
PHP 8.1 および WordPress 6.2 に対応しました。
コードをリファクタリングしました。
1.12.1管理画面の投稿一覧ページの検索が正常に動作しない不具合を修正しました。
1.13.0ショートコードの内容および同期パターンの内容を含めるかどうかのオプションを追加しました。
1.13.1WordPress coding standards 3.0.1に準拠するようにリファクタリングしました。
1.14.0特定のファイル名を除外する設定を追加しました。
1.15.0アイキャッチ画像の一括生成処理を高速化しました。
1.15.1エラーメッセージが表示される場合がある不具合を修正しました。
1.15.2URL 変更を伴うサイト移行環境において、誤ったアイキャッチ画像が選択される場合がある不具合を修正しました。