5. update_field() та delete_field() | Field Forge - Кастомні поля, створені для швидкості

Програмно створювати, оновлювати або видаляти значення полів з PHP коду.

`update_field( $selector, $value, $post_id )`

Параметри:

Параметр	Тип	За замовчуванням	Опис
`$selector`	`string`	—	Назва поля або ключ поля
`$value`	`mixed`	—	Нове значення (тип залежить від типу поля)
`$post_id`	`int\`	string\	false	`false`	ID поста, `'options'`, `'user_N'` або `false` для поточного поста

Повертає: int — ID запису значення. Формат значення за типом поля:

Тип поля	Очікуване значення
`text`, `textarea`, `email`, `url`, `password`	`string`
`number`, `range`	`string` або `int`/`float`
`image`, `file`	ID вкладення (`int`)
`select`, `radio`, `button_group`	Рядок значення або масив, якщо кілька
`checkbox`	Масив рядків значення
`true_false`	`true`/`false` або `1`/`0`
`relationship`, `post_object`	ID поста або масив ID постів
`taxonomy`	ID терміна або масив ID термінів
`user`	ID користувача або масив ID користувачів
`date_picker`	Формат рядка `'Ymd'` (наприклад, `'20241225'`)
`color_picker`	Шістнадцятковий рядок (наприклад, `'#FF5733'`)
`gallery`	Масив ID вкладень
`repeater`	Масив рядків масивів

// Update a text field
update_field( 'subtitle', 'New Subtitle', 42 );

// Update an image field (pass attachment ID)
update_field( 'hero_image', 155, 42 );

// Update a select field
update_field( 'product_status', 'in_stock', 42 );

// Update a checkbox field (array of values)
update_field( 'amenities', [ 'wifi', 'parking', 'pool' ], 42 );

// Update an options page value
update_field( 'site_phone', '+1-555-0123', 'options' );

// Update a user field
update_field( 'biography', 'Senior developer with 10 years experience.', 'user_5' );

// Bulk update in a loop
$products = get_posts( [ 'post_type' => 'product', 'numberposts' => -1 ] );
foreach ( $products as $product ) {
    $current_price = get_field( 'price', $product->ID );
    update_field( 'price', $current_price * 1.1, $product->ID ); // 10% increase
}

// Import data from CSV
$csv = array_map( 'str_getcsv', file( '/path/to/products.csv' ) );
$headers = array_shift( $csv );
foreach ( $csv as $row ) {
    $data = array_combine( $headers, $row );
    $post_id = wp_insert_post( [
        'post_title'  => $data['name'],
        'post_type'   => 'product',
        'post_status' => 'publish',
    ] );
    update_field( 'price', $data['price'], $post_id );
    update_field( 'sku', $data['sku'], $post_id );
}

`delete_field( $selector, $post_id )`

Видалити значення поля з бази даних.

Параметри:

Параметр	Тип	За замовчуванням	Опис
`$selector`	`string`	—	Назва поля
`$post_id`	`int\`	string\	false	`false`	ID поста, `'options'` або `'user_N'`

Повертає: bool — true при успіху.

// Delete a single field value
delete_field( 'old_field', 42 );

// Delete an option value
delete_field( 'deprecated_setting', 'options' );

// Delete a user field
delete_field( 'temp_code', 'user_5' );

// Clean up fields when a post transitions to trash
add_action( 'wp_trash_post', function( $post_id ) {
    delete_field( 'cached_summary', $post_id );
    delete_field( 'cached_thumbnail', $post_id );
});

// Remove all Field Forge values for a post
FIELDFORGE_Field_Values::instance()->delete_all( $post_id );

—