acf_remove_loop()


WordPressのacf_remove_loop()関数は、ACF（Advanced Custom Fields）のループを解除するために使用されます。この関数は、カスタムフィールドのループ処理中にループを終了させたい場合に役立ちます。

構文

acf_remove_loop();

例1: 基本的なループの解除

ACFのループ処理中にループを解除する基本的な例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); acf_remove_loop(); endwhile; endif; ?>

例2: 条件付きでループを解除

特定の条件が満たされた場合にループを解除する例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); } endwhile; endif; ?>

例3: ネストされたループでの使用

ネストされたACFループ内でループを解除する例です。

<?php if(have_rows('parent_field')): while(have_rows('parent_field')): the_row(); if(have_rows('child_field')): while(have_rows('child_field')): the_row(); if(get_sub_field('child_field_name') == 'value') { acf_remove_loop(); } endwhile; endif; endwhile; endif; ?>

例4: ループ解除後の処理

ループを解除した後に追加の処理を行う例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); echo 'ループが解除されました。'; } endwhile; endif; ?>

例5: 複数のループ解除

複数のループを解除する例です。

<?php if(have_rows('repeater_field_1')): while(have_rows('repeater_field_1')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); } endwhile; endif; if(have_rows('repeater_field_2')): while(have_rows('repeater_field_2')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); } endwhile; endif; ?>

例6: ループ解除後のリダイレクト

ループを解除した後にリダイレクトを行う例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); wp_redirect(home_url()); exit; } endwhile; endif; ?>

例7: ループ解除とログ記録

ループを解除した際にログを記録する例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); error_log('ループが解除されました。'); } endwhile; endif; ?>

例8: ループ解除とメール送信

ループを解除した際にメールを送信する例です。

<?php if(have_rows('repeater_field')): while(have_rows('repeater_field')): the_row(); if(get_sub_field('field_name') == 'value') { acf_remove_loop(); wp_mail('example@example.com', 'ループ解除', 'ループが解除されました。'); } endwhile; endif; ?>

注意点

  • acf_remove_loop()は、ACFのループ処理中にのみ使用できます。
  • ループを解除した後は、そのループ内の処理は続行されません。
  • ネストされたループ内で使用する場合、現在のループのみが解除されます。

関連機能：