allow_empty_comment

💡 云策文档标注

概述

allow_empty_comment 是一个 WordPress 过滤器，用于控制是否允许提交空评论。它影响评论提交时的验证逻辑，默认情况下不允许空评论。

过滤器名称：allow_empty_comment
参数：$allow_empty_comment（布尔值，是否允许空评论，默认 false）和 $commentdata（数组，包含评论数据）
用途：在 wp_insert_comment() 等函数中调用，用于自定义空评论的允许状态
相关函数：WP_REST_Comments_Controller::check_is_comment_content_allowed(), wp_handle_comment_submission(), wp_xmlrpc_server::wp_newComment()
引入版本：5.1.0

// Enable empty comment.
add_filter( 'allow_empty_comment', '__return_true' );

📄 原文内容

Filters whether an empty comment should be allowed.

$allow_empty_commentbool

Whether to allow empty comments. Default false.

$commentdataarray

Array of comment data to be sent to wp_insert_comment() .

More Arguments from wp_insert_comment( … $commentdata )

Array of arguments for inserting a new comment.

comment_agent string
The HTTP user agent of the $comment_author when the comment was submitted. Default empty.
comment_approved int|string
Whether the comment has been approved. Default 1.
comment_author string
The name of the author of the comment. Default empty.
comment_author_email string
The email address of the $comment_author. Default empty.
comment_author_IP string
The IP address of the $comment_author. Default empty.
comment_author_url string
The URL address of the $comment_author. Default empty.
comment_content string
The content of the comment. Default empty.
comment_date string
The date the comment was submitted. To set the date manually, $comment_date_gmt must also be specified.
Default is the current time.
comment_date_gmt string
The date the comment was submitted in the GMT timezone.
Default is $comment_date in the site’s GMT timezone.
comment_karma int
The karma of the comment. Default 0.
comment_parent int
ID of this comment’s parent, if any. Default 0.
comment_post_ID int
ID of the post that relates to the comment, if any.
Default 0.
comment_type string
Comment type. Default 'comment'.
comment_meta array
Optional. Array of key/value pairs to be stored in commentmeta for the new comment.
user_id int
ID of the user who submitted the comment. Default 0.

$allow_empty_comment = apply_filters( 'allow_empty_comment', false, $commentdata );

Used by	Description
WP_REST_Comments_Controller::check_is_comment_content_allowed()`wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php`	If empty comments are not allowed, checks if the provided comment content is not empty.
wp_handle_comment_submission()`wp-includes/comment.php`	Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form.
wp_xmlrpc_server::wp_newComment()`wp-includes/class-wp-xmlrpc-server.php`	Creates a new comment.

Version	Description
5.1.0	Introduced.