BP_REST_Reply_Endpoint::create_item( WP_REST_Request $request )
Create a reply.
Description
Parameters
- $request
-
(Required) Full details about the request.
Return
(WP_REST_Response) | WP_Error
Source
File: bp-forums/classes/class-bp-rest-reply-endpoint.php
public function create_item( $request ) { $reply = $this->prepare_reply_for_database( $request ); // Define local variable(s). $forum_id = 0; $reply_author = 0; $reply_to = 0; $reply_title = ''; $reply_content = ''; $anonymous_data = array(); /** Reply Author */ // User is anonymous. if ( bbp_is_anonymous() ) { $anonymous_args = array( 'bbp_anonymous_name' => ! empty( $request['anonymous_name'] ) ? sanitize_text_field( $request['anonymous_name'] ) : '', 'bbp_anonymous_email' => ! empty( $request['anonymous_email'] ) ? sanitize_email( $request['anonymous_email'] ) : '', 'bbp_anonymous_website' => ! empty( $request['anonymous_website'] ) ? sanitize_text_field( $request['anonymous_website'] ) : '', ); // Filter anonymous data (variable is used later). $anonymous_data = bbp_filter_anonymous_post_data( $anonymous_args ); // Anonymous data checks out, so set cookies, etc... if ( ! empty( $anonymous_data ) && is_array( $anonymous_data ) ) { bbp_set_current_anonymous_user_data( $anonymous_data ); } // User is logged in. } else { // User cannot create replies. if ( ! current_user_can( 'publish_replies' ) ) { return new WP_Error( 'bp_rest_bbp_reply_permission', __( 'Sorry, You do not have permission to reply.', 'buddyboss' ), array( 'status' => rest_authorization_required_code(), ) ); } // Reply author is current user. $reply_author = bbp_get_current_user_id(); } /** Topic ID */ // Topic id was not passed. if ( empty( $reply->bbp_topic_id ) ) { return new WP_Error( 'bp_rest_bbp_reply_topic_id', __( 'Sorry, Discussion ID is missing.', 'buddyboss' ), array( 'status' => 400, ) ); // Topic id is not a number. } elseif ( ! is_numeric( $reply->bbp_topic_id ) ) { return new WP_Error( 'bp_rest_bbp_reply_topic_id', __( 'Sorry, Discussion ID must be a number.', 'buddyboss' ), array( 'status' => 400, ) ); // Topic id might be valid. } else { // Get the topic id. $posted_topic_id = intval( $reply->bbp_topic_id ); // Topic id is a negative number. if ( 0 > $posted_topic_id ) { return new WP_Error( 'bp_rest_bbp_reply_topic_id', __( 'Sorry, Discussion ID cannot be a negative number.', 'buddyboss' ), array( 'status' => 400, ) ); // Topic does not exist. } elseif ( ! bbp_get_topic( $posted_topic_id ) ) { return new WP_Error( 'bp_rest_bbp_reply_topic_id', __( 'Sorry, Discussion does not exist.', 'buddyboss' ), array( 'status' => 400, ) ); // Use the POST'ed topic id. } else { $topic_id = $posted_topic_id; } } /** Forum ID */ // Try to use the forum id of the topic. if ( ! isset( $reply->bbp_forum_id ) && ! empty( $topic_id ) ) { $forum_id = bbp_get_topic_forum_id( $topic_id ); // Error check the POST'ed forum id. } elseif ( isset( $reply->bbp_forum_id ) ) { // Empty Forum id was passed. if ( empty( $reply->bbp_forum_id ) ) { return new WP_Error( 'bp_rest_bbp_reply_forum_id', __( 'Sorry, Forum ID is missing.', 'buddyboss' ), array( 'status' => 400, ) ); // Forum id is not a number. } elseif ( ! is_numeric( $reply->bbp_forum_id ) ) { return new WP_Error( 'bp_rest_bbp_reply_forum_id', __( 'Sorry, Forum ID must be a number.', 'buddyboss' ), array( 'status' => 400, ) ); // Forum id might be valid. } else { // Get the forum id. $posted_forum_id = intval( $reply->bbp_forum_id ); // Forum id is empty. if ( 0 === $posted_forum_id ) { return new WP_Error( 'bp_rest_bbp_topic_forum_id', __( 'Sorry, Forum ID is missing.', 'buddyboss' ), array( 'status' => 400, ) ); // Forum id is a negative number. } elseif ( 0 > $posted_forum_id ) { return new WP_Error( 'bp_rest_bbp_topic_forum_id', __( 'Sorry, Forum ID cannot be a negative number.', 'buddyboss' ), array( 'status' => 400, ) ); // Forum does not exist. } elseif ( ! bbp_get_forum( $posted_forum_id ) ) { return new WP_Error( 'bp_rest_bbp_topic_forum_id', __( 'Sorry, Forum does not exist.', 'buddyboss' ), array( 'status' => 400, ) ); // Use the POST'ed forum id. } else { $forum_id = $posted_forum_id; } } } // Forum exists. if ( ! empty( $forum_id ) ) { // Forum is a category. if ( bbp_is_forum_category( $forum_id ) ) { return new WP_Error( 'bp_rest_bbp_new_reply_forum_category', __( 'This forum is a category. No replies can be created in this forum.', 'buddyboss' ), array( 'status' => 400, ) ); // Forum is not a category. } else { // Forum is closed and user cannot access. if ( bbp_is_forum_closed( $forum_id ) && ! current_user_can( 'edit_forum', $forum_id ) ) { return new WP_Error( 'bp_rest_bbp_new_reply_forum_closed', __( 'This forum has been closed to new replies.', 'buddyboss' ), array( 'status' => 400, ) ); } /** * Added logic for group forum * Current user is part of that group or not. * We need to check manually because bbpress updating that caps only on group forum page and * in API those conditional tag will not work. */ $group_ids = bbp_get_forum_group_ids( $forum_id ); if ( ! empty( $group_ids ) ) { $is_member = false; foreach ( $group_ids as $group_id ) { if ( groups_is_user_member( get_current_user_id(), $group_id ) ) { $is_member = true; break; } } } // Forum is private and user cannot access. if ( bbp_is_forum_private( $forum_id ) ) { if ( ( empty( $group_ids ) && ! current_user_can( 'read_private_forums' ) ) || ( ! empty( $group_ids ) && ! $is_member ) ) { return new WP_Error( 'bp_rest_bbp_new_reply_forum_private', __( 'This forum is private and you do not have the capability to read or create new replies in it.', 'buddyboss' ), array( 'status' => 400, ) ); } // Forum is hidden and user cannot access. } elseif ( bbp_is_forum_hidden( $forum_id ) ) { if ( ( empty( $group_ids ) && ! current_user_can( 'read_hidden_forums' ) ) || ( ! empty( $group_ids ) && ! $is_member ) ) { return new WP_Error( 'bp_rest_bbp_new_reply_forum_hidden', __( 'This forum is hidden and you do not have the capability to read or create new replies in it.', 'buddyboss' ), array( 'status' => 400, ) ); } } } } /** Unfiltered HTML */ // Remove kses filters from title and content for capable users and if the nonce is verified. if ( current_user_can( 'unfiltered_html' ) ) { remove_filter( 'bbp_new_reply_pre_title', 'wp_filter_kses' ); remove_filter( 'bbp_new_reply_pre_content', 'bbp_encode_bad', 10 ); remove_filter( 'bbp_new_reply_pre_content', 'bbp_filter_kses', 30 ); } /** Reply Title */ if ( ! empty( $reply->bbp_reply_title ) ) { $reply_title = esc_attr( wp_strip_all_tags( $reply->bbp_reply_title ) ); } // Filter and sanitize. $reply_title = apply_filters( 'bbp_new_reply_pre_title', $reply_title ); /** Reply Content */ if ( ! empty( $reply->bbp_reply_content ) ) { $reply_content = $reply->bbp_reply_content; } // Filter and sanitize. $reply_content = apply_filters( 'bbp_new_reply_pre_content', $reply_content ); // No reply content. if ( empty( $reply_content ) && empty( $request['bbp_media'] ) && empty( $request['bbp_media_gif'] ) ) { return new WP_Error( 'bp_rest_bbp_reply_content', __( 'Sorry, Your reply cannot be empty.', 'buddyboss' ), array( 'status' => 400, ) ); } // Filter and sanitize. $reply_content = apply_filters( 'bbp_new_reply_pre_content', $reply_content ); /** Reply Flooding */ if ( ! bbp_check_for_flood( $anonymous_data, $reply_author ) ) { return new WP_Error( 'bp_rest_bbp_reply_flood', __( 'Slow down; you move too fast.', 'buddyboss' ), array( 'status' => 400, ) ); } /** Reply Duplicate */ if ( ! bbp_check_for_duplicate( array( 'post_type' => bbp_get_reply_post_type(), 'post_author' => $reply_author, 'post_content' => $reply_content, 'post_parent' => $topic_id, 'anonymous_data' => $anonymous_data, ) ) ) { return new WP_Error( 'bp_rest_bbp_reply_duplicate', __( 'Duplicate reply detected; it looks as though you\'ve already said that!', 'buddyboss' ), array( 'status' => 400, ) ); } /** Reply Blacklist */ if ( ! bbp_check_for_blacklist( $anonymous_data, $reply_author, $reply_title, $reply_content ) ) { return new WP_Error( 'bp_rest_bbp_reply_blacklist', __( 'Sorry, Your reply cannot be created at this time.', 'buddyboss' ), array( 'status' => 400, ) ); } /** Reply Status */ // Maybe put into moderation. if ( ! bbp_check_for_moderation( $anonymous_data, $reply_author, $reply_title, $reply_content ) ) { $reply_status = bbp_get_pending_status_id(); // Default. } else { $reply_status = bbp_get_public_status_id(); } /** Reply To */ // Handle Reply To of the reply; $_REQUEST for non-JS submissions. if ( isset( $reply->bbp_reply_to ) ) { $reply_to = bbp_validate_reply_to( $reply->bbp_reply_to ); } /** Topic Closed */ // If topic is closed, moderators can still reply. if ( bbp_is_topic_closed( $topic_id ) && ! current_user_can( 'moderate' ) ) { return new WP_Error( 'bp_rest_bbp_reply_topic_closed', __( 'Sorry, Discussion is closed.', 'buddyboss' ), array( 'status' => 400, ) ); } /** Topic Tags */ // Either replace terms. if ( bbp_allow_topic_tags() && current_user_can( 'assign_topic_tags' ) && ! empty( $reply->bbp_topic_tags ) ) { $terms = esc_attr( wp_strip_all_tags( $reply->bbp_topic_tags ) ); // ...or remove them. } elseif ( isset( $reply->bbp_topic_tags ) ) { $terms = ''; // Existing terms. } else { $terms = bbp_get_topic_tag_names( $topic_id ); } /** Additional Actions (Before Save) */ do_action( 'bbp_new_reply_pre_extras', $topic_id, $forum_id ); // Bail if errors. if ( bbp_has_errors() ) { return; } /** No Errors */ // Add the content of the form to $reply_data as an array. // Just in time manipulation of reply data before being created. $reply_data = apply_filters( 'bbp_new_reply_pre_insert', array( 'post_author' => $reply_author, 'post_title' => $reply_title, 'post_content' => $reply_content, 'post_status' => $reply_status, 'post_parent' => $topic_id, 'post_type' => bbp_get_reply_post_type(), 'comment_status' => 'closed', 'menu_order' => bbp_get_topic_reply_count( $topic_id, false ) + 1, ) ); // Insert reply. $reply_id = wp_insert_post( $reply_data ); if ( empty( $reply_id ) || is_wp_error( $reply_id ) ) { $append_error = ( ( is_wp_error( $reply_id ) && $reply_id->get_error_message() ) ? __( 'The following problem(s) have been found with your reply: ', 'buddyboss' ) . $reply_id->get_error_message() : __( 'We are facing a problem to creating a reply.', 'buddyboss' ) ); return new WP_Error( 'bp_rest_bbp_reply_error', $append_error, array( 'status' => 400, ) ); } /** Topic Tags */ // Just in time manipulation of reply terms before being edited. $terms = apply_filters( 'bbp_new_reply_pre_set_terms', $terms, $topic_id, $reply_id ); // Insert terms. $terms = wp_set_post_terms( $topic_id, $terms, bbp_get_topic_tag_tax_id(), true ); // Term error. if ( is_wp_error( $terms ) ) { return new WP_Error( 'bp_rest_bbp_reply_tags', __( 'There was a problem adding the tags to the topic.', 'buddyboss' ), array( 'status' => 400, ) ); } /** Trash Check */ // If this reply starts as trash, add it to pre_trashed_replies. // for the topic, so it is properly restored. if ( bbp_is_topic_trash( $topic_id ) || ( bbp_get_trash_status_id() === $reply_data['post_status'] ) ) { // Trash the reply. wp_trash_post( $reply_id ); // Only add to pre-trashed array if topic is trashed. if ( bbp_is_topic_trash( $topic_id ) ) { // Get pre_trashed_replies for topic. $pre_trashed_replies = (array) get_post_meta( $topic_id, '_bbp_pre_trashed_replies', true ); // Add this reply to the end of the existing replies. $pre_trashed_replies[] = $reply_id; // Update the pre_trashed_reply post meta. update_post_meta( $topic_id, '_bbp_pre_trashed_replies', $pre_trashed_replies ); } /** Spam Check */ // If reply or topic are spam, officially spam this reply. } elseif ( bbp_is_topic_spam( $topic_id ) || ( bbp_get_spam_status_id() === $reply_data['post_status'] ) ) { add_post_meta( $reply_id, '_bbp_spam_meta_status', bbp_get_public_status_id() ); // Only add to pre-spammed array if topic is spam. if ( bbp_is_topic_spam( $topic_id ) ) { // Get pre_spammed_replies for topic. $pre_spammed_replies = (array) get_post_meta( $topic_id, '_bbp_pre_spammed_replies', true ); // Add this reply to the end of the existing replies. $pre_spammed_replies[] = $reply_id; // Update the pre_spammed_replies post meta. update_post_meta( $topic_id, '_bbp_pre_spammed_replies', $pre_spammed_replies ); } } /** Update counts, etc... */ do_action( 'bbp_new_reply', $reply_id, $topic_id, $forum_id, $anonymous_data, $reply_author, false, $reply_to ); /** Additional Actions (After Save) */ do_action( 'bbp_new_reply_post_extras', $reply_id ); $reply = get_post( $reply_id ); $fields_update = $this->update_additional_fields_for_object( $reply, $request ); if ( is_wp_error( $fields_update ) ) { return $fields_update; } /** * Fires after a reply is created via the REST API. * * @param array $reply Created reply. * @param array $topic_id Reply's topic ID. * @param array $forum_id Reply's form ID. * @param WP_REST_Request $request The request sent to the API. * * @since 0.1.0 */ do_action( 'bp_rest_reply_create_item', $reply, $topic_id, $forum_id, $request ); return $this->get_item( array( 'id' => $reply_id, 'context' => 'view', ) ); }
Changelog
Version | Description |
---|---|
0.1.0 | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.