get_post_custom_values()
Отримує масив значень довільних полів із зазначеною назвою у зазначеного запису (поста).
Ця функція може стати в нагоді, якщо потрібно отримати значення довільного поля, коли пост має кілька полів з однаковими назвами ключів і різними значеннями. Інакше зручніше використовувати функцію get_post_meta() .
Працює на основі:
get_post_custom()
get_post_custom()
Хуків немає.
Повертає
Массив|null. Масив значень мета-полів.
Використання
get_post_custom_values($key, $post_id);
-
$key
(рядок) (обов’язковий) - Назву довільного поля (ключ довільного поля), значення якого потрібно отримати.
-
$post_id
(число) -
ID посту, довільні поля якого потрібно отримати.
За замовчуванням: Поточний пост (визначається за змінною $post)
Приклади
#1 Виведемо значення довільних полів на екран
Припустимо, що поточний пост має 3 довільні поля з однаковим ключем my_key, давайте виведемо їх на екран використовуючи get_post_custom_values:
$mykey_values = get_post_custom_values('my_key');
foreach( $mykey_values as $key => $value ) {
echo "$key => $value ('my_key')<br />";
}В результаті на екрані ми побачимо:
0 => перше значення ключа ‘my_key’
1 => друге значення ключа ‘my_key’
2 => третє значення ключа ‘my_key’
список змін
| З версії 1.2.0 | Введено. |
Код get_post_custom_values() get post custom values WP 6.0.2
function get_post_custom_values( $key = '', $post_id = 0 ) {
if ( ! $key ) {
return null;
}
$custom = get_post_custom($post_id);
return isset($custom[$key])? $custom[$key]: null;
}