Описание функции get_post_class()
Функция get_post_class() возвращает массив классов CSS для HTML-элемента, представляющего запись в WordPress. Эти классы могут использоваться для стилизации записей в зависимости от их состояния, типа и категории.
Функция полезна при создании тем и плагинов, так как позволяет легко добавлять индивидуальные стили к записям в зависимости от их характеристик.
Параметры
$class
Тип: string|array
Обязательный: Нет
По умолчанию: array()
Описание: Дополнительные классы CSS, которые будут добавлены к стандартным классам записи
Возможные значения:
$post_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID записи, для которой нужно получить классы. Если не указан, используется текущий пост
Возвращаемое значение
Тип: array
Описание: Массив классов CSS для записи
Возможные значения:
• Массив классов, включая стандартные и пользовательские
• Пустой массив, если запись не найдена
Примеры использования
Базовый пример получения классов для текущей записи
$classes = get_post_class();
// Выводим классы
echo implode(' ', $classes);
Классы могут включать ‘post’, ‘type-post’, ‘status-publish’ и др.
Получение классов для записи с ID 42 и добавление пользовательского класса
$classes = get_post_class('my-custom-class', 42);
// Выводим классы
echo implode(' ', $classes);
Класс ‘my-custom-class’ будет добавлен к стандартным классам
Проверка на случай, если запись не найдена
$classes = get_post_class('my-custom-class', 9999);
if (empty($classes)) {
echo 'Запись не найдена';
} else {
echo implode(' ', $classes);
}
Вывод сообщения об ошибке
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Классы автоматически очищаются перед выводом
Рекомендации: При выводе классов используйте esc_attr() для безопасного вывода
— Связанные функции
Получает тип поста по ID
Выводит классы поста напрямую в HTML
— Хуки
Фильтрует классы перед их возвращением
— Примечания
– Ограничения
Функция зависит от наличия записи
– Частые проблемы
- Неправильный ID записи может вернуть пустой массив
- Отсутствие записи вернет пустой массив
