From 9e4c655b2a6a2baf37df1fbef86d0b6101170aa0 Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Sun, 27 Sep 2015 22:44:18 +0000 Subject: [PATCH] Docs: Adjust the `themes_api()` DocBlock description to clarify the "second" available hook, `themes_api`, and add new information for the "third" hook, `themes_api_result`. See #34036. git-svn-id: https://develop.svn.wordpress.org/trunk@34648 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-admin/includes/theme.php | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/wp-admin/includes/theme.php b/src/wp-admin/includes/theme.php index 7c2fbd0a39..c522e323fe 100644 --- a/src/wp-admin/includes/theme.php +++ b/src/wp-admin/includes/theme.php @@ -307,7 +307,12 @@ function get_theme_feature_list( $api = true ) { * as the second parameter. The hook for {@see 'themes_api_args'} must ensure that * an object is returned. * - * The second filter, {@see 'themes_api'}, is the result that would be returned. + * The second filter, {@see 'themes_api'}, allows a plugin to override the WordPress.org + * Theme API entirely. If `$action` is 'query_themes', 'theme_information', or 'hot_categories', + * an object MUST be passed. If `$action` is 'hot_tags`, an array should be passed. + * + * Finally, the third filter, {@see 'themes_api_result'}, makes it possible to filter the + * response object or array, depending on the `$action` type. * * Supported arguments per action: *