Apuraのコメント機能カスタマイズ完全ガイド｜表示設定からフックによる拡張まで

この記事はApura v1.3.4以降を対象にしています。コード例はすべて子テーマのfunctions.php、または専用プラグインに記述する前提です。親テーマのファイルを直接編集すると、テーマ更新時に変更が失われるためご注意ください。子テーマの作り方は別記事「Apura子テーマ作成ガイド」をご覧ください。

「コメントが許可されていないのに、既存コメントは見せたい」という旧記事にも対応しています。コメントを締め切った投稿でも、すでに付いているコメントがあれば一覧は表示され、新規投稿フォームの代わりに「コメントは受け付けていません」というメッセージが出ます（この文言も後述のフックで変更できます）。

コメント見出しを件数付きにカスタマイズ

<?php
/**
 * コメント一覧の見出しを件数付きの日本語に変更する。
 *
 * @param string $title 既定の見出しHTML。
 * @param string $text  見出しテキスト。
 * @return string カスタマイズした見出しHTML。
 */
add_filter(
	'apura_comments_title',
	function ( $title, $text ) {
		$count = get_comments_number();

		$label = sprintf(
			/* translators: %s: コメント件数 */
			esc_html__( '%s件のコメント', 'apura-child' ),
			number_format_i18n( $count )
		);

		return sprintf( '<h3 class="comments__title">%s</h3>', $label );
	},
	10,
	2
);

コメント一覧のアバターサイズを変更

<?php
/**
 * コメント一覧（wp_list_comments）の引数を調整する。
 *
 * @param array $args 既定の引数。
 * @return array 調整後の引数。
 */
add_filter(
	'apura_comment_list_args',
	function ( $args ) {
		$args['avatar_size'] = 64; // アバターを64pxに拡大。
		$args['reply_text']  = esc_html__( '返信する', 'apura-child' );

		return $args;
	}
);

締め切り・承認待ちメッセージを日本語化

<?php
// コメント締め切り時のメッセージ。
add_filter(
	'apura_closed_comment_text',
	function () {
		return esc_html__( 'この投稿へのコメントは締め切りました。', 'apura-child' );
	}
);

// 承認待ちコメントの注記。
add_filter(
	'apura_comment_moderation_note',
	function () {
		return esc_html__( 'コメントは承認後に表示されます。', 'apura-child' );
	}
);

サイト全体を翻訳ファイル（.po／.mo）で日本語化している場合は、これらのフックを使わなくても翻訳が当たります。フックでの上書きは「特定の文言だけ独自の表現にしたい」「翻訳ファイルを用意せずピンポイントで変えたい」というときに便利です。

コメントナビゲーションのラベルをカスタマイズ

<?php
/**
 * コメントのページ送りラベルを変更する。
 *
 * @param array $args ナビゲーション引数。
 * @return array 調整後の引数。
 */
add_filter(
	'apura_comment_nav_args',
	function ( $args ) {
		$args['prev_text'] = esc_html__( '← 古いコメント', 'apura-child' );
		$args['next_text'] = esc_html__( '新しいコメント →', 'apura-child' );

		return $args;
	}
);

コメント投稿フォームの前に注意書きを表示

<?php
/**
 * コメント投稿フォームの直前にガイドラインを表示する。
 *
 * フォーム本体は優先度10で出力されるため、9以下を指定して前に挿入する。
 */
add_action(
	'apura_after_comments',
	function () {
		// コメントが開いている投稿でのみ表示。
		if ( ! comments_open() ) {
			return;
		}

		printf(
			'<p class="comment-guideline">%s</p>',
			esc_html__( '個人情報の記載はお控えください。コメントは承認後に公開されます。', 'apura-child' )
		);
	},
	9
);

アクションフック内でHTMLを出力するときは、必ずesc_html()やwp_kses_post()でエスケープしてください。ユーザー入力やオプション値をそのままechoすると、XSS（クロスサイトスクリプティング）の原因になります。リンクなど一部のタグを許可したい場合は、許可タグを明示できるwp_kses()が安全です。

コメント投稿欄のプレースホルダーやボタン文言を変更

<?php
/**
 * コメントフォームの既定値を調整する（WordPress本体のフィルター）。
 *
 * @param array $defaults comment_form() の既定設定。
 * @return array 調整後の設定。
 */
add_filter(
	'comment_form_defaults',
	function ( $defaults ) {
		$defaults['title_reply'] = esc_html__( 'この記事にコメントする', 'apura-child' );
		$defaults['label_submit'] = esc_html__( '送信する', 'apura-child' );

		return $defaults;
	}
);