Повертає значення зазначеного довільного поля записи (поста). Можна отримати масив всіх полів запису (поста).
Для того, щоб отримати значення всіх довільних полів певного поста, потрібно залишити порожнім параметр $ key. Також для цього можна скористатися функцією get_post_custom ().
Якщо в даних міститься серіалізовані масив (serialize), то він автоматично буде оброблений функцією unserialize (). тобто щоб отримати серіалізовані дані їх не потрібно окремо обробляти функцією unserialize ().
✈ 1 раз = 0.00013с = швидко | 50000 раз = 1.0с = дуже швидко
повертає
Поверне false. якщо неправильно передані $ meta_type або $ object_id.
При $ single = true
- якщо метапол є - поверне значення у вигляді рядка / масиву.
- якщо метапол немає - поверне порожній рядок ''.
- якщо метапол є - поверне масив значень метапол.
- якщо метапол немає - поверне порожній масив array ().
Якщо в значенні метапол зберігатися число воно буде повернуто у вигляді рядка, наприклад, "54".
Використання
$ Post_id (число) (обов'язковий) ID поста, довільні поля якого потрібно отримати.
За замовчуванням: немає $ key (рядок) Назва довільного поля, значення якого потрібно отримати. Якщо залишити поле порожнім, будуть отримані всі довільні поля поста.
За замовчуванням: '' $ single (логічний)
true - поверне значення метапол (якщо полів кілька то поверне значення першого метапол).
false - поверне масив всіх значень мета полів з вказаним ключем.
Якщо в значенні довільного поля знаходиться серіалізовані масив, то значення true поверне, нормальний масив, а якщо вказати false. то повернеться масив в елементі "[0]" якого буде все той же серіалізовані масив.
За замовчуванням: false
# 1. Отримаємо масив значень довільних полів
Отримаємо значення полів поста 76, ключ яких дорівнює key_1. мається на увазі що у посади не одне довільне поле з ключем key_1:
# 2. Отримаємо тільки одне довільне поле
Щоб отримати тільки перше (або єдине) значення довільного поля у вигляді рядка, використовуємо такий виклик функції:
# 3. Об'єднання всіх метапол в об'єкт
Цей приклад показує як можна зручно об'єднати всі довільні поля записи.
Потрібно це, коли в коді передбачається використовувати багато різних полів записи. Отримувати кожне з допомогою цієї функції не зручно, зручніше отримати один раз все поля, створити з них об'єкт і брати дані з об'єкта - це і працює швидше, і коду менше, і зрозуміліше.
Мається на увазі, що ключі довільних полів не в кирилиці і у поля з одним ключем передбачено тільки одне значення - все це звичайне явище:
# 4. Приклад використання get_post_meta всередині Циклу WordPress.
# 5. Перевіримо існування зазначеного метапол
Коли потрібно перевірити чи існує поле, з будь-яким значенням: порожній рядок або 0: