Создаем comments.php в WordPress

В этом посте о создании темы для WordPress не раскрыт процесс создания шаблона комментариев (comments.php). Сейчас наверстаем упущеное

Итак… Начать стоит с того, что заставим comments.php выводить количество комментариев для текущей записи. Делается это очень просто, с помощью функции comments_number и трех параметров:

<div id="comnum"><?php comments_number('Нет комментариев', '1 комментарий', 'Комментариев: % '); ?> для записи <?php the_title();  ?></div>

Думаю, понятно, что все три параметра – шаблон вывода инфы. В последнем, на месте «%», будет кол-во комментариев. <?php the_title(); ?> просто выводит название текущей записи.

Следующим шагом нам необходимо проверить, есть ли вообще комментарии для этой записи, если есть, то выводим их. Проверка осуществляется посредством переменной $comments. Если она есть, значит и комментарии есть.

<?php if ( $comments ) : ?>
<ol id="comlist">
<!-- выводим комментарии в цикле-->
</ol>
<?php endif; ?>

В случае, если есть хоть один комментарий, мы в цикле проходимся по всем и выводим всю необходимую информацию о каждом комментарии отдельно.

Теперь перечислю самые нужные функции, которые могут понадобиться при выводе комментов. Все они имеют говорящие названия:

• comment_ID – Выводит уникальный идентификатор комментария.
• comment_author – Выводит автора комментария (Никнейм).
• get_avatar – Выводит аватар автора.
• comment_author_IP – Выводит ип-адрес комментария.
• comment_author_email -Выводит почту автора.
• comment_author_email_link – Выводит имя автора ссылкой на его почту (mailto).
• comment_author_url – Выводит УРЛ сайта автора.
• comment_author_url_link – Выводит УРЛ автора ссылкой на этот самый УРЛ.
• comment_author_link – Выводит имя автора ссылкой на его сайт.
• comments_number – Выводит текущий номер комментария по порядку.
• comment_text – Собственно, текст комментария
• comment_date – Дата.
• comment_time – Время.

Теперь смело возвращаемся к коду выше и вписываем в него наш цикл foreach ($comments as $comment), а внутри него то, что мы хотим видеть в каждом комментарии:

<?php if ( $comments ) : ?>
<ol id="comlist">
<?php foreach ($comments as $comment) : ?>
<li id="comment-<?php comment_ID() ?>">
	Автор: <?php comment_author_link(); ?> (<?php comment_date(); ?> в <?php comment_time(); ?>) [ <?php comment_author_IP(); ?>]<br />
	Аватар: <?php echo get_avatar($comment, 32); ?><hr />
<?php comment_text(); ?>
</li>
<?php endforeach; ?>
</ol>
<?php endif; ?>

Здесь все довольно прозрачно, кроме второго параметра в get_avatar (это кол-во пикселей для аватара) и

id="comment-<?php comment_ID() ?>"

