Документация WordPress

wp_handle_comment_submission

Q: wp_handle_comment_submission

Функция wp_handle_comment_submission() в WordPress используется для обработки отправленных комментариев. Она принимает данные, отправленные из формы комментариев, проверяет их на корректность и возвращает результат, который можно использовать для дальнейшей обработки (например, для сохранения комментария в базе данных).

Функция wp_handle_comment_submission() в WordPress используется для обработки отправленных комментариев. Она принимает данные, отправленные из формы комментариев, проверяет их на корректность и возвращает результат, который можно использовать для дальнейшей обработки (например, для сохранения комментария в базе данных).

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

Синтаксис

wp_handle_comment_submission( $comment_data, $allow_unfiltered = false );

Аргументы:

$comment_data (массив, обязательный): Ассоциативный массив с данными комментария. Обычно это $_POST, который содержит данные, отправленные через форму комментариев.
$allow_unfiltered (логический, необязательный): Если true, позволяет администраторам отправлять комментарии без фильтрации. По умолчанию — false.

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

Успешно обработанный комментарий возвращает массив данных комментария.
Если возникает ошибка, возвращает объект WP_Error с кодом и сообщением об ошибке.

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

<?php
add_action( 'init', 'custom_handle_comment' );

function custom_handle_comment() {
    if ( $_SERVER['REQUEST_METHOD'] === 'POST' && isset( $_POST['comment'] ) ) {
        // Обработка данных формы
        $comment_data = wp_unslash( $_POST ); // Удаляем экранирование
        $allow_unfiltered = current_user_can( 'moderate_comments' );

// Обрабатываем отправленный комментарий
        $result = wp_handle_comment_submission( $comment_data, $allow_unfiltered );

if ( is_wp_error( $result ) ) {
            // Если произошла ошибка
            wp_die( 'Ошибка: ' . $result->get_error_message(), 'Ошибка', array( 'response' => 400 ) );
        } else {
            // Если комментарий прошёл проверку
            wp_redirect( get_permalink( $result['comment_post_ID'] ) . '#comment-' . $result['comment_ID'] );
            exit;
        }
    }
}

// Пример того, как выглядит массив с данными комментария, который обрабатывается функцией:
$comment_data = array(
    'comment_post_ID' => 1,          // ID поста, к которому относится комментарий
    'comment_author'  => 'John Doe', // Имя автора
    'comment_author_email' => 'john@example.com', // Email автора
    'comment_content' => 'Это мой комментарий!', // Текст комментария
    'comment_type'    => '',         // Тип комментария (обычно пусто для стандартных комментариев)
);
?>

Другие данные:

Обработка ошибок: Если функция возвращает объект WP_Error, вы можете получить код ошибки с помощью $error->get_error_code() и сообщение с $error->get_error_message().
Разрешение на неотфильтрированные комментарии: Второй параметр $allow_unfiltered может быть полезен для администраторов, чтобы публиковать HTML в комментариях без фильтрации.
Использование хуков: Функция автоматически вызывает стандартные хуки WordPress, такие как pre_comment_approved, что упрощает интеграцию с плагинами.