函数文档

wp_ajax_oembed_cache()

💡 云策文档标注

概述

wp_ajax_oembed_cache() 是一个 WordPress AJAX 处理函数,用于通过 AJAX 请求缓存 oEmbed 内容。它调用全局 wp_embed 对象的 cache_oembed 方法,并终止执行。

关键要点

  • 函数通过 AJAX 处理 oEmbed 缓存,提高嵌入内容加载效率。
  • 使用 $GLOBALS['wp_embed']->cache_oembed() 方法缓存指定文章的 oEmbed 数据。
  • 调用 wp_die(0) 终止 WordPress 执行,返回成功状态码 0。
  • 自 WordPress 3.1.0 版本引入,是核心 AJAX 钩子的一部分。

代码示例

function wp_ajax_oembed_cache() {
	$GLOBALS['wp_embed']->cache_oembed( $_GET['post'] );
	wp_die( 0 );
}

注意事项

  • 此函数依赖于 $_GET['post'] 参数传递文章 ID,需确保 AJAX 请求正确设置。
  • wp_die() 用于结束执行,开发者应避免在自定义代码中直接调用此函数,除非处理 AJAX 响应。
  • 相关函数 wp_die() 可用于错误处理,但在此上下文中仅返回成功状态。

📄 原文内容

Handles oEmbed caching via AJAX.

Source

function wp_ajax_oembed_cache() {
	$GLOBALS['wp_embed']->cache_oembed( $_GET['post'] );
	wp_die( 0 );
}

Changelog

Version Description
3.1.0 Introduced.