The get_media_item_args WordPress PHP filter allows you to modify the arguments used to retrieve an image for the edit image form.
Usage
add_filter('get_media_item_args', 'your_custom_function'); function your_custom_function($parsed_args) { // your custom code here return $parsed_args; }
Parameters
$parsed_args
(array): An array of arguments for retrieving an image in the edit image form.
More information
See WordPress Developer Resources: get_media_item_args
Examples
Change the orderby argument
Modify the arguments to change the orderby parameter to ‘title’:
add_filter('get_media_item_args', 'change_orderby_to_title'); function change_orderby_to_title($parsed_args) { $parsed_args['orderby'] = 'title'; return $parsed_args; }
Limit the number of images
Limit the number of images retrieved to 5:
add_filter('get_media_item_args', 'limit_images_to_five'); function limit_images_to_five($parsed_args) { $parsed_args['posts_per_page'] = 5; return $parsed_args; }
Show only images with a specific tag
Display only images that have the tag ‘featured’:
add_filter('get_media_item_args', 'show_only_featured_images'); function show_only_featured_images($parsed_args) { $parsed_args['tag'] = 'featured'; return $parsed_args; }
Change the order of the images
Change the order of the images to ascending:
add_filter('get_media_item_args', 'change_image_order_to_ascending'); function change_image_order_to_ascending($parsed_args) { $parsed_args['order'] = 'ASC'; return $parsed_args; }
Show only images from a specific category
Display images only from the ‘landscapes’ category:
add_filter('get_media_item_args', 'show_only_landscapes_category'); function show_only_landscapes_category($parsed_args) { $parsed_args['category_name'] = 'landscapes'; return $parsed_args; }
“END”