apply_filters( 'ajax_query_attachments_args', array $query )

Filters the arguments passed to WP_Query during an Ajax call for querying attachments.

Description

See also

Parameters

$query

(array) An array of query variables.

More Information

The ajax_query_attachments_args filter is used to filter the query that fetches the attachments displayed in the media library modal on the post edit screen.

The filter is used like this


add_filter( 'ajax_query_attachments_args', 'filter_function_name', 10, 1 )

Where filter_function_name() is the function WordPress should call when the query is being modified. Note that the filter function must return the query array after it is finished processing, or the query will be empty and no attachments will be shown.

filter_function_name() should be a unique function name. It cannot match any other function name already declared.

Source

File: wp-admin/includes/ajax-actions.php

View on Trac

Changelog

Version Description
3.7.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/ajax_query_attachments_args