ajax_query_attachments_args WordPress Filter Hook
The ajax_query_attachments_args hook is used to modify the arguments used in queries for attachments. This hook is called before the query is executed.
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
Changelog
| Version | Description |
|---|---|
| 3.7.0 | Introduced. |