acf_reset_meta()


関数acf_reset_meta()は、Advanced Custom Fields(ACF)プラグインで使用される関数で、現在の投稿やページに関連付けられたメタデータをリセットするために使用されます。この関数は、カスタムフィールドの値をクリアする際に役立ちます。

構文

acf_reset_meta( $post_id );
  • $post_id(int|string) — メタデータをリセットする投稿やページのID。デフォルトは現在の投稿ID。

例1: 現在の投稿のメタデータをリセット

現在表示されている投稿のメタデータをリセットします。

<?php acf_reset_meta( get_the_ID() ); ?>

例2: 特定の投稿IDのメタデータをリセット

指定された投稿IDのメタデータをリセットします。

<?php acf_reset_meta( 123 ); ?>

例3: カスタムフィールドの値をクリア

特定の投稿のカスタムフィールドの値をクリアします。

<?php acf_reset_meta( 456 ); ?>

例4: ループ内でメタデータをリセット

ループ内で各投稿のメタデータをリセットします。

<?php while ( have_posts() ) : the_post(); acf_reset_meta( get_the_ID() ); endwhile; ?>

例5: カスタムクエリでメタデータをリセット

カスタムクエリを使用して取得した投稿のメタデータをリセットします。

<?php $query = new WP_Query( array( 'post_type' => 'page' ) ); while ( $query->have_posts() ) : $query->the_post(); acf_reset_meta( get_the_ID() ); endwhile; wp_reset_postdata(); ?>

注意点:

  • メタデータをリセットすると、関連するカスタムフィールドの値が削除されます。