Create New Item
Item Type
File
Folder
Item Name
Search file in folder and subfolders...
Are you sure want to rename?
File Manager
/
post-date
/
wp-content
/
plugins
/
bbpress
/
includes
/
topics
:
functions.php
Advanced Search
Upload
New Item
Settings
Back
Back Up
Advanced Editor
Save
<?php /** * bbPress Topic Functions * * @package bbPress * @subpackage Functions */ // Exit if accessed directly defined( 'ABSPATH' ) || exit; /** Insert ********************************************************************/ /** * A wrapper for wp_insert_post() that also includes the necessary meta values * for the topic to function properly. * * @since 2.0.0 bbPress (r3349) * * @param array $topic_data Forum post data * @param arrap $topic_meta Forum meta data */ function bbp_insert_topic( $topic_data = array(), $topic_meta = array() ) { // Parse arguments against default values $topic_data = bbp_parse_args( $topic_data, array( 'post_parent' => 0, // forum ID 'post_status' => bbp_get_public_status_id(), 'post_type' => bbp_get_topic_post_type(), 'post_author' => bbp_get_current_user_id(), 'post_password' => '', 'post_content' => '', 'post_title' => '', 'comment_status' => 'closed', 'menu_order' => 0 ), 'insert_topic' ); // Insert topic $topic_id = wp_insert_post( $topic_data, false ); // Bail if no topic was added if ( empty( $topic_id ) ) { return false; } // Parse arguments against default values $topic_meta = bbp_parse_args( $topic_meta, array( 'author_ip' => bbp_current_author_ip(), 'forum_id' => 0, 'topic_id' => $topic_id, 'voice_count' => 1, 'reply_count' => 0, 'reply_count_hidden' => 0, 'last_reply_id' => 0, 'last_active_id' => $topic_id, 'last_active_time' => get_post_field( 'post_date', $topic_id, 'db' ) ), 'insert_topic_meta' ); // Insert topic meta foreach ( $topic_meta as $meta_key => $meta_value ) { // Prefix if not prefixed if ( '_bbp_' !== substr( $meta_key, 0, 5 ) ) { $meta_key = '_bbp_' . $meta_key; } // Update the meta update_post_meta( $topic_id, $meta_key, $meta_value ); } // Update the topic and hierarchy bbp_update_topic( $topic_id, $topic_meta['forum_id'], array(), $topic_data['post_author'], false ); /** * Fires after topic has been inserted via `bbp_insert_topic`. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * @param int $topic_meta['forum_id'] The topic forum meta. */ do_action( 'bbp_insert_topic', (int) $topic_id, (int) $topic_meta['forum_id'] ); // Return topic_id return $topic_id; } /** Post Form Handlers ********************************************************/ /** * Handles the front end topic submission * * @param string $action The requested action to compare this function to */ function bbp_new_topic_handler( $action = '' ) { // Bail if action is not bbp-new-topic if ( 'bbp-new-topic' !== $action ) { return; } // Nonce check if ( ! bbp_verify_nonce_request( 'bbp-new-topic' ) ) { bbp_add_error( 'bbp_new_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Define local variable(s) $view_all = false; $forum_id = $topic_author = 0; $topic_title = $topic_content = ''; $anonymous_data = array(); $terms = array( bbp_get_topic_tag_tax_id() => array() ); /** Topic Author **********************************************************/ // User is anonymous if ( bbp_is_anonymous() ) { // Filter anonymous data (variable is used later) $anonymous_data = bbp_filter_anonymous_post_data(); // Anonymous data checks out, so set cookies, etc... bbp_set_current_anonymous_user_data( $anonymous_data ); // User is logged in } else { // User cannot create topics if ( ! current_user_can( 'publish_topics' ) ) { bbp_add_error( 'bbp_topic_permission', __( '<strong>Error</strong>: You do not have permission to create new topics.', 'bbpress' ) ); return; } // Topic author is current user $topic_author = bbp_get_current_user_id(); } // Remove kses filters from title and content for capable users and if the nonce is verified if ( current_user_can( 'unfiltered_html' ) && ! empty( $_POST['_bbp_unfiltered_html_topic'] ) && wp_create_nonce( 'bbp-unfiltered-html-topic_new' ) === $_POST['_bbp_unfiltered_html_topic'] ) { remove_filter( 'bbp_new_topic_pre_title', 'wp_filter_kses' ); remove_filter( 'bbp_new_topic_pre_content', 'bbp_encode_bad', 10 ); remove_filter( 'bbp_new_topic_pre_content', 'bbp_filter_kses', 30 ); } /** Topic Title ***********************************************************/ if ( ! empty( $_POST['bbp_topic_title'] ) ) { $topic_title = sanitize_text_field( $_POST['bbp_topic_title'] ); } // Filter and sanitize $topic_title = apply_filters( 'bbp_new_topic_pre_title', $topic_title ); // No topic title if ( empty( $topic_title ) ) { bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your topic needs a title.', 'bbpress' ) ); } // Title too long if ( bbp_is_title_too_long( $topic_title ) ) { bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your title is too long.', 'bbpress' ) ); } /** Topic Content *********************************************************/ if ( ! empty( $_POST['bbp_topic_content'] ) ) { $topic_content = $_POST['bbp_topic_content']; } // Filter and sanitize $topic_content = apply_filters( 'bbp_new_topic_pre_content', $topic_content ); // No topic content if ( empty( $topic_content ) ) { bbp_add_error( 'bbp_topic_content', __( '<strong>Error</strong>: Your topic cannot be empty.', 'bbpress' ) ); } /** Topic Forum ***********************************************************/ // Error check the POST'ed topic id if ( isset( $_POST['bbp_forum_id'] ) ) { // Empty Forum id was passed if ( empty( $_POST['bbp_forum_id'] ) ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) ); // Forum id is not a number } elseif ( ! is_numeric( $_POST['bbp_forum_id'] ) ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID must be a number.', 'bbpress' ) ); // Forum id might be valid } else { // Get the forum id $posted_forum_id = intval( $_POST['bbp_forum_id'] ); // Forum id is empty if ( 0 === $posted_forum_id ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) ); // Forum id is a negative number } elseif ( 0 > $posted_forum_id ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID cannot be a negative number.', 'bbpress' ) ); // Forum does not exist } elseif ( ! bbp_get_forum( $posted_forum_id ) ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum does not exist.', 'bbpress' ) ); // 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 ) ) { bbp_add_error( 'bbp_new_topic_forum_category', __( '<strong>Error</strong>: This forum is a category. No topics can be created in this forum.', 'bbpress' ) ); // 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 ) ) { bbp_add_error( 'bbp_new_topic_forum_closed', __( '<strong>Error</strong>: This forum has been closed to new topics.', 'bbpress' ) ); } // Forum is private and user cannot access if ( bbp_is_forum_private( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) { bbp_add_error( 'bbp_new_topic_forum_private', __( '<strong>Error</strong>: This forum is private and you do not have the capability to read or create new topics in it.', 'bbpress' ) ); // Forum is hidden and user cannot access } elseif ( bbp_is_forum_hidden( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) { bbp_add_error( 'bbp_new_topic_forum_hidden', __( '<strong>Error</strong>: This forum is hidden and you do not have the capability to read or create new topics in it.', 'bbpress' ) ); } } } /** Topic Flooding ********************************************************/ if ( ! bbp_check_for_flood( $anonymous_data, $topic_author ) ) { bbp_add_error( 'bbp_topic_flood', __( '<strong>Error</strong>: Slow down; you move too fast.', 'bbpress' ) ); } /** Topic Duplicate *******************************************************/ if ( ! bbp_check_for_duplicate( array( 'post_type' => bbp_get_topic_post_type(), 'post_author' => $topic_author, 'post_content' => $topic_content, 'anonymous_data' => $anonymous_data ) ) ) { bbp_add_error( 'bbp_topic_duplicate', __( '<strong>Error</strong>: Duplicate topic detected; it looks as though you’ve already said that.', 'bbpress' ) ); } /** Topic Bad Words *******************************************************/ if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content, true ) ) { bbp_add_error( 'bbp_topic_moderation', __( '<strong>Error</strong>: Your topic cannot be created at this time.', 'bbpress' ) ); } /** Topic Status **********************************************************/ // Get available topic statuses $topic_statuses = bbp_get_topic_statuses(); // Maybe put into moderation if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content ) ) { $topic_status = bbp_get_pending_status_id(); // Check possible topic status ID's } elseif ( ! empty( $_POST['bbp_topic_status'] ) && in_array( $_POST['bbp_topic_status'], array_keys( $topic_statuses ), true ) ) { $topic_status = sanitize_key( $_POST['bbp_topic_status'] ); // Default to published if nothing else } else { $topic_status = bbp_get_public_status_id(); } /** Topic Tags ************************************************************/ if ( bbp_allow_topic_tags() && ! empty( $_POST['bbp_topic_tags'] ) ) { // Escape tag input $terms = sanitize_text_field( $_POST['bbp_topic_tags'] ); // Explode by comma if ( strstr( $terms, ',' ) ) { $terms = explode( ',', $terms ); } // Add topic tag ID as main key $terms = array( bbp_get_topic_tag_tax_id() => $terms ); } /** Additional Actions (Before Save) **************************************/ do_action( 'bbp_new_topic_pre_extras', $forum_id ); // Bail if errors if ( bbp_has_errors() ) { return; } /** No Errors *************************************************************/ // Add the content of the form to $topic_data as an array. // Just in time manipulation of topic data before being created $topic_data = apply_filters( 'bbp_new_topic_pre_insert', array( 'post_author' => $topic_author, 'post_title' => $topic_title, 'post_content' => $topic_content, 'post_status' => $topic_status, 'post_parent' => $forum_id, 'post_type' => bbp_get_topic_post_type(), 'tax_input' => $terms, 'comment_status' => 'closed' ) ); // Insert topic $topic_id = wp_insert_post( $topic_data, true ); /** No Errors *************************************************************/ if ( ! empty( $topic_id ) && ! is_wp_error( $topic_id ) ) { /** Close Check *******************************************************/ // If the topic is closed, close it properly if ( ( get_post_field( 'post_status', $topic_id ) === bbp_get_closed_status_id() ) || ( $topic_data['post_status'] === bbp_get_closed_status_id() ) ) { // Close the topic bbp_close_topic( $topic_id ); } /** Trash Check *******************************************************/ // If the forum is trash, or the topic_status is switched to // trash, trash the topic properly if ( ( get_post_field( 'post_status', $forum_id ) === bbp_get_trash_status_id() ) || ( $topic_data['post_status'] === bbp_get_trash_status_id() ) ) { // Trash the topic wp_trash_post( $topic_id ); // Force view=all $view_all = true; } /** Spam Check ********************************************************/ // If the topic is spam, officially spam this topic if ( $topic_data['post_status'] === bbp_get_spam_status_id() ) { add_post_meta( $topic_id, '_bbp_spam_meta_status', bbp_get_public_status_id() ); // Force view=all $view_all = true; } /** Update counts, etc... *********************************************/ do_action( 'bbp_new_topic', $topic_id, $forum_id, $anonymous_data, $topic_author ); /** Additional Actions (After Save) ***********************************/ do_action( 'bbp_new_topic_post_extras', $topic_id ); /** Redirect **********************************************************/ // Redirect to $redirect_to = bbp_get_redirect_to(); // Get the topic URL $redirect_url = bbp_get_topic_permalink( $topic_id, $redirect_to ); // Add view all? if ( bbp_get_view_all() || ! empty( $view_all ) ) { // User can moderate, so redirect to topic with view all set if ( current_user_can( 'moderate', $topic_id ) ) { $redirect_url = bbp_add_view_all( $redirect_url ); // User cannot moderate, so redirect to forum } else { $redirect_url = bbp_get_forum_permalink( $forum_id ); } } // Allow to be filtered $redirect_url = apply_filters( 'bbp_new_topic_redirect_to', $redirect_url, $redirect_to, $topic_id ); /** Successful Save ***************************************************/ // Redirect back to new topic bbp_redirect( $redirect_url ); /** Errors ****************************************************************/ // WP_Error } elseif ( is_wp_error( $topic_id ) ) { bbp_add_error( 'bbp_topic_error', sprintf( __( '<strong>Error</strong>: The following problem(s) occurred: %s', 'bbpress' ), $topic_id->get_error_message() ) ); // Generic error } else { bbp_add_error( 'bbp_topic_error', __( '<strong>Error</strong>: The topic was not created.', 'bbpress' ) ); } } /** * Handles the front end edit topic submission * * @param string $action The requested action to compare this function to */ function bbp_edit_topic_handler( $action = '' ) { // Bail if action is not bbp-edit-topic if ( 'bbp-edit-topic' !== $action ) { return; } // Define local variable(s) $revisions_removed = false; $topic = $topic_id = $topic_author = $forum_id = 0; $topic_title = $topic_content = $topic_edit_reason = ''; $anonymous_data = array(); /** Topic *****************************************************************/ // Topic id was not passed if ( empty( $_POST['bbp_topic_id'] ) ) { bbp_add_error( 'bbp_edit_topic_id', __( '<strong>Error</strong>: Topic ID not found.', 'bbpress' ) ); return; // Topic id was passed } elseif ( is_numeric( $_POST['bbp_topic_id'] ) ) { $topic_id = (int) $_POST['bbp_topic_id']; $topic = bbp_get_topic( $topic_id ); } // Topic does not exist if ( empty( $topic ) ) { bbp_add_error( 'bbp_edit_topic_not_found', __( '<strong>Error</strong>: The topic you want to edit was not found.', 'bbpress' ) ); return; // Topic exists } else { // Check users ability to create new topic if ( ! bbp_is_topic_anonymous( $topic_id ) ) { // User cannot edit this topic if ( ! current_user_can( 'edit_topic', $topic_id ) ) { bbp_add_error( 'bbp_edit_topic_permission', __( '<strong>Error</strong>: You do not have permission to edit that topic.', 'bbpress' ) ); } // Set topic author $topic_author = bbp_get_topic_author_id( $topic_id ); // It is an anonymous post } else { // Filter anonymous data $anonymous_data = bbp_filter_anonymous_post_data(); } } // Nonce check if ( ! bbp_verify_nonce_request( 'bbp-edit-topic_' . $topic_id ) ) { bbp_add_error( 'bbp_edit_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Remove kses filters from title and content for capable users and if the nonce is verified if ( current_user_can( 'unfiltered_html' ) && ! empty( $_POST['_bbp_unfiltered_html_topic'] ) && ( wp_create_nonce( 'bbp-unfiltered-html-topic_' . $topic_id ) === $_POST['_bbp_unfiltered_html_topic'] ) ) { remove_filter( 'bbp_edit_topic_pre_title', 'wp_filter_kses' ); remove_filter( 'bbp_edit_topic_pre_content', 'bbp_encode_bad', 10 ); remove_filter( 'bbp_edit_topic_pre_content', 'bbp_filter_kses', 30 ); } /** Topic Forum ***********************************************************/ // Forum id was not passed if ( empty( $_POST['bbp_forum_id'] ) ) { bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) ); // Forum id was passed } elseif ( is_numeric( $_POST['bbp_forum_id'] ) ) { $forum_id = (int) $_POST['bbp_forum_id']; } // Current forum this topic is in $current_forum_id = bbp_get_topic_forum_id( $topic_id ); // Forum exists if ( ! empty( $forum_id ) && ( $forum_id !== $current_forum_id ) ) { // Forum is a category if ( bbp_is_forum_category( $forum_id ) ) { bbp_add_error( 'bbp_edit_topic_forum_category', __( '<strong>Error</strong>: This forum is a category. No topics can be created in it.', 'bbpress' ) ); // 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 ) ) { bbp_add_error( 'bbp_edit_topic_forum_closed', __( '<strong>Error</strong>: This forum has been closed to new topics.', 'bbpress' ) ); } // Forum is private and user cannot access if ( bbp_is_forum_private( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) { bbp_add_error( 'bbp_edit_topic_forum_private', __( '<strong>Error</strong>: This forum is private and you do not have the capability to read or create new topics in it.', 'bbpress' ) ); // Forum is hidden and user cannot access } elseif ( bbp_is_forum_hidden( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) { bbp_add_error( 'bbp_edit_topic_forum_hidden', __( '<strong>Error</strong>: This forum is hidden and you do not have the capability to read or create new topics in it.', 'bbpress' ) ); } } } /** Topic Title ***********************************************************/ if ( ! empty( $_POST['bbp_topic_title'] ) ) { $topic_title = sanitize_text_field( $_POST['bbp_topic_title'] ); } // Filter and sanitize $topic_title = apply_filters( 'bbp_edit_topic_pre_title', $topic_title, $topic_id ); // No topic title if ( empty( $topic_title ) ) { bbp_add_error( 'bbp_edit_topic_title', __( '<strong>Error</strong>: Your topic needs a title.', 'bbpress' ) ); } // Title too long if ( bbp_is_title_too_long( $topic_title ) ) { bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your title is too long.', 'bbpress' ) ); } /** Topic Content *********************************************************/ if ( ! empty( $_POST['bbp_topic_content'] ) ) { $topic_content = $_POST['bbp_topic_content']; } // Filter and sanitize $topic_content = apply_filters( 'bbp_edit_topic_pre_content', $topic_content, $topic_id ); // No topic content if ( empty( $topic_content ) ) { bbp_add_error( 'bbp_edit_topic_content', __( '<strong>Error</strong>: Your topic cannot be empty.', 'bbpress' ) ); } /** Topic Bad Words *******************************************************/ if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content, true ) ) { bbp_add_error( 'bbp_topic_moderation', __( '<strong>Error</strong>: Your topic cannot be edited at this time.', 'bbpress' ) ); } /** Topic Status **********************************************************/ // Get available topic statuses $topic_statuses = bbp_get_topic_statuses( $topic_id ); // Maybe put into moderation if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content ) ) { // Set post status to pending if public or closed if ( bbp_is_topic_public( $topic->ID ) ) { $topic_status = bbp_get_pending_status_id(); } // Check possible topic status ID's } elseif ( ! empty( $_POST['bbp_topic_status'] ) && in_array( $_POST['bbp_topic_status'], array_keys( $topic_statuses ), true ) ) { $topic_status = sanitize_key( $_POST['bbp_topic_status'] ); // Use existing post_status } else { $topic_status = $topic->post_status; } /** Topic Tags ************************************************************/ // Either replace terms if ( bbp_allow_topic_tags() && current_user_can( 'assign_topic_tags', $topic_id ) && ! empty( $_POST['bbp_topic_tags'] ) ) { // Escape tag input $terms = sanitize_text_field( $_POST['bbp_topic_tags'] ); // Explode by comma if ( strstr( $terms, ',' ) ) { $terms = explode( ',', $terms ); } // Add topic tag ID as main key $terms = array( bbp_get_topic_tag_tax_id() => $terms ); // ...or remove them. } elseif ( isset( $_POST['bbp_topic_tags'] ) ) { $terms = array( bbp_get_topic_tag_tax_id() => array() ); // Existing terms } else { $terms = array( bbp_get_topic_tag_tax_id() => explode( ',', bbp_get_topic_tag_names( $topic_id, ',' ) ) ); } /** Additional Actions (Before Save) **************************************/ do_action( 'bbp_edit_topic_pre_extras', $topic_id ); // Bail if errors if ( bbp_has_errors() ) { return; } /** No Errors *************************************************************/ // Add the content of the form to $topic_data as an array // Just in time manipulation of topic data before being edited $topic_data = apply_filters( 'bbp_edit_topic_pre_insert', array( 'ID' => $topic_id, 'post_title' => $topic_title, 'post_content' => $topic_content, 'post_status' => $topic_status, 'post_parent' => $forum_id, 'post_author' => $topic_author, 'post_type' => bbp_get_topic_post_type(), 'tax_input' => $terms, ) ); // Toggle revisions to avoid duplicates if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) { $revisions_removed = true; remove_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } // Insert topic $topic_id = wp_update_post( $topic_data ); // Toggle revisions back on if ( true === $revisions_removed ) { $revisions_removed = false; add_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } /** No Errors *************************************************************/ if ( ! empty( $topic_id ) && ! is_wp_error( $topic_id ) ) { // Update counts, etc... do_action( 'bbp_edit_topic', $topic_id, $forum_id, $anonymous_data, $topic_author , true /* Is edit */ ); /** Revisions *********************************************************/ // Update locks update_post_meta( $topic_id, '_edit_last', bbp_get_current_user_id() ); delete_post_meta( $topic_id, '_edit_lock' ); // Revision Reason if ( ! empty( $_POST['bbp_topic_edit_reason'] ) ) { $topic_edit_reason = sanitize_text_field( $_POST['bbp_topic_edit_reason'] ); } // Update revision log if ( ! empty( $_POST['bbp_log_topic_edit'] ) && ( "1" === $_POST['bbp_log_topic_edit'] ) ) { $revision_id = wp_save_post_revision( $topic_id ); if ( ! empty( $revision_id ) ) { bbp_update_topic_revision_log( array( 'topic_id' => $topic_id, 'revision_id' => $revision_id, 'author_id' => bbp_get_current_user_id(), 'reason' => $topic_edit_reason ) ); } } /** Move Topic ********************************************************/ // If the new forum id is not equal to the old forum id, run the // bbp_move_topic action and pass the topic's forum id as the // first arg and topic id as the second to update counts. if ( $forum_id !== $topic->post_parent ) { bbp_move_topic_handler( $topic_id, $topic->post_parent, $forum_id ); } /** Additional Actions (After Save) ***********************************/ do_action( 'bbp_edit_topic_post_extras', $topic_id ); /** Redirect **********************************************************/ // Redirect to $redirect_to = bbp_get_redirect_to(); // View all? $view_all = bbp_get_view_all( 'edit_others_replies' ); // Get the topic URL $topic_url = bbp_get_topic_permalink( $topic_id, $redirect_to ); // Add view all? if ( ! empty( $view_all ) ) { $topic_url = bbp_add_view_all( $topic_url ); } // Allow to be filtered $topic_url = apply_filters( 'bbp_edit_topic_redirect_to', $topic_url, $view_all, $redirect_to ); /** Successful Edit ***************************************************/ // Redirect back to new topic bbp_redirect( $topic_url ); /** Errors ****************************************************************/ } else { $append_error = ( is_wp_error( $topic_id ) && $topic_id->get_error_message() ) ? $topic_id->get_error_message() . ' ' : ''; bbp_add_error( 'bbp_topic_error', __( '<strong>Error</strong>: The following problem(s) have been found with your topic:' . $append_error . 'Please try again.', 'bbpress' ) ); } } /** * Handle all the extra meta stuff from posting a new topic * * @param int $topic_id Optional. Topic id * @param int $forum_id Optional. Forum id * @param array $anonymous_data Optional - if it's an anonymous post. Do not * supply if supplying $author_id. Should be * sanitized (see {@link bbp_filter_anonymous_post_data()} * @param int $author_id Author id * @param bool $is_edit Optional. Is the post being edited? Defaults to false. */ function bbp_update_topic( $topic_id = 0, $forum_id = 0, $anonymous_data = array(), $author_id = 0, $is_edit = false ) { // Validate the ID's passed from 'bbp_new_topic' action $topic_id = bbp_get_topic_id( $topic_id ); $forum_id = bbp_get_forum_id( $forum_id ); // Bail if there is no topic if ( empty( $topic_id ) ) { return; } // Check author_id if ( empty( $author_id ) ) { $author_id = bbp_get_current_user_id(); } // Forum/Topic meta (early, for use in downstream functions) bbp_update_topic_forum_id( $topic_id, $forum_id ); bbp_update_topic_topic_id( $topic_id, $topic_id ); // Get the topic types $topic_types = bbp_get_topic_types( $topic_id ); // Sticky check after 'bbp_new_topic' action so forum ID meta is set if ( ! empty( $_POST['bbp_stick_topic'] ) && in_array( $_POST['bbp_stick_topic'], array_keys( $topic_types ), true ) ) { // What's the caps? if ( current_user_can( 'moderate', $topic_id ) ) { // What's the haps? switch ( $_POST['bbp_stick_topic'] ) { // Sticky in this forum case 'stick' : bbp_stick_topic( $topic_id ); break; // Super sticky in all forums case 'super' : bbp_stick_topic( $topic_id, true ); break; // Unsticky from everywhere case 'unstick' : default : bbp_unstick_topic( $topic_id ); break; } } } // If anonymous post, store name, email, website and ip in post_meta. if ( ! empty( $anonymous_data ) ) { // Update anonymous meta data (not cookies) bbp_update_anonymous_post_author( $topic_id, $anonymous_data, bbp_get_topic_post_type() ); // Set transient for throttle check (only on new, not edit) if ( empty( $is_edit ) ) { set_transient( '_bbp_' . bbp_current_author_ip() . '_last_posted', time(), HOUR_IN_SECONDS ); } } // Handle Subscription Checkbox if ( bbp_is_subscriptions_active() && ! empty( $author_id ) ) { // Check if subscribed $subscribed = bbp_is_user_subscribed( $author_id, $topic_id ); // Check for action $subscheck = ( ! empty( $_POST['bbp_topic_subscription'] ) && ( 'bbp_subscribe' === $_POST['bbp_topic_subscription'] ) ) ? true : false; // Subscribed and unsubscribing if ( ( true === $subscribed ) && ( false === $subscheck ) ) { bbp_remove_user_subscription( $author_id, $topic_id ); // Not subscribed and subscribing } elseif ( ( false === $subscribed ) && ( true === $subscheck ) ) { bbp_add_user_subscription( $author_id, $topic_id ); } } // Update associated topic values if this is a new topic if ( empty( $is_edit ) ) { // Update poster activity time bbp_update_user_last_posted( $author_id ); // Update poster IP update_post_meta( $topic_id, '_bbp_author_ip', bbp_current_author_ip(), false ); // Last active time $last_active = get_post_field( 'post_date', $topic_id ); // Reply topic meta bbp_update_topic_last_reply_id ( $topic_id, 0 ); bbp_update_topic_last_active_id ( $topic_id, $topic_id ); bbp_update_topic_last_active_time ( $topic_id, $last_active ); bbp_update_topic_reply_count ( $topic_id, 0 ); bbp_update_topic_reply_count_hidden ( $topic_id, 0 ); bbp_update_topic_voice_count ( $topic_id ); // Walk up ancestors and do the dirty work bbp_update_topic_walker( $topic_id, $last_active, $forum_id, 0, false ); } // Bump the custom query cache wp_cache_set( 'last_changed', microtime(), 'bbpress_posts' ); } /** * Walks up the post_parent tree from the current topic_id, and updates the * meta data of forums above it. This calls several functions that all run * manual queries against the database to get their results. As such, this * function can be costly to run but is necessary to keep everything accurate. * * @since 2.0.0 bbPress (r2800) * * @param int $topic_id Topic id * @param string $last_active_time Optional. Last active time * @param int $forum_id Optional. Forum id * @param int $reply_id Optional. Reply id * @param bool $refresh Reset all the previous parameters? Defaults to true. */ function bbp_update_topic_walker( $topic_id, $last_active_time = '', $forum_id = 0, $reply_id = 0, $refresh = true ) { // Validate topic_id $topic_id = bbp_get_topic_id( $topic_id ); // Define local variable(s) $active_id = 0; // Topic was passed if ( ! empty( $topic_id ) ) { // Get the forum ID if none was passed if ( empty( $forum_id ) ) { $forum_id = bbp_get_topic_forum_id( $topic_id ); } // Set the active_id based on topic_id/reply_id $active_id = empty( $reply_id ) ? $topic_id : $reply_id; } // Get topic ancestors $ancestors = array_values( array_unique( array_merge( array( $forum_id ), (array) get_post_ancestors( $topic_id ) ) ) ); // Topic status $topic_status = get_post_status( $topic_id ); // If we want a full refresh, unset any of the possibly passed variables if ( true === $refresh ) { $forum_id = $topic_id = $reply_id = $active_id = $last_active_time = 0; $topic_status = bbp_get_public_status_id(); } // Loop through ancestors if ( ! empty( $ancestors ) ) { foreach ( $ancestors as $ancestor ) { // If ancestor is a forum, update counts if ( bbp_is_forum( $ancestor ) ) { // Get the forum $forum = bbp_get_forum( $ancestor ); // Update the forum bbp_update_forum( array( 'forum_id' => $forum->ID, 'post_parent' => $forum->post_parent, 'last_topic_id' => $topic_id, 'last_reply_id' => $reply_id, 'last_active_id' => $active_id, 'last_active_time' => $last_active_time, 'last_active_status' => $topic_status ) ); } } } } /** * Handle the moving of a topic from one forum to another. This includes walking * up the old and new branches and updating the counts. * * @since 2.0.0 bbPress (r2907) * * @param int $topic_id The topic id. * @param int $old_forum_id Old forum id. * @param int $new_forum_id New forum id. */ function bbp_move_topic_handler( $topic_id, $old_forum_id, $new_forum_id ) { // Validate parameters $topic_id = bbp_get_topic_id( $topic_id ); $old_forum_id = bbp_get_forum_id( $old_forum_id ); $new_forum_id = bbp_get_forum_id( $new_forum_id ); // Clean old and new forum caches before proceeding, to ensure subsequent // calls to forum objects are using updated data. clean_post_cache( $old_forum_id ); clean_post_cache( $new_forum_id ); // Update topic forum's ID bbp_update_topic_forum_id( $topic_id, $new_forum_id ); // Update topic post parent with the new forum ID wp_update_post( array( 'ID' => $topic_id, 'post_parent' => $new_forum_id, ) ); /** Stickies **************************************************************/ // Get forum stickies $old_stickies = bbp_get_stickies( $old_forum_id ); // Only proceed if stickies are found if ( ! empty( $old_stickies ) ) { // Define local variables $updated_stickies = array(); // Loop through stickies of forum and add misses to the updated array foreach ( (array) $old_stickies as $sticky_topic_id ) { if ( $topic_id !== $sticky_topic_id ) { $updated_stickies[] = $sticky_topic_id; } } // If stickies are different, update or delete them if ( $updated_stickies !== $old_stickies ) { // No more stickies so delete the meta if ( empty( $updated_stickies ) ) { delete_post_meta( $old_forum_id, '_bbp_sticky_topics' ); // Still stickies so update the meta } else { update_post_meta( $old_forum_id, '_bbp_sticky_topics', $updated_stickies ); } // Topic was sticky, so restick in new forum bbp_stick_topic( $topic_id ); } } /** Topic Replies *********************************************************/ // Get the topics replies $replies = bbp_get_all_child_ids( $topic_id, bbp_get_reply_post_type() ); // Update the forum_id of all replies in the topic foreach ( $replies as $reply_id ) { bbp_update_reply_forum_id( $reply_id, $new_forum_id ); } /** Old forum_id **********************************************************/ // Get topic ancestors $old_forum_ancestors = array_values( array_unique( array_merge( array( $old_forum_id ), (array) get_post_ancestors( $old_forum_id ) ) ) ); // Public counts if ( bbp_is_topic_public( $topic_id ) ) { // Update old forum counts. bbp_decrease_forum_topic_count( $old_forum_id ); // Update new forum counts. bbp_increase_forum_topic_count( $new_forum_id ); // Non-public counts } else { // Update old forum counts. bbp_decrease_forum_topic_count_hidden( $old_forum_id ); // Update new forum counts. bbp_increase_forum_topic_count_hidden( $new_forum_id ); } // Get reply counts. $public_reply_count = bbp_get_public_child_count( $topic_id, bbp_get_reply_post_type() ); $hidden_reply_count = bbp_get_non_public_child_count( $topic_id, bbp_get_reply_post_type() ); // Bump reply counts. bbp_bump_forum_reply_count( $old_forum_id, -$public_reply_count ); bbp_bump_forum_reply_count( $new_forum_id, $public_reply_count ); bbp_bump_forum_reply_count_hidden( $old_forum_id, -$hidden_reply_count ); bbp_bump_forum_reply_count_hidden( $new_forum_id, $hidden_reply_count ); // Loop through ancestors and update them if ( ! empty( $old_forum_ancestors ) ) { foreach ( $old_forum_ancestors as $ancestor ) { if ( bbp_is_forum( $ancestor ) ) { bbp_update_forum( array( 'forum_id' => $ancestor, ) ); } } } /** New forum_id **********************************************************/ // Make sure we're not walking twice if ( ! in_array( $new_forum_id, $old_forum_ancestors, true ) ) { // Get topic ancestors $new_forum_ancestors = array_values( array_unique( array_merge( array( $new_forum_id ), (array) get_post_ancestors( $new_forum_id ) ) ) ); // Make sure we're not walking twice $new_forum_ancestors = array_diff( $new_forum_ancestors, $old_forum_ancestors ); // Loop through ancestors and update them if ( ! empty( $new_forum_ancestors ) ) { foreach ( $new_forum_ancestors as $ancestor ) { if ( bbp_is_forum( $ancestor ) ) { bbp_update_forum( array( 'forum_id' => $ancestor, ) ); } } } } } /** * Merge topic handler * * Handles the front end merge topic submission * * @since 2.0.0 bbPress (r2756) * * @param string $action The requested action to compare this function to */ function bbp_merge_topic_handler( $action = '' ) { // Bail if action is not bbp-merge-topic if ( 'bbp-merge-topic' !== $action ) { return; } // Define local variable(s) $source_topic_id = $destination_topic_id = 0; $source_topic = $destination_topic = 0; $subscribers = $favoriters = $replies = array(); /** Source Topic **********************************************************/ // Topic id if ( empty( $_POST['bbp_topic_id'] ) ) { bbp_add_error( 'bbp_merge_topic_source_id', __( '<strong>Error</strong>: Topic ID not found.', 'bbpress' ) ); } else { $source_topic_id = (int) $_POST['bbp_topic_id']; } // Nonce check if ( ! bbp_verify_nonce_request( 'bbp-merge-topic_' . $source_topic_id ) ) { bbp_add_error( 'bbp_merge_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; // Source topic not found } elseif ( ! $source_topic = bbp_get_topic( $source_topic_id ) ) { bbp_add_error( 'bbp_merge_topic_source_not_found', __( '<strong>Error</strong>: The topic you want to merge was not found.', 'bbpress' ) ); return; } // Cannot edit source topic if ( ! current_user_can( 'edit_topic', $source_topic->ID ) ) { bbp_add_error( 'bbp_merge_topic_source_permission', __( '<strong>Error</strong>: You do not have permission to edit the source topic.', 'bbpress' ) ); return; } /** Destination Topic *****************************************************/ // Topic id if ( empty( $_POST['bbp_destination_topic'] ) ) { bbp_add_error( 'bbp_merge_topic_destination_id', __( '<strong>Error</strong>: Destination topic ID not found.', 'bbpress' ) ); } else { $destination_topic_id = (int) $_POST['bbp_destination_topic']; } // Destination topic not found if ( ! $destination_topic = bbp_get_topic( $destination_topic_id ) ) { bbp_add_error( 'bbp_merge_topic_destination_not_found', __( '<strong>Error</strong>: The topic you want to merge to was not found.', 'bbpress' ) ); } // Cannot edit destination topic if ( ! current_user_can( 'edit_topic', $destination_topic->ID ) ) { bbp_add_error( 'bbp_merge_topic_destination_permission', __( '<strong>Error</strong>: You do not have permission to edit the destination topic.', 'bbpress' ) ); } // Bail if errors if ( bbp_has_errors() ) { return; } /** No Errors *************************************************************/ // Update counts, etc... do_action( 'bbp_merge_topic', $destination_topic->ID, $source_topic->ID ); /** Date Check ************************************************************/ // Check if the destination topic is older than the source topic if ( strtotime( $source_topic->post_date ) < strtotime( $destination_topic->post_date ) ) { // Set destination topic post_date to 1 second before source topic $destination_post_date = date( 'Y-m-d H:i:s', strtotime( $source_topic->post_date ) - 1 ); // Update destination topic wp_update_post( array( 'ID' => $destination_topic_id, 'post_date' => $destination_post_date, 'post_date_gmt' => get_gmt_from_date( $destination_post_date ) ) ); } /** Engagements ***********************************************************/ // Get engagements from source topic $engagements = bbp_get_topic_engagements( $source_topic->ID ); // Maybe migrate engagements if ( ! empty( $engagements ) ) { foreach ( $engagements as $engager ) { bbp_add_user_engagement( $engager, $destination_topic->ID ); } } /** Subscriptions *********************************************************/ // Get subscribers from source topic $subscribers = bbp_get_subscribers( $source_topic->ID ); // Maybe migrate subscriptions if ( ! empty( $subscribers ) && ! empty( $_POST['bbp_topic_subscribers'] ) && ( '1' === $_POST['bbp_topic_subscribers'] ) ) { foreach ( $subscribers as $subscriber ) { bbp_add_user_subscription( $subscriber, $destination_topic->ID ); } } /** Favorites *************************************************************/ // Get favoriters from source topic $favoriters = bbp_get_topic_favoriters( $source_topic->ID ); // Maybe migrate favorites if ( ! empty( $favoriters ) && ! empty( $_POST['bbp_topic_favoriters'] ) && ( '1' === $_POST['bbp_topic_favoriters'] ) ) { foreach ( $favoriters as $favoriter ) { bbp_add_user_favorite( $favoriter, $destination_topic->ID ); } } /** Tags ******************************************************************/ // Get the source topic tags $source_topic_tags = wp_get_post_terms( $source_topic->ID, bbp_get_topic_tag_tax_id(), array( 'fields' => 'names' ) ); // Tags to possibly merge if ( ! empty( $source_topic_tags ) && ! is_wp_error( $source_topic_tags ) ) { // Shift the tags if told to if ( ! empty( $_POST['bbp_topic_tags'] ) && ( "1" === $_POST['bbp_topic_tags'] ) ) { wp_set_post_terms( $destination_topic->ID, $source_topic_tags, bbp_get_topic_tag_tax_id(), true ); } // Delete the tags from the source topic wp_delete_object_term_relationships( $source_topic->ID, bbp_get_topic_tag_tax_id() ); } /** Source Topic **********************************************************/ // Status bbp_open_topic( $source_topic->ID ); // Sticky bbp_unstick_topic( $source_topic->ID ); // Delete source topic's last & count meta data delete_post_meta( $source_topic->ID, '_bbp_last_reply_id' ); delete_post_meta( $source_topic->ID, '_bbp_last_active_id' ); delete_post_meta( $source_topic->ID, '_bbp_last_active_time' ); delete_post_meta( $source_topic->ID, '_bbp_voice_count' ); delete_post_meta( $source_topic->ID, '_bbp_reply_count' ); delete_post_meta( $source_topic->ID, '_bbp_reply_count_hidden' ); // Delete source topics user relationships delete_post_meta( $source_topic->ID, '_bbp_favorite' ); delete_post_meta( $source_topic->ID, '_bbp_subscription' ); delete_post_meta( $source_topic->ID, '_bbp_engagement' ); // Get the replies of the source topic $replies = (array) get_posts( array( 'post_parent' => $source_topic->ID, 'post_type' => bbp_get_reply_post_type(), 'posts_per_page' => -1, 'order' => 'ASC' ) ); // Prepend the source topic to its replies array for processing array_unshift( $replies, $source_topic ); if ( ! empty( $replies ) ) { /** Merge Replies *****************************************************/ // Change the post_parent of each reply to the destination topic id foreach ( $replies as $reply ) { // Update the reply wp_update_post( array( 'ID' => $reply->ID, 'post_title' => '', 'post_name' => false, 'post_type' => bbp_get_reply_post_type(), 'post_parent' => $destination_topic->ID, 'guid' => '' ) ); // Adjust reply meta values bbp_update_reply_topic_id( $reply->ID, $destination_topic->ID ); bbp_update_reply_forum_id( $reply->ID, bbp_get_topic_forum_id( $destination_topic->ID ) ); // Update the reply position bbp_update_reply_position( $reply->ID ); // Do additional actions per merged reply do_action( 'bbp_merged_topic_reply', $reply->ID, $destination_topic->ID ); } } /** Successful Merge ******************************************************/ // Update topic's last meta data bbp_update_topic_last_reply_id ( $destination_topic->ID ); bbp_update_topic_last_active_id ( $destination_topic->ID ); bbp_update_topic_last_active_time( $destination_topic->ID ); // Send the post parent of the source topic as it has been shifted // (possibly to a new forum) so we need to update the counts of the // old forum as well as the new one do_action( 'bbp_merged_topic', $destination_topic->ID, $source_topic->ID, $source_topic->post_parent ); // Redirect back to new topic bbp_redirect( bbp_get_topic_permalink( $destination_topic->ID ) ); } /** * Fix counts on topic merge * * When a topic is merged, update the counts of source and destination topic * and their forums. * * @since 2.0.0 bbPress (r2756) * * @param int $destination_topic_id Destination topic id * @param int $source_topic_id Source topic id * @param int $source_topic_forum_id Source topic's forum id */ function bbp_merge_topic_count( $destination_topic_id, $source_topic_id, $source_topic_forum_id ) { /** Source Topic **********************************************************/ // Forum Topic Counts bbp_update_forum_topic_count( $source_topic_forum_id ); // Forum Reply Counts bbp_update_forum_reply_count( $source_topic_forum_id ); /** Destination Topic *****************************************************/ // Topic Reply Counts bbp_update_topic_reply_count( $destination_topic_id ); // Topic Hidden Reply Counts bbp_update_topic_reply_count_hidden( $destination_topic_id ); // Topic Voice Counts bbp_update_topic_voice_count( $destination_topic_id ); do_action( 'bbp_merge_topic_count', $destination_topic_id, $source_topic_id, $source_topic_forum_id ); } /** * Split topic handler * * Handles the front end split topic submission * * @since 2.0.0 bbPress (r2756) * * @param string $action The requested action to compare this function to */ function bbp_split_topic_handler( $action = '' ) { // Bail if action is not 'bbp-split-topic' if ( 'bbp-split-topic' !== $action ) { return; } // Prevent debug notices $from_reply_id = $destination_topic_id = 0; $destination_topic_title = ''; $destination_topic = $from_reply = $source_topic = ''; $split_option = false; /** Split Reply ***********************************************************/ if ( empty( $_POST['bbp_reply_id'] ) ) { bbp_add_error( 'bbp_split_topic_reply_id', __( '<strong>Error</strong>: A reply ID is required.', 'bbpress' ) ); } else { $from_reply_id = (int) $_POST['bbp_reply_id']; } $from_reply = bbp_get_reply( $from_reply_id ); // Reply exists if ( empty( $from_reply ) ) { bbp_add_error( 'bbp_split_topic_r_not_found', __( '<strong>Error</strong>: The reply you want to split from was not found.', 'bbpress' ) ); } /** Topic to Split ********************************************************/ // Get the topic being split $source_topic = bbp_get_topic( $from_reply->post_parent ); // No topic if ( empty( $source_topic ) ) { bbp_add_error( 'bbp_split_topic_source_not_found', __( '<strong>Error</strong>: The topic you want to split was not found.', 'bbpress' ) ); } // Nonce check failed if ( ! bbp_verify_nonce_request( 'bbp-split-topic_' . $source_topic->ID ) ) { bbp_add_error( 'bbp_split_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Use cannot edit topic if ( ! current_user_can( 'edit_topic', $source_topic->ID ) ) { bbp_add_error( 'bbp_split_topic_source_permission', __( '<strong>Error</strong>: You do not have permission to edit the source topic.', 'bbpress' ) ); } // How to Split if ( ! empty( $_POST['bbp_topic_split_option'] ) ) { $split_option = sanitize_key( $_POST['bbp_topic_split_option'] ); } // Invalid split option if ( empty( $split_option ) || ! in_array( $split_option, array( 'existing', 'reply' ), true ) ) { bbp_add_error( 'bbp_split_topic_option', __( '<strong>Error</strong>: You need to choose a valid split option.', 'bbpress' ) ); // Valid Split Option } else { // What kind of split switch ( $split_option ) { // Into an existing topic case 'existing' : // Get destination topic id if ( empty( $_POST['bbp_destination_topic'] ) ) { bbp_add_error( 'bbp_split_topic_destination_id', __( '<strong>Error</strong>: A topic ID is required.', 'bbpress' ) ); } else { $destination_topic_id = (int) $_POST['bbp_destination_topic']; } // Get the destination topic $destination_topic = bbp_get_topic( $destination_topic_id ); // No destination topic if ( empty( $destination_topic ) ) { bbp_add_error( 'bbp_split_topic_destination_not_found', __( '<strong>Error</strong>: The topic you want to split to was not found.', 'bbpress' ) ); } // User cannot edit the destination topic if ( ! current_user_can( 'edit_topic', $destination_topic->ID ) ) { bbp_add_error( 'bbp_split_topic_destination_permission', __( '<strong>Error</strong>: You do not have permission to edit the destination topic.', 'bbpress' ) ); } break; // Split at reply into a new topic case 'reply' : default : // User needs to be able to publish topics if ( current_user_can( 'publish_topics' ) ) { // Use the new title that was passed if ( ! empty( $_POST['bbp_topic_split_destination_title'] ) ) { $destination_topic_title = sanitize_text_field( $_POST['bbp_topic_split_destination_title'] ); // Use the source topic title } else { $destination_topic_title = $source_topic->post_title; } // Update the topic $destination_topic_id = wp_update_post( array( 'ID' => $from_reply->ID, 'post_title' => $destination_topic_title, 'post_name' => false, 'post_type' => bbp_get_topic_post_type(), 'post_parent' => $source_topic->post_parent, 'menu_order' => 0, 'guid' => '' ) ); $destination_topic = bbp_get_topic( $destination_topic_id ); // Make sure the new topic knows its a topic bbp_update_topic_topic_id( $from_reply->ID ); // Shouldn't happen if ( false === $destination_topic_id || is_wp_error( $destination_topic_id ) || empty( $destination_topic ) ) { bbp_add_error( 'bbp_split_topic_destination_reply', __( '<strong>Error</strong>: There was a problem converting the reply into the topic. Please try again.', 'bbpress' ) ); } // User cannot publish posts } else { bbp_add_error( 'bbp_split_topic_destination_permission', __( '<strong>Error</strong>: You do not have permission to create new topics. The reply could not be converted into a topic.', 'bbpress' ) ); } break; } } // Bail if there are errors if ( bbp_has_errors() ) { return; } /** No Errors - Do the Spit ***********************************************/ // Update counts, etc... do_action( 'bbp_pre_split_topic', $from_reply->ID, $source_topic->ID, $destination_topic->ID ); /** Date Check ************************************************************/ // Check if the destination topic is older than the from reply if ( strtotime( $from_reply->post_date ) < strtotime( $destination_topic->post_date ) ) { // Set destination topic post_date to 1 second before from reply $destination_post_date = date( 'Y-m-d H:i:s', strtotime( $from_reply->post_date ) - 1 ); // Update destination topic wp_update_post( array( 'ID' => $destination_topic_id, 'post_date' => $destination_post_date, 'post_date_gmt' => get_gmt_from_date( $destination_post_date ) ) ); } /** Subscriptions *********************************************************/ // Copy the subscribers if ( ! empty( $_POST['bbp_topic_subscribers'] ) && "1" === $_POST['bbp_topic_subscribers'] && bbp_is_subscriptions_active() ) { // Get the subscribers $subscribers = bbp_get_subscribers( $source_topic->ID ); if ( ! empty( $subscribers ) ) { // Add subscribers to new topic foreach ( (array) $subscribers as $subscriber ) { bbp_add_user_subscription( $subscriber, $destination_topic->ID ); } } } /** Favorites *************************************************************/ // Copy the favoriters if told to if ( ! empty( $_POST['bbp_topic_favoriters'] ) && ( "1" === $_POST['bbp_topic_favoriters'] ) ) { // Get the favoriters $favoriters = bbp_get_topic_favoriters( $source_topic->ID ); if ( ! empty( $favoriters ) ) { // Add the favoriters to new topic foreach ( (array) $favoriters as $favoriter ) { bbp_add_user_favorite( $favoriter, $destination_topic->ID ); } } } /** Tags ******************************************************************/ // Copy the tags if told to if ( ! empty( $_POST['bbp_topic_tags'] ) && ( "1" === $_POST['bbp_topic_tags'] ) ) { // Get the source topic tags $source_topic_tags = wp_get_post_terms( $source_topic->ID, bbp_get_topic_tag_tax_id(), array( 'fields' => 'names' ) ); if ( ! empty( $source_topic_tags ) ) { wp_set_post_terms( $destination_topic->ID, $source_topic_tags, bbp_get_topic_tag_tax_id(), true ); } } /** Split Replies *********************************************************/ // get_posts() is not used because it doesn't allow us to use '>=' // comparision without a filter. $bbp_db = bbp_db(); $query = $bbp_db->prepare( "SELECT * FROM {$bbp_db->posts} WHERE {$bbp_db->posts}.post_date >= %s AND {$bbp_db->posts}.post_parent = %d AND {$bbp_db->posts}.post_type = %s ORDER BY {$bbp_db->posts}.post_date ASC", $from_reply->post_date, $source_topic->ID, bbp_get_reply_post_type() ); $replies = (array) $bbp_db->get_results( $query ); // Make sure there are replies to loop through if ( ! empty( $replies ) && ! is_wp_error( $replies ) ) { // Save reply ids $reply_ids = array(); // Change the post_parent of each reply to the destination topic id foreach ( $replies as $reply ) { // Update the reply wp_update_post( array( 'ID' => $reply->ID, 'post_title' => '', 'post_name' => false, // will be automatically generated 'post_parent' => $destination_topic->ID, 'guid' => '' ) ); // Gather reply ids $reply_ids[] = $reply->ID; // Adjust reply meta values bbp_update_reply_topic_id( $reply->ID, $destination_topic->ID ); bbp_update_reply_forum_id( $reply->ID, bbp_get_topic_forum_id( $destination_topic->ID ) ); // Adjust reply position bbp_update_reply_position( $reply->ID ); // Adjust reply to values $reply_to = bbp_get_reply_to( $reply->ID ); // Not a reply to a reply that moved over if ( ! in_array( $reply_to, $reply_ids, true ) ) { bbp_update_reply_to( $reply->ID, 0 ); } // New topic from reply can't be a reply to if ( ( $from_reply->ID === $destination_topic->ID ) && ( $from_reply->ID === $reply_to ) ) { bbp_update_reply_to( $reply->ID, 0 ); } // Do additional actions per split reply do_action( 'bbp_split_topic_reply', $reply->ID, $destination_topic->ID ); } // Remove reply to from new topic if ( $from_reply->ID === $destination_topic->ID ) { delete_post_meta( $from_reply->ID, '_bbp_reply_to' ); } // Set the last reply ID and freshness $last_reply_id = $reply->ID; $freshness = $reply->post_date; // Set the last reply ID and freshness to the from_reply } else { $last_reply_id = $from_reply->ID; $freshness = $from_reply->post_date; } // It is a new topic and we need to set some default metas to make // the topic display in bbp_has_topics() list if ( 'reply' === $split_option ) { bbp_update_topic_last_reply_id ( $destination_topic->ID, $last_reply_id ); bbp_update_topic_last_active_id ( $destination_topic->ID, $last_reply_id ); bbp_update_topic_last_active_time( $destination_topic->ID, $freshness ); } // Update source topic ID last active bbp_update_topic_last_reply_id ( $source_topic->ID ); bbp_update_topic_last_active_id ( $source_topic->ID ); bbp_update_topic_last_active_time( $source_topic->ID ); /** Successful Split ******************************************************/ // Update counts, etc... do_action( 'bbp_post_split_topic', $from_reply->ID, $source_topic->ID, $destination_topic->ID ); // Redirect back to the topic bbp_redirect( bbp_get_topic_permalink( $destination_topic->ID ) ); } /** * Fix counts on topic split * * When a topic is split, update the counts of source and destination topic * and their forums. * * @since 2.0.0 bbPress (r2756) * * @param int $from_reply_id From reply id * @param int $source_topic_id Source topic id * @param int $destination_topic_id Destination topic id */ function bbp_split_topic_count( $from_reply_id, $source_topic_id, $destination_topic_id ) { // Forum Topic Counts bbp_update_forum_topic_count( bbp_get_topic_forum_id( $destination_topic_id ) ); // Forum Reply Counts bbp_update_forum_reply_count( bbp_get_topic_forum_id( $destination_topic_id ) ); // Topic Reply Counts bbp_update_topic_reply_count( $source_topic_id ); bbp_update_topic_reply_count( $destination_topic_id ); // Topic Hidden Reply Counts bbp_update_topic_reply_count_hidden( $source_topic_id ); bbp_update_topic_reply_count_hidden( $destination_topic_id ); // Topic Voice Counts bbp_update_topic_voice_count( $source_topic_id ); bbp_update_topic_voice_count( $destination_topic_id ); do_action( 'bbp_split_topic_count', $from_reply_id, $source_topic_id, $destination_topic_id ); } /** * Handles the front end tag management (renaming, merging, destroying) * * @since 2.0.0 bbPress (r2768) * * @param string $action The requested action to compare this function to */ function bbp_edit_topic_tag_handler( $action = '' ) { // Bail if required POST actions aren't passed if ( empty( $_POST['tag-id'] ) ) { return; } // Setup possible get actions $possible_actions = array( 'bbp-update-topic-tag', 'bbp-merge-topic-tag', 'bbp-delete-topic-tag' ); // Bail if actions aren't meant for this function if ( ! in_array( $action, $possible_actions, true ) ) { return; } // Setup vars $tag_id = (int) $_POST['tag-id']; $tag = get_term( $tag_id, bbp_get_topic_tag_tax_id() ); // Tag does not exist if ( is_wp_error( $tag ) && $tag->get_error_message() ) { bbp_add_error( 'bbp_manage_topic_invalid_tag', sprintf( __( '<strong>Error</strong>: The following problem(s) have been found while getting the tag: %s', 'bbpress' ), $tag->get_error_message() ) ); return; } // What action are we trying to perform? switch ( $action ) { // Update tag case 'bbp-update-topic-tag' : // Nonce check if ( ! bbp_verify_nonce_request( 'update-tag_' . $tag_id ) ) { bbp_add_error( 'bbp_manage_topic_tag_update_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Can user edit topic tags? if ( ! current_user_can( 'edit_topic_tag', $tag_id ) ) { bbp_add_error( 'bbp_manage_topic_tag_update_permission', __( '<strong>Error</strong>: You do not have permission to edit the topic tags.', 'bbpress' ) ); return; } // No tag name was provided if ( empty( $_POST['tag-name'] ) || ! $name = $_POST['tag-name'] ) { bbp_add_error( 'bbp_manage_topic_tag_update_name', __( '<strong>Error</strong>: You need to enter a tag name.', 'bbpress' ) ); return; } // Attempt to update the tag $slug = ! empty( $_POST['tag-slug'] ) ? $_POST['tag-slug'] : ''; $description = ! empty( $_POST['tag-description'] ) ? $_POST['tag-description'] : ''; $tag = wp_update_term( $tag_id, bbp_get_topic_tag_tax_id(), array( 'name' => $name, 'slug' => $slug, 'description' => $description ) ); // Cannot update tag if ( is_wp_error( $tag ) && $tag->get_error_message() ) { bbp_add_error( 'bbp_manage_topic_tag_update_error', sprintf( __( '<strong>Error</strong>: The following problem(s) have been found while updating the tag: %s', 'bbpress' ), $tag->get_error_message() ) ); return; } // Redirect $redirect = get_term_link( $tag_id, bbp_get_topic_tag_tax_id() ); // Update counts, etc... do_action( 'bbp_update_topic_tag', $tag_id, $tag, $name, $slug, $description ); break; // Merge two tags case 'bbp-merge-topic-tag' : // Nonce check if ( ! bbp_verify_nonce_request( 'merge-tag_' . $tag_id ) ) { bbp_add_error( 'bbp_manage_topic_tag_merge_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Can user edit topic tags? if ( ! current_user_can( 'edit_topic_tags' ) ) { bbp_add_error( 'bbp_manage_topic_tag_merge_permission', __( '<strong>Error</strong>: You do not have permission to edit the topic tags.', 'bbpress' ) ); return; } // No tag name was provided if ( empty( $_POST['tag-existing-name'] ) || ! $name = $_POST['tag-existing-name'] ) { bbp_add_error( 'bbp_manage_topic_tag_merge_name', __( '<strong>Error</strong>: You need to enter a tag name.', 'bbpress' ) ); return; } // If term does not exist, create it if ( ! $tag = term_exists( $name, bbp_get_topic_tag_tax_id() ) ) { $tag = wp_insert_term( $name, bbp_get_topic_tag_tax_id() ); } // Problem inserting the new term if ( is_wp_error( $tag ) && $tag->get_error_message() ) { bbp_add_error( 'bbp_manage_topic_tag_merge_error', sprintf( __( '<strong>Error</strong>: The following problem(s) have been found while merging the tags: %s', 'bbpress' ), $tag->get_error_message() ) ); return; } // Merging in to... $to_tag = $tag['term_id']; // Attempting to merge a tag into itself if ( $tag_id === $to_tag ) { bbp_add_error( 'bbp_manage_topic_tag_merge_same', __( '<strong>Error</strong>: The tags which are being merged can not be the same.', 'bbpress' ) ); return; } // Delete the old term $tag = wp_delete_term( $tag_id, bbp_get_topic_tag_tax_id(), array( 'default' => $to_tag, 'force_default' => true ) ); // Error merging the terms if ( is_wp_error( $tag ) && $tag->get_error_message() ) { bbp_add_error( 'bbp_manage_topic_tag_merge_error', sprintf( __( '<strong>Error</strong>: The following problem(s) have been found while merging the tags: %s', 'bbpress' ), $tag->get_error_message() ) ); return; } // Redirect $redirect = get_term_link( (int) $to_tag, bbp_get_topic_tag_tax_id() ); // Update counts, etc... do_action( 'bbp_merge_topic_tag', $tag_id, $to_tag, $tag ); break; // Delete tag case 'bbp-delete-topic-tag' : // Nonce check if ( ! bbp_verify_nonce_request( 'delete-tag_' . $tag_id ) ) { bbp_add_error( 'bbp_manage_topic_tag_delete_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) ); return; } // Can user delete topic tags? if ( ! current_user_can( 'delete_topic_tag', $tag_id ) ) { bbp_add_error( 'bbp_manage_topic_tag_delete_permission', __( '<strong>Error</strong>: You do not have permission to delete the topic tags.', 'bbpress' ) ); return; } // Attempt to delete term $tag = wp_delete_term( $tag_id, bbp_get_topic_tag_tax_id() ); // Error deleting term if ( is_wp_error( $tag ) && $tag->get_error_message() ) { bbp_add_error( 'bbp_manage_topic_tag_delete_error', sprintf( __( '<strong>Error</strong>: The following problem(s) have been found while deleting the tag: %s', 'bbpress' ), $tag->get_error_message() ) ); return; } // We don't have any other place to go other than home! Or we may die because of the 404 disease $redirect = bbp_get_forums_url(); // Update counts, etc... do_action( 'bbp_delete_topic_tag', $tag_id, $tag ); break; } /** Successful Moderation *************************************************/ // Redirect back $redirect = ( ! empty( $redirect ) && ! is_wp_error( $redirect ) ) ? $redirect : home_url(); bbp_redirect( $redirect ); } /** Helpers *******************************************************************/ /** * Return an associative array of available topic statuses * * @since 2.4.0 bbPress (r5059) * * @param int $topic_id Optional. Topic id. * * @return array */ function bbp_get_topic_statuses( $topic_id = 0 ) { // Filter & return return (array) apply_filters( 'bbp_get_topic_statuses', array( bbp_get_public_status_id() => _x( 'Open', 'Open the topic', 'bbpress' ), bbp_get_closed_status_id() => _x( 'Closed', 'Close the topic', 'bbpress' ), bbp_get_spam_status_id() => _x( 'Spam', 'Spam the topic', 'bbpress' ), bbp_get_trash_status_id() => _x( 'Trash', 'Trash the topic', 'bbpress' ), bbp_get_pending_status_id() => _x( 'Pending', 'Unapprove the topic', 'bbpress' ) ), $topic_id ); } /** * Return an associative array of topic sticky types * * @since 2.4.0 bbPress (r5059) * * @param int $topic_id Optional. Topic id. * * @return array */ function bbp_get_topic_types( $topic_id = 0 ) { // Filter & return return (array) apply_filters( 'bbp_get_topic_types', array( 'unstick' => _x( 'Normal', 'Unstick a topic', 'bbpress' ), 'stick' => _x( 'Sticky', 'Make topic sticky', 'bbpress' ), 'super' => _x( 'Super Sticky', 'Make topic super sticky', 'bbpress' ) ), $topic_id ); } /** * Return array of available topic toggle actions * * @since 2.6.0 bbPress (r6133) * * @param int $topic_id Optional. Topic id. * * @return array */ function bbp_get_topic_toggles( $topic_id = 0 ) { // Filter & return return (array) apply_filters( 'bbp_get_toggle_topic_actions', array( 'bbp_toggle_topic_close', 'bbp_toggle_topic_stick', 'bbp_toggle_topic_spam', 'bbp_toggle_topic_trash', 'bbp_toggle_topic_approve' ), $topic_id ); } /** * Return array of public topic statuses. * * @since 2.6.0 bbPress (r6383) * * @return array */ function bbp_get_public_topic_statuses() { $statuses = array( bbp_get_public_status_id(), bbp_get_closed_status_id() ); // Filter & return return (array) apply_filters( 'bbp_get_public_topic_statuses', $statuses ); } /** * Return array of non-public topic statuses. * * @since 2.6.0 bbPress (r6642) * * @return array */ function bbp_get_non_public_topic_statuses() { $statuses = array( bbp_get_trash_status_id(), bbp_get_spam_status_id(), bbp_get_pending_status_id() ); // Filter & return return (array) apply_filters( 'bbp_get_non_public_topic_statuses', $statuses ); } /** Stickies ******************************************************************/ /** * Return sticky topics of a forum * * @since 2.0.0 bbPress (r2592) * * @param int $forum_id Optional. If not passed, super stickies are returned. * @return array IDs of sticky topics of a forum or super stickies */ function bbp_get_stickies( $forum_id = 0 ) { // Get stickies (maybe super if empty) $stickies = empty( $forum_id ) ? bbp_get_super_stickies() : get_post_meta( $forum_id, '_bbp_sticky_topics', true ); // Cast as array $stickies = ( empty( $stickies ) || ! is_array( $stickies ) ) ? array() : wp_parse_id_list( $stickies ); // Filter & return return (array) apply_filters( 'bbp_get_stickies', $stickies, $forum_id ); } /** * Return topics stuck to front page of the forums * * @since 2.0.0 bbPress (r2592) * * @return array IDs of super sticky topics */ function bbp_get_super_stickies() { // Get super stickies $stickies = get_option( '_bbp_super_sticky_topics', array() ); // Cast as array $stickies = ( empty( $stickies ) || ! is_array( $stickies ) ) ? array() : wp_parse_id_list( $stickies ); // Filter & return return (array) apply_filters( 'bbp_get_super_stickies', $stickies ); } /** Topics Actions ************************************************************/ /** * Handles the front end opening/closing, spamming/unspamming, * sticking/unsticking and trashing/untrashing/deleting of topics * * @since 2.0.0 bbPress (r2727) * * @param string $action The requested action to compare this function to */ function bbp_toggle_topic_handler( $action = '' ) { // Bail if required GET actions aren't passed if ( empty( $_GET['topic_id'] ) ) { return; } // What's the topic id? $topic_id = bbp_get_topic_id( (int) $_GET['topic_id'] ); // Get possible topic-handler toggles $toggles = bbp_get_topic_toggles( $topic_id ); // Bail if actions aren't meant for this function if ( ! in_array( $action, $toggles, true ) ) { return; } // Make sure topic exists $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { bbp_add_error( 'bbp_toggle_topic_missing', __( '<strong>Error</strong>: This topic could not be found or no longer exists.', 'bbpress' ) ); return; } // What is the user doing here? if ( ! current_user_can( 'edit_topic', $topic_id ) || ( 'bbp_toggle_topic_trash' === $action && ! current_user_can( 'delete_topic', $topic_id ) ) ) { bbp_add_error( 'bbp_toggle_topic_permission', __( '<strong>Error</strong>: You do not have permission to do that.', 'bbpress' ) ); return; } // Sub-action? $sub_action = ! empty( $_GET['sub_action'] ) ? sanitize_key( $_GET['sub_action'] ) : false; // Preliminary array $post_data = array( 'ID' => $topic_id ); // Do the topic toggling $retval = bbp_toggle_topic( array( 'id' => $topic_id, 'action' => $action, 'sub_action' => $sub_action, 'data' => $post_data ) ); // Do additional topic toggle actions do_action( 'bbp_toggle_topic_handler', $retval['status'], $post_data, $action ); // No errors if ( ( false !== $retval['status'] ) && ! is_wp_error( $retval['status'] ) ) { bbp_redirect( $retval['redirect_to'] ); // Handle errors } else { bbp_add_error( 'bbp_toggle_topic', $retval['message'] ); } } /** * Do the actual topic toggling * * This function is used by `bbp_toggle_topic_handler()` to do the actual heavy * lifting when it comes to toggling topic. It only really makes sense to call * within that context, so if you need to call this function directly, make sure * you're also doing what the handler does too. * * @since 2.6.0 bbPress (r6133) * @access private * * @param array $args */ function bbp_toggle_topic( $args = array() ) { // Parse the arguments $r = bbp_parse_args( $args, array( 'id' => 0, 'action' => '', 'sub_action' => '', 'data' => array() ) ); // Build the nonce suffix $nonce_suffix = bbp_get_topic_post_type() . '_' . (int) $r['id']; // Default return values $retval = array( 'status' => 0, 'message' => '', 'redirect_to' => bbp_get_topic_permalink( $r['id'], bbp_get_redirect_to() ), 'view_all' => false ); // What action are we trying to perform? switch ( $r['action'] ) { // Toggle approve/unapprove case 'bbp_toggle_topic_approve' : check_ajax_referer( "approve-{$nonce_suffix}" ); $is_pending = bbp_is_topic_pending( $r['id'] ); $retval['view_all'] = ! $is_pending; // Toggle $retval['status'] = ( true === $is_pending ) ? bbp_approve_topic( $r['id'] ) : bbp_unapprove_topic( $r['id'] ); // Feedback $retval['message'] = ( true === $is_pending ) ? __( '<strong>Error</strong>: There was a problem approving the topic.', 'bbpress' ) : __( '<strong>Error</strong>: There was a problem unapproving the topic.', 'bbpress' ); break; // Toggle open/close case 'bbp_toggle_topic_close' : check_ajax_referer( "close-{$nonce_suffix}" ); $is_open = bbp_is_topic_open( $r['id'] ); // Toggle $retval['status'] = ( true === $is_open ) ? bbp_close_topic( $r['id'] ) : bbp_open_topic( $r['id'] ); // Feedback $retval['message'] = ( true === $is_open ) ? __( '<strong>Error</strong>: There was a problem closing the topic.', 'bbpress' ) : __( '<strong>Error</strong>: There was a problem opening the topic.', 'bbpress' ); break; // Toggle sticky/super-sticky/unstick case 'bbp_toggle_topic_stick' : check_ajax_referer( "stick-{$nonce_suffix}" ); $is_sticky = bbp_is_topic_sticky( $r['id'] ); $is_super = false === $is_sticky && ! empty( $_GET['super'] ) && ( "1" === $_GET['super'] ) ? true : false; // Toggle $retval['status'] = ( true === $is_sticky ) ? bbp_unstick_topic( $r['id'] ) : bbp_stick_topic( $r['id'], $is_super ); // Feedback $retval['message'] = ( true === $is_sticky ) ? __( '<strong>Error</strong>: There was a problem unsticking the topic.', 'bbpress' ) : __( '<strong>Error</strong>: There was a problem sticking the topic.', 'bbpress' ); break; // Toggle spam case 'bbp_toggle_topic_spam' : check_ajax_referer( "spam-{$nonce_suffix}" ); $is_spam = bbp_is_topic_spam( $r['id'] ); $retval['view_all'] = ! $is_spam; // Toggle $retval['status'] = ( true === $is_spam ) ? bbp_unspam_topic( $r['id'] ) : bbp_spam_topic( $r['id'] ); // Feedback $retval['message'] = ( true === $is_spam ) ? __( '<strong>Error</strong>: There was a problem unmarking the topic as spam.', 'bbpress' ) : __( '<strong>Error</strong>: There was a problem marking the topic as spam.', 'bbpress' ); break; // Toggle trash case 'bbp_toggle_topic_trash' : switch ( $r['sub_action'] ) { case 'trash': check_ajax_referer( "trash-{$nonce_suffix}" ); $retval['view_all'] = true; $retval['status'] = wp_trash_post( $r['id'] ); $retval['message'] = __( '<strong>Error</strong>: There was a problem trashing the topic.', 'bbpress' ); $retval['redirect_to'] = current_user_can( 'view_trash' ) ? bbp_get_topic_permalink( $r['id'] ) : bbp_get_forum_permalink( bbp_get_topic_forum_id( $r['id'] ) ); break; case 'untrash': check_ajax_referer( "untrash-{$nonce_suffix}" ); $retval['status'] = wp_untrash_post( $r['id'] ); $retval['message'] = __( '<strong>Error</strong>: There was a problem untrashing the topic.', 'bbpress' ); $retval['redirect_to'] = bbp_get_topic_permalink( $r['id'] ); break; case 'delete': check_ajax_referer( "delete-{$nonce_suffix}" ); $retval['status'] = wp_delete_post( $r['id'] ); $retval['message'] = __( '<strong>Error</strong>: There was a problem deleting the topic.', 'bbpress' ); $retval['redirect_to'] = bbp_get_forum_permalink( $retval['status']->post_parent ); break; } break; } // Add view all if needed if ( ! empty( $retval['view_all'] ) ) { $retval['redirect_to'] = bbp_add_view_all( $retval['redirect_to'], true ); } // Filter & return return apply_filters( 'bbp_toggle_topic', $retval, $r, $args ); } /** Favorites & Subscriptions *************************************************/ /** * Remove a deleted topic from all user favorites * * @since 2.0.0 bbPress (r2652) * * @param int $topic_id Get the topic id to remove */ function bbp_remove_topic_from_all_favorites( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); // Bail if no topic if ( empty( $topic_id ) ) { return; } // Get users $users = (array) bbp_get_topic_favoriters( $topic_id ); // Users exist if ( ! empty( $users ) ) { // Loop through users foreach ( $users as $user ) { // Remove each user bbp_remove_user_favorite( $user, $topic_id ); } } } /** * Remove a deleted topic from all user subscriptions * * @since 2.0.0 bbPress (r2652) * * @param int $topic_id Get the topic id to remove */ function bbp_remove_topic_from_all_subscriptions( $topic_id = 0 ) { // Subscriptions are not active if ( ! bbp_is_subscriptions_active() ) { return; } // Bail if no topic $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) ) { return; } // Remove all users return bbp_remove_object_from_all_users( $topic_id, '_bbp_subscription', 'post' ); } /** Count Bumpers *************************************************************/ /** * Bump the total reply count of a topic * * @since 2.1.0 bbPress (r3825) * * @param int $topic_id Optional. Topic id. * @param int $difference Optional. Default 1 * @return int Topic reply count */ function bbp_bump_topic_reply_count( $topic_id = 0, $difference = 1 ) { // Bail if no bump if ( empty( $difference ) ) { return false; } // Get counts $topic_id = bbp_get_topic_id( $topic_id ); $reply_count = bbp_get_topic_reply_count( $topic_id, true ); $difference = (int) $difference; $new_count = (int) ( $reply_count + $difference ); // Update this topic id's reply count update_post_meta( $topic_id, '_bbp_reply_count', $new_count ); // Filter & return return (int) apply_filters( 'bbp_bump_topic_reply_count', $new_count, $topic_id, $difference ); } /** * Increase the total reply count of a topic by one. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * * @return void */ function bbp_increase_topic_reply_count( $topic_id = 0 ) { // Bail early if no id is passed. if ( empty( $topic_id ) ) { return; } // If it's a reply, get the topic id. if ( bbp_is_reply( $topic_id ) ) { $reply_id = $topic_id; $topic_id = bbp_get_reply_topic_id( $reply_id ); // Update inverse based on item status if ( ! bbp_is_reply_public( $reply_id ) ) { bbp_increase_topic_reply_count_hidden( $topic_id ); return; } } // Bump up bbp_bump_topic_reply_count( $topic_id ); } /** * Decrease the total reply count of a topic by one. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * * @return void */ function bbp_decrease_topic_reply_count( $topic_id = 0 ) { // Bail early if no id is passed. if ( empty( $topic_id ) ) { return; } // If it's a reply, get the topic id. if ( bbp_is_reply( $topic_id ) ) { $reply_id = $topic_id; $topic_id = bbp_get_reply_topic_id( $reply_id ); // Update inverse based on item status if ( ! bbp_is_reply_public( $reply_id ) ) { bbp_decrease_topic_reply_count_hidden( $topic_id ); return; } } // Bump down bbp_bump_topic_reply_count( $topic_id, -1 ); } /** * Bump the total hidden reply count of a topic * * @since 2.1.0 bbPress (r3825) * * @param int $topic_id Optional. Topic id. * @param int $difference Optional. Default 1 * @return int Topic hidden reply count */ function bbp_bump_topic_reply_count_hidden( $topic_id = 0, $difference = 1 ) { // Bail if no bump if ( empty( $difference ) ) { return false; } // Get counts $topic_id = bbp_get_topic_id( $topic_id ); $reply_count = bbp_get_topic_reply_count_hidden( $topic_id, true ); $difference = (int) $difference; $new_count = (int) ( $reply_count + $difference ); // Update this topic id's hidden reply count update_post_meta( $topic_id, '_bbp_reply_count_hidden', $new_count ); // Filter & return return (int) apply_filters( 'bbp_bump_topic_reply_count_hidden', $new_count, $topic_id, $difference ); } /** * Increase the total hidden reply count of a topic by one. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * * @return void */ function bbp_increase_topic_reply_count_hidden( $topic_id = 0 ) { // Bail early if no id is passed. if ( empty( $topic_id ) ) { return; } // If it's a reply, get the topic id. if ( bbp_is_reply( $topic_id ) ) { $reply_id = $topic_id; $topic_id = bbp_get_reply_topic_id( $reply_id ); // Update inverse based on item status if ( bbp_is_reply_public( $reply_id ) ) { bbp_increase_topic_reply_count( $topic_id ); return; } } // Bump up bbp_bump_topic_reply_count_hidden( $topic_id ); } /** * Decrease the total hidden reply count of a topic by one. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * * @return void */ function bbp_decrease_topic_reply_count_hidden( $topic_id = 0 ) { // Bail early if no id is passed. if ( empty( $topic_id ) ) { return; } // If it's a reply, get the topic id. if ( bbp_is_reply( $topic_id ) ) { $reply_id = $topic_id; $topic_id = bbp_get_reply_topic_id( $reply_id ); // Update inverse based on item status if ( bbp_is_reply_public( $reply_id ) ) { bbp_decrease_topic_reply_count( $topic_id ); return; } } // Bump down bbp_bump_topic_reply_count_hidden( $topic_id, -1 ); } /** * Update counts after a topic is inserted via `bbp_insert_topic`. * * @since 2.6.0 bbPress (r6036) * * @param int $topic_id The topic id. * @param int $forum_id The forum id. * * @return void */ function bbp_insert_topic_update_counts( $topic_id = 0, $forum_id = 0 ) { // If the topic is public, update the forum topic counts. if ( bbp_is_topic_public( $topic_id ) ) { bbp_increase_forum_topic_count( $forum_id ); // If the topic isn't public only update the forum topic hidden count. } else { bbp_increase_forum_topic_count_hidden( $forum_id ); } } /** Topic Updaters ************************************************************/ /** * Update the topic's forum id * * @since 2.0.0 bbPress (r2855) * * @param int $topic_id Optional. Topic id to update * @param int $forum_id Optional. Forum id * @return int Forum id */ function bbp_update_topic_forum_id( $topic_id = 0, $forum_id = 0 ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Forum ID fallback if ( empty( $forum_id ) ) { $forum_id = get_post_field( 'post_parent', $topic_id ); } // Update the forum ID $forum_id = bbp_update_forum_id( $topic_id, $forum_id ); // Filter & return return (int) apply_filters( 'bbp_update_topic_forum_id', $forum_id, $topic_id ); } /** * Update the topic's topic id * * @since 2.0.0 bbPress (r2954) * * @param int $topic_id Optional. Topic id to update * @return int Topic id */ function bbp_update_topic_topic_id( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); $topic_id = bbp_update_topic_id( $topic_id, $topic_id ); // Filter & return return (int) apply_filters( 'bbp_update_topic_topic_id', $topic_id ); } /** * Adjust the total reply count of a topic * * @since 2.0.0 bbPress (r2467) * * @param int $topic_id Optional. Topic id to update * @param int $reply_count Optional. Set the reply count manually. * @return int Topic reply count */ function bbp_update_topic_reply_count( $topic_id = 0, $reply_count = false ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Get replies of topic if not passed $reply_count = ! is_int( $reply_count ) ? bbp_get_public_child_count( $topic_id, bbp_get_reply_post_type() ) : (int) $reply_count; update_post_meta( $topic_id, '_bbp_reply_count', $reply_count ); // Filter & return return (int) apply_filters( 'bbp_update_topic_reply_count', $reply_count, $topic_id ); } /** * Adjust the total hidden reply count of a topic (hidden includes trashed, * spammed and pending replies) * * @since 2.0.0 bbPress (r2740) * * @param int $topic_id Optional. Topic id to update * @param int $reply_count Optional. Set the reply count manually * @return int Topic hidden reply count */ function bbp_update_topic_reply_count_hidden( $topic_id = 0, $reply_count = false ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Get replies of topic $reply_count = ! is_int( $reply_count ) ? bbp_get_non_public_child_count( $topic_id, bbp_get_reply_post_type() ) : (int) $reply_count; update_post_meta( $topic_id, '_bbp_reply_count_hidden', $reply_count ); // Filter & return return (int) apply_filters( 'bbp_update_topic_reply_count_hidden', $reply_count, $topic_id ); } /** * Update the topic with the last active post ID * * @since 2.0.0 bbPress (r2888) * * @param int $topic_id Optional. Topic id to update * @param int $active_id Optional. active id * @return int Active id */ function bbp_update_topic_last_active_id( $topic_id = 0, $active_id = 0 ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Get last public active id if not passed if ( empty( $active_id ) ) { $active_id = bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() ); } // Adjust last_id's based on last_reply post_type if ( empty( $active_id ) || ! bbp_is_reply( $active_id ) ) { $active_id = $topic_id; } $active_id = (int) $active_id; // Update only if published update_post_meta( $topic_id, '_bbp_last_active_id', $active_id ); // Filter & return return (int) apply_filters( 'bbp_update_topic_last_active_id', $active_id, $topic_id ); } /** * Update the topics last active date/time (aka freshness) * * @since 2.0.0 bbPress (r2680) * * @param int $topic_id Optional. Topic id. * @param string $new_time Optional. New time in mysql format. * @return string MySQL timestamp of last active reply */ function bbp_update_topic_last_active_time( $topic_id = 0, $new_time = '' ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Check time and use current if empty if ( empty( $new_time ) ) { $new_time = get_post_field( 'post_date', bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() ) ); } // Update only if published if ( ! empty( $new_time ) ) { update_post_meta( $topic_id, '_bbp_last_active_time', $new_time ); } // Filter & return return apply_filters( 'bbp_update_topic_last_active_time', $new_time, $topic_id ); } /** * Update the topic with the most recent reply ID * * @since 2.0.0 bbPress (r2625) * * @param int $topic_id Optional. Topic id to update * @param int $reply_id Optional. Reply id * @return int Reply id */ function bbp_update_topic_last_reply_id( $topic_id = 0, $reply_id = 0 ) { // If it's a reply, then get the parent (topic id) if ( empty( $reply_id ) && bbp_is_reply( $topic_id ) ) { $reply_id = bbp_get_reply_id( $topic_id ); $topic_id = bbp_get_reply_topic_id( $reply_id ); } else { $reply_id = bbp_get_reply_id( $reply_id ); $topic_id = bbp_get_topic_id( $topic_id ); } if ( empty( $reply_id ) ) { $reply_id = bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() ); } // Adjust last_id's based on last_reply post_type if ( empty( $reply_id ) || ! bbp_is_reply( $reply_id ) ) { $reply_id = 0; } $reply_id = (int) $reply_id; // Update if reply is published update_post_meta( $topic_id, '_bbp_last_reply_id', $reply_id ); // Filter & return return (int) apply_filters( 'bbp_update_topic_last_reply_id', $reply_id, $topic_id ); } /** * Adjust the total voice count of a topic * * @since 2.0.0 bbPress (r2567) * @since 2.6.0 bbPress (r6515) This must be called after any engagement changes * * @param int $topic_id Optional. Topic id to update * @return int Voice count */ function bbp_update_topic_voice_count( $topic_id = 0 ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Bail if no topic ID if ( empty( $topic_id ) ) { return; } // Count the engagements $count = count( bbp_get_topic_engagements( $topic_id ) ); // Update the voice count for this topic id update_post_meta( $topic_id, '_bbp_voice_count', $count ); // Filter & return return (int) apply_filters( 'bbp_update_topic_voice_count', $count, $topic_id ); } /** * Adjust the total anonymous reply count of a topic * * @since 2.0.0 bbPress (r2567) * * @param int $topic_id Optional. Topic id to update * @return int Anonymous reply count */ function bbp_update_topic_anonymous_reply_count( $topic_id = 0 ) { // If it's a reply, then get the parent (topic id) $topic_id = bbp_is_reply( $topic_id ) ? bbp_get_reply_topic_id( $topic_id ) : bbp_get_topic_id( $topic_id ); // Query the DB to get anonymous replies in this topic $bbp_db = bbp_db(); $query = $bbp_db->prepare( "SELECT COUNT( ID ) FROM {$bbp_db->posts} WHERE ( post_parent = %d AND post_status = %s AND post_type = %s AND post_author = 0 ) OR ( ID = %d AND post_type = %s AND post_author = 0 )", $topic_id, bbp_get_public_status_id(), bbp_get_reply_post_type(), $topic_id, bbp_get_topic_post_type() ); $replies = (int) $bbp_db->get_var( $query ); update_post_meta( $topic_id, '_bbp_anonymous_reply_count', $replies ); // Filter & return return (int) apply_filters( 'bbp_update_topic_anonymous_reply_count', $replies, $topic_id ); } /** * Update the revision log of the topic * * @since 2.0.0 bbPress (r2782) * * @param array $args Supports these args: * - topic_id: Topic id * - author_id: Author id * - reason: Reason for editing * - revision_id: Revision id * @return mixed False on failure, true on success */ function bbp_update_topic_revision_log( $args = array() ) { // Parse arguments against default values $r = bbp_parse_args( $args, array( 'reason' => '', 'topic_id' => 0, 'author_id' => 0, 'revision_id' => 0 ), 'update_topic_revision_log' ); // Populate the variables $r['reason'] = bbp_format_revision_reason( $r['reason'] ); $r['topic_id'] = bbp_get_topic_id( $r['topic_id'] ); $r['author_id'] = bbp_get_user_id ( $r['author_id'], false, true ); $r['revision_id'] = (int) $r['revision_id']; // Get the logs and append the new one to those $revision_log = bbp_get_topic_raw_revision_log( $r['topic_id'] ); $revision_log[ $r['revision_id'] ] = array( 'author' => $r['author_id'], 'reason' => $r['reason'] ); // Finally, update return update_post_meta( $r['topic_id'], '_bbp_revision_log', $revision_log ); } /** Topic Actions *************************************************************/ /** * Closes a topic * * @since 2.0.0 bbPress (r2740) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_close_topic( $topic_id = 0 ) { // Get topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Get previous topic status meta $status = bbp_get_closed_status_id(); $topic_status = get_post_meta( $topic_id, '_bbp_status', true ); // Bail if already closed and topic status meta exists if ( $status === $topic->post_status && ! empty( $topic_status ) ) { return false; } // Set status meta public $topic_status = $topic->post_status; // Execute pre close code do_action( 'bbp_close_topic', $topic_id ); // Add pre close status add_post_meta( $topic_id, '_bbp_status', $topic_status ); // Set closed status $topic->post_status = $status; // Toggle revisions off as we are not altering content if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) { $revisions_removed = true; remove_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } // Update topic $topic_id = wp_update_post( $topic ); // Toggle revisions back on if ( true === $revisions_removed ) { $revisions_removed = false; add_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } // Execute post close code do_action( 'bbp_closed_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Opens a topic * * @since 2.0.0 bbPress (r2740) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_open_topic( $topic_id = 0 ) { // Get topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Bail if not closed if ( bbp_get_closed_status_id() !== $topic->post_status ) { return false; } // Execute pre open code do_action( 'bbp_open_topic', $topic_id ); // Get previous status $topic_status = get_post_meta( $topic_id, '_bbp_status', true ); // If no previous status, default to publish if ( empty( $topic_status ) ) { $topic_status = bbp_get_public_status_id(); } // Set previous status $topic->post_status = $topic_status; // Remove old status meta delete_post_meta( $topic_id, '_bbp_status' ); // Toggle revisions off as we are not altering content if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) { $revisions_removed = true; remove_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } // Update topic $topic_id = wp_update_post( $topic ); // Toggle revisions back on if ( true === $revisions_removed ) { $revisions_removed = false; add_post_type_support( bbp_get_topic_post_type(), 'revisions' ); } // Execute post open code do_action( 'bbp_opened_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Marks a topic as spam * * @since 2.0.0 bbPress (r2740) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_spam_topic( $topic_id = 0 ) { // Get the topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Get new status $status = bbp_get_spam_status_id(); // Bail if topic is spam if ( $status === $topic->post_status ) { return false; } // Add the original post status as post meta for future restoration add_post_meta( $topic_id, '_bbp_spam_meta_status', $topic->post_status ); // Execute pre spam code do_action( 'bbp_spam_topic', $topic_id ); // Set post status to spam $topic->post_status = $status; // Empty the topic of its tags $topic->tax_input = bbp_spam_topic_tags( $topic_id ); // No revisions remove_action( 'pre_post_update', 'wp_save_post_revision' ); // Update the topic $topic_id = wp_update_post( $topic ); // Execute post spam code do_action( 'bbp_spammed_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Trash replies to a topic when it's marked as spam * * Usually you'll want to do this before the topic itself is marked as spam. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_spam_topic_replies( $topic_id = 0 ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Topic is being spammed, so its replies are trashed $replies = new WP_Query( array( 'fields' => 'id=>parent', 'post_type' => bbp_get_reply_post_type(), 'post_status' => bbp_get_public_status_id(), 'post_parent' => $topic_id, 'posts_per_page' => -1, // Performance 'nopaging' => true, 'suppress_filters' => true, 'update_post_term_cache' => false, 'update_post_meta_cache' => false, 'ignore_sticky_posts' => true, 'no_found_rows' => true ) ); if ( ! empty( $replies->posts ) ) { // Prevent debug notices $pre_spammed_replies = array(); // Loop through replies, trash them, and add them to array foreach ( $replies->posts as $reply ) { wp_trash_post( $reply->ID ); $pre_spammed_replies[] = $reply->ID; } // Set a post_meta entry of the replies that were trashed by this action. // This is so we can possibly untrash them, without untrashing replies // that were purposefully trashed before. update_post_meta( $topic_id, '_bbp_pre_spammed_replies', $pre_spammed_replies ); // Reset the global post data after looping through the above WP_Query wp_reset_postdata(); } } /** * Store the tags to a topic in post meta before it's marked as spam so they * can be retrieved and unspammed later. * * Usually you'll want to do this before the topic itself is marked as spam. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_spam_topic_tags( $topic_id = 0 ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Get topic tags $terms = get_the_terms( $topic_id, bbp_get_topic_tag_tax_id() ); // Define local variable(s) $term_names = array(); // Topic has tags if ( ! empty( $terms ) ) { // Loop through and collect term names foreach ( $terms as $term ) { $term_names[] = $term->name; } // Topic terms have slugs if ( ! empty( $term_names ) ) { // Add the original post status as post meta for future restoration add_post_meta( $topic_id, '_bbp_spam_topic_tags', $term_names ); } } return array( bbp_get_topic_tag_tax_id() => '' ); } /** * Unspams a topic * * @since 2.0.0 bbPress (r2740) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_unspam_topic( $topic_id = 0 ) { // Get the topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Bail if already not spam if ( bbp_get_spam_status_id() !== $topic->post_status ) { return false; } // Execute pre unspam code do_action( 'bbp_unspam_topic', $topic_id ); // Get pre spam status $topic_status = get_post_meta( $topic_id, '_bbp_spam_meta_status', true ); // If no previous status, default to publish if ( empty( $topic_status ) ) { $topic_status = bbp_get_public_status_id(); } // Set post status to pre spam $topic->post_status = $topic_status; $topic->tax_input = bbp_unspam_topic_tags( $topic_id ); // Delete pre spam meta delete_post_meta( $topic_id, '_bbp_spam_meta_status' ); // No revisions remove_action( 'pre_post_update', 'wp_save_post_revision' ); // Update the topic $topic_id = wp_update_post( $topic ); // Execute post unspam code do_action( 'bbp_unspammed_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Untrash replies to a topic previously marked as spam. * * Usually you'll want to do this after the topic is unspammed. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_unspam_topic_replies( $topic_id = 0 ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Get the replies that were not previously trashed $pre_spammed_replies = get_post_meta( $topic_id, '_bbp_pre_spammed_replies', true ); // There are replies to untrash if ( ! empty( $pre_spammed_replies ) ) { // Maybe reverse the trashed replies array if ( is_array( $pre_spammed_replies ) ) { $pre_spammed_replies = array_reverse( $pre_spammed_replies ); } // Loop through replies foreach ( (array) $pre_spammed_replies as $reply ) { wp_untrash_post( $reply ); } } // Clear the trasheed reply meta for the topic delete_post_meta( $topic_id, '_bbp_pre_spammed_replies' ); } /** * Retrieve tags to a topic from post meta before it's unmarked as spam so they. * * Usually you'll want to do this before the topic itself is unmarked as spam. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_unspam_topic_tags( $topic_id = 0 ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Get pre-spam topic tags $terms = get_post_meta( $topic_id, '_bbp_spam_topic_tags', true ); // Delete pre-spam topic tag meta if ( ! empty( $terms ) ) { delete_post_meta( $topic_id, '_bbp_spam_topic_tags' ); } return array( bbp_get_topic_tag_tax_id() => $terms ); } /** * Sticks a topic to a forum or front * * @since 2.0.0 bbPress (r2754) * * @param int $topic_id Optional. Topic id * @param int $super Should we make the topic a super sticky? * @return bool True on success, false on failure */ function bbp_stick_topic( $topic_id = 0, $super = false ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Bail if a topic is not a topic (prevents revisions as stickies) if ( ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_stick_topic', $topic_id, $super ); // Maybe get the forum ID if not getting supers $forum_id = empty( $super ) ? bbp_get_topic_forum_id( $topic_id ) : 0; // Get the stickies, maybe from the forum ID $stickies = bbp_get_stickies( $forum_id ); // Add the topic to the stickies $stickies[] = $topic_id; // Pull out duplicates and empties $stickies = array_unique( array_filter( $stickies ) ); // Unset incorrectly stuck revisions foreach ( (array) $stickies as $key => $id ) { if ( ! bbp_is_topic( $id ) ) { unset( $stickies[ $key ] ); } } // Reset keys $stickies = array_values( $stickies ); // Update $success = ! empty( $super ) ? update_option( '_bbp_super_sticky_topics', $stickies ) : update_post_meta( $forum_id, '_bbp_sticky_topics', $stickies ); do_action( 'bbp_stuck_topic', $topic_id, $super, $success ); return (bool) $success; } /** * Approves a pending topic * * @since 2.6.0 bbPress (r5503) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_approve_topic( $topic_id = 0 ) { // Get topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Get new status $status = bbp_get_public_status_id(); // Bail if already approved if ( $status === $topic->post_status ) { return false; } // Execute pre pending code do_action( 'bbp_approve_topic', $topic_id ); // Set publish status $topic->post_status = $status; // Set post date GMT - prevents post_date override in wp_update_post() $topic->post_date_gmt = get_gmt_from_date( $topic->post_date ); // No revisions remove_action( 'pre_post_update', 'wp_save_post_revision' ); // Update topic $topic_id = wp_update_post( $topic ); // Execute post pending code do_action( 'bbp_approved_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Unapproves a topic * * @since 2.6.0 bbPress (r5503) * * @param int $topic_id Topic id * @return mixed False or {@link WP_Error} on failure, topic id on success */ function bbp_unapprove_topic( $topic_id = 0 ) { // Get topic $topic = bbp_get_topic( $topic_id ); if ( empty( $topic ) ) { return $topic; } // Get new status $status = bbp_get_pending_status_id(); // Bail if already unapproved if ( ! bbp_is_topic_public( $topic_id ) ) { return false; } // Execute pre open code do_action( 'bbp_unapprove_topic', $topic_id ); // Set pending status $topic->post_status = $status; // No revisions remove_action( 'pre_post_update', 'wp_save_post_revision' ); // Update topic $topic_id = wp_update_post( $topic ); // Execute post open code do_action( 'bbp_unapproved_topic', $topic_id ); // Return topic_id return $topic_id; } /** * Unsticks a topic both from front and it's forum * * @since 2.0.0 bbPress (r2754) * * @param int $topic_id Optional. Topic id * @return bool Always true. */ function bbp_unstick_topic( $topic_id = 0 ) { // Get topic sticky status $topic_id = bbp_get_topic_id( $topic_id ); $super = bbp_is_topic_super_sticky( $topic_id ); $forum_id = empty( $super ) ? bbp_get_topic_forum_id( $topic_id ) : 0; $stickies = bbp_get_stickies( $forum_id ); $offset = array_search( $topic_id, $stickies ); do_action( 'bbp_unstick_topic', $topic_id ); // Nothing to unstick if ( empty( $stickies ) ) { $success = true; // Topic not in stickies } elseif ( ! in_array( $topic_id, $stickies, true ) ) { $success = true; // Topic not in stickies } elseif ( false === $offset ) { $success = true; // Splice out the offset } else { array_splice( $stickies, $offset, 1 ); if ( empty( $stickies ) ) { $success = ! empty( $super ) ? delete_option( '_bbp_super_sticky_topics' ) : delete_post_meta( $forum_id, '_bbp_sticky_topics' ); } else { $success = ! empty( $super ) ? update_option( '_bbp_super_sticky_topics', $stickies ) : update_post_meta( $forum_id, '_bbp_sticky_topics', $stickies ); } } do_action( 'bbp_unstuck_topic', $topic_id, $success ); return (bool) $success; } /** Before Delete/Trash/Untrash ***********************************************/ /** * Called before deleting a topic. * * This function is supplemental to the actual topic deletion which is * handled by WordPress core API functions. It is used to clean up after * a topic that is being deleted. */ function bbp_delete_topic( $topic_id = 0 ) { // Validate topic ID $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_delete_topic', $topic_id ); } /** * Delete replies to a topic when it's deleted * * Usually you'll want to do this before the topic itself is deleted. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_delete_topic_replies( $topic_id = 0 ) { // Validate topic ID $topic_id = bbp_get_topic_id( $topic_id ); // Topic is being permanently deleted, so its replies gotta go too // Note that we get all post statuses here $replies = new WP_Query( array( 'fields' => 'id=>parent', 'post_type' => bbp_get_reply_post_type(), 'post_status' => array_keys( get_post_stati() ), 'post_parent' => $topic_id, 'posts_per_page' => -1, // Performance 'nopaging' => true, 'suppress_filters' => true, 'update_post_term_cache' => false, 'update_post_meta_cache' => false, 'ignore_sticky_posts' => true, 'no_found_rows' => true ) ); // Loop through and delete child replies if ( ! empty( $replies->posts ) ) { foreach ( $replies->posts as $reply ) { wp_delete_post( $reply->ID, true ); } // Reset the $post global wp_reset_postdata(); } } /** * Called before trashing a topic * * This function is supplemental to the actual topic being trashed which is * handled by WordPress core API functions. It is used to clean up after * a topic that is being trashed. */ function bbp_trash_topic( $topic_id = 0 ) { // Validate topic ID $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_trash_topic', $topic_id ); } /** * Trash replies to a topic when it's trashed. * * Usually you'll want to do this before the topic itself is marked as spam. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_trash_topic_replies( $topic_id = 0 ) { // Validate topic ID $topic_id = bbp_get_topic_id( $topic_id ); // Topic is being trashed, so its replies are trashed too $replies = new WP_Query( array( 'fields' => 'id=>parent', 'post_type' => bbp_get_reply_post_type(), 'post_status' => bbp_get_public_status_id(), 'post_parent' => $topic_id, 'posts_per_page' => -1, // Performance 'nopaging' => true, 'suppress_filters' => true, 'update_post_term_cache' => false, 'update_post_meta_cache' => false, 'ignore_sticky_posts' => true, 'no_found_rows' => true ) ); if ( ! empty( $replies->posts ) ) { // Prevent debug notices $pre_trashed_replies = array(); // Loop through replies, trash them, and add them to array foreach ( $replies->posts as $reply ) { wp_trash_post( $reply->ID ); $pre_trashed_replies[] = $reply->ID; } // Set a post_meta entry of the replies that were trashed by this action. // This is so we can possibly untrash them, without untrashing replies // that were purposefully trashed before. update_post_meta( $topic_id, '_bbp_pre_trashed_replies', $pre_trashed_replies ); // Reset the $post global wp_reset_postdata(); } } /** * Called before untrashing a topic */ function bbp_untrash_topic( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_untrash_topic', $topic_id ); } /** * Untrash replies to a topic previously trashed. * * Usually you'll want to do this after the topic is unspammed. * * @since 2.6.0 bbPress (r5405) * * @param int $topic_id */ function bbp_untrash_topic_replies( $topic_id = 0 ) { // Validation $topic_id = bbp_get_topic_id( $topic_id ); // Get the replies that were not previously trashed $pre_trashed_replies = get_post_meta( $topic_id, '_bbp_pre_trashed_replies', true ); // There are replies to untrash if ( ! empty( $pre_trashed_replies ) ) { // Maybe reverse the trashed replies array if ( is_array( $pre_trashed_replies ) ) { $pre_trashed_replies = array_reverse( $pre_trashed_replies ); } // Loop through replies foreach ( (array) $pre_trashed_replies as $reply ) { wp_untrash_post( $reply ); } } // Clear the trashed reply meta for the topic delete_post_meta( $topic_id, '_bbp_pre_trashed_replies' ); } /** After Delete/Trash/Untrash ************************************************/ /** * Called after deleting a topic * * @since 2.0.0 bbPress (r2993) */ function bbp_deleted_topic( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_deleted_topic', $topic_id ); } /** * Called after trashing a topic * * @since 2.0.0 bbPress (r2993) */ function bbp_trashed_topic( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_trashed_topic', $topic_id ); } /** * Called after untrashing a topic * * @since 2.0.0 bbPress (r2993) */ function bbp_untrashed_topic( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) { return false; } do_action( 'bbp_untrashed_topic', $topic_id ); } /** Settings ******************************************************************/ /** * Return the topics per page setting * * @since 2.0.0 bbPress (r3540) * @return int */ function bbp_get_topics_per_page( $default = 15 ) { // Get database option and cast as integer $retval = get_option( '_bbp_topics_per_page', $default ); // If return val is empty, set it to default if ( empty( $retval ) ) { $retval = $default; } // Filter & return return (int) apply_filters( 'bbp_get_topics_per_page', $retval, $default ); } /** * Return the topics per RSS page setting * * @since 2.0.0 bbPress (r3540) * * @param int $default Default replies per page (25) * @return int */ function bbp_get_topics_per_rss_page( $default = 25 ) { // Get database option and cast as integer $retval = get_option( '_bbp_topics_per_rss_page', $default ); // If return val is empty, set it to default if ( empty( $retval ) ) { $retval = $default; } // Filter & return return (int) apply_filters( 'bbp_get_topics_per_rss_page', $retval, $default ); } /** Topic Tags ****************************************************************/ /** * Get topic tags for a specific topic ID * * @since 2.6.0 bbPress (r5836) * * @param int $topic_id * * @return string */ function bbp_get_topic_tags( $topic_id = 0 ) { $topic_id = bbp_get_topic_id( $topic_id ); $terms = (array) get_the_terms( $topic_id, bbp_get_topic_tag_tax_id() ); $topic_tags = array_filter( $terms ); // Filter & return return apply_filters( 'bbp_get_topic_tags', $topic_tags, $topic_id ); } /** * Get topic tags for a specific topic ID * * @since 2.2.0 bbPress (r4165) * * @param int $topic_id * @param string $sep * * @return string */ function bbp_get_topic_tag_names( $topic_id = 0, $sep = ', ' ) { $topic_tags = bbp_get_topic_tags( $topic_id ); $pluck = wp_list_pluck( $topic_tags, 'name' ); $terms = ! empty( $pluck ) ? implode( $sep, $pluck ) : ''; // Filter & return return apply_filters( 'bbp_get_topic_tag_names', $terms, $topic_id, $sep ); } /** * Will update topic-tag count based on object type. * * Function for the default callback for topic-tag taxonomies. * * @see https://bbpress.trac.wordpress.org/ticket/3043 * @access private * * @since 2.6.0 bbPress (r6253) * * @param array $terms List of Term taxonomy IDs. * @param object $taxonomy Current taxonomy object of terms. */ function bbp_update_topic_tag_count( $terms, $taxonomy ) { // Bail if no object types are available if ( empty( $terms ) || empty( $taxonomy->object_type ) ) { return; } // Get object types $object_types = (array) $taxonomy->object_type; foreach ( $object_types as &$object_type ) { list( $object_type ) = explode( ':', $object_type ); } $object_types = array_unique( $object_types ); if ( ! empty( $object_types ) ) { $object_types = esc_sql( array_filter( $object_types, 'post_type_exists' ) ); } // Statuses to count $object_statuses = bbp_get_public_topic_statuses(); // Get database $bbp_db = bbp_db(); // Loop through terms, maybe update counts foreach ( (array) $terms as $term ) { $count = 0; // Get count, and bump it if ( ! empty( $object_types ) ) { $query = "SELECT COUNT(*) FROM {$bbp_db->term_relationships}, {$bbp_db->posts} WHERE {$bbp_db->posts}.ID = {$bbp_db->term_relationships}.object_id AND post_status IN ('" . implode("', '", $object_statuses ) . "') AND post_type IN ('" . implode("', '", $object_types ) . "') AND term_taxonomy_id = %d"; $prepare = $bbp_db->prepare( $query, $term ); $count += (int) $bbp_db->get_var( $prepare ); } /** This action is documented in wp-includes/taxonomy.php */ do_action( 'edit_term_taxonomy', $term, $taxonomy->name ); $bbp_db->update( $bbp_db->term_taxonomy, compact( 'count' ), array( 'term_taxonomy_id' => $term ) ); /** This action is documented in wp-includes/taxonomy.php */ do_action( 'edited_term_taxonomy', $term, $taxonomy->name ); } } /** Autoembed *****************************************************************/ /** * Check if autoembeds are enabled and hook them in if so * * @since 2.1.0 bbPress (r3752) * * @global WP_Embed $wp_embed */ function bbp_topic_content_autoembed() { global $wp_embed; if ( bbp_use_autoembed() && is_a( $wp_embed, 'WP_Embed' ) ) { add_filter( 'bbp_get_topic_content', array( $wp_embed, 'autoembed' ), 2 ); } } /** Feeds *********************************************************************/ /** * Output an RSS2 feed of topics, based on the query passed. * * @since 2.0.0 bbPress (r3171) * * @param array $topics_query */ function bbp_display_topics_feed_rss2( $topics_query = array() ) { // User cannot access this forum if ( bbp_is_single_forum() && ! bbp_user_can_view_forum( array( 'forum_id' => bbp_get_forum_id() ) ) ) { return; } // Feed title $title = get_bloginfo_rss( 'name' ) . ' » ' . esc_html__( 'All Topics', 'bbpress' ); $title = apply_filters( 'wp_title_rss', $title ); // Display the feed header( 'Content-Type: ' . feed_content_type( 'rss2' ) . '; charset=' . get_option( 'blog_charset' ), true ); header( 'Status: 200 OK' ); echo '<?xml version="1.0" encoding="' . get_option( 'blog_charset' ) . '"?' . '>'; ?> <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:atom="http://www.w3.org/2005/Atom" <?php do_action( 'bbp_feed' ); ?> > <channel> <title><?php echo $title; // Already escaped ?></title> <atom:link href="<?php self_link(); ?>" rel="self" type="application/rss+xml" /> <link><?php self_link(); ?></link> <description><?php //?></description> <lastBuildDate><?php echo date( 'r' ); ?></lastBuildDate> <generator><?php echo esc_url_raw( 'https://bbpress.org/?v=' . convert_chars( bbp_get_version() ) ); ?></generator> <language><?php bloginfo_rss( 'language' ); ?></language> <?php do_action( 'bbp_feed_head' ); ?> <?php if ( bbp_has_topics( $topics_query ) ) : ?> <?php while ( bbp_topics() ) : bbp_the_topic(); ?> <item> <guid><?php bbp_topic_permalink(); ?></guid> <title><![CDATA[<?php bbp_topic_title(); ?>]]></title> <link><?php bbp_topic_permalink(); ?></link> <pubDate><?php echo mysql2date( 'D, d M Y H:i:s +0000', get_post_meta( bbp_get_topic_id(), '_bbp_last_active_time', true ), false ); ?></pubDate> <dc:creator><?php the_author() ?></dc:creator> <?php if ( !post_password_required() ) : ?> <description> <![CDATA[ <p><?php printf( esc_html__( 'Replies: %s', 'bbpress' ), bbp_get_topic_reply_count() ); ?></p> <?php bbp_topic_content(); ?> ]]> </description> <?php rss_enclosure(); ?> <?php endif; ?> <?php do_action( 'bbp_feed_item' ); ?> </item> <?php endwhile; ?> <?php endif; ?> <?php do_action( 'bbp_feed_footer' ); ?> </channel> </rss> <?php exit(); } /** Permissions ***************************************************************/ /** * Redirect if unauthorized user is attempting to edit a topic * * @since 2.1.0 bbPress (r3605) */ function bbp_check_topic_edit() { // Bail if not editing a topic if ( ! bbp_is_topic_edit() ) { return; } // User cannot edit topic, so redirect back to topic if ( ! current_user_can( 'edit_topic', bbp_get_topic_id() ) ) { bbp_redirect( bbp_get_topic_permalink() ); } } /** * Redirect if unauthorized user is attempting to edit a topic tag * * @since 2.1.0 bbPress (r3605) */ function bbp_check_topic_tag_edit() { // Bail if not editing a topic tag if ( ! bbp_is_topic_tag_edit() ) { return; } // Bail if current user cannot edit topic tags if ( ! current_user_can( 'edit_topic_tag', bbp_get_topic_tag_id() ) ) { bbp_redirect( bbp_get_topic_tag_link() ); } }