add_comment_meta:WordPress私的マニュアル

add_comment_meta

(2.9.0以降)
add_comment_meta - コメントメタ情報の値を追加する

説明

mixed add_comment_meta( int $comment_id, string $meta_key, mixed $meta_value [ , bool $unique = false ] )

コメントメタ情報の値を追加する。

パラメータ

$comment_id
コメントIDを指定。
$meta_key
コメントメタ情報のキー名を指定。
$meta_value
コメントメタ情報のキー名に対応する値を指定。
$unique
同じキー名のコメントメタ情報を追加しない場合はtrueを、必ず追加する場合はfalseを指定（省略時はfalse）。

返り値

コメントメタ情報の値を追加した場合はコメントメタ情報IDを、失敗した場合はfalseを返す。

注意

使い方は投稿情報のメタ情報を追加するadd_post_meta関数と同じ。パラメータ$uniqueにtrueを設定すると、キー名で指定したコメントメタ情報が存在する場合は登録失敗となる。

使用例

コメントIDが2014で、キー名が'judge'の値として10を追加する。
<?php $mid = add_comment_meta( 2014, 'judge', 10 ); ?>
コメントIDが2014で、キー名が'judge'の値が登録されていない場合のみ、値として10を追加する。
<?php add_comment_meta( 2014, 'judge', 10, true ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/comment.php

参考

Code Reference: add_comment_meta

お勧めコンテンツ

canvasタグを投稿したい（2013年12月27日登録）

以前「投稿内容のid属性などを保存するための対策」で取り上げたように、WordPressでは投稿に記述できるHTMLタグが制限されている。同コラムでこの制限を調整する対策を紹介しているが、3.5以降ではフィルター関数を登録して対応できるようだ。

Post-tag automaton：プラグイン作ってみました（2012年7月3日登録）

みなさんは投稿をポストする際に投稿タグを付け忘れたことはないでしょうか。このプラグインは、投稿をポストする際にタイトルと記事に投稿タグが含まれていないか調べ、含まれていた場合はその投稿タグを追加します。

Slightly troublesome permalink：プラグイン作ってみました（2012年2月9日登録）

カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。

「投稿に挿入」時のタグをちょっとカスタマイズ（2011年7月29日登録）

投稿画面において、画像をアップロードし投稿に挿入するすると、imgタグをaタグで囲んだものが挿入される（キャプションを指定した場合はタグも）。それらの画像をLightBox（JavaScriptライブラリ）で表示する場合、aタグにrel属性を追加するのだが、その作業を毎回投稿に挿入した後で行うのがちょっと面倒。というわけで、自動的にrel属性を追加するようにしてみました。

新「WordPress Events and News」ウィジェットが興味深い（2017年5月26日登録）

4.8のベータ版ですぐに新機能とわかるのが管理者ダッシュボードの新「WordPress Events and News」ウィジェット。ユーザーが指定した地域近隣で開催されるイベント情報を表示してくれるウィジェットで、この中のフォームがちょっと興味深かった。なおこの記事はWordPress 4.8 beta-2をもとにしており、以降のバージョンで変更される可能性があることをあらかじめ断っておく。