概要
get_the_comments_navigation 関数は、WordPress のコア関数の一つで、コメントナビゲーションを取得するために使用されます。この関数は、特定の投稿に対してコメントのページネーションを構築する際に非常に便利です。
この関数を使うことがよくあるシーンは以下の通りです：
- コメントが多く投稿されるブログ記事に対して
- フォーラムやディスカッションサイトでのコメントナビゲーション
- コメントのデザインが必要なカスタムテーマ
- 特定の条件に基づいてフィルタリングされたコメント表示
- モバイルファーストデザインでのコメント管理
- ページネーションのスタイルをカスタマイズする際
- UXを向上させるためのナビゲーションを提供する場合
- コメントを非同期で読み込む場合の構造に利用すること
構文
get_the_comments_navigation( $args );
パラメータ
$args(配列): 生成するナビゲーションのカスタマイズに使用するオプションの配列。
戻り値
- 生成されたコメントナビゲーションの HTML。
関連する関数
使用可能なバージョン
get_the_comments_navigation 関数は、WordPress 4.4.0 以降で使用可能です。
コアファイルのパス
wp-includes/comment-template.php
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head |
get_the_comments_navigation 関数は特定のワードプレスバージョンで非推奨または削除されたことはありません。