检查$ check_urls中的所有Feed网址是否都被缓存。

原型

wp_dashboard_cached_rss_widget( string $widget_id, callable $callback, array $check_urls = array() )

描述

如果$ check_urls为空,请查找$ widget_id的仪表板小部件选项中找到的rss feed url。如果缓存,请调用$ callback,这是一个回显此窗口小部件输出的函数。如果不是缓存,则回显一个“正在加载…”存根,后来被Ajax调用替换(参见/wp-admin/index.php的顶部)

参数

$widget_id (string) (Required)

$callback (callable) (Required)

$check_urls (array) (Optional) RSS订阅

返回值

(bool)  失败时是假的。成功的真实。

源文件

路径:wp-admin/includes/dashboard.php

<?php
...
function wp_dashboard_cached_rss_widget( $widget_id, $callback, $check_urls = array() ) {
	$loading = '<p class="widget-loading hide-if-no-js">' . __( 'Loading&#8230;' ) . '</p><div class="hide-if-js notice notice-error inline"><p>' . __( 'This widget requires JavaScript.' ) . '</p></div>';
	$doing_ajax = wp_doing_ajax();
	if ( empty($check_urls) ) {
		$widgets = get_option( 'dashboard_widget_options' );
		if ( empty($widgets[$widget_id]['url']) && ! $doing_ajax ) {
			echo $loading;
			return false;
		}
		$check_urls = array( $widgets[$widget_id]['url'] );
	}
	$locale = get_user_locale();
	$cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale );
	if ( false !== ( $output = get_transient( $cache_key ) ) ) {
		echo $output;
		return true;
	}
	if ( ! $doing_ajax ) {
		echo $loading;
		return false;
	}
	if ( $callback && is_callable( $callback ) ) {
		$args = array_slice( func_get_args(), 3 );
		array_unshift( $args, $widget_id, $check_urls );
		ob_start();
		call_user_func_array( $callback, $args );
		set_transient( $cache_key, ob_get_flush(), 12 * HOUR_IN_SECONDS ); // Default lifetime in cache of 12 hours (same as the feeds)
	}
	return true;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_dashboard_cached_rss_widget/