wp_update_themes

函数


      wp_update_themes ( $extra_stats = array() )

参数

(array) $extra_stats Extra statistics to report to the WordPress.org API.

Required: 否

Default: array()

定义位置

wp-includes/update.php , line 584

相关方法: wp_update_theme wp_update_term wp_ajax_update_theme wp_paused_themes _maybe_update_themes

引入: 2.7.0

弃用: -

wp_update_themes是一个更新所有安装在WordPress站点上的主题的函数: 该函数检查WordPress主题库的更新，并在必要时应用它们: 该函数用于确保网站上安装的所有主题都是最新的，并具有最新的安全修复和功能。

根据WordPress.org上托管的最新版本，检查主题的可用更新。

尽管它的名字是这样的，这个功能实际上并不执行任何更新，它只是检查可用的更新。

一个已安装的所有主题的列表会被发送到WP，同时还有网站的定位。

检查位于api.wordpress.org的WordPress服务器。只有在WordPress没有安装的情况下才会检查。

function wp_update_themes( $extra_stats = array() ) {
	if ( wp_installing() ) {
		return;
	}

	// Include an unmodified $wp_version.
	require ABSPATH . WPINC . '/version.php';

	$installed_themes = wp_get_themes();
	$translations     = wp_get_installed_translations( 'themes' );

	$last_update = get_site_transient( 'update_themes' );

	if ( ! is_object( $last_update ) ) {
		$last_update = new stdClass;
	}

	$themes  = array();
	$checked = array();
	$request = array();

	// Put slug of active theme into request.
	$request['active'] = get_option( 'stylesheet' );

	foreach ( $installed_themes as $theme ) {
		$checked[ $theme->get_stylesheet() ] = $theme->get( 'Version' );

		$themes[ $theme->get_stylesheet() ] = array(
			'Name'       => $theme->get( 'Name' ),
			'Title'      => $theme->get( 'Name' ),
			'Version'    => $theme->get( 'Version' ),
			'Author'     => $theme->get( 'Author' ),
			'Author URI' => $theme->get( 'AuthorURI' ),
			'UpdateURI'  => $theme->get( 'UpdateURI' ),
			'Template'   => $theme->get_template(),
			'Stylesheet' => $theme->get_stylesheet(),
		);
	}

	$doing_cron = wp_doing_cron();

	// Check for update on a different schedule, depending on the page.
	switch ( current_filter() ) {
		case 'upgrader_process_complete':
			$timeout = 0;
			break;
		case 'load-update-core.php':
			$timeout = MINUTE_IN_SECONDS;
			break;
		case 'load-themes.php':
		case 'load-update.php':
			$timeout = HOUR_IN_SECONDS;
			break;
		default:
			if ( $doing_cron ) {
				$timeout = 2 * HOUR_IN_SECONDS;
			} else {
				$timeout = 12 * HOUR_IN_SECONDS;
			}
	}

	$time_not_changed = isset( $last_update->last_checked ) && $timeout > ( time() - $last_update->last_checked );

	if ( $time_not_changed && ! $extra_stats ) {
		$theme_changed = false;

		foreach ( $checked as $slug => $v ) {
			if ( ! isset( $last_update->checked[ $slug ] ) || (string) $last_update->checked[ $slug ] !== (string) $v ) {
				$theme_changed = true;
			}
		}

		if ( isset( $last_update->response ) && is_array( $last_update->response ) ) {
			foreach ( $last_update->response as $slug => $update_details ) {
				if ( ! isset( $checked[ $slug ] ) ) {
					$theme_changed = true;
					break;
				}
			}
		}

		// Bail if we've checked recently and if nothing has changed.
		if ( ! $theme_changed ) {
			return;
		}
	}

	// Update last_checked for current to prevent multiple blocking requests if request hangs.
	$last_update->last_checked = time();
	set_site_transient( 'update_themes', $last_update );

	$request['themes'] = $themes;

	$locales = array_values( get_available_languages() );

	/**
	 * Filters the locales requested for theme translations.
	 *
	 * @since 3.7.0
	 * @since 4.5.0 The default value of the `$locales` parameter changed to include all locales.
	 *
	 * @param string[] $locales Theme locales. Default is all available locales of the site.
	 */
	$locales = apply_filters( 'themes_update_check_locales', $locales );
	$locales = array_unique( $locales );

	if ( $doing_cron ) {
		$timeout = 30; // 30 seconds.
	} else {
		// Three seconds, plus one extra second for every 10 themes.
		$timeout = 3 + (int) ( count( $themes ) / 10 );
	}

	$options = array(
		'timeout'    => $timeout,
		'body'       => array(
			'themes'       => wp_json_encode( $request ),
			'translations' => wp_json_encode( $translations ),
			'locale'       => wp_json_encode( $locales ),
		),
		'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ),
	);

	if ( $extra_stats ) {
		$options['body']['update_stats'] = wp_json_encode( $extra_stats );
	}

	$url      = 'http://api.wordpress.org/themes/update-check/1.1/';
	$http_url = $url;
	$ssl      = wp_http_supports( array( 'ssl' ) );

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

	$raw_response = wp_remote_post( $url, $options );

	if ( $ssl && is_wp_error( $raw_response ) ) {
		trigger_error(
			sprintf(
				/* translators: %s: Support forums URL. */
				__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’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
		);
		$raw_response = wp_remote_post( $http_url, $options );
	}

	if ( is_wp_error( $raw_response ) || 200 !== wp_remote_retrieve_response_code( $raw_response ) ) {
		return;
	}

	$new_update               = new stdClass;
	$new_update->last_checked = time();
	$new_update->checked      = $checked;

	$response = json_decode( wp_remote_retrieve_body( $raw_response ), true );

	if ( is_array( $response ) ) {
		$new_update->response     = $response['themes'];
		$new_update->no_update    = $response['no_update'];
		$new_update->translations = $response['translations'];
	}

	// Support updates for any themes using the `Update URI` header field.
	foreach ( $themes as $theme_stylesheet => $theme_data ) {
		if ( ! $theme_data['UpdateURI'] || isset( $new_update->response[ $theme_stylesheet ] ) ) {
			continue;
		}

		$hostname = wp_parse_url( esc_url_raw( $theme_data['UpdateURI'] ), PHP_URL_HOST );

		/**
		 * Filters the update response for a given theme hostname.
		 *
		 * The dynamic portion of the hook name, `$hostname`, refers to the hostname
		 * of the URI specified in the `Update URI` header field.
		 *
		 * @since 6.1.0
		 *
		 * @param array|false $update {
		 *     The theme update data with the latest details. Default false.
		 *
		 *     @type string $id           Optional. ID of the theme for update purposes, should be a URI
		 *                                specified in the `Update URI` header field.
		 *     @type string $theme        Directory name of the theme.
		 *     @type string $version      The version of the theme.
		 *     @type string $url          The URL for details of the theme.
		 *     @type string $package      Optional. The update ZIP for the theme.
		 *     @type string $tested       Optional. The version of WordPress the theme is tested against.
		 *     @type string $requires_php Optional. The version of PHP which the theme requires.
		 *     @type bool   $autoupdate   Optional. Whether the theme should automatically update.
		 *     @type array  $translations {
		 *         Optional. List of translation updates for the theme.
		 *
		 *         @type string $language   The language the translation update is for.
		 *         @type string $version    The version of the theme this translation is for.
		 *                                  This is not the version of the language file.
		 *         @type string $updated    The update timestamp of the translation file.
		 *                                  Should be a date in the `YYYY-MM-DD HH:MM:SS` format.
		 *         @type string $package    The ZIP location containing the translation update.
		 *         @type string $autoupdate Whether the translation should be automatically installed.
		 *     }
		 * }
		 * @param array       $theme_data       Theme headers.
		 * @param string      $theme_stylesheet Theme stylesheet.
		 * @param string[]    $locales          Installed locales to look up translations for.
		 */
		$update = apply_filters( "update_themes_{$hostname}", false, $theme_data, $theme_stylesheet, $locales );

		if ( ! $update ) {
			continue;
		}

		$update = (object) $update;

		// Is it valid? We require at least a version.
		if ( ! isset( $update->version ) ) {
			continue;
		}

		// This should remain constant.
		$update->id = $theme_data['UpdateURI'];

		// WordPress needs the version field specified as 'new_version'.
		if ( ! isset( $update->new_version ) ) {
			$update->new_version = $update->version;
		}

		// Handle any translation updates.
		if ( ! empty( $update->translations ) ) {
			foreach ( $update->translations as $translation ) {
				if ( isset( $translation['language'], $translation['package'] ) ) {
					$translation['type'] = 'theme';
					$translation['slug'] = isset( $update->theme ) ? $update->theme : $update->id;

					$new_update->translations[] = $translation;
				}
			}
		}

		unset( $new_update->no_update[ $theme_stylesheet ], $new_update->response[ $theme_stylesheet ] );

		if ( version_compare( $update->new_version, $theme_data['Version'], '>' ) ) {
			$new_update->response[ $theme_stylesheet ] = (array) $update;
		} else {
			$new_update->no_update[ $theme_stylesheet ] = (array) $update;
		}
	}

	set_site_transient( 'update_themes', $new_update );
}

常见问题

FAQs

如何使用add_action添加一个钩子函数？
在WordPress中，你可以使用 add_action 函数添加一个钩子函数。钩子函数是在特定事件发生时自动触发的函数。

add_action 函数的第一个参数是钩子名称，第二个参数是要执行的函数名，第三个参数是函数的优先级（可选）。

例如，添加一个在文章保存后执行的钩子函数的代码如下：
```
function my_save_post_function( $post_ID, $post ) {  
    // 执行你的代码  
}  
add_action( 'save_post', 'my_save_post_function', 10, 2 );
```
这里， save_post 是钩子名称， my_save_post_function 是要执行的函数名，10是函数的优先级，2是传递给钩子函数的参数数量。
如何使用wp_reset_query重置查询？
wp_reset_query() 函数用于重置WordPress的查询。在自定义查询或修改查询参数之后，你可能需要使用这个函数来重置到默认的查询。例如：
```
// 自定义查询  
$args = array(  
    'post_type' => 'product',  
    'posts_per_page' => 10,  
);  
$custom_query = new WP_Query($args);  
  
// 重置查询  
wp_reset_query();
```
如何创建自定义的WordPress插件？
创建自定义的WordPress插件需要以下步骤：
- 创建一个新的文件夹，用于存放插件文件。
- 在文件夹中创建一个名为plugin-name.php的文件，这是插件的主要文件。
- 在plugin-name.php文件中添加插件的基本信息，例如名称、版本、描述等。
- 编写插件的功能代码，例如添加自定义文章类型、自定义字段、自定义页面等。
- 将文件夹上传到WordPress的wp-content/plugins目录下。
- 在WordPress后台激活插件。

如何使用get_post和get_page获取单个文章或页面的详细信息？

使用 get_post 和 get_page 获取单个文章或页面的详细信息：

// 获取文章或页面的ID  
$post_id = get_the_ID();  
  
// 获取文章或页面的详细信息  
$post = get_post($post_id);  
  
// 获取文章或页面的标题  
$title = $post->post_title;  
  
// 获取文章或页面的内容  
$content = $post->post_content;

wp_enqueue_script和wp_enqueue_style函数如何使用？
wp_enqueue_script 和 wp_enqueue_style 函数的使用：
- wp_enqueue_script() ：此函数位于wp-includes/script-loader.php文件中。它会将JavaScript文件添加到WordPress网站的页脚中。您可以在主题的functions.php文件中调用此函数，以添加自定义的JavaScript文件。
- wp_enqueue_style() ：此函数位于wp-includes/script-loader.php文件中。它会将CSS文件添加到WordPress网站的部分中。您可以在主题的functions.php文件中调用此函数，以添加自定义的CSS文件。
如何使用wp_head和wp_footer在主题中添加自定义内容？
使用 wp_head 和 wp_footer 在主题中添加自定义内容：
- wp_head() ：此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的header.php文件中调用此函数，以在部分中添加自定义内容。
- wp_footer() ：此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的footer.php文件中调用此函数，以在部分中添加自定义内容。

wp_update_themes

常见问题

相关文章