Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren



add_post_meta ›

Seit1.5.0
Veraltetn/v
add_post_meta ( $post_id, $meta_key, $meta_value, $unique = false )
Parameter: (4)
  • (int) $post_id Post ID.
    Erforderlich: Ja
  • (string) $meta_key Metadata name.
    Erforderlich: Ja
  • (mixed) $meta_value Metadata value. Must be serializable if non-scalar.
    Erforderlich: Ja
  • (bool) $unique Optional. Whether the same key should not be added. Default false.
    Erforderlich: Nein
    Standard: false
Gibt zurück:
  • (int|false) Meta ID on success, false on failure.
Definiert in:
Codex:

Adds a meta field to the given post.

Post meta data is called "Custom Fields" on the Administration Screen.



Quellcode

function add_post_meta( $post_id, $meta_key, $meta_value, $unique = false ) {
	// Make sure meta is added to the post, not a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return add_metadata( 'post', $post_id, $meta_key, $meta_value, $unique );
}