Docs: Vastly improve documentation for `themes_api()`.
Adds: * A hash notation with descriptions for all accepted arguments * A matrix-like data table demonstrating which arguments are available for the different `$action` types * A better summary and description with linked hooks * An improved return description with a link to external information Props ocean90. See #34036. Built from https://develop.svn.wordpress.org/trunk@34640 git-svn-id: http://core.svn.wordpress.org/trunk@34604 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes
parent
702e4e8ea7
commit
b6de1478fd
|
|
@ -296,27 +296,82 @@ function get_theme_feature_list( $api = true ) {
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieve theme installer pages from WordPress Themes API.
|
||||
* Retrieves theme installer pages from the WordPress.org Themes API.
|
||||
*
|
||||
* It is possible for a theme to override the Themes API result with three
|
||||
* filters. Assume this is for themes, which can extend on the Theme Info to
|
||||
* offer more choices. This is very powerful and must be used with care, when
|
||||
* overriding the filters.
|
||||
*
|
||||
* The first filter, 'themes_api_args', is for the args and gives the action as
|
||||
* the second parameter. The hook for 'themes_api_args' must ensure that an
|
||||
* object is returned.
|
||||
* The first filter, {@see 'themes_api_args'}, is for the args and gives the action
|
||||
* as the second parameter. The hook for {@see 'themes_api_args'} must ensure that
|
||||
* an object is returned.
|
||||
*
|
||||
* The second filter, 'themes_api', is the result that would be returned.
|
||||
* The second filter, {@see 'themes_api'}, is the result that would be returned.
|
||||
*
|
||||
* Supported arguments per action:
|
||||
*
|
||||
* | Argument Name | 'query_plugins' | 'theme_information' | 'hot_tags' | 'feature_list' |
|
||||
* | -------------------| :-------------: | :-----------------: | :--------: | :--------------: |
|
||||
* | `$slug` | No | Yes | No | No |
|
||||
* | `$per_page` | Yes | No | No | No |
|
||||
* | `$page` | Yes | No | No | No |
|
||||
* | `$number` | No | No | Yes | No |
|
||||
* | `$search` | Yes | No | No | No |
|
||||
* | `$tag` | Yes | No | No | No |
|
||||
* | `$author` | Yes | No | No | No |
|
||||
* | `$user` | Yes | No | No | No |
|
||||
* | `$browse` | Yes | No | No | No |
|
||||
* | `$locale` | Yes | Yes | No | No |
|
||||
* | `$fields` | Yes | Yes | No | No |
|
||||
*
|
||||
* @since 2.8.0
|
||||
*
|
||||
* @param string $action The requested action. Likely values are 'theme_information',
|
||||
* 'feature_list', or 'query_themes'.
|
||||
* @param array|object $args Optional. Arguments to serialize for the Theme Info API.
|
||||
* @return mixed
|
||||
* @param string $action API action to perform: 'query_themes', 'theme_information',
|
||||
* 'hot_tags' or 'feature_list'.
|
||||
* @param array|object $args {
|
||||
* Optional. Array or object of arguments to serialize for the Plugin Info API.
|
||||
*
|
||||
* @type string $slug The plugin slug. Default empty.
|
||||
* @type int $per_page Number of themes per page. Default 24.
|
||||
* @type int $page Number of current page. Default 1.
|
||||
* @type int $number Number of tags to be queried.
|
||||
* @type string $search A search term. Default empty.
|
||||
* @type string $tag Tag to filter themes. Default empty.
|
||||
* @type string $author Username of an author to filter themes. Default empty.
|
||||
* @type string $user Username to query for their favorites. Default empty.
|
||||
* @type string $browse Browse view: 'featured', 'popular', 'updated', 'favorites'.
|
||||
* @type string $locale Locale to provide context-sensitive results. Default is the value of get_locale().
|
||||
* @type array $fields {
|
||||
* Array of fields which should or should not be returned.
|
||||
*
|
||||
* @type bool $description Whether to return the theme full description. Default false.
|
||||
* @type bool $sections Whether to return the theme readme sections: description, installation,
|
||||
* FAQ, screenshots, other notes, and changelog. Default false.
|
||||
* @type bool $rating Whether to return the rating in percent and total number of ratings.
|
||||
* Default false.
|
||||
* @type bool $ratings Whether to return the number of rating for each star (1-5). Default false.
|
||||
* @type bool $downloaded Whether to return the download count. Default false.
|
||||
* @type bool $downloadlink Whether to return the download link for the package. Default false.
|
||||
* @type bool $last_updated Whether to return the date of the last update. Default false.
|
||||
* @type bool $tags Whether to return the assigned tags. Default false.
|
||||
* @type bool $homepage Whether to return the theme homepage link. Default false.
|
||||
* @type bool $screenshots Whether to return the screenshots. Default false.
|
||||
* @type int $screenshot_count Number of screenshots to return. Default 1.
|
||||
* @type bool $screenshot_url Whether to return the URL of the first screenshot. Default false.
|
||||
* @type bool $photon_screenshots Whether to return the screenshots via Photon. Default false.
|
||||
* @type bool $template Whether to return the slug of the parent theme. Default false.
|
||||
* @type bool $parent Whether to return the slug, name and homepage of the parent theme. Default false.
|
||||
* @type bool $versions Whether to return the list of all available versions. Default false.
|
||||
* @type bool $theme_url Whether to return theme's URL. Default false.
|
||||
* @type bool $extended_author Whether to return nicename or nicename and display name. Default false.
|
||||
* }
|
||||
* }
|
||||
* @return object|array|WP_Error Response object or array on success, WP_Error on failure. See the
|
||||
* {@link https://developer.wordpress.org/reference/functions/themes_api/ function reference article}
|
||||
* for more information on the make-up of possible return objects depending on the value of `$action`.
|
||||
*/
|
||||
function themes_api( $action, $args = null ) {
|
||||
function themes_api( $action, $args = array() ) {
|
||||
|
||||
if ( is_array( $args ) ) {
|
||||
$args = (object) $args;
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@
|
|||
*
|
||||
* @global string $wp_version
|
||||
*/
|
||||
$wp_version = '4.4-alpha-34639';
|
||||
$wp_version = '4.4-alpha-34640';
|
||||
|
||||
/**
|
||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||
|
|
|
|||
Loading…
Reference in New Issue