delete_metadata()


WordPressのdelete_metadata()関数は、投稿、コメント、ユーザー、またはタクソノミーに関連付けられたメタデータを削除するために使用されます。

シンタックス

delete_metadata( string $meta_type, int $object_id, string $meta_key, mixed $meta_value = '', bool $delete_all = false );

引数の説明:

  • $meta_type (string) — メタデータが関連付けられているオブジェクトの種類（例：'post', 'comment', 'user'）。
  • $object_id (int) — メタデータを削除するオブジェクトのID。
  • $meta_key (string) — 削除するメタデータのキー。
  • $meta_value (mixed) — 削除する特定の値。省略すると、キーに関連付けられたすべての値が削除されます。
  • $delete_all (bool) — trueの場合、指定されたキーを持つすべてのオブジェクトからメタデータを削除します。デフォルトはfalse。

例 1: 投稿のメタデータを削除する

投稿に関連付けられた特定のメタデータを削除します。

delete_metadata( 'post', get_the_ID(), 'custom_meta_key' );

例 2: コメントのメタデータを削除する

コメントに関連付けられた特定のメタデータを削除します。

delete_metadata( 'comment', get_comment_ID(), 'comment_meta_key' );

例 3: ユーザーメタデータを削除する

ユーザーに関連付けられた特定のメタデータを削除します。

delete_metadata( 'user', get_current_user_id(), 'user_meta_key' );

例 4: タクソノミーメタデータを削除する

タクソノミーに関連付けられた特定のメタデータを削除します。

delete_metadata( 'term', get_term( 'category', 'uncategorized' )->term_id, 'term_meta_key' );

例 5: メタデータを値で削除する

特定の値を持つ投稿メタデータを削除します。

delete_metadata( 'post', get_the_ID(), 'custom_meta_key', 'specific_value' );

注意点

  • 正しい$meta_typeと$object_idを指定することを確認してください。
  • $delete_allをtrueにすると、サイト全体のデータに影響を与える可能性があります。

関連機能：