Последнее мы сделали для того, чтобы после того, как посетитель отправил свой коммент, страница перекручивалась на него (site.ru/post/#comment-434). WP делает такой редирект, если запись успешно добавлена.

А вообще, это все не обязательно, достаточно одной функции – <?php wp_list_comments();?>, которую необходимо вставить в цикл. Если не хотите тонкой настройки, используйте этй функцию между тегами <ol></ol>.

Далее мы должны вывести форму добавления комментария. Но сперва, опять же, нужна проверка. Проверка на то, разрешены ли комментарии для текущей записи. Это делается посредством условия:

<?php if ( comments_open() ) : ?>
<!-- выводим форму -->
<?php endif; ?>

Хотя нет, пока не выводим форму. Вначале сделаем еще 1 проверочку. Ведь возможен и такой вариант, что комментирование разрешено только зарегистрированным пользователям.

<?php if ( comments_open() ) : ?>
<?php if ( get_option('comment_registration') && !$user_ID ) : ?>
<p>Вы должны <a href="/wp-login.php">представиться</a> для оставления комментариев.</p>
<?php else : ?>
<!-- выводим форму -->
<?php endif; ?>

Наконец-то выводим форму. В ней должно быть еще одно условие. Точнее исключение. Ведь такие поля, как имя, емейл и сайт, мы должны выводить только не залогиненым юзерам. Эта проверка осуществляется вот так:

<?php if ( !$user_ID ) : ?>
<!-- выводим 3 поля для гостей-->
<?php endif; ?>
<!-- выводим textarea и submit для всех. -->

Настала пора объединить кусочки формы воедино. Вот как это выглядит:

<?php if ( comments_open() ) :  //Если комментирование разрешено ?>
    <?php if ( get_option( 'comment_registration' ) && !$user_ID) : //Если разрешено только для зареганных юзеров ?>
        <p>Вы должны <a href="/wp-login.php">представиться</a> для оставления комментариев.</p>
    <?php else : // Если разрешено для всех юзеров ?>
        <form action="<?php echo get_option('siteurl'); ?>/wp-comments-post.php" method="post">
        <?php if ( !$user_ID ) : //Выводим три поля для гостей ?>
            <p><input type="text" name="author" id="author" value="<?php echo $comment_author; ?>" size="22" tabindex="1" />
            <label for="author"><small>имя</small></label></p>
            <p><input type="text" name="email" id="email" value="<?php echo $comment_author_email; ?>" size="22" tabindex="2" />
            <label for="email"><small>мейл</small></label></p>
            <p><input type="text" name="url" id="url" value="<?php echo $comment_author_url; ?>" size="22" tabindex="3" />
            <label for="url">Сайт</small></label></p>
        <?php endif; // Конец Выводим три поля для гостей ?>
        <p><textarea name="comment" id="comment"></textarea></p>
        <p><input name="submit" type="submit" value="Отправить" />
        <input type="hidden" name="comment_post_ID" value="<?php echo $id; ?>" /></p>
        </form>
    <?php endif; //Конец Если разрешено для всех юзеров?>
<?php endif;  //Конец Если комментирование разрешено ?>

Готово. А вот полный код comments.php:

<div id="comnum"><?php comments_number('Нет комментариев', '1 комментарий', 'Комментариев: % '); ?> для записи <?php the_title();  ?></div>

<?php if ( $comments ) : ?>
    <ol id="comlist">
    <?php foreach ($comments as $comment) : ?>
        <li id="comment-<?php comment_ID() ?>">
        Автор: <?php comment_author_link(); ?> (<?php comment_date(); ?> в <?php comment_time(); ?>) [ <?php comment_author_IP(); ?>]<br />
        Аватар: <?php echo get_avatar($comment, 32); ?><hr />
        <?php comment_text(); ?>
        </li>
    <?php endforeach; ?>
    </ol>
<?php endif; ?>

<?php if ( comments_open() ) :  //Если комментирование разрешено ?>
    <?php if ( get_option( 'comment_registration' ) && !$user_ID) : //Если разрешено только для зареганных юзеров ?>
        <p>Вы должны <a href="/wp-login.php">представиться</a> для оставления комментариев.</p>
    <?php else : // Если разрешено для всех юзеров ?>
        <form action="<?php echo get_option('siteurl'); ?>/wp-comments-post.php" method="post">
        <?php if ( !$user_ID ) : //Выводим три поля для гостей ?>
            <p><input type="text" name="author" id="author" value="<?php echo $comment_author; ?>" size="22" tabindex="1" />
            <label for="author"><small>имя</small></label></p>
            <p><input type="text" name="email" id="email" value="<?php echo $comment_author_email; ?>" size="22" tabindex="2" />
            <label for="email"><small>мейл</small></label></p>
            <p><input type="text" name="url" id="url" value="<?php echo $comment_author_url; ?>" size="22" tabindex="3" />
            <label for="url">Сайт</small></label></p>
        <?php endif; // Конец Выводим три поля для гостей ?>
        <p><textarea name="comment" id="comment"></textarea></p>
        <p><input name="submit" type="submit" value="Отправить" />
        <input type="hidden" name="comment_post_ID" value="<?php echo $id; ?>" /></p>
        </form>
    <?php endif; //Конец Если разрешено для всех юзеров?>
<?php endif;  //Конец Если комментирование разрешено ?>