add_sub_row()

WordPress関数add_sub_row()は、特定のリピーターフィールドに新しいサブ行を追加するために使用されます。

構文

add_sub_row( array|string $selector, array $values, int $post_id = null );

引数の説明:

• $selector (array|string) — サブフィールドの選択子（名前または配列）。
• $values (array) — サブフィールドに追加する値の配列。
• $post_id (int|null) — デフォルトでは現在の投稿のIDを使用します。他の投稿を指定する場合に使用。

例 1: 基本的なサブ行の追加

次のコードは、リピーターフィールドに新しいサブ行を追加します。

<?php add_sub_row('my_repeater_field', array('sub_field_1' => '値1', 'sub_field_2' => '値2')); ?>

例 2: 投稿IDを指定してサブ行を追加

特定の投稿にサブ行を追加します。

<?php add_sub_row('my_repeater_field', array('sub_field_1' => '値A', 'sub_field_2' => '値B'), get_the_ID()); ?>

例 3: ネストされたリピーターへの追加

ネストされたリピーターフィールドにサブ行を追加します。

<?php add_sub_row(array('parent_repeater', 0, 'child_repeater'), array('child_field' => 'ネストされた値')); ?>

例 4: 動的な値を使用してサブ行を追加

動的に取得した値を使用してサブ行を追加します。

<?php 
$dynamic_value = get_field('dynamic_field');
add_sub_row('my_repeater_field', array('sub_field_1' => $dynamic_value, 'sub_field_2' => '固定値')); 
?>

例 5: カスタム投稿タイプでの利用

カスタム投稿タイプの特定の投稿にサブ行を追加します。

<?php 
$custom_post_id = 123; 
add_sub_row('my_repeater_field', array('sub_field_1' => 'カスタム値1', 'sub_field_2' => 'カスタム値2'), $custom_post_id); 
?>

注意事項

• リピーターフィールドが正しく設定されていない場合、エラーが発生する可能性があります。
• $selectorが不適切な場合、値が正しく追加されません。