Коментарі в WordPress

Коментарі це окрема сутність у структурі даних WordPress. Зв’язують коментарі із записами (постами, таблиця wp_posts ) та користувачами (таблиця wp_users ).

Структура таблиць коментарів у БД

У базі даних WordPress за коментарі відповідають дві таблиці: wp_comments та wp_commentmeta . Розберемо кожну.

wp_comments

Містить основні дані коментарів.

// $com - це об'єкт оброблюваного коментаря
wp_update_comment([
	'comment_ID' => $com->comment_ID,
	'comment_type' => "archive-$com->comment_type", // archive-question_comment
]);

wp_commentmeta

Містить додаткові дані коментаря. З коробки в цю таблицю нічого не записується, вона потрібна для розширення функціоналу коментування, щоб додати додаткові дані.

Висновок коментарів у темі

Для виведення коментарів на сторінці потрібно використовувати функцію comments_template() у тому місці, де нам потрібно показати список коментарів. Ця функція зробить запит та збере коментарі для сторінки.

Також у тему потрібно додати файл comments.php. У ньому потрібно описати висновок коментарів:

• Потрібно перевірити чи є коментарі на сторінці. Робиться це за допомогою змінної $comemnts , яка встановлюється в comments_template() – $comments = & $wp_query->commentsі доступна в цьому файлі. Також перевірити наявність коментарів на сторінці можна функцією have_comments() . Далі якщо:
  • коментарі є , потрібно використовувати функцію wp_list_comments() , щоб вивести список коментарів.
  • коментарів немає , потрібно вивести повідомлення, що їх немає.
• Потрібно вивести форму коментування. comment_form () .

Приклад файлу comments.php із теми Twenty Twenty:

<?php
/**
 * The template file for displaying the comments and comment form for the
 * Twenty Twenty theme.
 *
 * @package WordPress
 * @subpackage Twenty_Twenty
 * @since Twenty Twenty 1.0
 */

/*
 * If the current post is protected by a password and
 * the visitor has not yet entered the password we will
 * return early without loading the comments.
*/
if (post_password_required()) {
	return;
}

if ( $comments ) {
	?>

	<div class="comments" id="comments">

		<?php
		$comments_number = absint( get_comments_number() );
		?>

		<div class="comments-header section-inner small max-percentage">

			<h2 class="comment-reply-title">
				<?php
				if ( ! have_comments() ) {
					_e ( 'Leave a comment', 'twentytwenty');
				}
				elseif ( 1 === $comments_number ) {
					/* translators: %s: Post title. */
					printf( _x( 'One reply on “%s”', 'comments title', 'twentytwenty' ), get_the_title() );
				}
				else {
					printf(
					/* translators: 1: Number of comments, 2: Post title. */
						_nx(
							'%1$s reply on “%2$s”',
							'%1$s replies on “%2$s”',
							$comments_number,
							'comments title',
							'twentytwenty'
						),
						number_format_i18n( $comments_number ),
						get_the_title()
					);
				}

				?>
			</h2><!-- .comments-title -->

		</div><!-- .comments-header -->

		<div class="comments-inner section-inner thin max-percentage">

			<?php
			wp_list_comments(
				array(
					'walker' => new TwentyTwenty_Walker_Comment(),
					'avatar_size' => 120,
					'style' => 'div',
				)
			);

			$comment_pagination = paginate_comments_links(
				array(
					'echo' => false,
					'end_size' => 0,
					'mid_size' => 0,
					'next_text' => __( 'Newer Comments', 'twentytwenty' ) . '<span aria-hidden="true">→</span>',
					'prev_text' => '<span aria-hidden="true">←</span> ' . __( 'Older Comments', 'twentytwenty' ),
				)
			);

			if ( $comment_pagination ) {
				$pagination_classes = '';

				// If we're only showing the "Next" link, add a class indicating so.
				if ( false === strpos( $comment_pagination, 'prev page-numbers' ) ) {
					$pagination_classes = 'only-next';
				}
				?>

				<nav class="comments-pagination pagination<?php echo $pagination_classes; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static output ?>" aria-label="<?php esc_attr_e( 'Comments' twentytwenty'); ?>">
					<?php echo wp_kses_post( $comment_pagination ); ?>
				</nav>

				<?php
			}
			?>

		</div><!-- .comments-inner -->

	</div><!-- comments -->

	<?php
}

if ( comments_open() || pings_open() ) {

	if ( $comments ) {
		echo '<hr class="styled-separator is-style-wide" aria-hidden="true" />';
	}

	comment_form(
		array(
			'class_form' => 'section-inner thin max-percentage',
			'title_reply_before' => '<h2 id="reply-title" class="comment-reply-title">',
			'title_reply_after' => '</h2>',
		)
	);

}
elseif (is_single()) {

	if ( $comments ) {
		echo '<hr class="styled-separator is-style-wide" aria-hidden="true" />';
	}

	?>

	<div class="comment-respond" id="respond">

		<p class="comments-closed"><?php _e( 'Comments are closed.', 'twentytwenty' ); ?></p>

	</div><!-- #respond -->

	<?php
}

Встановлення куків коментування для неавторизованих користувачів

Коли неавторизований користувач залишає коментар, WP встановлює куки, в яких зберігаються введені дані. Які куки зберігаються:

'comment_author_' . COOKIEHASH
'comment_author_email_' . COOKIEHASH
'comment_author_url_' . COOKIEHASH

// де COOKIEHASH = md5( get_site_option( 'siteurl' ) )

Зберігає ці куки функція wp_set_comment_cookies() .

За промовчанням вона повішена на хук /wp-includes/default-filters.php :

add_action( 'set_comment_cookies', 'wp_set_comment_cookies', 10, 3);

Цей хук спрацьовує коли коментар публікується через форму коментування /wp-comments-post.php :

/**
 * Perform other actions when comment cookies є set.
 *
 * @ Since 3.4.0
 * @since 4.9.6 The `$cookies_consent` parameter was added.
 *
 * @param WP_Comment $comment Comment object.
 * @param WP_User $user Comment author's user object. User не може бути.
 * @param bool $cookies_consent Коментарі автора входять до магазину cookies.
 */
do_action( 'set_comment_cookies', $comment, $user, $cookies_consent);

Використовуйте wp_get_current_commenter() , щоб отримати дані цих cookies.

Функції коментарів

Це список функцій, що часто використовуються. Повний список дивіться тут .