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