如何为WordPress贡献嵌入功能？将自有网站纳入嵌入区域的方法

一、为WordPress贡献自定义嵌入功能 #

1. 先摸透WordPress嵌入底层逻辑
   WordPress的嵌入系统基于oEmbed标准，核心是WP_oEmbed类，还有相关钩子用于扩展功能。得先搞懂这些基础逻辑，避免开发踩坑。

2. 开发自定义嵌入提供者

• 注册oEmbed规则：用wp_oembed_add_provider()函数，将你的嵌入服务URL模式与API端点绑定。示例代码：

  wp_oembed_add_provider( '#https?://your-service\.com/.*#i', 'https://your-service.com/oembed/', true );
  

• 实现oEmbed API接口：在你的服务端编写接口，返回符合oEmbed规范的JSON/XML数据，必须包含标题、嵌入代码、宽高这些必填字段，确保WordPress能正确解析。

3. 按规范提交贡献

• 若要将功能纳入WordPress核心，需遵循官方核心贡献规范，编写补丁提交到Trac系统，等待社区审核通过。
• 也可直接打包成插件发布到WordPress插件库，让其他用户自行安装使用。

4. 做好测试调试
   用oEmbed_fetch_url钩子调试请求，验证嵌入代码能否正常渲染，同时测试不同主题、设备下的兼容性，避免出现bug。

二、将自有网站添加到WordPress嵌入区域 #

方法一：依赖WordPress自动识别（推荐） #

• 给自有网站添加oEmbed支持：按照oEmbed规范实现API接口，返回的响应示例如下：

  {
    "version": "1.0",
    "type": "rich",
    "title": "我的文章",
    "html": "<iframe src='https://my-site.com/embed/456' width='600' height='400'></iframe>",
    "width": 600,
    "height": 400
  }
  

• 完成后在WordPress编辑器中直接粘贴网站URL，系统会自动调用oEmbed接口渲染内容。

方法二：手动注册嵌入规则 #

如果WordPress未自动识别你的网站，可在主题functions.php或自定义插件中，用wp_oembed_add_provider()注册URL模式与API端点，代码参考前面的示例即可。

方法三：用短代码兜底 #

不想依赖oEmbed的话，可自定义短代码实现嵌入。示例代码：

function my_site_embed_shortcode( $atts ) {
  $atts = shortcode_atts( array(
    'post_id' => '',
  ), $atts );
  return "<iframe src='https://my-site.com/embed/{$atts['post_id']}' width='100%' height='400'></iframe>";
}
add_shortcode( 'my_site_embed', 'my_site_embed_shortcode' );

之后在编辑器中使用[my_site_embed post_id="456"]就能嵌入对应内容。

内容的提问来源于stack exchange，提问作者Joan Lee