Функция get_term_meta(): Полное руководство с примером использования

Функция get_term_meta() используется в WordPress для получения метаданных, связанных с конкретным термином таксономии (категории, метки и другие пользовательские таксономии). Эта функция особенно полезна, когда вам нужно извлечь дополнительные данные, хранящиеся в метаданных термина.

mixed get_term_meta( int $term_id, string $key = '', bool $single = false )

• $term_id (int) (обязательный): ID термина, метаданные которого нужно получить.
• $key (string) (необязательный): Ключ метаданных. Если указан, функция вернет значение метаданных для этого ключа. Если не указан, вернется массив всех метаданных для данного термина.
• $single (bool) (необязательный): Если true, функция вернет только одно значение метаданных (первое найденное). Если false, вернется массив всех значений для данного ключа. По умолчанию false.

Возвращаемое значение

Функция возвращает значение (или значения) метаданных для указанного термина. Если ключ не указан, возвращается массив всех метаданных термина.

Пример использования

Рассмотрим, как использовать get_term_meta() на практике. Допустим, у нас есть термин с ID 123, и мы хотим получить метаданные с ключом custom_meta_key.

Получение одного значения метаданных

$term_id = 123;
$meta_key = 'custom_meta_key';

// Получаем значение метаданных
$meta_value = get_term_meta($term_id, $meta_key, true);

if (!empty($meta_value)) {
    echo 'Значение метаданных: ' . $meta_value;
} else {
    echo 'Метаданные для указанного ключа не найдены.';
}

Получение всех значений для указанного ключа

$term_id = 123;
$meta_key = 'custom_meta_key';

// Получаем все значения метаданных для указанного ключа
$meta_values = get_term_meta($term_id, $meta_key, false);

if (!empty($meta_values)) {
    echo 'Значения метаданных: <br>';
    foreach ($meta_values as $value) {
        echo '- ' . $value . '<br>';
    }
} else {
    echo 'Метаданные для указанного ключа не найдены.';
}

Получение всех метаданных для термина

$term_id = 123;

// Получаем все метаданные для термина
$all_meta = get_term_meta($term_id);

if (!empty($all_meta)) {
    echo 'Все метаданные для термина: <br>';
    foreach ($all_meta as $key => $values) {
        echo '<strong>' . $key . ':</strong><br>';
        foreach ($values as $value) {
            echo '- ' . $value . '<br>';
        }
    }
} else {
    echo 'Метаданные для термина не найдены.';
}

Заключение

Функция get_term_meta() является мощным инструментом для работы с метаданными терминов в WordPress. С ее помощью можно легко получать дополнительные данные, связанные с терминами таксономий. Использование метаданных позволяет значительно расширить функциональность вашего сайта, делая его более гибким и адаптируемым к различным потребностям.