# post_gallery

URL: https://chugunov.pro/api-wordpress/filters/post_gallery/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 2.5.0.

## Сигнатура

```php
apply_filters( 'post_gallery', string $output, array $attr, int $instance )
```

## Описание

Если отфильтрованный вывод не пуст, он будет использован вместо генерации шаблона галереи по умолчанию.
См. alsogallery_shortcode()

## Параметры

- `$output` `string` — обязательный. Вывод галереи. По умолчанию пусто.
- `$attr` `array` — обязательный. Атрибуты шорткода галереи.
- `$instance` `int` — обязательный. Уникальный числовой ID данного экземпляра шорткода галереи.

## Фильтруемое значение

Вывод галереи. По умолчанию пусто.

## Исходный код

Файл: `wp-includes/media.php:2740`

```php
$output = apply_filters( 'post_gallery', '', $attr, $instance );
```

## История изменений

- 4.2.0 — The $instance parameter was added.
- 2.5.0 — Introduced.

## Связанные

Используется в: [`gallery_shortcode`](https://chugunov.pro/api-wordpress/functions/gallery_shortcode/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/post_gallery/