Описание функции has_post_format()
Функция has_post_format() проверяет, установлен ли заданный формат для текущей записи. Форматы записей позволяют создавать различные стили и шаблоны для записей, что улучшает организацию контента.
Эта функция используется в темах и плагинах для изменения отображения записей в зависимости от их формата.
Параметры
$format
Тип: string|array
Обязательный: Да
По умолчанию: »
Описание: Формат(ы) записи для проверки
Возможные значения:
string: формат (например, ‘aside’, ‘gallery’)
array: массив форматов
$post
Тип: int|WP_Post
Обязательный: Нет
По умолчанию: null
Описание: ID записи или объект WP_Post для проверки
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если заданный формат соответствует формату записи, иначе false
Возможные значения:
• true — если формат соответствует
• false — если формат не соответствует или запись не найдена
Примеры использования
Базовый пример проверки формата ‘gallery’
if (has_post_format('gallery')) {
echo 'Это галерея!';
}
Выводит сообщение, если текущая запись является галереей
Проверка на несколько форматов одновременно
if (has_post_format(['quote', 'aside'])) {
echo 'Это цитата или заметка!';
}
Сработает, если один из форматов соответствует
Проверка формата записи с заданным ID
$post_id = 42;
if (has_post_format('video', $post_id)) {
echo 'Это видео!';
}
Проверяет формат записи с ID 42
Обработка случая, когда формат не соответствует
if (!has_post_format('gallery')) {
echo 'Формат не соответствует';
}
Выводит сообщение об ошибке
Безопасность
Валидация входных данных: Параметры проверяются на соответствие ожидаемым типам
Санитизация: Функция сама обрабатывает входные значения
Рекомендации: Всегда проверяйте наличие записи перед использованием функции
— Связанные функции
Получает формат записи
Устанавливает формат записи
— Примечания
– Ограничения
Функция проверяет только форматы, зарегистрированные в WordPress
– Частые проблемы
- Неверный формат, возвращает false
- Не работает для старых записей без форматов
