Filters Actions

Filters

duplicate_post_excludelist_filter

In some cases, you might not want Duplicate Post to copy custom fields when duplicating a post. This filter allows you to filter out such fields.

In either your custom plugin or your theme's functions.php, add the following code and filter out any custom field you don't want to be duplicated.

/** 
 * Filters out custom fields from being duplicated in addition to the defaults.
 *
 * @param array $meta_excludelist The default exclusion list, based on the “Do not copy these fields” setting, plus some other field names.
 *
 * @return array The custom fields to exclude.
 */
function my_custom_fields_filter( $meta_excludelist ) {
    // Merges the defaults array with our own array of custom fields.
    return array_merge( $meta_excludelist, [ 'my_custom_field1', 'my_custom_field2' ] );
}

add_filter( 'duplicate_post_excludelist_filter', 'my_custom_fields_filter' );

duplicate_post_meta_keys_filter

If you want to retrieve or alter custom fields' keys after excluding custom fields you don't want to be duplicated, you can use this filter.

In either your custom plugin or your theme's functions.php, add the following code and filter the meta keys.

/** 
 * Adds an additional meta key to the stack.
 *
 * @param array $meta_keys The keys of the custom fields in the original post, minus those that were previously excluded.
 *
 * @return array The custom fields.
 */
function my_custom_post_meta_keys_filter( $meta_keys ) {
    // Example: Add key my_custom_field3
    $meta_keys[] = 'my_custom_field3';

    return $meta_keys;
}

add_filter( 'duplicate_post_meta_keys_filter', 'my_custom_post_meta_keys_filter' );

duplicate_post_get_clone_post_link

If (for some reason) you need to retrieve or alter the duplicate post link for a post, you can use this filter to do so.

In either your custom plugin or your theme's functions.php, add the following code and retrieve or alter the post link

/** 
 * Add a custom argument to the clone post link.
 *
 * @param string $link The post clone link URL.
 *
 * @return string The post clone link URL with the added argument.
 */
function my_custom_get_clone_post_link( $link ) {
    // Example: Add a query argument to the link.
    return add_query_arg( 'my_arg', 'hello-world', $link );
}

add_filter( 'duplicate_post_get_clone_post_link', 'my_custom_get_clone_post_link' );

duplicate_post_clone_post_link

此过滤器与 duplicate_post_clone_post_link 模板标签结合使用，允许您操作输出链接的各个部分。

在您的自定义插件或主题的 functions.php 文件中，添加以下代码以获取或修改文章链接的 HTML。

/** 
 * 确保文章的克隆链接 HTML 始终包裹在带有自定义 CSS 的 div 中。
 *
 * @param string $link 作为 HTML 的文章克隆链接。
 *
 * @return string 作为 HTML 的文章克隆链接。
 */
function my_custom_clone_post_link( $link ) {
    return '<div class="my_custom_css">' . $link . '</div>';
}

add_filter( 'duplicate_post_clone_post_link', 'my_custom_clone_post_link' );

现在，每当您在主题中调用 duplicate_post_clone_post_link 时，输出的链接将始终被包裹在我们自定义的 div 标签中。

duplicate_post_enabled_post_types

如果（出于某些原因）你需要修改插件启用的文章类型列表，可以使用此过滤器来实现。 该过滤器在从数据库读取选项值后被调用，因此可用于覆盖设置，或启用未在选项页面显示的文章类型。

例如，在你的自定义插件或主题的 functions.php 文件中，添加以下代码以启用插件对 product 文章类型的支持：

/** 
 * 为 WooCommerce 的 "product" 文章类型启用插件，该类型默认不可用。
 *
 * @param array $enabled_post_types 插件已启用的文章类型名称数组。
 *
 * @return array 过滤后的文章类型名称数组。
 */
function my_custom_enabled_post_types( $enabled_post_types ) {
	$enabled_post_types[] = 'product';
	return $enabled_post_types;
}
add_filter('duplicate_post_enabled_post_types', 'my_custom_enabled_post_types');

Actions

duplicate_post_pre_copy

This action is called right before cloning of the post or page starts.

In either your custom plugin or your theme's functions.php, add the following code if you want to hook into this action.

/**
 * Performs some actions before copying the post.
 */
function my_custom_duplicate_post_pre_copy() {
    // Perform some actions before copying the post.
}

add_action( 'duplicate_post_pre_copy', 'my_custom_duplicate_post_pre_copy' );

duplicate_post_post_copy

This action is called right after cloning of the post or page starts.

In either your custom plugin or your theme's functions.php, add the following code if you want to hook into this action.

/**
 * Performs some actions after copying the post.
 */
function my_custom_duplicate_post_post_copy() {
    // Perform some actions after copying the post.
}

add_action( 'duplicate_post_post_copy', 'my_custom_duplicate_post_post_copy' );

dp_duplicate_post

This action is called right after the WordPress standard fields of a post, or a non-hierarchical custom type item, have been copied. Duplicate Post itself hooks some functions to this action to copy custom fields, taxonomies, attachments, comments etc.

This action has the following parameters:

• $new_post_id (int) - The newly created post's ID.
• $post (WP_Post) - The original post's object.
• $status (string) - The destination status as set by the calling method: e.g. ‘draft’ if the function has been called using the “New Draft” links. Empty otherwise.

In either your custom plugin or your theme's functions.php, add the following code if you want to hook into this action.

/**
 * Performs some actions after the WordPress standard fields of a post, or a non-hierarchical custom type item, have been copied.
 * 
 * @param int $new_post_id The newly created post's ID.
 * @param WP_Post $post The original post's object.
 * @param string $status The destination status as set by the calling method: e.g. ‘draft’ if the function has been called using the “New Draft” links. Empty otherwise.
 */
function my_custom_dp_duplicate_post( $new_post_id, $post, $status ) {
    // Perform some actions after the post has been duplicated.
}

add_action( 'dp_duplicate_post', 'my_custom_dp_duplicate_post' );

dp_duplicate_page

This action is called right after the WordPress standard fields of a page, or a non-hierarchical custom type item, have been copied. Duplicate Post itself hooks some functions to this action to copy custom fields, taxonomies, attachments, comments etc.

This action has the following parameters:

• $new_post_id (int) - The newly created post's ID.
• $post (WP_Post) - The original post's object.
• $status (string) - The destination status as set by the calling method: e.g. ‘draft’ if the function has been called using the “New Draft” links. Empty otherwise.

In either your custom plugin or your theme's functions.php, add the following code if you want to hook into this action.

/**
 * Performs some actions the WordPress standard fields of a page, or a non-hierarchical custom type item, have been copied.
 * 
 * @param int $new_post_id The newly created post's ID.
 * @param WP_Post $post The original post's object.
 * @param string $status The destination status as set by the calling method: e.g. ‘draft’ if the function has been called using the “New Draft” links. Empty otherwise.
 */
function my_custom_dp_duplicate_page( $new_post_id, $post, $status ) {
    // Perform some actions after the post has been duplicated.
}

add_action( 'dp_duplicate_page', 'my_custom_dp_duplicate_page' );