Описание функции is_attachment()
Функция is_attachment() используется для проверки, является ли текущая запись вложением (attachment) в WordPress. Эта функция возвращает true, если текущая запись — вложение, и false в противном случае.
Функция часто используется в шаблонах и плагинах для условного вывода контента в зависимости от типа записи.
Параметры
$attachment
Тип: int|string
Обязательный: Нет
По умолчанию: null
Описание: ID или объект вложения для проверки
Возможные значения:
ID: Числовой идентификатор вложения
post: Объект WP_Post вложения
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если текущая запись является вложением, иначе false
Возможные значения:
• true — если запись является вложением
• false — если запись не является вложением
Примеры использования
Базовый пример проверки типа записи
if (is_attachment()) {
echo 'Это вложение';
} else {
echo 'Это не вложение';
}
Выводит ‘Это вложение’ если текущая запись действительно вложение
Проверка конкретного вложения по ID
$attachment_id = 123;
if (is_attachment($attachment_id)) {
echo 'Это вложение с ID 123';
}
Выводит сообщение, если запись с указанным ID является вложением
Безопасность
Валидация входных данных: Функция проверяет входные параметры на корректность
Санитизация: Параметры не требуют дополнительной очистки, так как функция работает с ID или объектами
Рекомендации: Следует использовать проверенные ID для избегания ошибок
— Связанные функции
Получает ссылку на вложение по ID
Проверяет, является ли вложение изображением
— Примечания
– Ограничения
Работает только в контексте записи
– Частые проблемы
- Может вернуть false при неверно указанном ID
- Не сработает вне контекста записи (например, в админке)
