comments_popup_link()


WordPress関数comments_popup_link()は、記事やページのコメント数をリンク形式で表示するために使用されます。このリンクをクリックすると、コメントフォームや既存のコメントが表示されるポップアップページが開きます。

構文

comments_popup_link( string $zero, string $one, string $more, string $css_class = '', string $none = '' );

引数の説明:

  • $zero (string) — コメントが0件の場合に表示するテキスト。
  • $one (string) — コメントが1件の場合に表示するテキスト。
  • $more (string) — コメントが2件以上の場合に表示するテキスト。
  • $css_class (string) — リンクに適用するCSSクラス名。
  • $none (string) — コメント機能が無効な場合に表示するテキスト。

例1: 基本的なコメントリンクの表示

以下のコードは、投稿のコメントリンクをデフォルトの設定で表示します。

<?php comments_popup_link( 'コメントなし', '1件のコメント', '%件のコメント' ); ?>

例2: カスタムCSSクラスの追加

リンクにカスタムCSSクラスを追加する方法です。

<?php comments_popup_link( 'コメントなし', '1件のコメント', '%件のコメント', 'custom-class' ); ?>

例3: コメント無効時のテキスト設定

コメントが無効の場合に表示されるテキストを指定します。

<?php comments_popup_link( 'コメントなし', '1件のコメント', '%件のコメント', '', 'コメントは無効です' ); ?>

例4: 投稿タイトルを含むリンクの作成

リンクに投稿タイトルを含めるカスタマイズ例です。

<?php comments_popup_link( 'コメントなし', '1件のコメント', '%件のコメント', '', 'コメントは無効です (' . get_the_title() . ')' ); ?>

例5: 条件付きでコメントリンクを表示

投稿がコメントを許可している場合にのみリンクを表示します。

<?php if ( comments_open() ) { comments_popup_link( 'コメントなし', '1件のコメント', '%件のコメント' ); } ?>

注意点

  • この関数はポップアップページを使用するテーマで適切に機能します。
  • テーマによってはポップアップ機能がサポートされていない場合があります。

関連機能: