Функция EDIT_COMMENT_LINK() в WordPress

Функция EDIT_COMMENT_LINK() используется для отображения ссылки на редактирование комментария с соответствующим форматированием. Это удобный инструмент, который позволяет пользователям легко изменять свои комментарии на сайте.

Использование функции

EDIT_COMMENT_LINK() использует другую функцию — get_edit_comment_link(), чтобы создать правильную ссылку на редактирование комментария.

Хуки из функции

Функция привязывается к хуку edit_comment_link, что позволяет разработчикам добавлять свои изменения в ссылку редактирования.

Возвращаемое значение

Функция ничего не возвращает (null), если пользователь не имеет прав на редактирование комментария.

Синтаксис функции

С помощью функции можно вызвать ее следующим образом:

edit_comment_link( $text, $before, $after );

Параметры

• $text (строка): Текст ссылки. По умолчанию используется текст "Edit This".
• $before (строка): Текст, который будет отображаться перед ссылкой на редактирование. По умолчанию — пустая строка.
• $after (строка): Текст, который будет отображаться после ссылки на редактирование. По умолчанию — пустая строка.

Примеры использования

Пример 1: Отображение ссылки на редактирование комментария

Чтобы отобразить ссылку на редактирование комментария, используйте следующий код в цикле комментариев в файле comments.php:

Пример 2: Изменение текста ссылки и обрамление в HTML-тег

Если вы хотите изменить текст ссылки и поместить ее в тег <p>, используйте такой код:

', '
' ); ?>

Код функции

Вот как реализована функция edit_comment_link в ядре WordPress:

function edit_comment_link( $text = null, $before = '', $after = '' ) {
$comment = get_comment();

if ( ! current_user_can( 'edit_comment', $comment->comment_ID ) ) {
    return;
}

if ( null === $text ) {
    $text = __( 'Редактировать комментарий' );
}

$link = '' . $text . '';

echo $before . apply_filters( 'edit_comment_link', $link, $comment->comment_ID, $text ) . $after;

}

Объяснение кода

1. Получение комментария: Сначала мы получаем комментарий с помощью функции get_comment().
2. Проверка прав: Далее проверяем, имеет ли текущий пользователь права на редактирование данного комментари��. Если нет — функция завершит выполнение.
3. Установка текста по умолчанию: Если текст ссылки не передан, используется значение "Редактировать комментарий".
4. Создание ссылки: Затем создается HTML-код для ссылки с классом "comment-edit-link".
5. Отображение с фильтрами: В конце обрамленный тег выводится на экран, при этом используется хук, позволяющий другим разработчикам изменять его.

Связанные функции

Если вы хотите узнать больше полезных функций, связанных с редактированием и управлением комментариями, вот некоторые из них:

• edit_bookmark_link(): Ссылка на редактирование закладок.
• edit_post_link(): Ссылка на редактирование постов.
• edit_tag_link(): Ссылка на редактирование тегов.

Заключение

Функция EDIT_COMMENT_LINK() очень полезна для администраторов и пользователей WordPress, так как она предоставляет простой способ редактирования своих комментариев. Используйте её в своих темах и плагинах, чтобы улучшить взаимодействие пользователей с вашим сайтом.