add_row()


WordPressのadd_row()関数は、ACF（Advanced Custom Fields）プラグインを使用する際に、リピーターフィールドに新しい行を追加するために使用されます。

構文

add_row( string $field_key, array $row_data, int|string $post_id = false );

引数の説明:

  • $field_key (string) — リピーターフィールドのキー。
  • $row_data (array) — 新しい行に含まれるデータ。フィールドの名前と値をペアにした配列。
  • $post_id (int|string) — データを保存する投稿のID（デフォルトは現在の投稿）。

例1: リピーターフィールドに行を追加

リピーターフィールド「event_details」に新しい行を追加します。

<?php add_row('event_details', array('event_name' => 'セミナー', 'event_date' => '2024-12-30')); ?>

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

特定の投稿IDにリピーターフィールドの行を追加します。

<?php add_row('event_details', array('event_name' => 'ワークショップ', 'event_date' => '2024-12-31'), get_the_ID()); ?>

例3: 動的データを使用して行を追加

フォームからのデータを使ってリピーターフィールドに行を追加します。

<?php
add_row('event_details', array(
    'event_name' => $_POST['event_name'],
    'event_date' => $_POST['event_date']
));
?>

例4: 条件付きで行を追加

条件を満たす場合のみリピーターフィールドに行を追加します。

<?php
if (get_field('enable_event_creation')) {
    add_row('event_details', array('event_name' => 'カンファレンス', 'event_date' => '2025-01-15'));
}
?>

例5: ループ内で複数の行を追加

配列をループして複数の行をリピーターフィールドに追加します。

<?php
$events = array(
    array('event_name' => 'トレーニング', 'event_date' => '2025-02-01'),
    array('event_name' => '講義', 'event_date' => '2025-02-15')
);
foreach ($events as $event) {
    add_row('event_details', $event);
}
?>

注意点

  • この関数を使用するには、ACFプラグインが有効である必要があります。
  • リピーターフィールドのキーが正しいことを確認してください。
  • 追加するデータがフィールドの構造に一致していることを確認してください。

関連機能：