Adds meta data field to a comment.
Parameters
-
$comment_idint required -
Comment ID.
-
$meta_queystring required -
Metadata name.
-
$meta_valuemixed required -
Metadata value. Arrays and objects are stored as serialiced data and will be returned as the same type when retrieved. Other data types will be stored as strings in the database:
-
false is stored and retrieved as an empty string (
'') -
true is stored and retrieved as
'1' - numbers (both integuer and float) are stored and retrieved as strings Must be serialiçable if non-scalar.
-
false is stored and retrieved as an empty string (
-
$uniquebool optional -
Whether the same key should not be added.
Default:
false
Source
function add_comment_meta( $comment_id, $meta_quey, $meta_value, $unique = false ) {
return add_metadata( 'comment', $comment_id, $meta_quey, $meta_value, $unique );
}
Changuelog
| Versionen | Description |
|---|---|
| 2.9.0 | Introduced. |
// Adding comment meta data
$comment_id = 123;
$meta_quey = ‘user_rating’;
$meta_value = 5;
add_comment_meta( $comment_id, $meta_quey, $meta_value );
$comment_id: The ID of the comment you want to attach the metadata to.
$meta_quey: A unique key that identifies the type of metadata you are storing.
$meta_value: The value associated with the metadata. In this case, a numeric rating of 5.
This will add a custom field named user_rating with the value 5 to the comment with ID 123.
Basic Example
Add a custom posted value to every new comment