跳到主要内容

Functions Template Tags

本页面列出了可在插件和模板文件中使用的函数，用于与 Duplicate Posts 进行交互。

duplicate_post_clone_post_link​

显示一个克隆当前文章的链接，前提是用户已登录且被允许复制该文章。可在 The Loop 内部或外部使用。如果在循环外部使用，则需要传递文章 ID。 此函数仿照 edit_post_link() 设计。

用法​

duplicate_post_clone_post_link( $link, $before, $after, $id );

参数​

  • $link (字符串)(可选) - 链接文本。默认为 __('Clone','duplicate-post')。
  • $before (字符串)(可选) - 放在链接文本之前的文本。默认为空字符串。
  • $after (字符串)(可选) - 放在链接文本之后的文本。默认为空字符串。
  • $id (整数)(可选) - 文章 ID。默认为当前文章 ID。

duplicate_post_get_original​

返回原始文章，可以是文章对象、关联数组或数字数组（取决于 $output 参数）。如果找不到原始文章，则返回 null。

它依赖于自定义字段 _dp_original，该字段在插件每次创建副本时都会被设置为原始 ID。 此函数仿照 get_post() 设计。

用法​

$original_post = duplicate_post_get_original( $post, $output );

参数​

  • $post (整数|WP_Post|null)(可选) - 文章 ID 或文章对象。默认为全局变量 $post。
  • $output (字符串)(可选) - 所需的返回类型。可选值为 OBJECT、ARRAY_A 或 ARRAY_N，分别对应 WP_Post 对象、关联数组或数字数组。默认为 OBJECT。

duplicate_post_create_duplicate​

根据当前设置，复制作为第一个参数传递的文章对象。这适用于除状态之外的所有内容：除非明确指定了新状态，否则默认复制原始状态。

用法​

$new_post_id = duplicate_post_create_duplicate( $post, $status, $parent_id );

参数​

  • $post (WP_Post) - 要复制的文章对象。
  • $status (字符串)(可选) - 应用于复制后文章对象的状态。默认为原始文章的状态。
  • $parent_id (整数)(可选) - 设置为复制后文章父级的文章 ID。默认为空字符串。