[ Index ]

PHP Cross Reference of BBPress

title

Body

[close]

/src/includes/topics/ -> functions.php (source)

   1  <?php
   2  
   3  /**
   4   * bbPress Topic Functions
   5   *
   6   * @package bbPress
   7   * @subpackage Functions
   8   */
   9  
  10  // Exit if accessed directly
  11  defined( 'ABSPATH' ) || exit;
  12  
  13  /** Insert ********************************************************************/
  14  
  15  /**
  16   * A wrapper for wp_insert_post() that also includes the necessary meta values
  17   * for the topic to function properly.
  18   *
  19   * @since 2.0.0 bbPress (r3349)
  20   *
  21   * @param array $topic_data Forum post data
  22   * @param arrap $topic_meta Forum meta data
  23   */
  24  function bbp_insert_topic( $topic_data = array(), $topic_meta = array() ) {
  25  
  26      // Parse arguments against default values
  27      $topic_data = bbp_parse_args( $topic_data, array(
  28          'post_parent'    => 0, // forum ID
  29          'post_status'    => bbp_get_public_status_id(),
  30          'post_type'      => bbp_get_topic_post_type(),
  31          'post_author'    => bbp_get_current_user_id(),
  32          'post_password'  => '',
  33          'post_content'   => '',
  34          'post_title'     => '',
  35          'comment_status' => 'closed',
  36          'menu_order'     => 0
  37      ), 'insert_topic' );
  38  
  39      // Insert topic
  40      $topic_id = wp_insert_post( $topic_data, false );
  41  
  42      // Bail if no topic was added
  43      if ( empty( $topic_id ) ) {
  44          return false;
  45      }
  46  
  47      // Parse arguments against default values
  48      $topic_meta = bbp_parse_args( $topic_meta, array(
  49          'author_ip'          => bbp_current_author_ip(),
  50          'forum_id'           => 0,
  51          'topic_id'           => $topic_id,
  52          'voice_count'        => 1,
  53          'reply_count'        => 0,
  54          'reply_count_hidden' => 0,
  55          'last_reply_id'      => 0,
  56          'last_active_id'     => $topic_id,
  57          'last_active_time'   => get_post_field( 'post_date', $topic_id, 'db' )
  58      ), 'insert_topic_meta' );
  59  
  60      // Insert topic meta
  61      foreach ( $topic_meta as $meta_key => $meta_value ) {
  62  
  63          // Prefix if not prefixed
  64          if ( '_bbp_' !== substr( $meta_key, 0, 5 ) ) {
  65              $meta_key = '_bbp_' . $meta_key;
  66          }
  67  
  68          // Update the meta
  69          update_post_meta( $topic_id, $meta_key, $meta_value );
  70      }
  71  
  72      // Update the topic and hierarchy
  73      bbp_update_topic( $topic_id, $topic_meta['forum_id'], array(), $topic_data['post_author'], false );
  74  
  75      /**
  76       * Fires after topic has been inserted via `bbp_insert_topic`.
  77       *
  78       * @since 2.6.0 bbPress (r6036)
  79       *
  80       * @param int $topic_id               The topic id.
  81       * @param int $topic_meta['forum_id'] The topic forum meta.
  82       */
  83      do_action( 'bbp_insert_topic', (int) $topic_id, (int) $topic_meta['forum_id'] );
  84  
  85      // Return topic_id
  86      return $topic_id;
  87  }
  88  
  89  /** Post Form Handlers ********************************************************/
  90  
  91  /**
  92   * Handles the front end topic submission
  93   *
  94   * @param string $action The requested action to compare this function to
  95   */
  96  function bbp_new_topic_handler( $action = '' ) {
  97  
  98      // Bail if action is not bbp-new-topic
  99      if ( 'bbp-new-topic' !== $action ) {
 100          return;
 101      }
 102  
 103      // Nonce check
 104      if ( ! bbp_verify_nonce_request( 'bbp-new-topic' ) ) {
 105          bbp_add_error( 'bbp_new_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
 106          return;
 107      }
 108  
 109      // Define local variable(s)
 110      $view_all = false;
 111      $forum_id = $topic_author = 0;
 112      $topic_title = $topic_content = '';
 113      $anonymous_data = array();
 114      $terms = array( bbp_get_topic_tag_tax_id() => array() );
 115  
 116      /** Topic Author **********************************************************/
 117  
 118      // User is anonymous
 119      if ( bbp_is_anonymous() ) {
 120  
 121          // Filter anonymous data (variable is used later)
 122          $anonymous_data = bbp_filter_anonymous_post_data();
 123  
 124          // Anonymous data checks out, so set cookies, etc...
 125          bbp_set_current_anonymous_user_data( $anonymous_data );
 126  
 127      // User is logged in
 128      } else {
 129  
 130          // User cannot create topics
 131          if ( ! current_user_can( 'publish_topics' ) ) {
 132              bbp_add_error( 'bbp_topic_permission', __( '<strong>Error</strong>: You do not have permission to create new topics.', 'bbpress' ) );
 133              return;
 134          }
 135  
 136          // Topic author is current user
 137          $topic_author = bbp_get_current_user_id();
 138      }
 139  
 140      // Remove kses filters from title and content for capable users and if the nonce is verified
 141      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'] ) {
 142          remove_filter( 'bbp_new_topic_pre_title',   'wp_filter_kses'      );
 143          remove_filter( 'bbp_new_topic_pre_content', 'bbp_encode_bad',  10 );
 144          remove_filter( 'bbp_new_topic_pre_content', 'bbp_filter_kses', 30 );
 145      }
 146  
 147      /** Topic Title ***********************************************************/
 148  
 149      if ( ! empty( $_POST['bbp_topic_title'] ) ) {
 150          $topic_title = sanitize_text_field( $_POST['bbp_topic_title'] );
 151      }
 152  
 153      // Filter and sanitize
 154      $topic_title = apply_filters( 'bbp_new_topic_pre_title', $topic_title );
 155  
 156      // No topic title
 157      if ( empty( $topic_title ) ) {
 158          bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your topic needs a title.', 'bbpress' ) );
 159      }
 160  
 161      // Title too long
 162      if ( bbp_is_title_too_long( $topic_title ) ) {
 163          bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your title is too long.', 'bbpress' ) );
 164      }
 165  
 166      /** Topic Content *********************************************************/
 167  
 168      if ( ! empty( $_POST['bbp_topic_content'] ) ) {
 169          $topic_content = $_POST['bbp_topic_content'];
 170      }
 171  
 172      // Filter and sanitize
 173      $topic_content = apply_filters( 'bbp_new_topic_pre_content', $topic_content );
 174  
 175      // No topic content
 176      if ( empty( $topic_content ) ) {
 177          bbp_add_error( 'bbp_topic_content', __( '<strong>Error</strong>: Your topic cannot be empty.', 'bbpress' ) );
 178      }
 179  
 180      /** Topic Forum ***********************************************************/
 181  
 182      // Error check the POST'ed topic id
 183      if ( isset( $_POST['bbp_forum_id'] ) ) {
 184  
 185          // Empty Forum id was passed
 186          if ( empty( $_POST['bbp_forum_id'] ) ) {
 187              bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) );
 188  
 189          // Forum id is not a number
 190          } elseif ( ! is_numeric( $_POST['bbp_forum_id'] ) ) {
 191              bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID must be a number.', 'bbpress' ) );
 192  
 193          // Forum id might be valid
 194          } else {
 195  
 196              // Get the forum id
 197              $posted_forum_id = intval( $_POST['bbp_forum_id'] );
 198  
 199              // Forum id is empty
 200              if ( 0 === $posted_forum_id ) {
 201                  bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) );
 202  
 203              // Forum id is a negative number
 204              } elseif ( 0 > $posted_forum_id ) {
 205                  bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID cannot be a negative number.', 'bbpress' ) );
 206  
 207              // Forum does not exist
 208              } elseif ( ! bbp_get_forum( $posted_forum_id ) ) {
 209                  bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum does not exist.', 'bbpress' ) );
 210  
 211              // Use the POST'ed forum id
 212              } else {
 213                  $forum_id = $posted_forum_id;
 214              }
 215          }
 216      }
 217  
 218      // Forum exists
 219      if ( ! empty( $forum_id ) ) {
 220  
 221          // Forum is a category
 222          if ( bbp_is_forum_category( $forum_id ) ) {
 223              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' ) );
 224  
 225          // Forum is not a category
 226          } else {
 227  
 228              // Forum is closed and user cannot access
 229              if ( bbp_is_forum_closed( $forum_id ) && ! current_user_can( 'edit_forum', $forum_id ) ) {
 230                  bbp_add_error( 'bbp_new_topic_forum_closed', __( '<strong>Error</strong>: This forum has been closed to new topics.', 'bbpress' ) );
 231              }
 232  
 233              // Forum is private and user cannot access
 234              if ( bbp_is_forum_private( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) {
 235                  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' ) );
 236  
 237              // Forum is hidden and user cannot access
 238              } elseif ( bbp_is_forum_hidden( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) {
 239                  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' ) );
 240              }
 241          }
 242      }
 243  
 244      /** Topic Flooding ********************************************************/
 245  
 246      if ( ! bbp_check_for_flood( $anonymous_data, $topic_author ) ) {
 247          bbp_add_error( 'bbp_topic_flood', __( '<strong>Error</strong>: Slow down; you move too fast.', 'bbpress' ) );
 248      }
 249  
 250      /** Topic Duplicate *******************************************************/
 251  
 252      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 ) ) ) {
 253          bbp_add_error( 'bbp_topic_duplicate', __( '<strong>Error</strong>: Duplicate topic detected; it looks as though you&#8217;ve already said that.', 'bbpress' ) );
 254      }
 255  
 256      /** Topic Bad Words *******************************************************/
 257  
 258      if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content, true ) ) {
 259          bbp_add_error( 'bbp_topic_moderation', __( '<strong>Error</strong>: Your topic cannot be created at this time.', 'bbpress' ) );
 260      }
 261  
 262      /** Topic Status **********************************************************/
 263  
 264      // Get available topic statuses
 265      $topic_statuses = bbp_get_topic_statuses();
 266  
 267      // Maybe put into moderation
 268      if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content ) ) {
 269          $topic_status = bbp_get_pending_status_id();
 270  
 271      // Check possible topic status ID's
 272      } elseif ( ! empty( $_POST['bbp_topic_status'] ) && in_array( $_POST['bbp_topic_status'], array_keys( $topic_statuses ), true ) ) {
 273          $topic_status = sanitize_key( $_POST['bbp_topic_status'] );
 274  
 275      // Default to published if nothing else
 276      } else {
 277          $topic_status = bbp_get_public_status_id();
 278      }
 279  
 280      /** Topic Tags ************************************************************/
 281  
 282      if ( bbp_allow_topic_tags() && ! empty( $_POST['bbp_topic_tags'] ) ) {
 283  
 284          // Escape tag input
 285          $terms = sanitize_text_field( $_POST['bbp_topic_tags'] );
 286  
 287          // Explode by comma
 288          if ( strstr( $terms, ',' ) ) {
 289              $terms = explode( ',', $terms );
 290          }
 291  
 292          // Add topic tag ID as main key
 293          $terms = array( bbp_get_topic_tag_tax_id() => $terms );
 294      }
 295  
 296      /** Additional Actions (Before Save) **************************************/
 297  
 298      do_action( 'bbp_new_topic_pre_extras', $forum_id );
 299  
 300      // Bail if errors
 301      if ( bbp_has_errors() ) {
 302          return;
 303      }
 304  
 305      /** No Errors *************************************************************/
 306  
 307      // Add the content of the form to $topic_data as an array.
 308      // Just in time manipulation of topic data before being created
 309      $topic_data = apply_filters( 'bbp_new_topic_pre_insert', array(
 310          'post_author'    => $topic_author,
 311          'post_title'     => $topic_title,
 312          'post_content'   => $topic_content,
 313          'post_status'    => $topic_status,
 314          'post_parent'    => $forum_id,
 315          'post_type'      => bbp_get_topic_post_type(),
 316          'tax_input'      => $terms,
 317          'comment_status' => 'closed'
 318      ) );
 319  
 320      // Insert topic
 321      $topic_id = wp_insert_post( $topic_data, true );
 322  
 323      /** No Errors *************************************************************/
 324  
 325      if ( ! empty( $topic_id ) && ! is_wp_error( $topic_id ) ) {
 326  
 327          /** Close Check *******************************************************/
 328  
 329          // If the topic is closed, close it properly
 330          if ( ( get_post_field( 'post_status', $topic_id ) === bbp_get_closed_status_id() ) || ( $topic_data['post_status'] === bbp_get_closed_status_id() ) ) {
 331  
 332              // Close the topic
 333              bbp_close_topic( $topic_id );
 334          }
 335  
 336          /** Trash Check *******************************************************/
 337  
 338          // If the forum is trash, or the topic_status is switched to
 339          // trash, trash the topic properly
 340          if ( ( get_post_field( 'post_status', $forum_id ) === bbp_get_trash_status_id() ) || ( $topic_data['post_status'] === bbp_get_trash_status_id() ) ) {
 341  
 342              // Trash the topic
 343              wp_trash_post( $topic_id );
 344  
 345              // Force view=all
 346              $view_all = true;
 347          }
 348  
 349          /** Spam Check ********************************************************/
 350  
 351          // If the topic is spam, officially spam this topic
 352          if ( $topic_data['post_status'] === bbp_get_spam_status_id() ) {
 353              add_post_meta( $topic_id, '_bbp_spam_meta_status', bbp_get_public_status_id() );
 354  
 355              // Force view=all
 356              $view_all = true;
 357          }
 358  
 359          /** Update counts, etc... *********************************************/
 360  
 361          do_action( 'bbp_new_topic', $topic_id, $forum_id, $anonymous_data, $topic_author );
 362  
 363          /** Additional Actions (After Save) ***********************************/
 364  
 365          do_action( 'bbp_new_topic_post_extras', $topic_id );
 366  
 367          /** Redirect **********************************************************/
 368  
 369          // Redirect to
 370          $redirect_to = bbp_get_redirect_to();
 371  
 372          // Get the topic URL
 373          $redirect_url = bbp_get_topic_permalink( $topic_id, $redirect_to );
 374  
 375          // Add view all?
 376          if ( bbp_get_view_all() || ! empty( $view_all ) ) {
 377  
 378              // User can moderate, so redirect to topic with view all set
 379              if ( current_user_can( 'moderate', $topic_id ) ) {
 380                  $redirect_url = bbp_add_view_all( $redirect_url );
 381  
 382              // User cannot moderate, so redirect to forum
 383              } else {
 384                  $redirect_url = bbp_get_forum_permalink( $forum_id );
 385              }
 386          }
 387  
 388          // Allow to be filtered
 389          $redirect_url = apply_filters( 'bbp_new_topic_redirect_to', $redirect_url, $redirect_to, $topic_id );
 390  
 391          /** Successful Save ***************************************************/
 392  
 393          // Redirect back to new topic
 394          bbp_redirect( $redirect_url );
 395  
 396      /** Errors ****************************************************************/
 397  
 398      // WP_Error
 399      } elseif ( is_wp_error( $topic_id ) ) {
 400          bbp_add_error( 'bbp_topic_error', sprintf( __( '<strong>Error</strong>: The following problem(s) occurred: %s', 'bbpress' ), $topic_id->get_error_message() ) );
 401  
 402      // Generic error
 403      } else {
 404          bbp_add_error( 'bbp_topic_error', __( '<strong>Error</strong>: The topic was not created.', 'bbpress' ) );
 405      }
 406  }
 407  
 408  /**
 409   * Handles the front end edit topic submission
 410   *
 411   * @param string $action The requested action to compare this function to
 412   */
 413  function bbp_edit_topic_handler( $action = '' ) {
 414  
 415      // Bail if action is not bbp-edit-topic
 416      if ( 'bbp-edit-topic' !== $action ) {
 417          return;
 418      }
 419  
 420      // Define local variable(s)
 421      $revisions_removed = false;
 422      $topic = $topic_id = $topic_author = $forum_id = 0;
 423      $topic_title = $topic_content = $topic_edit_reason = '';
 424      $anonymous_data = array();
 425  
 426      /** Topic *****************************************************************/
 427  
 428      // Topic id was not passed
 429      if ( empty( $_POST['bbp_topic_id'] ) ) {
 430          bbp_add_error( 'bbp_edit_topic_id', __( '<strong>Error</strong>: Topic ID not found.', 'bbpress' ) );
 431          return;
 432  
 433      // Topic id was passed
 434      } elseif ( is_numeric( $_POST['bbp_topic_id'] ) ) {
 435          $topic_id = (int) $_POST['bbp_topic_id'];
 436          $topic    = bbp_get_topic( $topic_id );
 437      }
 438  
 439      // Topic does not exist
 440      if ( empty( $topic ) ) {
 441          bbp_add_error( 'bbp_edit_topic_not_found', __( '<strong>Error</strong>: The topic you want to edit was not found.', 'bbpress' ) );
 442          return;
 443  
 444      // Topic exists
 445      } else {
 446  
 447          // Check users ability to create new topic
 448          if ( ! bbp_is_topic_anonymous( $topic_id ) ) {
 449  
 450              // User cannot edit this topic
 451              if ( ! current_user_can( 'edit_topic', $topic_id ) ) {
 452                  bbp_add_error( 'bbp_edit_topic_permission', __( '<strong>Error</strong>: You do not have permission to edit that topic.', 'bbpress' ) );
 453              }
 454  
 455              // Set topic author
 456              $topic_author = bbp_get_topic_author_id( $topic_id );
 457  
 458          // It is an anonymous post
 459          } else {
 460  
 461              // Filter anonymous data
 462              $anonymous_data = bbp_filter_anonymous_post_data();
 463          }
 464      }
 465  
 466      // Nonce check
 467      if ( ! bbp_verify_nonce_request( 'bbp-edit-topic_' . $topic_id ) ) {
 468          bbp_add_error( 'bbp_edit_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
 469          return;
 470      }
 471  
 472      // Remove kses filters from title and content for capable users and if the nonce is verified
 473      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'] ) ) {
 474          remove_filter( 'bbp_edit_topic_pre_title',   'wp_filter_kses'      );
 475          remove_filter( 'bbp_edit_topic_pre_content', 'bbp_encode_bad',  10 );
 476          remove_filter( 'bbp_edit_topic_pre_content', 'bbp_filter_kses', 30 );
 477      }
 478  
 479      /** Topic Forum ***********************************************************/
 480  
 481      // Forum id was not passed
 482      if ( empty( $_POST['bbp_forum_id'] ) ) {
 483          bbp_add_error( 'bbp_topic_forum_id', __( '<strong>Error</strong>: Forum ID is missing.', 'bbpress' ) );
 484  
 485      // Forum id was passed
 486      } elseif ( is_numeric( $_POST['bbp_forum_id'] ) ) {
 487          $forum_id = (int) $_POST['bbp_forum_id'];
 488      }
 489  
 490      // Current forum this topic is in
 491      $current_forum_id = bbp_get_topic_forum_id( $topic_id );
 492  
 493      // Forum exists
 494      if ( ! empty( $forum_id ) && ( $forum_id !== $current_forum_id ) ) {
 495  
 496          // Forum is a category
 497          if ( bbp_is_forum_category( $forum_id ) ) {
 498              bbp_add_error( 'bbp_edit_topic_forum_category', __( '<strong>Error</strong>: This forum is a category. No topics can be created in it.', 'bbpress' ) );
 499  
 500          // Forum is not a category
 501          } else {
 502  
 503              // Forum is closed and user cannot access
 504              if ( bbp_is_forum_closed( $forum_id ) && ! current_user_can( 'edit_forum', $forum_id ) ) {
 505                  bbp_add_error( 'bbp_edit_topic_forum_closed', __( '<strong>Error</strong>: This forum has been closed to new topics.', 'bbpress' ) );
 506              }
 507  
 508              // Forum is private and user cannot access
 509              if ( bbp_is_forum_private( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) {
 510                  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' ) );
 511  
 512              // Forum is hidden and user cannot access
 513              } elseif ( bbp_is_forum_hidden( $forum_id ) && ! current_user_can( 'read_forum', $forum_id ) ) {
 514                  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' ) );
 515              }
 516          }
 517      }
 518  
 519      /** Topic Title ***********************************************************/
 520  
 521      if ( ! empty( $_POST['bbp_topic_title'] ) ) {
 522          $topic_title = sanitize_text_field( $_POST['bbp_topic_title'] );
 523      }
 524  
 525      // Filter and sanitize
 526      $topic_title = apply_filters( 'bbp_edit_topic_pre_title', $topic_title, $topic_id );
 527  
 528      // No topic title
 529      if ( empty( $topic_title ) ) {
 530          bbp_add_error( 'bbp_edit_topic_title', __( '<strong>Error</strong>: Your topic needs a title.', 'bbpress' ) );
 531      }
 532  
 533      // Title too long
 534      if ( bbp_is_title_too_long( $topic_title ) ) {
 535          bbp_add_error( 'bbp_topic_title', __( '<strong>Error</strong>: Your title is too long.', 'bbpress' ) );
 536      }
 537  
 538      /** Topic Content *********************************************************/
 539  
 540      if ( ! empty( $_POST['bbp_topic_content'] ) ) {
 541          $topic_content = $_POST['bbp_topic_content'];
 542      }
 543  
 544      // Filter and sanitize
 545      $topic_content = apply_filters( 'bbp_edit_topic_pre_content', $topic_content, $topic_id );
 546  
 547      // No topic content
 548      if ( empty( $topic_content ) ) {
 549          bbp_add_error( 'bbp_edit_topic_content', __( '<strong>Error</strong>: Your topic cannot be empty.', 'bbpress' ) );
 550      }
 551  
 552      /** Topic Bad Words *******************************************************/
 553  
 554      if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content, true ) ) {
 555          bbp_add_error( 'bbp_topic_moderation', __( '<strong>Error</strong>: Your topic cannot be edited at this time.', 'bbpress' ) );
 556      }
 557  
 558      /** Topic Status **********************************************************/
 559  
 560      // Get available topic statuses
 561      $topic_statuses = bbp_get_topic_statuses( $topic_id );
 562  
 563      // Maybe put into moderation
 564      if ( ! bbp_check_for_moderation( $anonymous_data, $topic_author, $topic_title, $topic_content ) ) {
 565  
 566          // Set post status to pending if public or closed
 567          if ( bbp_is_topic_public( $topic->ID ) ) {
 568              $topic_status = bbp_get_pending_status_id();
 569          }
 570  
 571      // Check possible topic status ID's
 572      } elseif ( ! empty( $_POST['bbp_topic_status'] ) && in_array( $_POST['bbp_topic_status'], array_keys( $topic_statuses ), true ) ) {
 573          $topic_status = sanitize_key( $_POST['bbp_topic_status'] );
 574  
 575      // Use existing post_status
 576      } else {
 577          $topic_status = $topic->post_status;
 578      }
 579  
 580      /** Topic Tags ************************************************************/
 581  
 582      // Either replace terms
 583      if ( bbp_allow_topic_tags() && current_user_can( 'assign_topic_tags', $topic_id ) && ! empty( $_POST['bbp_topic_tags'] ) ) {
 584  
 585          // Escape tag input
 586          $terms = sanitize_text_field( $_POST['bbp_topic_tags'] );
 587  
 588          // Explode by comma
 589          if ( strstr( $terms, ',' ) ) {
 590              $terms = explode( ',', $terms );
 591          }
 592  
 593          // Add topic tag ID as main key
 594          $terms = array( bbp_get_topic_tag_tax_id() => $terms );
 595  
 596      // ...or remove them.
 597      } elseif ( isset( $_POST['bbp_topic_tags'] ) ) {
 598          $terms = array( bbp_get_topic_tag_tax_id() => array() );
 599  
 600      // Existing terms
 601      } else {
 602          $terms = array( bbp_get_topic_tag_tax_id() => explode( ',', bbp_get_topic_tag_names( $topic_id, ',' ) ) );
 603      }
 604  
 605      /** Additional Actions (Before Save) **************************************/
 606  
 607      do_action( 'bbp_edit_topic_pre_extras', $topic_id );
 608  
 609      // Bail if errors
 610      if ( bbp_has_errors() ) {
 611          return;
 612      }
 613  
 614      /** No Errors *************************************************************/
 615  
 616      // Add the content of the form to $topic_data as an array
 617      // Just in time manipulation of topic data before being edited
 618      $topic_data = apply_filters( 'bbp_edit_topic_pre_insert', array(
 619          'ID'           => $topic_id,
 620          'post_title'   => $topic_title,
 621          'post_content' => $topic_content,
 622          'post_status'  => $topic_status,
 623          'post_parent'  => $forum_id,
 624          'post_author'  => $topic_author,
 625          'post_type'    => bbp_get_topic_post_type(),
 626          'tax_input'    => $terms,
 627      ) );
 628  
 629      // Toggle revisions to avoid duplicates
 630      if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) {
 631          $revisions_removed = true;
 632          remove_post_type_support( bbp_get_topic_post_type(), 'revisions' );
 633      }
 634  
 635      // Insert topic
 636      $topic_id = wp_update_post( $topic_data );
 637  
 638      // Toggle revisions back on
 639      if ( true === $revisions_removed ) {
 640          $revisions_removed = false;
 641          add_post_type_support( bbp_get_topic_post_type(), 'revisions' );
 642      }
 643  
 644      /** No Errors *************************************************************/
 645  
 646      if ( ! empty( $topic_id ) && ! is_wp_error( $topic_id ) ) {
 647  
 648          // Update counts, etc...
 649          do_action( 'bbp_edit_topic', $topic_id, $forum_id, $anonymous_data, $topic_author, true /* Is edit */ );
 650  
 651          /** Revisions *********************************************************/
 652  
 653          // Update locks
 654          update_post_meta( $topic_id, '_edit_last', bbp_get_current_user_id() );
 655          delete_post_meta( $topic_id, '_edit_lock' );
 656  
 657          // Revision Reason
 658          if ( ! empty( $_POST['bbp_topic_edit_reason'] ) ) {
 659              $topic_edit_reason = sanitize_text_field( $_POST['bbp_topic_edit_reason'] );
 660          }
 661  
 662          // Update revision log
 663          if ( ! empty( $_POST['bbp_log_topic_edit'] ) && ( '1' === $_POST['bbp_log_topic_edit'] ) ) {
 664              $revision_id = wp_save_post_revision( $topic_id );
 665              if ( ! empty( $revision_id ) ) {
 666                  bbp_update_topic_revision_log( array(
 667                      'topic_id'    => $topic_id,
 668                      'revision_id' => $revision_id,
 669                      'author_id'   => bbp_get_current_user_id(),
 670                      'reason'      => $topic_edit_reason
 671                  ) );
 672              }
 673          }
 674  
 675          /** Move Topic ********************************************************/
 676  
 677          // If the new forum id is not equal to the old forum id, run the
 678          // bbp_move_topic action and pass the topic's forum id as the
 679          // first arg and topic id as the second to update counts.
 680          if ( $forum_id !== $topic->post_parent ) {
 681              bbp_move_topic_handler( $topic_id, $topic->post_parent, $forum_id );
 682          }
 683  
 684          /** Additional Actions (After Save) ***********************************/
 685  
 686          do_action( 'bbp_edit_topic_post_extras', $topic_id );
 687  
 688          /** Redirect **********************************************************/
 689  
 690          // Redirect to
 691          $redirect_to = bbp_get_redirect_to();
 692  
 693          // View all?
 694          $view_all = bbp_get_view_all( 'edit_others_replies' );
 695  
 696          // Get the topic URL
 697          $topic_url = bbp_get_topic_permalink( $topic_id, $redirect_to );
 698  
 699          // Add view all?
 700          if ( ! empty( $view_all ) ) {
 701              $topic_url = bbp_add_view_all( $topic_url );
 702          }
 703  
 704          // Allow to be filtered
 705          $topic_url = apply_filters( 'bbp_edit_topic_redirect_to', $topic_url, $view_all, $redirect_to );
 706  
 707          /** Successful Edit ***************************************************/
 708  
 709          // Redirect back to new topic
 710          bbp_redirect( $topic_url );
 711  
 712      /** Errors ****************************************************************/
 713  
 714      } else {
 715          $append_error = ( is_wp_error( $topic_id ) && $topic_id->get_error_message() ) ? $topic_id->get_error_message() . ' ' : '';
 716          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' ) );
 717      }
 718  }
 719  
 720  /**
 721   * Handle all the extra meta stuff from posting a new topic
 722   *
 723   * @param int $topic_id Optional. Topic id
 724   * @param int $forum_id Optional. Forum id
 725   * @param array $anonymous_data Optional - if it's an anonymous post. Do not
 726   *                              supply if supplying $author_id. Should be
 727   *                              sanitized (see {@link bbp_filter_anonymous_post_data()}
 728   * @param int $author_id Author id
 729   * @param bool $is_edit Optional. Is the post being edited? Defaults to false.
 730   */
 731  function bbp_update_topic( $topic_id = 0, $forum_id = 0, $anonymous_data = array(), $author_id = 0, $is_edit = false ) {
 732  
 733      // Validate the ID's passed from 'bbp_new_topic' action
 734      $topic_id = bbp_get_topic_id( $topic_id );
 735      $forum_id = bbp_get_forum_id( $forum_id );
 736  
 737      // Bail if there is no topic
 738      if ( empty( $topic_id ) ) {
 739          return;
 740      }
 741  
 742      // Check author_id
 743      if ( empty( $author_id ) ) {
 744          $author_id = bbp_get_current_user_id();
 745      }
 746  
 747      // Forum/Topic meta (early, for use in downstream functions)
 748      bbp_update_topic_forum_id( $topic_id, $forum_id );
 749      bbp_update_topic_topic_id( $topic_id, $topic_id );
 750  
 751      // Get the topic types
 752      $topic_types = bbp_get_topic_types( $topic_id );
 753  
 754      // Sticky check after 'bbp_new_topic' action so forum ID meta is set
 755      if ( ! empty( $_POST['bbp_stick_topic'] ) && in_array( $_POST['bbp_stick_topic'], array_keys( $topic_types ), true ) ) {
 756  
 757          // What's the caps?
 758          if ( current_user_can( 'moderate', $topic_id ) ) {
 759  
 760              // What's the haps?
 761              switch ( $_POST['bbp_stick_topic'] ) {
 762  
 763                  // Sticky in this forum
 764                  case 'stick'   :
 765                      bbp_stick_topic( $topic_id );
 766                      break;
 767  
 768                  // Super sticky in all forums
 769                  case 'super'   :
 770                      bbp_stick_topic( $topic_id, true );
 771                      break;
 772  
 773                  // We can avoid this as it is a new topic
 774                  case 'unstick' :
 775                  default        :
 776                      break;
 777              }
 778          }
 779      }
 780  
 781      // If anonymous post, store name, email, website and ip in post_meta.
 782      if ( ! empty( $anonymous_data ) ) {
 783  
 784          // Update anonymous meta data (not cookies)
 785          bbp_update_anonymous_post_author( $topic_id, $anonymous_data, bbp_get_topic_post_type() );
 786  
 787          // Set transient for throttle check (only on new, not edit)
 788          if ( empty( $is_edit ) ) {
 789              set_transient( '_bbp_' . bbp_current_author_ip() . '_last_posted', time(), HOUR_IN_SECONDS );
 790          }
 791      }
 792  
 793      // Handle Subscription Checkbox
 794      if ( bbp_is_subscriptions_active() && ! empty( $author_id ) ) {
 795  
 796          // Check if subscribed
 797          $subscribed = bbp_is_user_subscribed( $author_id, $topic_id );
 798  
 799          // Check for action
 800          $subscheck  = ( ! empty( $_POST['bbp_topic_subscription'] ) && ( 'bbp_subscribe' === $_POST['bbp_topic_subscription'] ) )
 801              ? true
 802              : false;
 803  
 804          // Subscribed and unsubscribing
 805          if ( ( true === $subscribed ) && ( false === $subscheck ) ) {
 806              bbp_remove_user_subscription( $author_id, $topic_id );
 807  
 808          // Not subscribed and subscribing
 809          } elseif ( ( false === $subscribed ) && ( true === $subscheck ) ) {
 810              bbp_add_user_subscription( $author_id, $topic_id );
 811          }
 812      }
 813  
 814      // Update associated topic values if this is a new topic
 815      if ( empty( $is_edit ) ) {
 816  
 817          // Update poster activity time
 818          bbp_update_user_last_posted( $author_id );
 819  
 820          // Update poster IP
 821          update_post_meta( $topic_id, '_bbp_author_ip', bbp_current_author_ip(), false );
 822  
 823          // Last active time
 824          $last_active = get_post_field( 'post_date', $topic_id );
 825  
 826          // Reply topic meta
 827          bbp_update_topic_last_reply_id      ( $topic_id, 0            );
 828          bbp_update_topic_last_active_id     ( $topic_id, $topic_id    );
 829          bbp_update_topic_last_active_time   ( $topic_id, $last_active );
 830          bbp_update_topic_reply_count        ( $topic_id, 0            );
 831          bbp_update_topic_reply_count_hidden ( $topic_id, 0            );
 832          bbp_update_topic_voice_count        ( $topic_id               );
 833  
 834          // Walk up ancestors and do the dirty work
 835          bbp_update_topic_walker( $topic_id, $last_active, $forum_id, 0, false );
 836      }
 837  
 838      // Bump the custom query cache
 839      wp_cache_set( 'last_changed', microtime(), 'bbpress_posts' );
 840  }
 841  
 842  /**
 843   * Walks up the post_parent tree from the current topic_id, and updates the
 844   * meta data of forums above it. This calls several functions that all run
 845   * manual queries against the database to get their results. As such, this
 846   * function can be costly to run but is necessary to keep everything accurate.
 847   *
 848   * @since 2.0.0 bbPress (r2800)
 849   *
 850   * @param int $topic_id Topic id
 851   * @param string $last_active_time Optional. Last active time
 852   * @param int $forum_id Optional. Forum id
 853   * @param int $reply_id Optional. Reply id
 854   * @param bool $refresh Reset all the previous parameters? Defaults to true.
 855   */
 856  function bbp_update_topic_walker( $topic_id, $last_active_time = '', $forum_id = 0, $reply_id = 0, $refresh = true ) {
 857  
 858      // Validate topic_id
 859      $topic_id  = bbp_get_topic_id( $topic_id );
 860  
 861      // Define local variable(s)
 862      $active_id = 0;
 863  
 864      // Topic was passed
 865      if ( ! empty( $topic_id ) ) {
 866  
 867          // Get the forum ID if none was passed
 868          if ( empty( $forum_id ) ) {
 869              $forum_id = bbp_get_topic_forum_id( $topic_id );
 870          }
 871  
 872          // Set the active_id based on topic_id/reply_id
 873          $active_id = empty( $reply_id ) ? $topic_id : $reply_id;
 874      }
 875  
 876      // Get topic ancestors
 877      $ancestors = array_values( array_unique( array_merge( array( $forum_id ), (array) get_post_ancestors( $topic_id ) ) ) );
 878  
 879      // Topic status
 880      $topic_status = get_post_status( $topic_id );
 881  
 882      // If we want a full refresh, unset any of the possibly passed variables
 883      if ( true === $refresh ) {
 884          $forum_id = $topic_id = $reply_id = $active_id = $last_active_time = 0;
 885          $topic_status = bbp_get_public_status_id();
 886      }
 887  
 888      // Loop through ancestors
 889      if ( ! empty( $ancestors ) ) {
 890          foreach ( $ancestors as $ancestor ) {
 891  
 892              // If ancestor is a forum, update counts
 893              if ( bbp_is_forum( $ancestor ) ) {
 894  
 895                  // Get the forum
 896                  $forum = bbp_get_forum( $ancestor );
 897  
 898                  // Update the forum
 899                  bbp_update_forum( array(
 900                      'forum_id'           => $forum->ID,
 901                      'post_parent'        => $forum->post_parent,
 902                      'last_topic_id'      => $topic_id,
 903                      'last_reply_id'      => $reply_id,
 904                      'last_active_id'     => $active_id,
 905                      'last_active_time'   => $last_active_time,
 906                      'last_active_status' => $topic_status
 907                  ) );
 908              }
 909          }
 910      }
 911  }
 912  
 913  /**
 914   * Handle the moving of a topic from one forum to another. This includes walking
 915   * up the old and new branches and updating the counts.
 916   *
 917   * @since 2.0.0 bbPress (r2907)
 918   *
 919   * @param int $topic_id     The topic id.
 920   * @param int $old_forum_id Old forum id.
 921   * @param int $new_forum_id New forum id.
 922   */
 923  function bbp_move_topic_handler( $topic_id, $old_forum_id, $new_forum_id ) {
 924  
 925      // Validate parameters
 926      $topic_id     = bbp_get_topic_id( $topic_id     );
 927      $old_forum_id = bbp_get_forum_id( $old_forum_id );
 928      $new_forum_id = bbp_get_forum_id( $new_forum_id );
 929  
 930      // Clean old and new forum caches before proceeding, to ensure subsequent
 931      // calls to forum objects are using updated data.
 932      clean_post_cache( $old_forum_id );
 933      clean_post_cache( $new_forum_id );
 934  
 935      // Update topic forum's ID
 936      bbp_update_topic_forum_id( $topic_id, $new_forum_id );
 937  
 938      // Update topic post parent with the new forum ID
 939      wp_update_post( array(
 940          'ID'          => $topic_id,
 941          'post_parent' => $new_forum_id,
 942      ) );
 943  
 944      /** Stickies **************************************************************/
 945  
 946      // Get forum stickies
 947      $old_stickies = bbp_get_stickies( $old_forum_id );
 948  
 949      // Only proceed if stickies are found
 950      if ( ! empty( $old_stickies ) ) {
 951  
 952          // Define local variables
 953          $updated_stickies = array();
 954  
 955          // Loop through stickies of forum and add misses to the updated array
 956          foreach ( (array) $old_stickies as $sticky_topic_id ) {
 957              if ( $topic_id !== $sticky_topic_id ) {
 958                  $updated_stickies[] = $sticky_topic_id;
 959              }
 960          }
 961  
 962          // If stickies are different, update or delete them
 963          if ( $updated_stickies !== $old_stickies ) {
 964  
 965              // No more stickies so delete the meta
 966              if ( empty( $updated_stickies ) ) {
 967                  delete_post_meta( $old_forum_id, '_bbp_sticky_topics' );
 968  
 969              // Still stickies so update the meta
 970              } else {
 971                  update_post_meta( $old_forum_id, '_bbp_sticky_topics', $updated_stickies );
 972              }
 973  
 974              // Topic was sticky, so restick in new forum
 975              bbp_stick_topic( $topic_id );
 976          }
 977      }
 978  
 979      /** Topic Replies *********************************************************/
 980  
 981      // Get the topics replies
 982      $replies = bbp_get_all_child_ids( $topic_id, bbp_get_reply_post_type() );
 983  
 984      // Update the forum_id of all replies in the topic
 985      foreach ( $replies as $reply_id ) {
 986          bbp_update_reply_forum_id( $reply_id, $new_forum_id );
 987      }
 988  
 989      /** Old forum_id **********************************************************/
 990  
 991      // Get topic ancestors
 992      $old_forum_ancestors = array_values( array_unique( array_merge( array( $old_forum_id ), (array) get_post_ancestors( $old_forum_id ) ) ) );
 993  
 994      // Public counts
 995      if ( bbp_is_topic_public( $topic_id ) ) {
 996  
 997          // Update old forum counts.
 998          bbp_decrease_forum_topic_count( $old_forum_id );
 999  
1000          // Update new forum counts.
1001          bbp_increase_forum_topic_count( $new_forum_id );
1002  
1003      // Non-public counts
1004      } else {
1005  
1006          // Update old forum counts.
1007          bbp_decrease_forum_topic_count_hidden( $old_forum_id );
1008  
1009          // Update new forum counts.
1010          bbp_increase_forum_topic_count_hidden( $new_forum_id );
1011      }
1012  
1013      // Get reply counts.
1014      $public_reply_count = bbp_get_public_child_count( $topic_id, bbp_get_reply_post_type() );
1015      $hidden_reply_count = bbp_get_non_public_child_count( $topic_id, bbp_get_reply_post_type() );
1016  
1017      // Bump reply counts.
1018      bbp_bump_forum_reply_count( $old_forum_id, -$public_reply_count );
1019      bbp_bump_forum_reply_count( $new_forum_id, $public_reply_count );
1020      bbp_bump_forum_reply_count_hidden( $old_forum_id, -$hidden_reply_count );
1021      bbp_bump_forum_reply_count_hidden( $new_forum_id, $hidden_reply_count );
1022  
1023      // Loop through ancestors and update them
1024      if ( ! empty( $old_forum_ancestors ) ) {
1025          foreach ( $old_forum_ancestors as $ancestor ) {
1026              if ( bbp_is_forum( $ancestor ) ) {
1027                  bbp_update_forum( array(
1028                      'forum_id' => $ancestor,
1029                  ) );
1030              }
1031          }
1032      }
1033  
1034      /** New forum_id **********************************************************/
1035  
1036      // Make sure we're not walking twice
1037      if ( ! in_array( $new_forum_id, $old_forum_ancestors, true ) ) {
1038  
1039          // Get topic ancestors
1040          $new_forum_ancestors = array_values( array_unique( array_merge( array( $new_forum_id ), (array) get_post_ancestors( $new_forum_id ) ) ) );
1041  
1042          // Make sure we're not walking twice
1043          $new_forum_ancestors = array_diff( $new_forum_ancestors, $old_forum_ancestors );
1044  
1045          // Loop through ancestors and update them
1046          if ( ! empty( $new_forum_ancestors ) ) {
1047              foreach ( $new_forum_ancestors as $ancestor ) {
1048                  if ( bbp_is_forum( $ancestor ) ) {
1049                      bbp_update_forum( array(
1050                          'forum_id' => $ancestor,
1051                      ) );
1052                  }
1053              }
1054          }
1055      }
1056  }
1057  
1058  /**
1059   * Merge topic handler
1060   *
1061   * Handles the front end merge topic submission
1062   *
1063   * @since 2.0.0 bbPress (r2756)
1064   *
1065   * @param string $action The requested action to compare this function to
1066   */
1067  function bbp_merge_topic_handler( $action = '' ) {
1068  
1069      // Bail if action is not bbp-merge-topic
1070      if ( 'bbp-merge-topic' !== $action ) {
1071          return;
1072      }
1073  
1074      // Define local variable(s)
1075      $source_topic_id = $destination_topic_id = 0;
1076      $source_topic = $destination_topic = 0;
1077      $subscribers = $favoriters = $replies = array();
1078  
1079      /** Source Topic **********************************************************/
1080  
1081      // Topic id
1082      if ( empty( $_POST['bbp_topic_id'] ) ) {
1083          bbp_add_error( 'bbp_merge_topic_source_id', __( '<strong>Error</strong>: Topic ID not found.', 'bbpress' ) );
1084      } else {
1085          $source_topic_id = (int) $_POST['bbp_topic_id'];
1086      }
1087  
1088      // Nonce check
1089      if ( ! bbp_verify_nonce_request( 'bbp-merge-topic_' . $source_topic_id ) ) {
1090          bbp_add_error( 'bbp_merge_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
1091          return;
1092  
1093      // Source topic not found
1094      } elseif ( ! $source_topic = bbp_get_topic( $source_topic_id ) ) {
1095          bbp_add_error( 'bbp_merge_topic_source_not_found', __( '<strong>Error</strong>: The topic you want to merge was not found.', 'bbpress' ) );
1096          return;
1097      }
1098  
1099      // Cannot edit source topic
1100      if ( ! current_user_can( 'edit_topic', $source_topic->ID ) ) {
1101          bbp_add_error( 'bbp_merge_topic_source_permission', __( '<strong>Error</strong>: You do not have permission to edit the source topic.', 'bbpress' ) );
1102          return;
1103      }
1104  
1105      /** Destination Topic *****************************************************/
1106  
1107      // Topic id
1108      if ( empty( $_POST['bbp_destination_topic'] ) ) {
1109          bbp_add_error( 'bbp_merge_topic_destination_id', __( '<strong>Error</strong>: Destination topic ID not found.', 'bbpress' ) );
1110      } else {
1111          $destination_topic_id = (int) $_POST['bbp_destination_topic'];
1112      }
1113  
1114      // Destination topic not found
1115      if ( ! $destination_topic = bbp_get_topic( $destination_topic_id ) ) {
1116          bbp_add_error( 'bbp_merge_topic_destination_not_found', __( '<strong>Error</strong>: The topic you want to merge to was not found.', 'bbpress' ) );
1117      }
1118  
1119      // Cannot edit destination topic
1120      if ( ! current_user_can( 'edit_topic', $destination_topic->ID ) ) {
1121          bbp_add_error( 'bbp_merge_topic_destination_permission', __( '<strong>Error</strong>: You do not have permission to edit the destination topic.', 'bbpress' ) );
1122      }
1123  
1124      // Bail if errors
1125      if ( bbp_has_errors() ) {
1126          return;
1127      }
1128  
1129      /** No Errors *************************************************************/
1130  
1131      // Update counts, etc...
1132      do_action( 'bbp_merge_topic', $destination_topic->ID, $source_topic->ID );
1133  
1134      /** Date Check ************************************************************/
1135  
1136      // Check if the destination topic is older than the source topic
1137      if ( strtotime( $source_topic->post_date ) < strtotime( $destination_topic->post_date ) ) {
1138  
1139          // Set destination topic post_date to 1 second before source topic
1140          $destination_post_date = date( 'Y-m-d H:i:s', strtotime( $source_topic->post_date ) - 1 );
1141  
1142          // Update destination topic
1143          wp_update_post( array(
1144              'ID'            => $destination_topic_id,
1145              'post_date'     => $destination_post_date,
1146              'post_date_gmt' => get_gmt_from_date( $destination_post_date )
1147          ) );
1148      }
1149  
1150      /** Engagements ***********************************************************/
1151  
1152      // Get engagements from source topic
1153      $engagements = bbp_get_topic_engagements( $source_topic->ID );
1154  
1155      // Maybe migrate engagements
1156      if ( ! empty( $engagements ) ) {
1157          foreach ( $engagements as $engager ) {
1158              bbp_add_user_engagement( $engager, $destination_topic->ID );
1159          }
1160      }
1161  
1162      /** Subscriptions *********************************************************/
1163  
1164      // Get subscribers from source topic
1165      $subscribers = bbp_get_subscribers( $source_topic->ID );
1166  
1167      // Maybe migrate subscriptions
1168      if ( ! empty( $subscribers ) && ! empty( $_POST['bbp_topic_subscribers'] ) && ( '1' === $_POST['bbp_topic_subscribers'] ) ) {
1169          foreach ( $subscribers as $subscriber ) {
1170              bbp_add_user_subscription( $subscriber, $destination_topic->ID );
1171          }
1172      }
1173  
1174      /** Favorites *************************************************************/
1175  
1176      // Get favoriters from source topic
1177      $favoriters = bbp_get_topic_favoriters( $source_topic->ID );
1178  
1179      // Maybe migrate favorites
1180      if ( ! empty( $favoriters ) && ! empty( $_POST['bbp_topic_favoriters'] ) && ( '1' === $_POST['bbp_topic_favoriters'] ) ) {
1181          foreach ( $favoriters as $favoriter ) {
1182              bbp_add_user_favorite( $favoriter, $destination_topic->ID );
1183          }
1184      }
1185  
1186      /** Tags ******************************************************************/
1187  
1188      // Get the source topic tags
1189      $source_topic_tags = wp_get_post_terms( $source_topic->ID, bbp_get_topic_tag_tax_id(), array( 'fields' => 'names' ) );
1190  
1191      // Tags to possibly merge
1192      if ( ! empty( $source_topic_tags ) && ! is_wp_error( $source_topic_tags ) ) {
1193  
1194          // Shift the tags if told to
1195          if ( ! empty( $_POST['bbp_topic_tags'] ) && ( '1' === $_POST['bbp_topic_tags'] ) ) {
1196              wp_set_post_terms( $destination_topic->ID, $source_topic_tags, bbp_get_topic_tag_tax_id(), true );
1197          }
1198  
1199          // Delete the tags from the source topic
1200          wp_delete_object_term_relationships( $source_topic->ID, bbp_get_topic_tag_tax_id() );
1201      }
1202  
1203      /** Source Topic **********************************************************/
1204  
1205      // Status
1206      bbp_open_topic( $source_topic->ID );
1207  
1208      // Sticky
1209      bbp_unstick_topic( $source_topic->ID );
1210  
1211      // Delete source topic's last & count meta data
1212      delete_post_meta( $source_topic->ID, '_bbp_last_reply_id'      );
1213      delete_post_meta( $source_topic->ID, '_bbp_last_active_id'     );
1214      delete_post_meta( $source_topic->ID, '_bbp_last_active_time'   );
1215      delete_post_meta( $source_topic->ID, '_bbp_voice_count'        );
1216      delete_post_meta( $source_topic->ID, '_bbp_reply_count'        );
1217      delete_post_meta( $source_topic->ID, '_bbp_reply_count_hidden' );
1218  
1219      // Delete source topics user relationships
1220      delete_post_meta( $source_topic->ID, '_bbp_favorite'     );
1221      delete_post_meta( $source_topic->ID, '_bbp_subscription' );
1222      delete_post_meta( $source_topic->ID, '_bbp_engagement'   );
1223  
1224      // Get the replies of the source topic
1225      $replies = (array) get_posts( array(
1226          'post_parent'    => $source_topic->ID,
1227          'post_type'      => bbp_get_reply_post_type(),
1228          'posts_per_page' => -1,
1229          'order'          => 'ASC'
1230      ) );
1231  
1232      // Prepend the source topic to its replies array for processing
1233      array_unshift( $replies, $source_topic );
1234  
1235      if ( ! empty( $replies ) ) {
1236  
1237          /** Merge Replies *****************************************************/
1238  
1239          // Change the post_parent of each reply to the destination topic id
1240          foreach ( $replies as $reply ) {
1241  
1242              // Update the reply
1243              wp_update_post( array(
1244                  'ID'          => $reply->ID,
1245                  'post_title'  => '',
1246                  'post_name'   => false,
1247                  'post_type'   => bbp_get_reply_post_type(),
1248                  'post_parent' => $destination_topic->ID,
1249                  'guid'        => ''
1250              ) );
1251  
1252              // Adjust reply meta values
1253              bbp_update_reply_topic_id( $reply->ID, $destination_topic->ID                           );
1254              bbp_update_reply_forum_id( $reply->ID, bbp_get_topic_forum_id( $destination_topic->ID ) );
1255  
1256              // Update the reply position
1257              bbp_update_reply_position( $reply->ID );
1258  
1259              // Do additional actions per merged reply
1260              do_action( 'bbp_merged_topic_reply', $reply->ID, $destination_topic->ID );
1261          }
1262      }
1263  
1264      /** Successful Merge ******************************************************/
1265  
1266      // Update topic's last meta data
1267      bbp_update_topic_last_reply_id   ( $destination_topic->ID );
1268      bbp_update_topic_last_active_id  ( $destination_topic->ID );
1269      bbp_update_topic_last_active_time( $destination_topic->ID );
1270  
1271      // Send the post parent of the source topic as it has been shifted
1272      // (possibly to a new forum) so we need to update the counts of the
1273      // old forum as well as the new one
1274      do_action( 'bbp_merged_topic', $destination_topic->ID, $source_topic->ID, $source_topic->post_parent );
1275  
1276      // Redirect back to new topic
1277      bbp_redirect( bbp_get_topic_permalink( $destination_topic->ID ) );
1278  }
1279  
1280  /**
1281   * Fix counts on topic merge
1282   *
1283   * When a topic is merged, update the counts of source and destination topic
1284   * and their forums.
1285   *
1286   * @since 2.0.0 bbPress (r2756)
1287   *
1288   * @param int $destination_topic_id Destination topic id
1289   * @param int $source_topic_id Source topic id
1290   * @param int $source_topic_forum_id Source topic's forum id
1291   */
1292  function bbp_merge_topic_count( $destination_topic_id, $source_topic_id, $source_topic_forum_id ) {
1293  
1294      /** Source Topic **********************************************************/
1295  
1296      // Forum Topic Counts
1297      bbp_update_forum_topic_count( $source_topic_forum_id );
1298  
1299      // Forum Reply Counts
1300      bbp_update_forum_reply_count( $source_topic_forum_id );
1301  
1302      /** Destination Topic *****************************************************/
1303  
1304      // Topic Reply Counts
1305      bbp_update_topic_reply_count( $destination_topic_id );
1306  
1307      // Topic Hidden Reply Counts
1308      bbp_update_topic_reply_count_hidden( $destination_topic_id );
1309  
1310      // Topic Voice Counts
1311      bbp_update_topic_voice_count( $destination_topic_id );
1312  
1313      do_action( 'bbp_merge_topic_count', $destination_topic_id, $source_topic_id, $source_topic_forum_id );
1314  }
1315  
1316  /**
1317   * Split topic handler
1318   *
1319   * Handles the front end split topic submission
1320   *
1321   * @since 2.0.0 bbPress (r2756)
1322   *
1323   * @param string $action The requested action to compare this function to
1324   */
1325  function bbp_split_topic_handler( $action = '' ) {
1326  
1327      // Bail if action is not 'bbp-split-topic'
1328      if ( 'bbp-split-topic' !== $action ) {
1329          return;
1330      }
1331  
1332      // Prevent debug notices
1333      $from_reply_id = $destination_topic_id = 0;
1334      $destination_topic_title = '';
1335      $destination_topic = $from_reply = $source_topic = '';
1336      $split_option = false;
1337  
1338      /** Split Reply ***********************************************************/
1339  
1340      if ( empty( $_POST['bbp_reply_id'] ) ) {
1341          bbp_add_error( 'bbp_split_topic_reply_id', __( '<strong>Error</strong>: A reply ID is required.', 'bbpress' ) );
1342      } else {
1343          $from_reply_id = (int) $_POST['bbp_reply_id'];
1344      }
1345  
1346      $from_reply = bbp_get_reply( $from_reply_id );
1347  
1348      // Reply exists
1349      if ( empty( $from_reply ) ) {
1350          bbp_add_error( 'bbp_split_topic_r_not_found', __( '<strong>Error</strong>: The reply you want to split from was not found.', 'bbpress' ) );
1351      }
1352  
1353      /** Topic to Split ********************************************************/
1354  
1355      // Get the topic being split
1356      $source_topic = bbp_get_topic( $from_reply->post_parent );
1357  
1358      // No topic
1359      if ( empty( $source_topic ) ) {
1360          bbp_add_error( 'bbp_split_topic_source_not_found', __( '<strong>Error</strong>: The topic you want to split was not found.', 'bbpress' ) );
1361      }
1362  
1363      // Nonce check failed
1364      if ( ! bbp_verify_nonce_request( 'bbp-split-topic_' . $source_topic->ID ) ) {
1365          bbp_add_error( 'bbp_split_topic_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
1366          return;
1367      }
1368  
1369      // Use cannot edit topic
1370      if ( ! current_user_can( 'edit_topic', $source_topic->ID ) ) {
1371          bbp_add_error( 'bbp_split_topic_source_permission', __( '<strong>Error</strong>: You do not have permission to edit the source topic.', 'bbpress' ) );
1372      }
1373  
1374      // How to Split
1375      if ( ! empty( $_POST['bbp_topic_split_option'] ) ) {
1376          $split_option = sanitize_key( $_POST['bbp_topic_split_option'] );
1377      }
1378  
1379      // Invalid split option
1380      if ( empty( $split_option ) || ! in_array( $split_option, array( 'existing', 'reply' ), true ) ) {
1381          bbp_add_error( 'bbp_split_topic_option', __( '<strong>Error</strong>: You need to choose a valid split option.', 'bbpress' ) );
1382  
1383      // Valid Split Option
1384      } else {
1385  
1386          // What kind of split
1387          switch ( $split_option ) {
1388  
1389              // Into an existing topic
1390              case 'existing' :
1391  
1392                  // Get destination topic id
1393                  if ( empty( $_POST['bbp_destination_topic'] ) ) {
1394                      bbp_add_error( 'bbp_split_topic_destination_id', __( '<strong>Error</strong>: A topic ID is required.', 'bbpress' ) );
1395                  } else {
1396                      $destination_topic_id = (int) $_POST['bbp_destination_topic'];
1397                  }
1398  
1399                  // Get the destination topic
1400                  $destination_topic = bbp_get_topic( $destination_topic_id );
1401  
1402                  // No destination topic
1403                  if ( empty( $destination_topic ) ) {
1404                      bbp_add_error( 'bbp_split_topic_destination_not_found', __( '<strong>Error</strong>: The topic you want to split to was not found.', 'bbpress' ) );
1405                  }
1406  
1407                  // User cannot edit the destination topic
1408                  if ( ! current_user_can( 'edit_topic', $destination_topic->ID ) ) {
1409                      bbp_add_error( 'bbp_split_topic_destination_permission', __( '<strong>Error</strong>: You do not have permission to edit the destination topic.', 'bbpress' ) );
1410                  }
1411  
1412                  break;
1413  
1414              // Split at reply into a new topic
1415              case 'reply' :
1416              default :
1417  
1418                  // User needs to be able to publish topics
1419                  if ( current_user_can( 'publish_topics' ) ) {
1420  
1421                      // Use the new title that was passed
1422                      if ( ! empty( $_POST['bbp_topic_split_destination_title'] ) ) {
1423                          $destination_topic_title = sanitize_text_field( $_POST['bbp_topic_split_destination_title'] );
1424  
1425                      // Use the source topic title
1426                      } else {
1427                          $destination_topic_title = $source_topic->post_title;
1428                      }
1429  
1430                      // Update the topic
1431                      $destination_topic_id = wp_update_post( array(
1432                          'ID'          => $from_reply->ID,
1433                          'post_title'  => $destination_topic_title,
1434                          'post_name'   => false,
1435                          'post_type'   => bbp_get_topic_post_type(),
1436                          'post_parent' => $source_topic->post_parent,
1437                          'menu_order'  => 0,
1438                          'guid'        => ''
1439                      ) );
1440                      $destination_topic = bbp_get_topic( $destination_topic_id );
1441  
1442                      // Make sure the new topic knows its a topic
1443                      bbp_update_topic_topic_id( $from_reply->ID );
1444  
1445                      // Shouldn't happen
1446                      if ( false === $destination_topic_id || is_wp_error( $destination_topic_id ) || empty( $destination_topic ) ) {
1447                          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' ) );
1448                      }
1449  
1450                  // User cannot publish posts
1451                  } else {
1452                      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' ) );
1453                  }
1454  
1455                  break;
1456          }
1457      }
1458  
1459      // Bail if there are errors
1460      if ( bbp_has_errors() ) {
1461          return;
1462      }
1463  
1464      /** No Errors - Do the Spit ***********************************************/
1465  
1466      // Update counts, etc...
1467      do_action( 'bbp_pre_split_topic', $from_reply->ID, $source_topic->ID, $destination_topic->ID );
1468  
1469      /** Date Check ************************************************************/
1470  
1471      // Check if the destination topic is older than the from reply
1472      if ( strtotime( $from_reply->post_date ) < strtotime( $destination_topic->post_date ) ) {
1473  
1474          // Set destination topic post_date to 1 second before from reply
1475          $destination_post_date = date( 'Y-m-d H:i:s', strtotime( $from_reply->post_date ) - 1 );
1476  
1477          // Update destination topic
1478          wp_update_post( array(
1479              'ID'            => $destination_topic_id,
1480              'post_date'     => $destination_post_date,
1481              'post_date_gmt' => get_gmt_from_date( $destination_post_date )
1482          ) );
1483      }
1484  
1485      /** Subscriptions *********************************************************/
1486  
1487      // Copy the subscribers
1488      if ( ! empty( $_POST['bbp_topic_subscribers'] ) && '1' === $_POST['bbp_topic_subscribers'] && bbp_is_subscriptions_active() ) {
1489  
1490          // Get the subscribers
1491          $subscribers = bbp_get_subscribers( $source_topic->ID );
1492  
1493          if ( ! empty( $subscribers ) ) {
1494  
1495              // Add subscribers to new topic
1496              foreach ( (array) $subscribers as $subscriber ) {
1497                  bbp_add_user_subscription( $subscriber, $destination_topic->ID );
1498              }
1499          }
1500      }
1501  
1502      /** Favorites *************************************************************/
1503  
1504      // Copy the favoriters if told to
1505      if ( ! empty( $_POST['bbp_topic_favoriters'] ) && ( '1' === $_POST['bbp_topic_favoriters'] ) ) {
1506  
1507          // Get the favoriters
1508          $favoriters = bbp_get_topic_favoriters( $source_topic->ID );
1509  
1510          if ( ! empty( $favoriters ) ) {
1511  
1512              // Add the favoriters to new topic
1513              foreach ( (array) $favoriters as $favoriter ) {
1514                  bbp_add_user_favorite( $favoriter, $destination_topic->ID );
1515              }
1516          }
1517      }
1518  
1519      /** Tags ******************************************************************/
1520  
1521      // Copy the tags if told to
1522      if ( ! empty( $_POST['bbp_topic_tags'] ) && ( '1' === $_POST['bbp_topic_tags'] ) ) {
1523  
1524          // Get the source topic tags
1525          $source_topic_tags = wp_get_post_terms( $source_topic->ID, bbp_get_topic_tag_tax_id(), array( 'fields' => 'names' ) );
1526  
1527          if ( ! empty( $source_topic_tags ) ) {
1528              wp_set_post_terms( $destination_topic->ID, $source_topic_tags, bbp_get_topic_tag_tax_id(), true );
1529          }
1530      }
1531  
1532      /** Split Replies *********************************************************/
1533  
1534      // get_posts() is not used because it doesn't allow us to use '>='
1535      // comparision without a filter.
1536      $bbp_db  = bbp_db();
1537      $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() );
1538      $replies = (array) $bbp_db->get_results( $query );
1539  
1540      // Make sure there are replies to loop through
1541      if ( ! empty( $replies ) && ! is_wp_error( $replies ) ) {
1542  
1543          // Save reply ids
1544          $reply_ids = array();
1545  
1546          // Change the post_parent of each reply to the destination topic id
1547          foreach ( $replies as $reply ) {
1548  
1549              // Update the reply
1550              wp_update_post( array(
1551                  'ID'          => $reply->ID,
1552                  'post_title'  => '',
1553                  'post_name'   => false, // will be automatically generated
1554                  'post_parent' => $destination_topic->ID,
1555                  'guid'        => ''
1556              ) );
1557  
1558              // Gather reply ids
1559              $reply_ids[] = $reply->ID;
1560  
1561              // Adjust reply meta values
1562              bbp_update_reply_topic_id( $reply->ID, $destination_topic->ID                           );
1563              bbp_update_reply_forum_id( $reply->ID, bbp_get_topic_forum_id( $destination_topic->ID ) );
1564  
1565              // Adjust reply position
1566              bbp_update_reply_position( $reply->ID );
1567  
1568              // Adjust reply to values
1569              $reply_to = bbp_get_reply_to( $reply->ID );
1570  
1571              // Not a reply to a reply that moved over
1572              if ( ! in_array( $reply_to, $reply_ids, true ) ) {
1573                  bbp_update_reply_to( $reply->ID, 0 );
1574              }
1575  
1576              // New topic from reply can't be a reply to
1577              if ( ( $from_reply->ID === $destination_topic->ID ) && ( $from_reply->ID === $reply_to ) ) {
1578                  bbp_update_reply_to( $reply->ID, 0 );
1579              }
1580  
1581              // Do additional actions per split reply
1582              do_action( 'bbp_split_topic_reply', $reply->ID, $destination_topic->ID );
1583          }
1584  
1585          // Remove reply to from new topic
1586          if ( $from_reply->ID === $destination_topic->ID ) {
1587              delete_post_meta( $from_reply->ID, '_bbp_reply_to' );
1588          }
1589  
1590          // Set the last reply ID and freshness
1591          $last_reply_id = $reply->ID;
1592          $freshness     = $reply->post_date;
1593  
1594      // Set the last reply ID and freshness to the from_reply
1595      } else {
1596          $last_reply_id = $from_reply->ID;
1597          $freshness     = $from_reply->post_date;
1598      }
1599  
1600      // It is a new topic and we need to set some default metas to make
1601      // the topic display in bbp_has_topics() list
1602      if ( 'reply' === $split_option ) {
1603          bbp_update_topic_last_reply_id   ( $destination_topic->ID, $last_reply_id );
1604          bbp_update_topic_last_active_id  ( $destination_topic->ID, $last_reply_id );
1605          bbp_update_topic_last_active_time( $destination_topic->ID, $freshness     );
1606      }
1607  
1608      // Update source topic ID last active
1609      bbp_update_topic_last_reply_id   ( $source_topic->ID );
1610      bbp_update_topic_last_active_id  ( $source_topic->ID );
1611      bbp_update_topic_last_active_time( $source_topic->ID );
1612  
1613      /** Successful Split ******************************************************/
1614  
1615      // Update counts, etc...
1616      do_action( 'bbp_post_split_topic', $from_reply->ID, $source_topic->ID, $destination_topic->ID );
1617  
1618      // Redirect back to the topic
1619      bbp_redirect( bbp_get_topic_permalink( $destination_topic->ID ) );
1620  }
1621  
1622  /**
1623   * Fix counts on topic split
1624   *
1625   * When a topic is split, update the counts of source and destination topic
1626   * and their forums.
1627   *
1628   * @since 2.0.0 bbPress (r2756)
1629   *
1630   * @param int $from_reply_id From reply id
1631   * @param int $source_topic_id Source topic id
1632   * @param int $destination_topic_id Destination topic id
1633   */
1634  function bbp_split_topic_count( $from_reply_id, $source_topic_id, $destination_topic_id ) {
1635  
1636      // Forum Topic Counts
1637      bbp_update_forum_topic_count( bbp_get_topic_forum_id( $destination_topic_id ) );
1638  
1639      // Forum Reply Counts
1640      bbp_update_forum_reply_count( bbp_get_topic_forum_id( $destination_topic_id ) );
1641  
1642      // Topic Reply Counts
1643      bbp_update_topic_reply_count( $source_topic_id      );
1644      bbp_update_topic_reply_count( $destination_topic_id );
1645  
1646      // Topic Hidden Reply Counts
1647      bbp_update_topic_reply_count_hidden( $source_topic_id      );
1648      bbp_update_topic_reply_count_hidden( $destination_topic_id );
1649  
1650      // Topic Voice Counts
1651      bbp_update_topic_voice_count( $source_topic_id      );
1652      bbp_update_topic_voice_count( $destination_topic_id );
1653  
1654      do_action( 'bbp_split_topic_count', $from_reply_id, $source_topic_id, $destination_topic_id );
1655  }
1656  
1657  /**
1658   * Handles the front end tag management (renaming, merging, destroying)
1659   *
1660   * @since 2.0.0 bbPress (r2768)
1661   *
1662   * @param string $action The requested action to compare this function to
1663   */
1664  function bbp_edit_topic_tag_handler( $action = '' ) {
1665  
1666      // Bail if required POST actions aren't passed
1667      if ( empty( $_POST['tag-id'] ) ) {
1668          return;
1669      }
1670  
1671      // Setup possible get actions
1672      $possible_actions = array(
1673          'bbp-update-topic-tag',
1674          'bbp-merge-topic-tag',
1675          'bbp-delete-topic-tag'
1676      );
1677  
1678      // Bail if actions aren't meant for this function
1679      if ( ! in_array( $action, $possible_actions, true ) ) {
1680          return;
1681      }
1682  
1683      // Setup vars
1684      $tag_id = (int) $_POST['tag-id'];
1685      $tag    = get_term( $tag_id, bbp_get_topic_tag_tax_id() );
1686  
1687      // Tag does not exist
1688      if ( is_wp_error( $tag ) && $tag->get_error_message() ) {
1689          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() ) );
1690          return;
1691      }
1692  
1693      // What action are we trying to perform?
1694      switch ( $action ) {
1695  
1696          // Update tag
1697          case 'bbp-update-topic-tag' :
1698  
1699              // Nonce check
1700              if ( ! bbp_verify_nonce_request( 'update-tag_' . $tag_id ) ) {
1701                  bbp_add_error( 'bbp_manage_topic_tag_update_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
1702                  return;
1703              }
1704  
1705              // Can user edit topic tags?
1706              if ( ! current_user_can( 'edit_topic_tag', $tag_id ) ) {
1707                  bbp_add_error( 'bbp_manage_topic_tag_update_permission', __( '<strong>Error</strong>: You do not have permission to edit the topic tags.', 'bbpress' ) );
1708                  return;
1709              }
1710  
1711              // No tag name was provided
1712              if ( empty( $_POST['tag-name'] ) || ! $name = $_POST['tag-name'] ) {
1713                  bbp_add_error( 'bbp_manage_topic_tag_update_name', __( '<strong>Error</strong>: You need to enter a tag name.', 'bbpress' ) );
1714                  return;
1715              }
1716  
1717              // Attempt to update the tag
1718              $slug        = ! empty( $_POST['tag-slug']        ) ? $_POST['tag-slug']        : '';
1719              $description = ! empty( $_POST['tag-description'] ) ? $_POST['tag-description'] : '';
1720              $tag         = wp_update_term( $tag_id, bbp_get_topic_tag_tax_id(), array(
1721                  'name'        => $name,
1722                  'slug'        => $slug,
1723                  'description' => $description
1724              ) );
1725  
1726              // Cannot update tag
1727              if ( is_wp_error( $tag ) && $tag->get_error_message() ) {
1728                  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() ) );
1729                  return;
1730              }
1731  
1732              // Redirect
1733              $redirect = get_term_link( $tag_id, bbp_get_topic_tag_tax_id() );
1734  
1735              // Update counts, etc...
1736              do_action( 'bbp_update_topic_tag', $tag_id, $tag, $name, $slug, $description );
1737  
1738              break;
1739  
1740          // Merge two tags
1741          case 'bbp-merge-topic-tag'  :
1742  
1743              // Nonce check
1744              if ( ! bbp_verify_nonce_request( 'merge-tag_' . $tag_id ) ) {
1745                  bbp_add_error( 'bbp_manage_topic_tag_merge_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
1746                  return;
1747              }
1748  
1749              // Can user edit topic tags?
1750              if ( ! current_user_can( 'edit_topic_tags' ) ) {
1751                  bbp_add_error( 'bbp_manage_topic_tag_merge_permission', __( '<strong>Error</strong>: You do not have permission to edit the topic tags.', 'bbpress' ) );
1752                  return;
1753              }
1754  
1755              // No tag name was provided
1756              if ( empty( $_POST['tag-existing-name'] ) || ! $name = $_POST['tag-existing-name'] ) {
1757                  bbp_add_error( 'bbp_manage_topic_tag_merge_name', __( '<strong>Error</strong>: You need to enter a tag name.', 'bbpress' ) );
1758                  return;
1759              }
1760  
1761              // If term does not exist, create it
1762              if ( ! $tag = term_exists( $name, bbp_get_topic_tag_tax_id() ) ) {
1763                  $tag = wp_insert_term( $name, bbp_get_topic_tag_tax_id() );
1764              }
1765  
1766              // Problem inserting the new term
1767              if ( is_wp_error( $tag ) && $tag->get_error_message() ) {
1768                  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() ) );
1769                  return;
1770              }
1771  
1772              // Merging in to...
1773              $to_tag = $tag['term_id'];
1774  
1775              // Attempting to merge a tag into itself
1776              if ( $tag_id === $to_tag ) {
1777                  bbp_add_error( 'bbp_manage_topic_tag_merge_same', __( '<strong>Error</strong>: The tags which are being merged can not be the same.', 'bbpress' ) );
1778                  return;
1779              }
1780  
1781              // Delete the old term
1782              $tag = wp_delete_term( $tag_id, bbp_get_topic_tag_tax_id(), array(
1783                  'default'       => $to_tag,
1784                  'force_default' => true
1785              ) );
1786  
1787              // Error merging the terms
1788              if ( is_wp_error( $tag ) && $tag->get_error_message() ) {
1789                  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() ) );
1790                  return;
1791              }
1792  
1793              // Redirect
1794              $redirect = get_term_link( (int) $to_tag, bbp_get_topic_tag_tax_id() );
1795  
1796              // Update counts, etc...
1797              do_action( 'bbp_merge_topic_tag', $tag_id, $to_tag, $tag );
1798  
1799              break;
1800  
1801          // Delete tag
1802          case 'bbp-delete-topic-tag' :
1803  
1804              // Nonce check
1805              if ( ! bbp_verify_nonce_request( 'delete-tag_' . $tag_id ) ) {
1806                  bbp_add_error( 'bbp_manage_topic_tag_delete_nonce', __( '<strong>Error</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
1807                  return;
1808              }
1809  
1810              // Can user delete topic tags?
1811              if ( ! current_user_can( 'delete_topic_tag', $tag_id ) ) {
1812                  bbp_add_error( 'bbp_manage_topic_tag_delete_permission', __( '<strong>Error</strong>: You do not have permission to delete the topic tags.', 'bbpress' ) );
1813                  return;
1814              }
1815  
1816              // Attempt to delete term
1817              $tag = wp_delete_term( $tag_id, bbp_get_topic_tag_tax_id() );
1818  
1819              // Error deleting term
1820              if ( is_wp_error( $tag ) && $tag->get_error_message() ) {
1821                  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() ) );
1822                  return;
1823              }
1824  
1825              // We don't have any other place to go other than home! Or we may die because of the 404 disease
1826              $redirect = bbp_get_forums_url();
1827  
1828              // Update counts, etc...
1829              do_action( 'bbp_delete_topic_tag', $tag_id, $tag );
1830  
1831              break;
1832      }
1833  
1834      /** Successful Moderation *************************************************/
1835  
1836      // Redirect back
1837      $redirect = ( ! empty( $redirect ) && ! is_wp_error( $redirect ) ) ? $redirect : home_url();
1838      bbp_redirect( $redirect );
1839  }
1840  
1841  /** Helpers *******************************************************************/
1842  
1843  /**
1844   * Return an associative array of available topic statuses
1845   *
1846   * @since 2.4.0 bbPress (r5059)
1847   *
1848   * @param int $topic_id   Optional. Topic id.
1849   *
1850   * @return array
1851   */
1852  function bbp_get_topic_statuses( $topic_id = 0 ) {
1853  
1854      // Filter & return
1855      return (array) apply_filters( 'bbp_get_topic_statuses', array(
1856          bbp_get_public_status_id()  => _x( 'Open',    'Open the topic',      'bbpress' ),
1857          bbp_get_closed_status_id()  => _x( 'Closed',  'Close the topic',     'bbpress' ),
1858          bbp_get_spam_status_id()    => _x( 'Spam',    'Spam the topic',      'bbpress' ),
1859          bbp_get_trash_status_id()   => _x( 'Trash',   'Trash the topic',     'bbpress' ),
1860          bbp_get_pending_status_id() => _x( 'Pending', 'Unapprove the topic', 'bbpress' )
1861      ), $topic_id );
1862  }
1863  
1864  /**
1865   * Return an associative array of topic sticky types
1866   *
1867   * @since 2.4.0 bbPress (r5059)
1868   *
1869   * @param int $topic_id   Optional. Topic id.
1870   *
1871   * @return array
1872   */
1873  function bbp_get_topic_types( $topic_id = 0 ) {
1874  
1875      // Filter & return
1876      return (array) apply_filters( 'bbp_get_topic_types', array(
1877          'unstick' => _x( 'Normal',       'Unstick a topic',         'bbpress' ),
1878          'stick'   => _x( 'Sticky',       'Make topic sticky',       'bbpress' ),
1879          'super'   => _x( 'Super Sticky', 'Make topic super sticky', 'bbpress' )
1880      ), $topic_id );
1881  }
1882  
1883  /**
1884   * Return array of available topic toggle actions
1885   *
1886   * @since 2.6.0 bbPress (r6133)
1887   *
1888   * @param int $topic_id   Optional. Topic id.
1889   *
1890   * @return array
1891   */
1892  function bbp_get_topic_toggles( $topic_id = 0 ) {
1893  
1894      // Filter & return
1895      return (array) apply_filters( 'bbp_get_toggle_topic_actions', array(
1896          'bbp_toggle_topic_close',
1897          'bbp_toggle_topic_stick',
1898          'bbp_toggle_topic_spam',
1899          'bbp_toggle_topic_trash',
1900          'bbp_toggle_topic_approve'
1901      ), $topic_id );
1902  }
1903  
1904  /**
1905   * Return array of public topic statuses.
1906   *
1907   * @since 2.6.0 bbPress (r6383)
1908   *
1909   * @return array
1910   */
1911  function bbp_get_public_topic_statuses() {
1912      $statuses = array(
1913          bbp_get_public_status_id(),
1914          bbp_get_closed_status_id()
1915      );
1916  
1917      // Filter & return
1918      return (array) apply_filters( 'bbp_get_public_topic_statuses', $statuses );
1919  }
1920  
1921  /**
1922   * Return array of non-public topic statuses.
1923   *
1924   * @since 2.6.0 bbPress (r6642)
1925   *
1926   * @return array
1927   */
1928  function bbp_get_non_public_topic_statuses() {
1929      $statuses = array(
1930          bbp_get_trash_status_id(),
1931          bbp_get_spam_status_id(),
1932          bbp_get_pending_status_id()
1933      );
1934  
1935      // Filter & return
1936      return (array) apply_filters( 'bbp_get_non_public_topic_statuses', $statuses );
1937  }
1938  
1939  /** Stickies ******************************************************************/
1940  
1941  /**
1942   * Return sticky topics of a forum
1943   *
1944   * @since 2.0.0 bbPress (r2592)
1945   *
1946   * @param int $forum_id Optional. If not passed, super stickies are returned.
1947   * @return array IDs of sticky topics of a forum or super stickies
1948   */
1949  function bbp_get_stickies( $forum_id = 0 ) {
1950  
1951      // Get stickies (maybe super if empty)
1952      $stickies = empty( $forum_id )
1953          ? bbp_get_super_stickies()
1954          : get_post_meta( $forum_id, '_bbp_sticky_topics', true );
1955  
1956      // Cast as array
1957      $stickies = ( empty( $stickies ) || ! is_array( $stickies ) )
1958          ? array()
1959          : wp_parse_id_list( $stickies );
1960  
1961      // Filter & return
1962      return (array) apply_filters( 'bbp_get_stickies', $stickies, $forum_id );
1963  }
1964  
1965  /**
1966   * Return topics stuck to front page of the forums
1967   *
1968   * @since 2.0.0 bbPress (r2592)
1969   *
1970   * @return array IDs of super sticky topics
1971   */
1972  function bbp_get_super_stickies() {
1973  
1974      // Get super stickies
1975      $stickies = get_option( '_bbp_super_sticky_topics', array() );
1976  
1977      // Cast as array
1978      $stickies = ( empty( $stickies ) || ! is_array( $stickies ) )
1979          ? array()
1980          : wp_parse_id_list( $stickies );
1981  
1982      // Filter & return
1983      return (array) apply_filters( 'bbp_get_super_stickies', $stickies );
1984  }
1985  
1986  /** Topics Actions ************************************************************/
1987  
1988  /**
1989   * Handles the front end opening/closing, spamming/unspamming,
1990   * sticking/unsticking and trashing/untrashing/deleting of topics
1991   *
1992   * @since 2.0.0 bbPress (r2727)
1993   *
1994   * @param string $action The requested action to compare this function to
1995   */
1996  function bbp_toggle_topic_handler( $action = '' ) {
1997  
1998      // Bail if required GET actions aren't passed
1999      if ( empty( $_GET['topic_id'] ) ) {
2000          return;
2001      }
2002  
2003      // What's the topic id?
2004      $topic_id = bbp_get_topic_id( (int) $_GET['topic_id'] );
2005  
2006      // Get possible topic-handler toggles
2007      $toggles = bbp_get_topic_toggles( $topic_id );
2008  
2009      // Bail if actions aren't meant for this function
2010      if ( ! in_array( $action, $toggles, true ) ) {
2011          return;
2012      }
2013  
2014      // Make sure topic exists
2015      $topic = bbp_get_topic( $topic_id );
2016      if ( empty( $topic ) ) {
2017          bbp_add_error( 'bbp_toggle_topic_missing', __( '<strong>Error</strong>: This topic could not be found or no longer exists.', 'bbpress' ) );
2018          return;
2019      }
2020  
2021      // What is the user doing here?
2022      if ( ! current_user_can( 'edit_topic', $topic_id ) || ( 'bbp_toggle_topic_trash' === $action && ! current_user_can( 'delete_topic', $topic_id ) ) ) {
2023          bbp_add_error( 'bbp_toggle_topic_permission', __( '<strong>Error</strong>: You do not have permission to do that.', 'bbpress' ) );
2024          return;
2025      }
2026  
2027      // Sub-action?
2028      $sub_action = ! empty( $_GET['sub_action'] )
2029          ? sanitize_key( $_GET['sub_action'] )
2030          : false;
2031  
2032      // Preliminary array
2033      $post_data = array( 'ID' => $topic_id );
2034  
2035      // Do the topic toggling
2036      $retval = bbp_toggle_topic( array(
2037          'id'         => $topic_id,
2038          'action'     => $action,
2039          'sub_action' => $sub_action,
2040          'data'       => $post_data
2041      ) );
2042  
2043      // Do additional topic toggle actions
2044      do_action( 'bbp_toggle_topic_handler', $retval['status'], $post_data, $action );
2045  
2046      // No errors
2047      if ( ( false !== $retval['status'] ) && ! is_wp_error( $retval['status'] ) ) {
2048          bbp_redirect( $retval['redirect_to'] );
2049  
2050      // Handle errors
2051      } else {
2052          bbp_add_error( 'bbp_toggle_topic', $retval['message'] );
2053      }
2054  }
2055  
2056  /**
2057   * Do the actual topic toggling
2058   *
2059   * This function is used by `bbp_toggle_topic_handler()` to do the actual heavy
2060   * lifting when it comes to toggling topic. It only really makes sense to call
2061   * within that context, so if you need to call this function directly, make sure
2062   * you're also doing what the handler does too.
2063   *
2064   * @since 2.6.0  bbPress (r6133)
2065   * @access private
2066   *
2067   * @param array $args
2068   */
2069  function bbp_toggle_topic( $args = array() ) {
2070  
2071      // Parse the arguments
2072      $r = bbp_parse_args( $args, array(
2073          'id'         => 0,
2074          'action'     => '',
2075          'sub_action' => '',
2076          'data'       => array()
2077      ) );
2078  
2079      // Build the nonce suffix
2080      $nonce_suffix = bbp_get_topic_post_type() . '_' . (int) $r['id'];
2081  
2082      // Default return values
2083      $retval = array(
2084          'status'      => 0,
2085          'message'     => '',
2086          'redirect_to' => bbp_get_topic_permalink( $r['id'], bbp_get_redirect_to() ),
2087          'view_all'    => false
2088      );
2089  
2090      // What action are we trying to perform?
2091      switch ( $r['action'] ) {
2092  
2093          // Toggle approve/unapprove
2094          case 'bbp_toggle_topic_approve' :
2095              check_ajax_referer( "approve-{$nonce_suffix}" );
2096  
2097              $is_pending         = bbp_is_topic_pending( $r['id'] );
2098              $retval['view_all'] = ! $is_pending;
2099  
2100              // Toggle
2101              $retval['status'] = ( true === $is_pending )
2102                  ? bbp_approve_topic( $r['id'] )
2103                  : bbp_unapprove_topic( $r['id'] );
2104  
2105              // Feedback
2106              $retval['message'] = ( true === $is_pending )
2107                  ? __( '<strong>Error</strong>: There was a problem approving the topic.',   'bbpress' )
2108                  : __( '<strong>Error</strong>: There was a problem unapproving the topic.', 'bbpress' );
2109  
2110              break;
2111  
2112          // Toggle open/close
2113          case 'bbp_toggle_topic_close' :
2114              check_ajax_referer( "close-{$nonce_suffix}" );
2115  
2116              $is_open = bbp_is_topic_open( $r['id'] );
2117  
2118              // Toggle
2119              $retval['status'] = ( true === $is_open )
2120                  ? bbp_close_topic( $r['id'] )
2121                  : bbp_open_topic( $r['id'] );
2122  
2123              // Feedback
2124              $retval['message'] = ( true === $is_open )
2125                  ? __( '<strong>Error</strong>: There was a problem closing the topic.', 'bbpress' )
2126                  : __( '<strong>Error</strong>: There was a problem opening the topic.', 'bbpress' );
2127  
2128              break;
2129  
2130          // Toggle sticky/super-sticky/unstick
2131          case 'bbp_toggle_topic_stick' :
2132              check_ajax_referer( "stick-{$nonce_suffix}" );
2133  
2134              $is_sticky = bbp_is_topic_sticky( $r['id'] );
2135              $is_super  = false === $is_sticky && ! empty( $_GET['super'] ) && ( '1' === $_GET['super'] ) ? true : false;
2136  
2137              // Toggle
2138              $retval['status'] = ( true === $is_sticky )
2139                  ? bbp_unstick_topic( $r['id'] )
2140                  : bbp_stick_topic( $r['id'], $is_super );
2141  
2142              // Feedback
2143              $retval['message'] = ( true === $is_sticky )
2144                  ? __( '<strong>Error</strong>: There was a problem unsticking the topic.', 'bbpress' )
2145                  : __( '<strong>Error</strong>: There was a problem sticking the topic.',   'bbpress' );
2146  
2147              break;
2148  
2149          // Toggle spam
2150          case 'bbp_toggle_topic_spam' :
2151              check_ajax_referer( "spam-{$nonce_suffix}" );
2152  
2153              $is_spam            = bbp_is_topic_spam( $r['id'] );
2154              $retval['view_all'] = ! $is_spam;
2155  
2156              // Toggle
2157              $retval['status'] = ( true === $is_spam )
2158                  ? bbp_unspam_topic( $r['id'] )
2159                  : bbp_spam_topic( $r['id'] );
2160  
2161              // Feedback
2162              $retval['message'] = ( true === $is_spam )
2163                  ? __( '<strong>Error</strong>: There was a problem unmarking the topic as spam.', 'bbpress' )
2164                  : __( '<strong>Error</strong>: There was a problem marking the topic as spam.',   'bbpress' );
2165  
2166              break;
2167  
2168          // Toggle trash
2169          case 'bbp_toggle_topic_trash' :
2170  
2171              switch ( $r['sub_action'] ) {
2172                  case 'trash':
2173                      check_ajax_referer( "trash-{$nonce_suffix}" );
2174  
2175                      $retval['view_all']    = true;
2176                      $retval['status']      = wp_trash_post( $r['id'] );
2177                      $retval['message']     = __( '<strong>Error</strong>: There was a problem trashing the topic.', 'bbpress' );
2178                      $retval['redirect_to'] = current_user_can( 'view_trash' )
2179                          ? bbp_get_topic_permalink( $r['id'] )
2180                          : bbp_get_forum_permalink( bbp_get_topic_forum_id( $r['id'] ) );
2181  
2182                      break;
2183  
2184                  case 'untrash':
2185                      check_ajax_referer( "untrash-{$nonce_suffix}" );
2186  
2187                      $retval['status']      = wp_untrash_post( $r['id'] );
2188                      $retval['message']     = __( '<strong>Error</strong>: There was a problem untrashing the topic.', 'bbpress' );
2189                      $retval['redirect_to'] = bbp_get_topic_permalink( $r['id'] );
2190  
2191                      break;
2192  
2193                  case 'delete':
2194                      check_ajax_referer( "delete-{$nonce_suffix}" );
2195  
2196                      $retval['status']      = wp_delete_post( $r['id'] );
2197                      $retval['message']     = __( '<strong>Error</strong>: There was a problem deleting the topic.', 'bbpress' );
2198                      $retval['redirect_to'] = bbp_get_forum_permalink( $retval['status']->post_parent );
2199  
2200                      break;
2201              }
2202  
2203              break;
2204      }
2205  
2206      // Add view all if needed
2207      if ( ! empty( $retval['view_all'] ) ) {
2208          $retval['redirect_to'] = bbp_add_view_all( $retval['redirect_to'], true );
2209      }
2210  
2211      // Filter & return
2212      return apply_filters( 'bbp_toggle_topic', $retval, $r, $args );
2213  }
2214  
2215  /** Favorites & Subscriptions *************************************************/
2216  
2217  /**
2218   * Remove a deleted topic from all user favorites
2219   *
2220   * @since 2.0.0 bbPress (r2652)
2221   *
2222   * @param int $topic_id Get the topic id to remove
2223   */
2224  function bbp_remove_topic_from_all_favorites( $topic_id = 0 ) {
2225      $topic_id = bbp_get_topic_id( $topic_id );
2226  
2227      // Bail if no topic
2228      if ( empty( $topic_id ) ) {
2229          return;
2230      }
2231  
2232      // Get users
2233      $users = (array) bbp_get_topic_favoriters( $topic_id );
2234  
2235      // Users exist
2236      if ( ! empty( $users ) ) {
2237  
2238          // Loop through users
2239          foreach ( $users as $user ) {
2240  
2241              // Remove each user
2242              bbp_remove_user_favorite( $user, $topic_id );
2243          }
2244      }
2245  }
2246  
2247  /**
2248   * Remove a deleted topic from all user subscriptions
2249   *
2250   * @since 2.0.0 bbPress (r2652)
2251   *
2252   * @param int $topic_id Get the topic id to remove
2253   */
2254  function bbp_remove_topic_from_all_subscriptions( $topic_id = 0 ) {
2255  
2256      // Subscriptions are not active
2257      if ( ! bbp_is_subscriptions_active() ) {
2258          return;
2259      }
2260  
2261      // Bail if no topic
2262      $topic_id = bbp_get_topic_id( $topic_id );
2263      if ( empty( $topic_id ) ) {
2264          return;
2265      }
2266  
2267      // Remove all users
2268      return bbp_remove_object_from_all_users( $topic_id, '_bbp_subscription', 'post' );
2269  }
2270  
2271  /** Count Bumpers *************************************************************/
2272  
2273  /**
2274   * Bump the total reply count of a topic
2275   *
2276   * @since 2.1.0 bbPress (r3825)
2277   *
2278   * @param int $topic_id   Optional. Topic id.
2279   * @param int $difference Optional. Default 1
2280   * @return int Topic reply count
2281   */
2282  function bbp_bump_topic_reply_count( $topic_id = 0, $difference = 1 ) {
2283  
2284      // Bail if no bump
2285      if ( empty( $difference ) ) {
2286          return false;
2287      }
2288  
2289      // Get counts
2290      $topic_id    = bbp_get_topic_id( $topic_id );
2291      $reply_count = bbp_get_topic_reply_count( $topic_id, true );
2292      $difference  = (int) $difference;
2293      $new_count   = (int) ( $reply_count + $difference );
2294  
2295      // Update this topic id's reply count
2296      update_post_meta( $topic_id, '_bbp_reply_count', $new_count );
2297  
2298      // Filter & return
2299      return (int) apply_filters( 'bbp_bump_topic_reply_count', $new_count, $topic_id, $difference );
2300  }
2301  
2302  /**
2303   * Increase the total reply count of a topic by one.
2304   *
2305   * @since 2.6.0 bbPress (r6036)
2306   *
2307   * @param int $topic_id The topic id.
2308   *
2309   * @return void
2310   */
2311  function bbp_increase_topic_reply_count( $topic_id = 0 ) {
2312  
2313      // Bail early if no id is passed.
2314      if ( empty( $topic_id ) ) {
2315          return;
2316      }
2317  
2318      // If it's a reply, get the topic id.
2319      if ( bbp_is_reply( $topic_id ) ) {
2320          $reply_id = $topic_id;
2321          $topic_id = bbp_get_reply_topic_id( $reply_id );
2322  
2323          // Update inverse based on item status
2324          if ( ! bbp_is_reply_public( $reply_id ) ) {
2325              bbp_increase_topic_reply_count_hidden( $topic_id );
2326              return;
2327          }
2328      }
2329  
2330      // Bump up
2331      bbp_bump_topic_reply_count( $topic_id );
2332  }
2333  
2334  /**
2335   * Decrease the total reply count of a topic by one.
2336   *
2337   * @since 2.6.0 bbPress (r6036)
2338   *
2339   * @param int $topic_id The topic id.
2340   *
2341   * @return void
2342   */
2343  function bbp_decrease_topic_reply_count( $topic_id = 0 ) {
2344  
2345      // Bail early if no id is passed.
2346      if ( empty( $topic_id ) ) {
2347          return;
2348      }
2349  
2350      // If it's a reply, get the topic id.
2351      if ( bbp_is_reply( $topic_id ) ) {
2352          $reply_id = $topic_id;
2353          $topic_id = bbp_get_reply_topic_id( $reply_id );
2354  
2355          // Update inverse based on item status
2356          if ( ! bbp_is_reply_public( $reply_id ) ) {
2357              bbp_decrease_topic_reply_count_hidden( $topic_id );
2358              return;
2359          }
2360      }
2361  
2362      // Bump down
2363      bbp_bump_topic_reply_count( $topic_id, -1 );
2364  }
2365  
2366  /**
2367   * Bump the total hidden reply count of a topic
2368   *
2369   * @since 2.1.0 bbPress (r3825)
2370   *
2371   * @param int $topic_id   Optional. Topic id.
2372   * @param int $difference Optional. Default 1
2373   * @return int Topic hidden reply count
2374   */
2375  function bbp_bump_topic_reply_count_hidden( $topic_id = 0, $difference = 1 ) {
2376  
2377      // Bail if no bump
2378      if ( empty( $difference ) ) {
2379          return false;
2380      }
2381  
2382      // Get counts
2383      $topic_id    = bbp_get_topic_id( $topic_id );
2384      $reply_count = bbp_get_topic_reply_count_hidden( $topic_id, true );
2385      $difference  = (int) $difference;
2386      $new_count   = (int) ( $reply_count + $difference );
2387  
2388      // Update this topic id's hidden reply count
2389      update_post_meta( $topic_id, '_bbp_reply_count_hidden', $new_count );
2390  
2391      // Filter & return
2392      return (int) apply_filters( 'bbp_bump_topic_reply_count_hidden', $new_count, $topic_id, $difference );
2393  }
2394  
2395  /**
2396   * Increase the total hidden reply count of a topic by one.
2397   *
2398   * @since 2.6.0 bbPress (r6036)
2399   *
2400   * @param int $topic_id The topic id.
2401   *
2402   * @return void
2403   */
2404  function bbp_increase_topic_reply_count_hidden( $topic_id = 0 ) {
2405  
2406      // Bail early if no id is passed.
2407      if ( empty( $topic_id ) ) {
2408          return;
2409      }
2410  
2411      // If it's a reply, get the topic id.
2412      if ( bbp_is_reply( $topic_id ) ) {
2413          $reply_id = $topic_id;
2414          $topic_id = bbp_get_reply_topic_id( $reply_id );
2415  
2416          // Update inverse based on item status
2417          if ( bbp_is_reply_public( $reply_id ) ) {
2418              bbp_increase_topic_reply_count( $topic_id );
2419              return;
2420          }
2421      }
2422  
2423      // Bump up
2424      bbp_bump_topic_reply_count_hidden( $topic_id );
2425  }
2426  
2427  /**
2428   * Decrease the total hidden reply count of a topic by one.
2429   *
2430   * @since 2.6.0 bbPress (r6036)
2431   *
2432   * @param int $topic_id The topic id.
2433   *
2434   * @return void
2435   */
2436  function bbp_decrease_topic_reply_count_hidden( $topic_id = 0 ) {
2437  
2438      // Bail early if no id is passed.
2439      if ( empty( $topic_id ) ) {
2440          return;
2441      }
2442  
2443      // If it's a reply, get the topic id.
2444      if ( bbp_is_reply( $topic_id ) ) {
2445          $reply_id = $topic_id;
2446          $topic_id = bbp_get_reply_topic_id( $reply_id );
2447  
2448          // Update inverse based on item status
2449          if ( bbp_is_reply_public( $reply_id ) ) {
2450              bbp_decrease_topic_reply_count( $topic_id );
2451              return;
2452          }
2453      }
2454  
2455      // Bump down
2456      bbp_bump_topic_reply_count_hidden( $topic_id, -1 );
2457  }
2458  
2459  /**
2460   * Update counts after a topic is inserted via `bbp_insert_topic`.
2461   *
2462   * @since 2.6.0 bbPress (r6036)
2463   *
2464   * @param int $topic_id The topic id.
2465   * @param int $forum_id The forum id.
2466   *
2467   * @return void
2468   */
2469  function bbp_insert_topic_update_counts( $topic_id = 0, $forum_id = 0 ) {
2470  
2471      // If the topic is public, update the forum topic counts.
2472      if ( bbp_is_topic_public( $topic_id ) ) {
2473          bbp_increase_forum_topic_count( $forum_id );
2474  
2475      // If the topic isn't public only update the forum topic hidden count.
2476      } else {
2477          bbp_increase_forum_topic_count_hidden( $forum_id );
2478      }
2479  }
2480  
2481  /** Topic Updaters ************************************************************/
2482  
2483  /**
2484   * Update the topic's forum id
2485   *
2486   * @since 2.0.0 bbPress (r2855)
2487   *
2488   * @param int $topic_id Optional. Topic id to update
2489   * @param int $forum_id Optional. Forum id
2490   * @return int Forum id
2491   */
2492  function bbp_update_topic_forum_id( $topic_id = 0, $forum_id = 0 ) {
2493  
2494      // If it's a reply, then get the parent (topic id)
2495      $topic_id = bbp_is_reply( $topic_id )
2496          ? bbp_get_reply_topic_id( $topic_id )
2497          : bbp_get_topic_id( $topic_id );
2498  
2499      // Forum ID fallback
2500      if ( empty( $forum_id ) ) {
2501          $forum_id = get_post_field( 'post_parent', $topic_id );
2502      }
2503  
2504      $forum_id = (int) $forum_id;
2505  
2506      update_post_meta( $topic_id, '_bbp_forum_id', $forum_id );
2507  
2508      // Filter & return
2509      return (int) apply_filters( 'bbp_update_topic_forum_id', $forum_id, $topic_id );
2510  }
2511  
2512  /**
2513   * Update the topic's topic id
2514   *
2515   * @since 2.0.0 bbPress (r2954)
2516   *
2517   * @param int $topic_id Optional. Topic id to update
2518   * @return int Topic id
2519   */
2520  function bbp_update_topic_topic_id( $topic_id = 0 ) {
2521      $topic_id = bbp_get_topic_id( $topic_id );
2522  
2523      update_post_meta( $topic_id, '_bbp_topic_id', $topic_id );
2524  
2525      // Filter & return
2526      return apply_filters( 'bbp_update_topic_topic_id', $topic_id );
2527  }
2528  
2529  /**
2530   * Adjust the total reply count of a topic
2531   *
2532   * @since 2.0.0 bbPress (r2467)
2533   *
2534   * @param int $topic_id Optional. Topic id to update
2535   * @param int $reply_count Optional. Set the reply count manually.
2536   * @return int Topic reply count
2537   */
2538  function bbp_update_topic_reply_count( $topic_id = 0, $reply_count = false ) {
2539  
2540      // If it's a reply, then get the parent (topic id)
2541      $topic_id = bbp_is_reply( $topic_id )
2542          ? bbp_get_reply_topic_id( $topic_id )
2543          : bbp_get_topic_id( $topic_id );
2544  
2545      // Get replies of topic if not passed
2546      $reply_count = ! is_int( $reply_count )
2547          ? bbp_get_public_child_count( $topic_id, bbp_get_reply_post_type() )
2548          : (int) $reply_count;
2549  
2550      update_post_meta( $topic_id, '_bbp_reply_count', $reply_count );
2551  
2552      // Filter & return
2553      return (int) apply_filters( 'bbp_update_topic_reply_count', $reply_count, $topic_id );
2554  }
2555  
2556  /**
2557   * Adjust the total hidden reply count of a topic (hidden includes trashed,
2558   * spammed and pending replies)
2559   *
2560   * @since 2.0.0 bbPress (r2740)
2561   *
2562   * @param int $topic_id Optional. Topic id to update
2563   * @param int $reply_count Optional. Set the reply count manually
2564   * @return int Topic hidden reply count
2565   */
2566  function bbp_update_topic_reply_count_hidden( $topic_id = 0, $reply_count = false ) {
2567  
2568      // If it's a reply, then get the parent (topic id)
2569      $topic_id = bbp_is_reply( $topic_id )
2570          ? bbp_get_reply_topic_id( $topic_id )
2571          : bbp_get_topic_id( $topic_id );
2572  
2573      // Get replies of topic
2574      $reply_count = ! is_int( $reply_count )
2575          ? bbp_get_non_public_child_count( $topic_id, bbp_get_reply_post_type() )
2576          : (int) $reply_count;
2577  
2578      update_post_meta( $topic_id, '_bbp_reply_count_hidden', $reply_count );
2579  
2580      // Filter & return
2581      return (int) apply_filters( 'bbp_update_topic_reply_count_hidden', $reply_count, $topic_id );
2582  }
2583  
2584  /**
2585   * Update the topic with the last active post ID
2586   *
2587   * @since 2.0.0 bbPress (r2888)
2588   *
2589   * @param int $topic_id Optional. Topic id to update
2590   * @param int $active_id Optional. active id
2591   * @return int Active id
2592   */
2593  function bbp_update_topic_last_active_id( $topic_id = 0, $active_id = 0 ) {
2594  
2595      // If it's a reply, then get the parent (topic id)
2596      $topic_id = bbp_is_reply( $topic_id )
2597          ? bbp_get_reply_topic_id( $topic_id )
2598          : bbp_get_topic_id( $topic_id );
2599  
2600      // Get last public active id if not passed
2601      if ( empty( $active_id ) ) {
2602          $active_id = bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() );
2603      }
2604  
2605      // Adjust last_id's based on last_reply post_type
2606      if ( empty( $active_id ) || ! bbp_is_reply( $active_id ) ) {
2607          $active_id = $topic_id;
2608      }
2609  
2610      $active_id = (int) $active_id;
2611  
2612      // Update only if published
2613      update_post_meta( $topic_id, '_bbp_last_active_id', $active_id );
2614  
2615      // Filter & return
2616      return (int) apply_filters( 'bbp_update_topic_last_active_id', $active_id, $topic_id );
2617  }
2618  
2619  /**
2620   * Update the topics last active date/time (aka freshness)
2621   *
2622   * @since 2.0.0 bbPress (r2680)
2623   *
2624   * @param int    $topic_id Optional. Topic id.
2625   * @param string $new_time Optional. New time in mysql format.
2626   * @return string MySQL timestamp of last active reply
2627   */
2628  function bbp_update_topic_last_active_time( $topic_id = 0, $new_time = '' ) {
2629  
2630      // If it's a reply, then get the parent (topic id)
2631      $topic_id = bbp_is_reply( $topic_id )
2632          ? bbp_get_reply_topic_id( $topic_id )
2633          : bbp_get_topic_id( $topic_id );
2634  
2635      // Check time and use current if empty
2636      if ( empty( $new_time ) ) {
2637          $new_time = get_post_field( 'post_date', bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() ) );
2638      }
2639  
2640      // Update only if published
2641      if ( ! empty( $new_time ) ) {
2642          update_post_meta( $topic_id, '_bbp_last_active_time', $new_time );
2643      }
2644  
2645      // Filter & return
2646      return apply_filters( 'bbp_update_topic_last_active_time', $new_time, $topic_id );
2647  }
2648  
2649  /**
2650   * Update the topic with the most recent reply ID
2651   *
2652   * @since 2.0.0 bbPress (r2625)
2653   *
2654   * @param int $topic_id Optional. Topic id to update
2655   * @param int $reply_id Optional. Reply id
2656   * @return int Reply id
2657   */
2658  function bbp_update_topic_last_reply_id( $topic_id = 0, $reply_id = 0 ) {
2659  
2660      // If it's a reply, then get the parent (topic id)
2661      if ( empty( $reply_id ) && bbp_is_reply( $topic_id ) ) {
2662          $reply_id = bbp_get_reply_id( $topic_id );
2663          $topic_id = bbp_get_reply_topic_id( $reply_id );
2664      } else {
2665          $reply_id = bbp_get_reply_id( $reply_id );
2666          $topic_id = bbp_get_topic_id( $topic_id );
2667      }
2668  
2669      if ( empty( $reply_id ) ) {
2670          $reply_id = bbp_get_public_child_last_id( $topic_id, bbp_get_reply_post_type() );
2671      }
2672  
2673      // Adjust last_id's based on last_reply post_type
2674      if ( empty( $reply_id ) || ! bbp_is_reply( $reply_id ) ) {
2675          $reply_id = 0;
2676      }
2677  
2678      $reply_id = (int) $reply_id;
2679  
2680      // Update if reply is published
2681      update_post_meta( $topic_id, '_bbp_last_reply_id', $reply_id );
2682  
2683      // Filter & return
2684      return (int) apply_filters( 'bbp_update_topic_last_reply_id', $reply_id, $topic_id );
2685  }
2686  
2687  /**
2688   * Adjust the total voice count of a topic
2689   *
2690   * @since 2.0.0 bbPress (r2567)
2691   * @since 2.6.0 bbPress (r6515) This must be called after any engagement changes
2692   *
2693   * @param int $topic_id Optional. Topic id to update
2694   * @return int Voice count
2695   */
2696  function bbp_update_topic_voice_count( $topic_id = 0 ) {
2697  
2698      // If it's a reply, then get the parent (topic id)
2699      $topic_id = bbp_is_reply( $topic_id )
2700          ? bbp_get_reply_topic_id( $topic_id )
2701          : bbp_get_topic_id( $topic_id );
2702  
2703      // Bail if no topic ID
2704      if ( empty( $topic_id ) ) {
2705          return;
2706      }
2707  
2708      // Count the engagements
2709      $count = count( bbp_get_topic_engagements( $topic_id ) );
2710  
2711      // Update the voice count for this topic id
2712      update_post_meta( $topic_id, '_bbp_voice_count', $count );
2713  
2714      // Filter & return
2715      return (int) apply_filters( 'bbp_update_topic_voice_count', $count, $topic_id );
2716  }
2717  
2718  /**
2719   * Adjust the total anonymous reply count of a topic
2720   *
2721   * @since 2.0.0 bbPress (r2567)
2722   *
2723   * @param int $topic_id Optional. Topic id to update
2724   * @return int Anonymous reply count
2725   */
2726  function bbp_update_topic_anonymous_reply_count( $topic_id = 0 ) {
2727  
2728      // If it's a reply, then get the parent (topic id)
2729      $topic_id = bbp_is_reply( $topic_id )
2730          ? bbp_get_reply_topic_id( $topic_id )
2731          : bbp_get_topic_id( $topic_id );
2732  
2733      // Query the DB to get anonymous replies in this topic
2734      $bbp_db  = bbp_db();
2735      $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() );
2736      $replies = (int) $bbp_db->get_var( $query );
2737  
2738      update_post_meta( $topic_id, '_bbp_anonymous_reply_count', $replies );
2739  
2740      // Filter & return
2741      return (int) apply_filters( 'bbp_update_topic_anonymous_reply_count', $replies, $topic_id );
2742  }
2743  
2744  /**
2745   * Update the revision log of the topic
2746   *
2747   * @since 2.0.0 bbPress (r2782)
2748   *
2749   * @param array $args Supports these args:
2750   *  - topic_id: Topic id
2751   *  - author_id: Author id
2752   *  - reason: Reason for editing
2753   *  - revision_id: Revision id
2754   * @return mixed False on failure, true on success
2755   */
2756  function bbp_update_topic_revision_log( $args = array() ) {
2757  
2758      // Parse arguments against default values
2759      $r = bbp_parse_args( $args, array(
2760          'reason'      => '',
2761          'topic_id'    => 0,
2762          'author_id'   => 0,
2763          'revision_id' => 0
2764      ), 'update_topic_revision_log' );
2765  
2766      // Populate the variables
2767      $r['reason']      = bbp_format_revision_reason( $r['reason'] );
2768      $r['topic_id']    = bbp_get_topic_id( $r['topic_id'] );
2769      $r['author_id']   = bbp_get_user_id ( $r['author_id'], false, true );
2770      $r['revision_id'] = (int) $r['revision_id'];
2771  
2772      // Get the logs and append the new one to those
2773      $revision_log                      = bbp_get_topic_raw_revision_log( $r['topic_id'] );
2774      $revision_log[ $r['revision_id'] ] = array( 'author' => $r['author_id'], 'reason' => $r['reason'] );
2775  
2776      // Finally, update
2777      return update_post_meta( $r['topic_id'], '_bbp_revision_log', $revision_log );
2778  }
2779  
2780  /** Topic Actions *************************************************************/
2781  
2782  /**
2783   * Closes a topic
2784   *
2785   * @since 2.0.0 bbPress (r2740)
2786   *
2787   * @param int $topic_id Topic id
2788   * @return mixed False or {@link WP_Error} on failure, topic id on success
2789   */
2790  function bbp_close_topic( $topic_id = 0 ) {
2791  
2792      // Get topic
2793      $topic = bbp_get_topic( $topic_id );
2794      if ( empty( $topic ) ) {
2795          return $topic;
2796      }
2797  
2798      // Get previous topic status meta
2799      $status       = bbp_get_closed_status_id();
2800      $topic_status = get_post_meta( $topic_id, '_bbp_status', true );
2801  
2802      // Bail if already closed and topic status meta exists
2803      if ( $status === $topic->post_status && ! empty( $topic_status ) ) {
2804          return false;
2805      }
2806  
2807      // Set status meta public
2808      $topic_status = $topic->post_status;
2809  
2810      // Execute pre close code
2811      do_action( 'bbp_close_topic', $topic_id );
2812  
2813      // Add pre close status
2814      add_post_meta( $topic_id, '_bbp_status', $topic_status );
2815  
2816      // Set closed status
2817      $topic->post_status = $status;
2818  
2819      // Toggle revisions off as we are not altering content
2820      if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) {
2821          $revisions_removed = true;
2822          remove_post_type_support( bbp_get_topic_post_type(), 'revisions' );
2823      }
2824  
2825      // Update topic
2826      $topic_id = wp_update_post( $topic );
2827  
2828      // Toggle revisions back on
2829      if ( true === $revisions_removed ) {
2830          $revisions_removed = false;
2831          add_post_type_support( bbp_get_topic_post_type(), 'revisions' );
2832      }
2833  
2834      // Execute post close code
2835      do_action( 'bbp_closed_topic', $topic_id );
2836  
2837      // Return topic_id
2838      return $topic_id;
2839  }
2840  
2841  /**
2842   * Opens a topic
2843   *
2844   * @since 2.0.0 bbPress (r2740)
2845   *
2846   * @param int $topic_id Topic id
2847   * @return mixed False or {@link WP_Error} on failure, topic id on success
2848   */
2849  function bbp_open_topic( $topic_id = 0 ) {
2850  
2851      // Get topic
2852      $topic = bbp_get_topic( $topic_id );
2853      if ( empty( $topic ) ) {
2854          return $topic;
2855      }
2856  
2857      // Bail if not closed
2858      if ( bbp_get_closed_status_id() !== $topic->post_status ) {
2859          return false;
2860      }
2861  
2862      // Execute pre open code
2863      do_action( 'bbp_open_topic', $topic_id );
2864  
2865      // Get previous status
2866      $topic_status = get_post_meta( $topic_id, '_bbp_status', true );
2867  
2868      // If no previous status, default to publish
2869      if ( empty( $topic_status ) ) {
2870          $topic_status = bbp_get_public_status_id();
2871      }
2872  
2873      // Set previous status
2874      $topic->post_status = $topic_status;
2875  
2876      // Remove old status meta
2877      delete_post_meta( $topic_id, '_bbp_status' );
2878  
2879      // Toggle revisions off as we are not altering content
2880      if ( post_type_supports( bbp_get_topic_post_type(), 'revisions' ) ) {
2881          $revisions_removed = true;
2882          remove_post_type_support( bbp_get_topic_post_type(), 'revisions' );
2883      }
2884  
2885      // Update topic
2886      $topic_id = wp_update_post( $topic );
2887  
2888      // Toggle revisions back on
2889      if ( true === $revisions_removed ) {
2890          $revisions_removed = false;
2891          add_post_type_support( bbp_get_topic_post_type(), 'revisions' );
2892      }
2893  
2894      // Execute post open code
2895      do_action( 'bbp_opened_topic', $topic_id );
2896  
2897      // Return topic_id
2898      return $topic_id;
2899  }
2900  
2901  /**
2902   * Marks a topic as spam
2903   *
2904   * @since 2.0.0 bbPress (r2740)
2905   *
2906   * @param int $topic_id Topic id
2907   * @return mixed False or {@link WP_Error} on failure, topic id on success
2908   */
2909  function bbp_spam_topic( $topic_id = 0 ) {
2910  
2911      // Get the topic
2912      $topic = bbp_get_topic( $topic_id );
2913      if ( empty( $topic ) ) {
2914          return $topic;
2915      }
2916  
2917      // Get new status
2918      $status = bbp_get_spam_status_id();
2919  
2920      // Bail if topic is spam
2921      if ( $status === $topic->post_status ) {
2922          return false;
2923      }
2924  
2925      // Add the original post status as post meta for future restoration
2926      add_post_meta( $topic_id, '_bbp_spam_meta_status', $topic->post_status );
2927  
2928      // Execute pre spam code
2929      do_action( 'bbp_spam_topic', $topic_id );
2930  
2931      // Set post status to spam
2932      $topic->post_status = $status;
2933  
2934      // Empty the topic of its tags
2935      $topic->tax_input = bbp_spam_topic_tags( $topic_id );
2936  
2937      // No revisions
2938      remove_action( 'pre_post_update', 'wp_save_post_revision' );
2939  
2940      // Update the topic
2941      $topic_id = wp_update_post( $topic );
2942  
2943      // Execute post spam code
2944      do_action( 'bbp_spammed_topic', $topic_id );
2945  
2946      // Return topic_id
2947      return $topic_id;
2948  }
2949  
2950  /**
2951   * Trash replies to a topic when it's marked as spam
2952   *
2953   * Usually you'll want to do this before the topic itself is marked as spam.
2954   *
2955   * @since 2.6.0 bbPress (r5405)
2956   *
2957   * @param int $topic_id
2958   */
2959  function bbp_spam_topic_replies( $topic_id = 0 ) {
2960  
2961      // Validation
2962      $topic_id = bbp_get_topic_id( $topic_id );
2963  
2964      // Topic is being spammed, so its replies are trashed
2965      $replies = new WP_Query( array(
2966          'fields'         => 'id=>parent',
2967          'post_type'      => bbp_get_reply_post_type(),
2968          'post_status'    => bbp_get_public_status_id(),
2969          'post_parent'    => $topic_id,
2970          'posts_per_page' => -1,
2971  
2972          // Performance
2973          'nopaging'               => true,
2974          'suppress_filters'       => true,
2975          'update_post_term_cache' => false,
2976          'update_post_meta_cache' => false,
2977          'ignore_sticky_posts'    => true,
2978          'no_found_rows'          => true
2979      ) );
2980  
2981      if ( ! empty( $replies->posts ) ) {
2982  
2983          // Prevent debug notices
2984          $pre_spammed_replies = array();
2985  
2986          // Loop through replies, trash them, and add them to array
2987          foreach ( $replies->posts as $reply ) {
2988              wp_trash_post( $reply->ID );
2989              $pre_spammed_replies[] = $reply->ID;
2990          }
2991  
2992          // Set a post_meta entry of the replies that were trashed by this action.
2993          // This is so we can possibly untrash them, without untrashing replies
2994          // that were purposefully trashed before.
2995          update_post_meta( $topic_id, '_bbp_pre_spammed_replies', $pre_spammed_replies );
2996  
2997          // Reset the global post data after looping through the above WP_Query
2998          wp_reset_postdata();
2999      }
3000  }
3001  
3002  /**
3003   * Store the tags to a topic in post meta before it's marked as spam so they
3004   * can be retrieved and unspammed later.
3005   *
3006   * Usually you'll want to do this before the topic itself is marked as spam.
3007   *
3008   * @since 2.6.0 bbPress (r5405)
3009   *
3010   * @param int $topic_id
3011   */
3012  function bbp_spam_topic_tags( $topic_id = 0 ) {
3013  
3014      // Validation
3015      $topic_id = bbp_get_topic_id( $topic_id );
3016  
3017      // Get topic tags
3018      $terms = get_the_terms( $topic_id, bbp_get_topic_tag_tax_id() );
3019  
3020      // Define local variable(s)
3021      $term_names = array();
3022  
3023      // Topic has tags
3024      if ( ! empty( $terms ) ) {
3025  
3026          // Loop through and collect term names
3027          foreach ( $terms as $term ) {
3028              $term_names[] = $term->name;
3029          }
3030  
3031          // Topic terms have slugs
3032          if ( ! empty( $term_names ) ) {
3033  
3034              // Add the original post status as post meta for future restoration
3035              add_post_meta( $topic_id, '_bbp_spam_topic_tags', $term_names );
3036          }
3037      }
3038  
3039      return array( bbp_get_topic_tag_tax_id() => '' );
3040  }
3041  
3042  /**
3043   * Unspams a topic
3044   *
3045   * @since 2.0.0 bbPress (r2740)
3046   *
3047   * @param int $topic_id Topic id
3048   * @return mixed False or {@link WP_Error} on failure, topic id on success
3049   */
3050  function bbp_unspam_topic( $topic_id = 0 ) {
3051  
3052      // Get the topic
3053      $topic = bbp_get_topic( $topic_id );
3054      if ( empty( $topic ) ) {
3055          return $topic;
3056      }
3057  
3058      // Bail if already not spam
3059      if ( bbp_get_spam_status_id() !== $topic->post_status ) {
3060          return false;
3061      }
3062  
3063      // Execute pre unspam code
3064      do_action( 'bbp_unspam_topic', $topic_id );
3065  
3066      // Get pre spam status
3067      $topic_status = get_post_meta( $topic_id, '_bbp_spam_meta_status', true );
3068  
3069      // If no previous status, default to publish
3070      if ( empty( $topic_status ) ) {
3071          $topic_status = bbp_get_public_status_id();
3072      }
3073  
3074      // Set post status to pre spam
3075      $topic->post_status = $topic_status;
3076      $topic->tax_input   = bbp_unspam_topic_tags( $topic_id );
3077  
3078      // Delete pre spam meta
3079      delete_post_meta( $topic_id, '_bbp_spam_meta_status' );
3080  
3081      // No revisions
3082      remove_action( 'pre_post_update', 'wp_save_post_revision' );
3083  
3084      // Update the topic
3085      $topic_id = wp_update_post( $topic );
3086  
3087      // Execute post unspam code
3088      do_action( 'bbp_unspammed_topic', $topic_id );
3089  
3090      // Return topic_id
3091      return $topic_id;
3092  }
3093  
3094  /**
3095   * Untrash replies to a topic previously marked as spam.
3096   *
3097   * Usually you'll want to do this after the topic is unspammed.
3098   *
3099   * @since 2.6.0 bbPress (r5405)
3100   *
3101   * @param int $topic_id
3102   */
3103  function bbp_unspam_topic_replies( $topic_id = 0 ) {
3104  
3105      // Validation
3106      $topic_id = bbp_get_topic_id( $topic_id );
3107  
3108      // Get the replies that were not previously trashed
3109      $pre_spammed_replies = get_post_meta( $topic_id, '_bbp_pre_spammed_replies', true );
3110  
3111      // There are replies to untrash
3112      if ( ! empty( $pre_spammed_replies ) ) {
3113  
3114          // Maybe reverse the trashed replies array
3115          if ( is_array( $pre_spammed_replies ) ) {
3116              $pre_spammed_replies = array_reverse( $pre_spammed_replies );
3117          }
3118  
3119          // Loop through replies
3120          foreach ( (array) $pre_spammed_replies as $reply ) {
3121              wp_untrash_post( $reply );
3122          }
3123      }
3124  
3125      // Clear the trasheed reply meta for the topic
3126      delete_post_meta( $topic_id, '_bbp_pre_spammed_replies' );
3127  }
3128  
3129  /**
3130   * Retrieve tags to a topic from post meta before it's unmarked as spam so they.
3131   *
3132   * Usually you'll want to do this before the topic itself is unmarked as spam.
3133   *
3134   * @since 2.6.0 bbPress (r5405)
3135   *
3136   * @param int $topic_id
3137   */
3138  function bbp_unspam_topic_tags( $topic_id = 0 ) {
3139  
3140      // Validation
3141      $topic_id = bbp_get_topic_id( $topic_id );
3142  
3143      // Get pre-spam topic tags
3144      $terms = get_post_meta( $topic_id, '_bbp_spam_topic_tags', true );
3145  
3146      // Delete pre-spam topic tag meta
3147      if ( ! empty( $terms ) ) {
3148          delete_post_meta( $topic_id, '_bbp_spam_topic_tags' );
3149      }
3150  
3151      return array( bbp_get_topic_tag_tax_id() => $terms );
3152  }
3153  
3154  /**
3155   * Sticks a topic to a forum or front
3156   *
3157   * @since 2.0.0 bbPress (r2754)
3158   *
3159   * @param int $topic_id Optional. Topic id
3160   * @param int $super Should we make the topic a super sticky?
3161   * @return bool True on success, false on failure
3162   */
3163  function bbp_stick_topic( $topic_id = 0, $super = false ) {
3164  
3165      // Validation
3166      $topic_id = bbp_get_topic_id( $topic_id );
3167  
3168      // Bail if a topic is not a topic (prevents revisions as stickies)
3169      if ( ! bbp_is_topic( $topic_id ) ) {
3170          return false;
3171      }
3172  
3173      do_action( 'bbp_stick_topic', $topic_id, $super );
3174  
3175      // Maybe get the forum ID if not getting supers
3176      $forum_id = empty( $super )
3177          ? bbp_get_topic_forum_id( $topic_id )
3178          : 0;
3179  
3180      // Get the stickies, maybe from the forum ID
3181      $stickies = bbp_get_stickies( $forum_id );
3182  
3183      // Add the topic to the stickies
3184      $stickies[] = $topic_id;
3185  
3186      // Pull out duplicates and empties
3187      $stickies = array_unique( array_filter( $stickies ) );
3188  
3189      // Unset incorrectly stuck revisions
3190      foreach ( (array) $stickies as $key => $id ) {
3191          if ( ! bbp_is_topic( $id ) ) {
3192              unset( $stickies[ $key ] );
3193          }
3194      }
3195  
3196      // Reset keys
3197      $stickies = array_values( $stickies );
3198  
3199      // Update
3200      $success  = ! empty( $super )
3201          ? update_option( '_bbp_super_sticky_topics', $stickies )
3202          : update_post_meta( $forum_id, '_bbp_sticky_topics', $stickies );
3203  
3204      do_action( 'bbp_stuck_topic', $topic_id, $super, $success );
3205  
3206      return (bool) $success;
3207  }
3208  
3209  /**
3210   * Approves a pending topic
3211   *
3212   * @since 2.6.0 bbPress (r5503)
3213   *
3214   * @param int $topic_id Topic id
3215   * @return mixed False or {@link WP_Error} on failure, topic id on success
3216   */
3217  function bbp_approve_topic( $topic_id = 0 ) {
3218  
3219      // Get topic
3220      $topic = bbp_get_topic( $topic_id );
3221      if ( empty( $topic ) ) {
3222          return $topic;
3223      }
3224  
3225      // Get new status
3226      $status = bbp_get_public_status_id();
3227  
3228      // Bail if already approved
3229      if ( $status === $topic->post_status ) {
3230          return false;
3231      }
3232  
3233      // Execute pre pending code
3234      do_action( 'bbp_approve_topic', $topic_id );
3235  
3236      // Set publish status
3237      $topic->post_status = $status;
3238  
3239      // No revisions
3240      remove_action( 'pre_post_update', 'wp_save_post_revision' );
3241  
3242      // Update topic
3243      $topic_id = wp_update_post( $topic );
3244  
3245      // Execute post pending code
3246      do_action( 'bbp_approved_topic', $topic_id );
3247  
3248      // Return topic_id
3249      return $topic_id;
3250  }
3251  
3252  /**
3253   * Unapproves a topic
3254   *
3255   * @since 2.6.0 bbPress (r5503)
3256   *
3257   * @param int $topic_id Topic id
3258   * @return mixed False or {@link WP_Error} on failure, topic id on success
3259   */
3260  function bbp_unapprove_topic( $topic_id = 0 ) {
3261  
3262      // Get topic
3263      $topic = bbp_get_topic( $topic_id );
3264      if ( empty( $topic ) ) {
3265          return $topic;
3266      }
3267  
3268      // Get new status
3269      $status = bbp_get_pending_status_id();
3270  
3271      // Bail if already unapproved
3272      if ( ! bbp_is_topic_public( $topic_id ) ) {
3273          return false;
3274      }
3275  
3276      // Execute pre open code
3277      do_action( 'bbp_unapprove_topic', $topic_id );
3278  
3279      // Set pending status
3280      $topic->post_status = $status;
3281  
3282      // No revisions
3283      remove_action( 'pre_post_update', 'wp_save_post_revision' );
3284  
3285      // Update topic
3286      $topic_id = wp_update_post( $topic );
3287  
3288      // Execute post open code
3289      do_action( 'bbp_unapproved_topic', $topic_id );
3290  
3291      // Return topic_id
3292      return $topic_id;
3293  }
3294  
3295  /**
3296   * Unsticks a topic both from front and it's forum
3297   *
3298   * @since 2.0.0 bbPress (r2754)
3299   *
3300   * @param int $topic_id Optional. Topic id
3301   * @return bool Always true.
3302   */
3303  function bbp_unstick_topic( $topic_id = 0 ) {
3304  
3305      // Get topic sticky status
3306      $topic_id = bbp_get_topic_id( $topic_id );
3307      $super    = bbp_is_topic_super_sticky( $topic_id );
3308      $forum_id = empty( $super ) ? bbp_get_topic_forum_id( $topic_id ) : 0;
3309      $stickies = bbp_get_stickies( $forum_id );
3310      $offset   = array_search( $topic_id, $stickies );
3311  
3312      do_action( 'bbp_unstick_topic', $topic_id );
3313  
3314      // Nothing to unstick
3315      if ( empty( $stickies ) ) {
3316          $success = true;
3317  
3318      // Topic not in stickies
3319      } elseif ( ! in_array( $topic_id, $stickies, true ) ) {
3320          $success = true;
3321  
3322      // Topic not in stickies
3323      } elseif ( false === $offset ) {
3324          $success = true;
3325  
3326      // Splice out the offset
3327      } else {
3328          array_splice( $stickies, $offset, 1 );
3329  
3330          if ( empty( $stickies ) ) {
3331              $success = ! empty( $super )
3332                  ? delete_option( '_bbp_super_sticky_topics' )
3333                  : delete_post_meta( $forum_id, '_bbp_sticky_topics' );
3334          } else {
3335              $success = ! empty( $super )
3336                  ? update_option( '_bbp_super_sticky_topics', $stickies )
3337                  : update_post_meta( $forum_id, '_bbp_sticky_topics', $stickies );
3338          }
3339      }
3340  
3341      do_action( 'bbp_unstuck_topic', $topic_id, $success );
3342  
3343      return (bool) $success;
3344  }
3345  
3346  /** Before Delete/Trash/Untrash ***********************************************/
3347  
3348  /**
3349   * Called before deleting a topic.
3350   *
3351   * This function is supplemental to the actual topic deletion which is
3352   * handled by WordPress core API functions. It is used to clean up after
3353   * a topic that is being deleted.
3354   */
3355  function bbp_delete_topic( $topic_id = 0 ) {
3356  
3357      // Validate topic ID
3358      $topic_id = bbp_get_topic_id( $topic_id );
3359  
3360      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3361          return false;
3362      }
3363  
3364      do_action( 'bbp_delete_topic', $topic_id );
3365  }
3366  
3367  /**
3368   * Delete replies to a topic when it's deleted
3369   *
3370   * Usually you'll want to do this before the topic itself is deleted.
3371   *
3372   * @since 2.6.0 bbPress (r5405)
3373   *
3374   * @param int $topic_id
3375   */
3376  function bbp_delete_topic_replies( $topic_id = 0 ) {
3377  
3378      // Validate topic ID
3379      $topic_id = bbp_get_topic_id( $topic_id );
3380  
3381      // Topic is being permanently deleted, so its replies gotta go too
3382      // Note that we get all post statuses here
3383      $replies = new WP_Query( array(
3384          'fields'         => 'id=>parent',
3385          'post_type'      => bbp_get_reply_post_type(),
3386          'post_status'    => array_keys( get_post_stati() ),
3387          'post_parent'    => $topic_id,
3388          'posts_per_page' => -1,
3389  
3390          // Performance
3391          'nopaging'               => true,
3392          'suppress_filters'       => true,
3393          'update_post_term_cache' => false,
3394          'update_post_meta_cache' => false,
3395          'ignore_sticky_posts'    => true,
3396          'no_found_rows'          => true
3397      ) );
3398  
3399      // Loop through and delete child replies
3400      if ( ! empty( $replies->posts ) ) {
3401          foreach ( $replies->posts as $reply ) {
3402              wp_delete_post( $reply->ID, true );
3403          }
3404  
3405          // Reset the $post global
3406          wp_reset_postdata();
3407      }
3408  }
3409  
3410  /**
3411   * Called before trashing a topic
3412   *
3413   * This function is supplemental to the actual topic being trashed which is
3414   * handled by WordPress core API functions. It is used to clean up after
3415   * a topic that is being trashed.
3416   */
3417  function bbp_trash_topic( $topic_id = 0 ) {
3418  
3419      // Validate topic ID
3420      $topic_id = bbp_get_topic_id( $topic_id );
3421  
3422      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3423          return false;
3424      }
3425  
3426      do_action( 'bbp_trash_topic', $topic_id );
3427  }
3428  
3429  /**
3430   * Trash replies to a topic when it's trashed.
3431   *
3432   * Usually you'll want to do this before the topic itself is marked as spam.
3433   *
3434   * @since 2.6.0 bbPress (r5405)
3435   *
3436   * @param int $topic_id
3437   */
3438  function bbp_trash_topic_replies( $topic_id = 0 ) {
3439  
3440      // Validate topic ID
3441      $topic_id = bbp_get_topic_id( $topic_id );
3442  
3443      // Topic is being trashed, so its replies are trashed too
3444      $replies = new WP_Query( array(
3445          'fields'         => 'id=>parent',
3446          'post_type'      => bbp_get_reply_post_type(),
3447          'post_status'    => bbp_get_public_status_id(),
3448          'post_parent'    => $topic_id,
3449          'posts_per_page' => -1,
3450  
3451          // Performance
3452          'nopaging'               => true,
3453          'suppress_filters'       => true,
3454          'update_post_term_cache' => false,
3455          'update_post_meta_cache' => false,
3456          'ignore_sticky_posts'    => true,
3457          'no_found_rows'          => true
3458      ) );
3459  
3460      if ( ! empty( $replies->posts ) ) {
3461  
3462          // Prevent debug notices
3463          $pre_trashed_replies = array();
3464  
3465          // Loop through replies, trash them, and add them to array
3466          foreach ( $replies->posts as $reply ) {
3467              wp_trash_post( $reply->ID );
3468              $pre_trashed_replies[] = $reply->ID;
3469          }
3470  
3471          // Set a post_meta entry of the replies that were trashed by this action.
3472          // This is so we can possibly untrash them, without untrashing replies
3473          // that were purposefully trashed before.
3474          update_post_meta( $topic_id, '_bbp_pre_trashed_replies', $pre_trashed_replies );
3475  
3476          // Reset the $post global
3477          wp_reset_postdata();
3478      }
3479  }
3480  
3481  /**
3482   * Called before untrashing a topic
3483   */
3484  function bbp_untrash_topic( $topic_id = 0 ) {
3485      $topic_id = bbp_get_topic_id( $topic_id );
3486  
3487      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3488          return false;
3489      }
3490  
3491      do_action( 'bbp_untrash_topic', $topic_id );
3492  }
3493  
3494  /**
3495   * Untrash replies to a topic previously trashed.
3496   *
3497   * Usually you'll want to do this after the topic is unspammed.
3498   *
3499   * @since 2.6.0 bbPress (r5405)
3500   *
3501   * @param int $topic_id
3502   */
3503  function bbp_untrash_topic_replies( $topic_id = 0 ) {
3504  
3505      // Validation
3506      $topic_id = bbp_get_topic_id( $topic_id );
3507  
3508      // Get the replies that were not previously trashed
3509      $pre_trashed_replies = get_post_meta( $topic_id, '_bbp_pre_trashed_replies', true );
3510  
3511      // There are replies to untrash
3512      if ( ! empty( $pre_trashed_replies ) ) {
3513  
3514          // Maybe reverse the trashed replies array
3515          if ( is_array( $pre_trashed_replies ) ) {
3516              $pre_trashed_replies = array_reverse( $pre_trashed_replies );
3517          }
3518  
3519          // Loop through replies
3520          foreach ( (array) $pre_trashed_replies as $reply ) {
3521              wp_untrash_post( $reply );
3522          }
3523      }
3524  
3525      // Clear the trashed reply meta for the topic
3526      delete_post_meta( $topic_id, '_bbp_pre_trashed_replies' );
3527  }
3528  
3529  /** After Delete/Trash/Untrash ************************************************/
3530  
3531  /**
3532   * Called after deleting a topic
3533   *
3534   * @since 2.0.0 bbPress (r2993)
3535   */
3536  function bbp_deleted_topic( $topic_id = 0 ) {
3537      $topic_id = bbp_get_topic_id( $topic_id );
3538  
3539      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3540          return false;
3541      }
3542  
3543      do_action( 'bbp_deleted_topic', $topic_id );
3544  }
3545  
3546  /**
3547   * Called after trashing a topic
3548   *
3549   * @since 2.0.0 bbPress (r2993)
3550   */
3551  function bbp_trashed_topic( $topic_id = 0 ) {
3552      $topic_id = bbp_get_topic_id( $topic_id );
3553  
3554      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3555          return false;
3556      }
3557  
3558      do_action( 'bbp_trashed_topic', $topic_id );
3559  }
3560  
3561  /**
3562   * Called after untrashing a topic
3563   *
3564   * @since 2.0.0 bbPress (r2993)
3565   */
3566  function bbp_untrashed_topic( $topic_id = 0 ) {
3567      $topic_id = bbp_get_topic_id( $topic_id );
3568  
3569      if ( empty( $topic_id ) || ! bbp_is_topic( $topic_id ) ) {
3570          return false;
3571      }
3572  
3573      do_action( 'bbp_untrashed_topic', $topic_id );
3574  }
3575  
3576  /** Settings ******************************************************************/
3577  
3578  /**
3579   * Return the topics per page setting
3580   *
3581   * @since 2.0.0 bbPress (r3540)
3582   * @return int
3583   */
3584  function bbp_get_topics_per_page( $default = 15 ) {
3585  
3586      // Get database option and cast as integer
3587      $retval = get_option( '_bbp_topics_per_page', $default );
3588  
3589      // If return val is empty, set it to default
3590      if ( empty( $retval ) ) {
3591          $retval = $default;
3592      }
3593  
3594      // Filter & return
3595      return (int) apply_filters( 'bbp_get_topics_per_page', $retval, $default );
3596  }
3597  
3598  /**
3599   * Return the topics per RSS page setting
3600   *
3601   * @since 2.0.0 bbPress (r3540)
3602   *
3603   * @param int $default Default replies per page (25)
3604   * @return int
3605   */
3606  function bbp_get_topics_per_rss_page( $default = 25 ) {
3607  
3608      // Get database option and cast as integer
3609      $retval = get_option( '_bbp_topics_per_rss_page', $default );
3610  
3611      // If return val is empty, set it to default
3612      if ( empty( $retval ) ) {
3613          $retval = $default;
3614      }
3615  
3616      // Filter & return
3617      return (int) apply_filters( 'bbp_get_topics_per_rss_page', $retval, $default );
3618  }
3619  
3620  /** Topic Tags ****************************************************************/
3621  
3622  /**
3623   * Get topic tags for a specific topic ID
3624   *
3625   * @since 2.6.0 bbPress (r5836)
3626   *
3627   * @param int $topic_id
3628   *
3629   * @return string
3630   */
3631  function bbp_get_topic_tags( $topic_id = 0 ) {
3632      $topic_id   = bbp_get_topic_id( $topic_id );
3633      $terms      = (array) get_the_terms( $topic_id, bbp_get_topic_tag_tax_id() );
3634      $topic_tags = array_filter( $terms );
3635  
3636      // Filter & return
3637      return apply_filters( 'bbp_get_topic_tags', $topic_tags, $topic_id );
3638  }
3639  
3640  /**
3641   * Get topic tags for a specific topic ID
3642   *
3643   * @since 2.2.0 bbPress (r4165)
3644   *
3645   * @param int    $topic_id
3646   * @param string $sep
3647   *
3648   * @return string
3649   */
3650  function bbp_get_topic_tag_names( $topic_id = 0, $sep = ', ' ) {
3651      $topic_tags = bbp_get_topic_tags( $topic_id );
3652      $pluck      = wp_list_pluck( $topic_tags, 'name' );
3653      $terms      = ! empty( $pluck )
3654          ? implode( $sep, $pluck )
3655          : '';
3656  
3657      // Filter & return
3658      return apply_filters( 'bbp_get_topic_tag_names', $terms, $topic_id, $sep );
3659  }
3660  
3661  /**
3662   * Will update topic-tag count based on object type.
3663   *
3664   * Function for the default callback for topic-tag taxonomies.
3665   *
3666   * @see https://bbpress.trac.wordpress.org/ticket/3043
3667   * @access private
3668   *
3669   * @since 2.6.0 bbPress (r6253)
3670   *
3671   * @param array  $terms    List of Term taxonomy IDs.
3672   * @param object $taxonomy Current taxonomy object of terms.
3673   */
3674  function bbp_update_topic_tag_count( $terms, $taxonomy ) {
3675  
3676      // Bail if no object types are available
3677      if ( empty( $terms ) || empty( $taxonomy->object_type ) ) {
3678          return;
3679      }
3680  
3681      // Get object types
3682      $object_types = (array) $taxonomy->object_type;
3683  
3684      foreach ( $object_types as &$object_type ) {
3685          list( $object_type ) = explode( ':', $object_type );
3686      }
3687  
3688      $object_types = array_unique( $object_types );
3689  
3690      if ( ! empty( $object_types ) ) {
3691          $object_types = esc_sql( array_filter( $object_types, 'post_type_exists' ) );
3692      }
3693  
3694      // Statuses to count
3695      $object_statuses = bbp_get_public_topic_statuses();
3696  
3697      // Get database
3698      $bbp_db = bbp_db();
3699  
3700      // Loop through terms, maybe update counts
3701      foreach ( (array) $terms as $term ) {
3702          $count = 0;
3703  
3704          // Get count, and bump it
3705          if ( ! empty( $object_types ) ) {
3706              $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";
3707              $prepare  = $bbp_db->prepare( $query, $term );
3708              $count   += (int) $bbp_db->get_var( $prepare );
3709          }
3710  
3711          /** This action is documented in wp-includes/taxonomy.php */
3712          do_action( 'edit_term_taxonomy', $term, $taxonomy->name );
3713          $bbp_db->update( $bbp_db->term_taxonomy, compact( 'count' ), array( 'term_taxonomy_id' => $term ) );
3714  
3715          /** This action is documented in wp-includes/taxonomy.php */
3716          do_action( 'edited_term_taxonomy', $term, $taxonomy->name );
3717      }
3718  }
3719  
3720  /** Autoembed *****************************************************************/
3721  
3722  /**
3723   * Check if autoembeds are enabled and hook them in if so
3724   *
3725   * @since 2.1.0 bbPress (r3752)
3726   *
3727   * @global WP_Embed $wp_embed
3728   */
3729  function bbp_topic_content_autoembed() {
3730      global $wp_embed;
3731  
3732      if ( bbp_use_autoembed() && is_a( $wp_embed, 'WP_Embed' ) ) {
3733          add_filter( 'bbp_get_topic_content', array( $wp_embed, 'autoembed' ), 2 );
3734      }
3735  }
3736  
3737  /** Feeds *********************************************************************/
3738  
3739  /**
3740   * Output an RSS2 feed of topics, based on the query passed.
3741   *
3742   * @since 2.0.0 bbPress (r3171)
3743   *
3744   * @param array $topics_query
3745   */
3746  function bbp_display_topics_feed_rss2( $topics_query = array() ) {
3747  
3748      // User cannot access this forum
3749      if ( bbp_is_single_forum() && ! bbp_user_can_view_forum( array( 'forum_id' => bbp_get_forum_id() ) ) ) {
3750          return;
3751      }
3752  
3753      // Feed title
3754      $title = get_bloginfo_rss( 'name' ) . ' &#187; ' . esc_html__( 'All Topics', 'bbpress' );
3755      $title = apply_filters( 'wp_title_rss', $title );
3756  
3757      // Display the feed
3758      header( 'Content-Type: ' . feed_content_type( 'rss2' ) . '; charset=' . get_option( 'blog_charset' ), true );
3759      header( 'Status: 200 OK' );
3760      echo '<?xml version="1.0" encoding="' . get_option( 'blog_charset' ) . '"?' . '>'; ?>
3761  
3762      <rss version="2.0"
3763          xmlns:content="http://purl.org/rss/1.0/modules/content/"
3764          xmlns:wfw="http://wellformedweb.org/CommentAPI/"
3765          xmlns:dc="http://purl.org/dc/elements/1.1/"
3766          xmlns:atom="http://www.w3.org/2005/Atom"
3767  
3768          <?php do_action( 'bbp_feed' ); ?>
3769      >
3770  
3771      <channel>
3772  
3773          <title><?php echo $title; // Already escaped ?></title>
3774          <atom:link href="<?php self_link(); ?>" rel="self" type="application/rss+xml" />
3775          <link><?php self_link(); ?></link>
3776          <description><?php //?></description><?php // phpcs:ignore ?>
3777          <lastBuildDate><?php echo date( 'r' ); ?></lastBuildDate>
3778          <generator><?php echo esc_url_raw( 'https://bbpress.org/?v=' . convert_chars( bbp_get_version() ) ); ?></generator>
3779          <language><?php bloginfo_rss( 'language' ); ?></language>
3780  
3781          <?php do_action( 'bbp_feed_head' ); ?>
3782  
3783          <?php if ( bbp_has_topics( $topics_query ) ) : ?>
3784  
3785              <?php while ( bbp_topics() ) : bbp_the_topic(); ?>
3786  
3787                  <item>
3788                      <guid><?php bbp_topic_permalink(); ?></guid>
3789                      <title><![CDATA[<?php bbp_topic_title(); ?>]]></title>
3790                      <link><?php bbp_topic_permalink(); ?></link>
3791                      <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>
3792                      <dc:creator><?php the_author(); ?></dc:creator>
3793  
3794                      <?php if ( !post_password_required() ) : ?>
3795  
3796                      <description>
3797                          <![CDATA[
3798                          <p><?php printf( esc_html__( 'Replies: %s', 'bbpress' ), bbp_get_topic_reply_count() ); ?></p>
3799                          <?php bbp_topic_content(); ?>
3800                          ]]>
3801                      </description>
3802  
3803                      <?php rss_enclosure(); ?>
3804  
3805                      <?php endif; ?>
3806  
3807                      <?php do_action( 'bbp_feed_item' ); ?>
3808  
3809                  </item>
3810  
3811                  <?php endwhile; ?>
3812              <?php endif; ?>
3813  
3814          <?php do_action( 'bbp_feed_footer' ); ?>
3815  
3816      </channel>
3817      </rss>
3818  
3819  <?php
3820      exit();
3821  }
3822  
3823  /** Permissions ***************************************************************/
3824  
3825  /**
3826   * Redirect if unauthorized user is attempting to edit a topic
3827   *
3828   * @since 2.1.0 bbPress (r3605)
3829   */
3830  function bbp_check_topic_edit() {
3831  
3832      // Bail if not editing a topic
3833      if ( ! bbp_is_topic_edit() ) {
3834          return;
3835      }
3836  
3837      // User cannot edit topic, so redirect back to topic
3838      if ( ! current_user_can( 'edit_topic', bbp_get_topic_id() ) ) {
3839          bbp_redirect( bbp_get_topic_permalink() );
3840      }
3841  }
3842  
3843  /**
3844   * Redirect if unauthorized user is attempting to edit a topic tag
3845   *
3846   * @since 2.1.0 bbPress (r3605)
3847   */
3848  function bbp_check_topic_tag_edit() {
3849  
3850      // Bail if not editing a topic tag
3851      if ( ! bbp_is_topic_tag_edit() ) {
3852          return;
3853      }
3854  
3855      // Bail if current user cannot edit topic tags
3856      if ( ! current_user_can( 'edit_topic_tag', bbp_get_topic_tag_id() ) ) {
3857          bbp_redirect( bbp_get_topic_tag_link() );
3858      }
3859  }


Generated: Tue Jul 7 01:01:20 2020 Cross-referenced by PHPXref 0.7.1