Описание функции register_post_status()
Функция register_post_status() позволяет разработчикам регистрировать пользовательские статусы для записей в WordPress. Это полезно для создания специальных состояний, которые могут быть использованы в админке или на фронтэнде для отображения информации о записях. Например, можно создать статусы такие как ‘в ожидании’, ‘в процессе’, ‘завершено’.
Функция должна быть вызвана в хуке ‘init’ или позже.
Параметры
$post_status
Тип: string
Обязательный: Да
Описание: Уникальный идентификатор статуса записи
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки статуса
Возможные значения:
label: Отображаемое название статуса
public: 1,
exclude_from_search: 1,
show_in_admin_status_list: 1,
show_in_admin_all_list: 1,
meta_box: 1,
label_count: Формат отображаемого количества записей
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
Примеры использования
Регистрация статуса ‘в ожидании’ с отображаемым названием
register_post_status('в_ожидании', array(
'label' => 'В ожидании',
'public' => true
));
Статус будет доступен для использования в админке
Регистрация статуса ‘завершено’ с параметрами для поиска
register_post_status('завершено', array(
'label' => 'Завершено',
'public' => true,
'exclude_from_search' => false
));
Этот статус будет виден в результатах поиска
Проверка на успешную регистрацию статуса
$status = 'недоступно';
if(!register_post_status($status, array('label' => 'Недоступно'))) {
// Обработка ошибки
}
Можно добавить логику для обработки ошибок
Регистрация статуса в хуке ‘init’ плагина
add_action('init', function() {
register_post_status('в_ожидании', array(
'label' => 'В ожидании',
'public' => true
));
});
Обеспечивает корректную регистрацию статуса
Безопасность
Валидация входных данных: Параметры должны быть проверены на соответствие ожиданиям
Санитизация: Функция не выполняет автоматическую очистку входных данных
Рекомендации: Убедитесь, что все входные данные валидированы и безопасны перед регистрацией
— Связанные функции
Получает список всех зарегистрированных статусов записей
Обновляет статус существующей записи
— Примечания
– Ограничения
Необходимо следить за уникальностью идентификаторов статусов
– Частые проблемы
- Ошибка при регистрации статуса с уже существующим идентификатором
- Проблемы с отображением статуса в админке при неправильных параметрах
