Описание функции add_post_meta()
Функция add_post_meta() позволяет добавлять метаданные к записям в WordPress. Она используется для хранения дополнительной информации о записях, такой как дополнительные поля форм, настройки и другие пользовательские данные.
Функция может добавлять новые метаданные, а также предотвращать дублирование существующих значений.
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, к которой добавляются метаданные
Возможные значения:
$meta_key
Тип: string
Обязательный: Да
Описание: Ключ метаданных, по которому будет храниться значение
Возможные значения:
$meta_value
Тип: mixed
Обязательный: Да
Описание: Значение метаданных, которое будет храниться
Возможные значения:
$unique
Тип: bool
Обязательный: Нет
Описание: Флаг, указывающий, можно ли добавлять несколько значений с одним и тем же ключом
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном добавлении метаданных или false при ошибке
Возможные значения:
• true — метаданные успешно добавлены
• false — ошибка при добавлении метаданных
Примеры использования
Базовый пример добавления метаданных к записи с ID 42
$result = add_post_meta(42, 'custom_field', 'значение поля');
// $result будет true
Метаданные будут добавлены без ошибок
Добавление уникальных метаданных, которые не могут дублироваться
$result = add_post_meta(42, 'custom_field', 'значение поля', true);
// $result будет true или false в зависимости от существования метаданных
Если метаданные уже существуют, будет возвращено false
Обработка ситуации, когда добавление метаданных не удалось
$result = add_post_meta(0, 'custom_field', 'значение поля');
if (!$result) {
echo 'Ошибка: метаданные не были добавлены';
}
ID записи должен быть действительным
Добавление метаданных при сохранении записи в плагине
function my_custom_meta() {
add_post_meta($post_id, 'my_meta_key', 'my_meta_value');
}
add_action('save_post', 'my_custom_meta');
Метаданные будут добавлены каждый раз при сохранении записи
Безопасность
Валидация входных данных: Параметры проверяются на корректность внутри функции
Санитизация: Значения автоматически очищаются WordPress
Рекомендации: При выводе значений метаданных используйте функции esc_html() или esc_attr() для предотвращения XSS
— Связанные функции
Обновляет метаданные записи, если они уже существуют
Удаляет метаданные записи
— Примечания
– Ограничения
Не может добавлять метаданные к несуществующим записям
– Частые проблемы
- Возвращает false, если ID записи некорректен
- Метаданные не добавляются, если они уже существуют и unique=true
