Back to Main Site

Крючок: post.default_image

Last updated on Jun 24, 2026 01:58

Обзор

Тип: Фильтр Расположение: app/helpers.php - get_default_post_image()

Позволяет темам и модулям переопределять резервное изображение, отображаемое, если в сообщении нет избранного изображения. Администратор устанавливает глобальное значение по умолчанию через Настройки > Чтение > Изображение сообщения по умолчанию. Этот фильтр запускается после получения этого значения, давая разработчикам возможность вернуть другой URL-адрес в зависимости от контекста.

Параметры

Парам Тип Описание
$imageUrl string or null Текущий URL-адрес изображения по умолчанию из настроек
$context mixed Опубликовать экземпляр модели (или ноль)

Возвращаться

Должен возвращать string|null — URL-адрес изображения, которое нужно использовать, или null, чтобы вернуться к заполнителю SVG.

Пример использования

Установите другое изображение по умолчанию для каждой категории сообщений:

use App\Facades\Hook;

Hook::addFilter('post.default_image', function (?string $url, $post) {
    if ($post?->categories->contains('slug', 'technology')) {
        return '/images/defaults/tech-cover.jpg';
    }
    return $url;
});

Связанные хуки

  • post.frontend_url – настройка общедоступного URL-адреса публикации.
  • post.content.render — фильтровать HTML-код публикации перед ответом API.