Hàm cập nhật trường meta bài đăng dựa trên post ID đã cho. Hàm update_post_meta là hàm cơ bản và cần thiết khi phát triển thêm các tính năng cho WordPress.
update_post_meta( int $post_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|bool
Sử dụng tham số $prev_value để phân biệt giữa các trường meta có cùng khóa và ID bài đăng.
Nếu trường meta cho bài viết không tồn tại, nó sẽ được thêm vào và trả về ID của nó.
Có thể được sử dụng thay cho add_post_meta().
Các tham số
$post_id: int (bắt buộc). ID bài đăng.
$meta_key: string (bắt buộc). Metadata key.
$meta_value: mixed (bắt buộc). Giá trị metadata. Phải có khả năng tuần tự hóa nếu không phải là số vô hướng.
$prev_value: mixed (tùy chọn). Giá trị trước đó để kiểm tra trước khi cập nhật. Nếu được chỉ định, chỉ cập nhật các mục metadata hiện có bằng giá trị này. Nếu không, hàm sẽ cập nhật tất cả các mục. Mặc định: '' (chuỗi rỗng).
Giá trị trả về của hàm update_post_meta
Kiểu int|bool. Hàm sẽ trả về:
- Meta ID nếu key không tồn tại,
truekhi cập nhật thành công,falsekhi cập nhật thất bại hoặc nếu giá trị được truyền cho hàm giống với giá trị đã có sẵn trong cơ sở dữ liệu.
Lưu ý:
Các giá trị post meta vượt qua kiểm tra của hàm striplashes() khi được lưu trữ, vì vậy bạn sẽ cần phải cẩn thận khi chuyển các giá trị (chẳng hạn như JSON) có thể bao gồm ký tự thoát \.
Không lưu trữ các giá trị thoát. Xem xét giá trị JSON {"key":"value với \" dấu ngoặc kép thoát \" "}
Ví dụ
Ví dụ sau lỗi khi truyền giá trị thoát:
<?php
$escaped_json = '{"key":"value with \\"escaped quotes\\""}';
update_post_meta( $id, 'escaped_json', $escaped_json );
$broken = get_post_meta( $id, 'escaped_json', true );
/*
$broken, sau khi truyền qua stripslashes() sẽ không thể phân tích cú pháp được:
{"key":"value with "escaped quotes""}
*/
?>
Giải pháp thay thế:
Bằng cách thêm một cấp độ thoát \ nữa bằng hàm wp_slash (được giới thiệu trong WP 3.6), bạn có thể bù cho lệnh gọi stripslashes().
<?php
$escaped_json = '{"key":"value with \\"escaped quotes\\""}';
update_post_meta( $id, 'double_escaped_json', wp_slash( $escaped_json ) );
$fixed = get_post_meta( $id, 'double_escaped_json', true );
/*
$fixed, after stripslashes(), ends up being stored as desired:
{"key":"value with \"escaped quotes\""}
*/
?>
Cập nhật template được sử dụng bởi một trang:
update_post_meta( $page_id, '_wp_page_template', 'new_template.php' );
Giả sử một bài đăng có ID là 76 và 4 trường tùy chỉnh sau:
[key_1] => 'Happy'
[key_1] => 'Sad'
[key_2] => 'Gregory'
[my_key] => 'Steve'
Để thay đổi giá trị của key_2 thành Hans:
<?php update_post_meta( 76, 'key_2', 'Hans' ); ?>
Để thay đổi giá trị của key_1 từ Sad sang Happy:
<?php update_post_meta( 76, 'key_1', 'Happy', 'Sad' ); ?>
Các trường bây giờ sẽ trông như thế này:
[key_1] => 'Happy'
[key_1] => 'Happy'
[key_2] => 'Hans'
[my_key] => 'Steve'
Bạn cũng có thể update các key theo kiểu:
<?php
//Thay đổi tất cả các trường với key="key_1":
$key1_values = get_post_custom_values( 'key_1', 76 );
foreach ( $key1_values as $value )
update_post_meta( 76, 'key_1', 'Excited', $value );
?>
Tham khảo các bài viết chuyên đề: WordPress.






