# media_library_months_with_files

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

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

## Сигнатура

```php
apply_filters( 'media_library_months_with_files', stdClass[]|null $months )
```

## Описание

По умолчанию (если этот фильтр не возвращает массив) будет выполнен запрос для определения месяцев, в которых есть медиаэлементы. Такой запрос может быть затратным для больших медиабиблиотек, поэтому сайтам может быть желательно переопределить это поведение.

## Параметры

- `$months` `stdClass[]|null` — обязательный. Массив объектов со свойствами month и year или null для стандартного поведения.

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

Массив объектов со свойствами month и year или null для стандартного поведения.

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

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

```php
$months = apply_filters( 'media_library_months_with_files', null );
```

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

- 4.7.4 — Introduced.

## Связанные

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

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