acf_copy_metadata()


WordPressの関数acf_copy_metadata()は、Advanced Custom Fields(ACF)プラグインで使用され、指定された投稿またはページからメタデータをコピーするための関数です。

構文

acf_copy_metadata( int $from_id, int $to_id );

引数の説明

  • $from_id (int) — メタデータをコピー元として使用する投稿またはページのID。
  • $to_id (int) — メタデータをコピー先として使用する投稿またはページのID。

例1: 投稿間でメタデータをコピー

指定された投稿IDからメタデータをコピーして別の投稿IDに追加します。

<?php acf_copy_metadata( get_the_ID(), 123 ); ?>

例2: 特定のページ間でメタデータをコピー

現在のページIDから特定のページID(例: 456)にメタデータをコピーします。

<?php acf_copy_metadata( get_the_ID(), 456 ); ?>

例3: 投稿タイプに基づいてメタデータをコピー

特定の投稿タイプに対してメタデータをコピーします。

<?php
if ( 'custom_post_type' == get_post_type() ) {
    acf_copy_metadata( get_the_ID(), 789 );
}
?>

例4: ループ内でのメタデータコピー

ループ内で取得した投稿IDから別の投稿IDにメタデータをコピーします。

<?php
if ( have_posts() ) :
    while ( have_posts() ) : the_post();
        acf_copy_metadata( get_the_ID(), 101 );
    endwhile;
endif;
?>

例5: 異なる投稿間で複数のメタデータをコピー

複数の投稿ID間でメタデータをコピーします。

<?php
acf_copy_metadata( get_the_ID(), 102 );
acf_copy_metadata( get_the_ID(), 103 );
?>

注意事項

  • acf_copy_metadata()関数を使用する前に、コピー元とコピー先のIDが正しいことを確認してください。
  • コピー元の投稿やページにACFフィールドが正しく設定されている必要があります。