themes_api() - Retrieves theme installer pages from the WordPress.org Themes API.

themes_api() – Retrieves theme installer pages from the WordPress.org Themes API.

You appear to be a bot. Output may be restricted

Description

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 second filter, themes_api , allows a plugin to override the WordPress.org Theme API entirely. If $action is 'query_themes', 'theme_information', or 'feature_list', an object MUST be passed. If $action is 'hot_tags', an array should be passed. Finally, the third filter, themes_api_result , makes it possible to filter the response object or array, depending on the $action type. Supported arguments per action:

Argument Name	‘query_themes’	‘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

Usage

$object|array|WP_Error = themes_api( $action, $args );

Parameters

$action: ( string ) required – API action to perform: 'query_themes', 'theme_information', 'hot_tags' or 'feature_list'.
$args: ( array|object ) optional – { Optional. Array or object of arguments to serialize for the Themes API. Default empty array.

Returns

object|array|WP_Error Response object or array on success, WP_Error on failure. See the https://developer.wordpress.org/reference/functions/themes_api/ for more information on the make-up of possible return objects depending on the value of `$action`.

Source

File name: wordpress/wp-admin/includes/theme.php
Lines:

1 to 100 of 147

function themes_api( $action, $args = array() ) {
  // Include an unmodified $wp_version.
  require ABSPATH . WPINC . '/version.php';

  if ( is_array( $args ) ) {
    $args = (object) $args;
  }

  if ( 'query_themes' === $action ) {
    if ( ! isset( $args->per_page ) ) {
      $args->per_page = 24;
    }
  }

  if ( ! isset( $args->locale ) ) {
    $args->locale = get_user_locale();
  }

  if ( ! isset( $args->wp_version ) ) {
    $args->wp_version = substr( $wp_version, 0, 3 ); // x.y
  }

  
/**
 * Filters arguments used to query for installer pages from the WordPress.org Themes API.
 *
 * Important: An object MUST be returned to this filter.
 *
 * @since 2.8.0
 *
 * @param object $args   Arguments used to query for installer pages from the WordPress.org Themes API.
 * @param string $action Requested action. Likely values are 'theme_information',
 *                       'feature_list', or 'query_themes'.
 */
  $args = apply_filters( 'themes_api_args', $args, $action );

  
/**
 * Filters whether to override the WordPress.org Themes API.
 *
 * Returning a non-false value will effectively short-circuit the WordPress.org API request.
 *
 * If `$action` is 'query_themes', 'theme_information', or 'feature_list', an object MUST
 * be passed. If `$action` is 'hot_tags', an array should be passed.
 *
 * @since 2.8.0
 *
 * @param false|object|array $override Whether to override the WordPress.org Themes API. Default false.
 * @param string             $action   Requested action. Likely values are 'theme_information',
 *                                    'feature_list', or 'query_themes'.
 * @param object             $args     Arguments used to query for installer pages from the Themes API.
 */
  $res = apply_filters( 'themes_api', false, $action, $args );

  if ( ! $res ) {
    $url = 'http://api.wordpress.org/themes/info/1.2/';
    $url = add_query_arg(
      array(
        'action'  => $action,
        'request' => $args,
      ),
      $url
    );

    $http_url = $url;
    $ssl      = wp_http_supports( array( 'ssl' ) );
    if ( $ssl ) {
      $url = set_url_scheme( $url, 'https' );
    }

    $http_args = array(
      'timeout'    => 15,
      'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ),
    );
    $request   = wp_remote_get( $url, $http_args );

    if ( $ssl && is_wp_error( $request ) ) {
      if ( ! wp_doing_ajax() ) {
        trigger_error(
          sprintf(
            /* translators: %s: Support forums URL. */
            __( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
            __( 'https://wordpress.org/support/forums/' )
          ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
          headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
        );
      }
      $request = wp_remote_get( $http_url, $http_args );
    }

    if ( is_wp_error( $request ) ) {
      $res = new WP_Error(
        'themes_api_failed',
        sprintf(
          /* translators: %s: Support forums URL. */
          __( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
          __( 'https://wordpress.org/support/forums/' )
        ),
        $request->get_error_message()
      );
    } else {
      $res = json_decode( wp_remote_retrieve_body( $request ), true );

[1] [2] Next »

View on GitHub View on Trac