_wp_copy_post_meta( int $source_post_id, int $target_post_id, string $meta_key )

Parameters

$source_post_idint

Post ID to copy meta value(s) from.

$target_post_idint

Post ID to copy meta value(s) to.

$meta_keystring

Meta key to copy.

Uses · 3

• get_post_meta()Retrieves a post meta field for the given post ID.
• add_metadata()Adds metadata for the specified object.
• wp_slash()Adds slashes to a string or recursively adds slashes to strings within an array.

Used by · 2

• wp_restore_post_revision_meta()Restore the revisioned meta values for a post.
• wp_save_revisioned_meta_fields()Save the revisioned meta fields.

Source

View on Trac ↗View on GitHub ↗

555function _wp_copy_post_meta( $source_post_id, $target_post_id, $meta_key ) {556 557	foreach ( get_post_meta( $source_post_id, $meta_key ) as $meta_value ) {558		/**559		 * We use add_metadata() function vs add_post_meta() here560		 * to allow for a revision post target OR regular post.561		 */562		add_metadata( 'post', $target_post_id, $meta_key, wp_slash( $meta_value ) );563	}564}

History

Introduced in 6.4.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/revision.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.