Описание функции wp_count_posts()
Функция wp_count_posts() возвращает количество записей для заданного типа поста. Она полезна для получения информации о количестве опубликованных, черновиков и других состояний записей определенного типа. Используется в админке и темах для отображения статистики по записям.
Функция позволяет разработчикам и администраторам быстро получить представление о состоянии контента на сайте.
Параметры
$post_type
Тип: string
Обязательный: Нет
По умолчанию: ‘post’
Описание: Тип поста, для которого необходимо получить количество записей.
Возможные значения:
0: ‘post’
1: ‘page’
2: ‘custom_post_type’
Возвращаемое значение
Тип: object
Описание: Объект, содержащий количество записей для каждого состояния (published, draft, etc.)
Возможные значения:
• Объект с количеством записей для каждого состояния
• null если передан неверный тип поста
Примеры использования
Базовый пример получения количества опубликованных записей
$post_counts = wp_count_posts();
$published_count = $post_counts->publish;
echo 'Опубликовано: ' . $published_count;
Опубликовано: 5
Получение количества опубликованных страниц
$page_counts = wp_count_posts('page');
echo 'Количество страниц: ' . $page_counts->publish;
Количество страниц: 10
Проверка на наличие ошибок при передаче неверного типа поста
$invalid_counts = wp_count_posts('invalid_post_type');
if (is_null($invalid_counts)) {
echo 'Неверный тип поста';
}
Неверный тип поста
Безопасность
Валидация входных данных: Тип поста проходит валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте только известные типы постов
— Связанные функции
Получает общее количество записей всех типов
Обновляет запись, что может повлиять на количество записей
— Примечания
– Ограничения
Возвращает количество записей только для публичных типов по умолчанию
– Частые проблемы
- null при передаче неверного типа поста
- Ошибки при недостатке прав доступа для просмотра записей
