_wp_preview_meta_filter()


WordPressの_wp_preview_meta_filter()関数は、プレビュー中の投稿のメタデータをフィルタリングするために使用されます。この関数は、プレビューモードで投稿のメタデータを一時的に変更する際に役立ちます。

構文

_wp_preview_meta_filter( array $meta, int $post_id );

引数の説明:

  • $meta(array) — フィルタリングするメタデータの配列。
  • $post_id(int) — プレビュー中の投稿のID。

例1: プレビューモードでメタデータをフィルタリング

プレビューモードで特定のメタデータを変更する例です。

add_filter('get_post_metadata', '_wp_preview_meta_filter', 10, 2);

例2: プレビュー中の投稿のメタデータを追加

プレビューモードで新しいメタデータを追加する例です。

$meta = array('new_key' => 'new_value'); _wp_preview_meta_filter($meta, get_the_ID());

例3: プレビュー中の投稿のメタデータを削除

プレビューモードで特定のメタデータを削除する例です。

$meta = array(); _wp_preview_meta_filter($meta, get_the_ID());

例4: プレビュー中の投稿のメタデータを更新

プレビューモードで既存のメタデータを更新する例です。

$meta = array('existing_key' => 'updated_value'); _wp_preview_meta_filter($meta, get_the_ID());

例5: プレビュー中の投稿のメタデータを条件付きで変更

特定の条件に基づいてプレビューモードでメタデータを変更する例です。

if (is_preview()) { $meta = array('conditional_key' => 'conditional_value'); _wp_preview_meta_filter($meta, get_the_ID()); }

例6: プレビュー中の投稿のメタデータを複数変更

プレビューモードで複数のメタデータを一度に変更する例です。

$meta = array('key1' => 'value1', 'key2' => 'value2'); _wp_preview_meta_filter($meta, get_the_ID());

例7: プレビュー中の投稿のメタデータをリセット

プレビューモードでメタデータをリセットする例です。

$meta = array(); _wp_preview_meta_filter($meta, get_the_ID());

注意点

  • この関数はプレビューモードでのみ動作します。本番環境では影響を与えません。
  • メタデータの変更は一時的なものであり、プレビューを終了すると元に戻ります。
  • プレビューモードでのみ使用することを推奨します。

関連機能：