wppaste
WordPress

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

Since
4.7.4
Allows overriding the list of months displayed in the media library.

Description

By default (if this filter does not return an array), a query will be run to determine the months that have media items. This query can be expensive for large media libraries, so it may be desirable for sites to override this behavior.

Compatibility

WordPress
since 4.7.4
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$months\stdClass[]|null
An array of objects with month and year properties, or null for default behavior.

Where this hook fires · 1

  • wp-includes/media.php:5041wp_enqueue_media()

Source code

View on Trac View on GitHub 

<?php	 *	 * @link https://core.trac.wordpress.org/ticket/31071	 *	 * @param stdClass[]|null $months An array of objects with `month` and `year`	 *                                properties, or `null` for default behavior.	 */	$months = apply_filters( 'media_library_months_with_files', null );	if ( ! is_array( $months ) ) {		$months = $wpdb->get_results(			$wpdb->prepare(				"SELECT DISTINCT YEAR( post_date ) AS year, MONTH( post_date ) AS month				FROM $wpdb->posts				WHERE post_type = %s

Changelog

Introduced in 4.7.4. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.