_wp_post_thumbnail_context_filter_add()


WordPressの_wp_post_thumbnail_context_filter_add()関数は、投稿のサムネイルに関連するコンテキストをフィルタリングするために使用されます。この関数は、特定の条件に基づいてサムネイルの表示を制御する際に役立ちます。

構文

_wp_post_thumbnail_context_filter_add( string $context );
  • $context(string) — サムネイルのコンテキストを指定します。例えば、’post-thumbnail’や’custom-thumbnail’などの値を取ることができます。

例1: サムネイルのコンテキストを追加

この例では、投稿のサムネイルに新しいコンテキストを追加します。

_wp_post_thumbnail_context_filter_add('custom-thumbnail');

例2: サムネイルのコンテキストを変更

この例では、既存のサムネイルコンテキストを変更します。

_wp_post_thumbnail_context_filter_add('modified-thumbnail');

例3: 特定の投稿タイプにサムネイルコンテキストを適用

この例では、特定の投稿タイプにのみサムネイルコンテキストを適用します。

if(get_post_type() === 'book'){_wp_post_thumbnail_context_filter_add('book-thumbnail');}

例4: カスタムフィールドに基づいてコンテキストを追加

この例では、カスタムフィールドの値に基づいてサムネイルコンテキストを追加します。

if(get_post_meta(get_the_ID(),'custom_field',true) === 'special'){_wp_post_thumbnail_context_filter_add('special-thumbnail');}

例5: カテゴリーに基づいてコンテキストを変更

この例では、特定のカテゴリーに属する投稿のサムネイルコンテキストを変更します。

if(in_category('news')){_wp_post_thumbnail_context_filter_add('news-thumbnail');}

例6: タグに基づいてコンテキストを追加

この例では、特定のタグが付いた投稿のサムネイルコンテキストを追加します。

if(has_tag('featured')){_wp_post_thumbnail_context_filter_add('featured-thumbnail');}

例7: ユーザーロールに基づいてコンテキストを変更

この例では、特定のユーザーロールに基づいてサムネイルコンテキストを変更します。

if(current_user_can('editor')){_wp_post_thumbnail_context_filter_add('editor-thumbnail');}

注意点

  • この関数は、テーマやプラグインの開発者がサムネイルの表示をカスタマイズする際に使用されます。
  • コンテキストの値は、テーマやプラグイン内で一貫して使用される必要があります。
  • 誤ったコンテキストを指定すると、サムネイルが正しく表示されない場合があります。

関連機能：