acf_delete_value()

WordPressのacf_delete_value()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、指定されたフィールドの値を削除します。この関数は、カスタムフィールドの値をデータベースから完全に削除するために使用されます。

構文

acf_delete_value( int|string $post_id, array|string $field_name );

引数の説明:

• $post_id (int|string) — 投稿IDまたはオプションページの名前。
• $field_name (array|string) — 削除するフィールドの名前またはキー。

例1: 特定の投稿のフィールド値を削除

この例では、投稿IDが123の投稿から「custom_field」という名前のフィールドの値を削除します。

acf_delete_value(123, 'custom_field');

例2: 現在の投稿のフィールド値を削除

この例では、現在表示されている投稿から「custom_field」という名前のフィールドの値を削除します。

acf_delete_value(get_the_ID(), 'custom_field');

例3: オプションページのフィールド値を削除

この例では、オプションページから「site_logo」という名前のフィールドの値を削除します。

acf_delete_value('option', 'site_logo');

例4: サブフィールドの値を削除

この例では、リピーターフィールド内のサブフィールドの値を削除します。

acf_delete_value(get_the_ID(), 'repeater_field_0_sub_field');

例5: 複数のフィールドを一度に削除

この例では、複数のフィールドを一度に削除します。

acf_delete_value(get_the_ID(), array('field_1', 'field_2', 'field_3'));

例6: カスタムタクソノミーのフィールド値を削除

この例では、カスタムタクソノミーのフィールド値を削除します。

acf_delete_value('category_2', 'category_field');

例7: ユーザーフィールドの値を削除

この例では、ユーザーのカスタムフィールドの値を削除します。

acf_delete_value('user_1', 'user_field');

例8: フィールドキーを使用して値を削除

この例では、フィールドキーを使用してフィールドの値を削除します。

acf_delete_value(get_the_ID(), 'field_1234567890abc');

注意点

• この関数を使用すると、フィールドの値が完全に削除されます。削除した値は復元できないため、注意して使用してください。
• フィールド名やキーが正しく指定されていない場合、意図しないデータが削除される可能性があります。