comments_link()


WordPressのcomments_link()関数は、投稿やページのコメントセクションへのリンクを生成するために使用されます。この関数は、コメント数やコメントフォームへの直接リンクを表示する際に役立ちます。

構文

comments_link( string $zero = false, string $one = false, string $more = false, string $css_class = 'comments-link', string $none = false, string $before = '', string $after = '' );

引数の説明:

  • $zero (string) — コメントが0件の場合に表示するテキスト。
  • $one (string) — コメントが1件の場合に表示するテキスト。
  • $more (string) — コメントが2件以上の場合に表示するテキスト。
  • $css_class (string) — リンクに適用するCSSクラス。
  • $none (string) — コメントが閉じられている場合に表示するテキスト。
  • $before (string) — リンクの前に表示するテキスト。
  • $after (string) — リンクの後に表示するテキスト。

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

この例では、投稿にコメントがある場合にコメントリンクを表示します。

<?php comments_link(); ?>

例2: カスタムテキストを使用したコメントリンク

コメント数に応じてカスタムテキストを表示する例です。

<?php comments_link('コメントはありません', '1件のコメント', '%件のコメント'); ?>

例3: CSSクラスの追加

コメントリンクにCSSクラスを追加する例です。

<?php comments_link('', '', '', 'custom-comments-link'); ?>

例4: コメントが閉じられている場合のテキスト

コメントが閉じられている場合に表示するテキストを指定します。

<?php comments_link('', '', '', '', 'コメントは閉じられています'); ?>

例5: リンクの前後にテキストを追加

コメントリンクの前後にテキストを追加する例です。

<?php comments_link('', '', '', '', '', 'コメント: ', '件'); ?>

例6: コメント数なしでリンクを表示

コメント数を表示せずにリンクのみを表示する例です。

<?php comments_link('コメントする', 'コメントする', 'コメントする'); ?>

例7: コメントリンクのスタイル変更

CSSクラスを使用してコメントリンクのスタイルを変更します。

<?php comments_link('', '', '', 'comments-style'); ?>

例8: コメントリンクの前後にHTMLタグを追加

コメントリンクの前後にHTMLタグを追加して、スタイルを調整します。

<?php comments_link('', '', '', '', '', '<div class="comments-header">', '</div>'); ?>

注意点:

  • コメントリンクを表示する前に、投稿がコメントを許可しているか確認してください。
  • カスタムテキストを使用する場合、コメント数に応じた適切なテキストを指定してください。
  • CSSクラスを使用する際は、スタイルシートに適切なスタイルを定義してください。

関連機能: