/wp-content/plugins/bbpress/includes/forums/functions.php
PHP | 2216 lines | 859 code | 425 blank | 932 comment | 200 complexity | 5a764146bf4a8fa03d348a0d2371c936 MD5 | raw file
Possible License(s): GPL-2.0, GPL-3.0, AGPL-1.0, LGPL-3.0, LGPL-2.1
Large files files are truncated, but you can click here to view the full file
- <?php
- /**
- * bbPress Forum Functions
- *
- * @package bbPress
- * @subpackage Functions
- */
- // Exit if accessed directly
- if ( !defined( 'ABSPATH' ) ) exit;
- /** Insert ********************************************************************/
- /**
- * A wrapper for wp_insert_post() that also includes the necessary meta values
- * for the forum to function properly.
- *
- * @since bbPress (r3349)
- *
- * @uses bbp_parse_args()
- * @uses bbp_get_forum_post_type()
- * @uses wp_insert_post()
- * @uses update_post_meta()
- *
- * @param array $forum_data Forum post data
- * @param arrap $forum_meta Forum meta data
- */
- function bbp_insert_forum( $forum_data = array(), $forum_meta = array() ) {
- // Forum
- $default_forum = array(
- 'post_parent' => 0, // forum ID
- 'post_status' => bbp_get_public_status_id(),
- 'post_type' => bbp_get_forum_post_type(),
- 'post_author' => bbp_get_current_user_id(),
- 'post_password' => '',
- 'post_content' => '',
- 'post_title' => '',
- 'menu_order' => 0,
- 'comment_status' => 'closed'
- );
- $forum_data = bbp_parse_args( $forum_data, $default_forum, 'insert_forum' );
- // Insert forum
- $forum_id = wp_insert_post( $forum_data );
- // Bail if no forum was added
- if ( empty( $forum_id ) )
- return false;
- // Forum meta
- $default_meta = array(
- 'reply_count' => 0,
- 'topic_count' => 0,
- 'topic_count_hidden' => 0,
- 'total_reply_count' => 0,
- 'total_topic_count' => 0,
- 'last_topic_id' => 0,
- 'last_reply_id' => 0,
- 'last_active_id' => 0,
- 'last_active_time' => 0,
- 'forum_subforum_count' => 0,
- );
- $forum_meta = bbp_parse_args( $forum_meta, $default_meta, 'insert_forum_meta' );
- // Insert forum meta
- foreach ( $forum_meta as $meta_key => $meta_value )
- update_post_meta( $forum_id, '_bbp_' . $meta_key, $meta_value );
- // Return new forum ID
- return $forum_id;
- }
- /** Post Form Handlers ********************************************************/
- /**
- * Handles the front end forum submission
- *
- * @param string $action The requested action to compare this function to
- * @uses bbp_add_error() To add an error message
- * @uses bbp_verify_nonce_request() To verify the nonce and check the request
- * @uses bbp_is_anonymous() To check if an anonymous post is being made
- * @uses current_user_can() To check if the current user can publish forum
- * @uses bbp_get_current_user_id() To get the current user id
- * @uses bbp_filter_anonymous_post_data() To filter anonymous data
- * @uses bbp_set_current_anonymous_user_data() To set the anonymous user cookies
- * @uses is_wp_error() To check if the value retrieved is a {@link WP_Error}
- * @uses esc_attr() For sanitization
- * @uses bbp_is_forum_category() To check if the forum is a category
- * @uses bbp_is_forum_closed() To check if the forum is closed
- * @uses bbp_is_forum_private() To check if the forum is private
- * @uses bbp_check_for_flood() To check for flooding
- * @uses bbp_check_for_duplicate() To check for duplicates
- * @uses bbp_get_forum_post_type() To get the forum post type
- * @uses remove_filter() To remove kses filters if needed
- * @uses apply_filters() Calls 'bbp_new_forum_pre_title' with the content
- * @uses apply_filters() Calls 'bbp_new_forum_pre_content' with the content
- * @uses bbPress::errors::get_error_codes() To get the {@link WP_Error} errors
- * @uses wp_insert_post() To insert the forum
- * @uses do_action() Calls 'bbp_new_forum' with the forum id, forum id,
- * anonymous data and reply author
- * @uses bbp_stick_forum() To stick or super stick the forum
- * @uses bbp_unstick_forum() To unstick the forum
- * @uses bbp_get_forum_permalink() To get the forum permalink
- * @uses wp_safe_redirect() To redirect to the forum link
- * @uses bbPress::errors::get_error_messages() To get the {@link WP_Error} error
- * messages
- */
- function bbp_new_forum_handler( $action = '' ) {
- // Bail if action is not bbp-new-forum
- if ( 'bbp-new-forum' !== $action )
- return;
- // Nonce check
- if ( ! bbp_verify_nonce_request( 'bbp-new-forum' ) ) {
- bbp_add_error( 'bbp_new_forum_nonce', __( '<strong>ERROR</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
- return;
- }
- // Define local variable(s)
- $view_all = $anonymous_data = false;
- $forum_parent_id = $forum_author = 0;
- $forum_title = $forum_content = '';
- /** Forum Author **********************************************************/
- // User cannot create forums
- if ( !current_user_can( 'publish_forums' ) ) {
- bbp_add_error( 'bbp_forum_permissions', __( '<strong>ERROR</strong>: You do not have permission to create new forums.', 'bbpress' ) );
- return;
- }
- // Forum author is current user
- $forum_author = bbp_get_current_user_id();
- // Remove kses filters from title and content for capable users and if the nonce is verified
- if ( current_user_can( 'unfiltered_html' ) && !empty( $_POST['_bbp_unfiltered_html_forum'] ) && wp_create_nonce( 'bbp-unfiltered-html-forum_new' ) == $_POST['_bbp_unfiltered_html_forum'] ) {
- remove_filter( 'bbp_new_forum_pre_title', 'wp_filter_kses' );
- remove_filter( 'bbp_new_forum_pre_content', 'bbp_encode_bad', 10 );
- remove_filter( 'bbp_new_forum_pre_content', 'bbp_filter_kses', 30 );
- }
- /** Forum Title ***********************************************************/
- if ( !empty( $_POST['bbp_forum_title'] ) )
- $forum_title = esc_attr( strip_tags( $_POST['bbp_forum_title'] ) );
- // Filter and sanitize
- $forum_title = apply_filters( 'bbp_new_forum_pre_title', $forum_title );
- // No forum title
- if ( empty( $forum_title ) )
- bbp_add_error( 'bbp_forum_title', __( '<strong>ERROR</strong>: Your forum needs a title.', 'bbpress' ) );
- /** Forum Content *********************************************************/
- if ( !empty( $_POST['bbp_forum_content'] ) )
- $forum_content = $_POST['bbp_forum_content'];
- // Filter and sanitize
- $forum_content = apply_filters( 'bbp_new_forum_pre_content', $forum_content );
- // No forum content
- if ( empty( $forum_content ) )
- bbp_add_error( 'bbp_forum_content', __( '<strong>ERROR</strong>: Your forum description cannot be empty.', 'bbpress' ) );
- /** Forum Parent **********************************************************/
- // Forum parent was passed (the norm)
- if ( !empty( $_POST['bbp_forum_parent_id'] ) )
- $forum_parent_id = (int) $_POST['bbp_forum_parent_id'];
- // Filter and sanitize
- $forum_parent_id = apply_filters( 'bbp_new_forum_pre_parent_id', $forum_parent_id );
- // No forum parent was passed (should never happen)
- if ( empty( $forum_parent_id ) ) {
- bbp_add_error( 'bbp_new_forum_missing_parent', __( '<strong>ERROR</strong>: Your forum must have a parent.', 'bbpress' ) );
- // Forum exists
- } elseif ( !empty( $forum_parent_id ) ) {
- // Forum is a category
- if ( bbp_is_forum_category( $forum_parent_id ) ) {
- bbp_add_error( 'bbp_new_forum_forum_category', __( '<strong>ERROR</strong>: This forum is a category. No forums can be created in this forum.', 'bbpress' ) );
- }
- // Forum is closed and user cannot access
- if ( bbp_is_forum_closed( $forum_parent_id ) && !current_user_can( 'edit_forum', $forum_parent_id ) ) {
- bbp_add_error( 'bbp_new_forum_forum_closed', __( '<strong>ERROR</strong>: This forum has been closed to new forums.', 'bbpress' ) );
- }
- // Forum is private and user cannot access
- if ( bbp_is_forum_private( $forum_parent_id ) && !current_user_can( 'read_private_forums' ) ) {
- bbp_add_error( 'bbp_new_forum_forum_private', __( '<strong>ERROR</strong>: This forum is private and you do not have the capability to read or create new forums in it.', 'bbpress' ) );
- }
- // Forum is hidden and user cannot access
- if ( bbp_is_forum_hidden( $forum_parent_id ) && !current_user_can( 'read_hidden_forums' ) ) {
- bbp_add_error( 'bbp_new_forum_forum_hidden', __( '<strong>ERROR</strong>: This forum is hidden and you do not have the capability to read or create new forums in it.', 'bbpress' ) );
- }
- }
- /** Forum Flooding ********************************************************/
- if ( !bbp_check_for_flood( $anonymous_data, $forum_author ) )
- bbp_add_error( 'bbp_forum_flood', __( '<strong>ERROR</strong>: Slow down; you move too fast.', 'bbpress' ) );
- /** Forum Duplicate *******************************************************/
- if ( !bbp_check_for_duplicate( array( 'post_type' => bbp_get_forum_post_type(), 'post_author' => $forum_author, 'post_content' => $forum_content, 'anonymous_data' => $anonymous_data ) ) )
- bbp_add_error( 'bbp_forum_duplicate', __( '<strong>ERROR</strong>: This forum already exists.', 'bbpress' ) );
- /** Forum Blacklist *******************************************************/
- if ( !bbp_check_for_blacklist( $anonymous_data, $forum_author, $forum_title, $forum_content ) )
- bbp_add_error( 'bbp_forum_blacklist', __( '<strong>ERROR</strong>: Your forum cannot be created at this time.', 'bbpress' ) );
- /** Forum Moderation ******************************************************/
- $post_status = bbp_get_public_status_id();
- if ( !bbp_check_for_moderation( $anonymous_data, $forum_author, $forum_title, $forum_content ) )
- $post_status = bbp_get_pending_status_id();
- /** Additional Actions (Before Save) **************************************/
- do_action( 'bbp_new_forum_pre_extras', $forum_parent_id );
- // Bail if errors
- if ( bbp_has_errors() )
- return;
- /** No Errors *************************************************************/
- // Add the content of the form to $forum_data as an array
- // Just in time manipulation of forum data before being created
- $forum_data = apply_filters( 'bbp_new_forum_pre_insert', array(
- 'post_author' => $forum_author,
- 'post_title' => $forum_title,
- 'post_content' => $forum_content,
- 'post_parent' => $forum_parent_id,
- 'post_status' => $post_status,
- 'post_type' => bbp_get_forum_post_type(),
- 'comment_status' => 'closed'
- ) );
- // Insert forum
- $forum_id = wp_insert_post( $forum_data );
- /** No Errors *************************************************************/
- if ( !empty( $forum_id ) && !is_wp_error( $forum_id ) ) {
- /** Trash Check *******************************************************/
- // If the forum is trash, or the forum_status is switched to
- // trash, trash it properly
- if ( ( get_post_field( 'post_status', $forum_id ) == bbp_get_trash_status_id() ) || ( $forum_data['post_status'] == bbp_get_trash_status_id() ) ) {
- // Trash the reply
- wp_trash_post( $forum_id );
- // Force view=all
- $view_all = true;
- }
- /** Spam Check ********************************************************/
- // If reply or forum are spam, officially spam this reply
- if ( $forum_data['post_status'] == bbp_get_spam_status_id() ) {
- add_post_meta( $forum_id, '_bbp_spam_meta_status', bbp_get_public_status_id() );
- // Force view=all
- $view_all = true;
- }
- /** Update counts, etc... *********************************************/
- $forum_args = array(
- 'forum_id' => $forum_id,
- 'post_parent' => $forum_parent_id,
- 'forum_author' => $forum_author,
- 'last_topic_id' => 0,
- 'last_reply_id' => 0,
- 'last_active_id' => 0,
- 'last_active_time' => 0,
- 'last_active_status' => bbp_get_public_status_id()
- );
- do_action( 'bbp_new_forum', $forum_args );
- /** Additional Actions (After Save) ***********************************/
- do_action( 'bbp_new_forum_post_extras', $forum_id );
- /** Redirect **********************************************************/
- // Redirect to
- $redirect_to = bbp_get_redirect_to();
- // Get the forum URL
- $redirect_url = bbp_get_forum_permalink( $forum_id, $redirect_to );
- // Add view all?
- if ( bbp_get_view_all() || !empty( $view_all ) ) {
- // User can moderate, so redirect to forum with view all set
- if ( current_user_can( 'moderate' ) ) {
- $redirect_url = bbp_add_view_all( $redirect_url );
- // User cannot moderate, so redirect to forum
- } else {
- $redirect_url = bbp_get_forum_permalink( $forum_id );
- }
- }
- // Allow to be filtered
- $redirect_url = apply_filters( 'bbp_new_forum_redirect_to', $redirect_url, $redirect_to );
- /** Successful Save ***************************************************/
- // Redirect back to new forum
- wp_safe_redirect( $redirect_url );
- // For good measure
- exit();
- // Errors
- } else {
- $append_error = ( is_wp_error( $forum_id ) && $forum_id->get_error_message() ) ? $forum_id->get_error_message() . ' ' : '';
- bbp_add_error( 'bbp_forum_error', __( '<strong>ERROR</strong>: The following problem(s) have been found with your forum:' . $append_error, 'bbpress' ) );
- }
- }
- /**
- * Handles the front end edit forum submission
- *
- * @param string $action The requested action to compare this function to
- * @uses bbPress:errors::add() To log various error messages
- * @uses bbp_get_forum() To get the forum
- * @uses bbp_verify_nonce_request() To verify the nonce and check the request
- * @uses bbp_is_forum_anonymous() To check if forum is by an anonymous user
- * @uses current_user_can() To check if the current user can edit the forum
- * @uses bbp_filter_anonymous_post_data() To filter anonymous data
- * @uses is_wp_error() To check if the value retrieved is a {@link WP_Error}
- * @uses esc_attr() For sanitization
- * @uses bbp_is_forum_category() To check if the forum is a category
- * @uses bbp_is_forum_closed() To check if the forum is closed
- * @uses bbp_is_forum_private() To check if the forum is private
- * @uses remove_filter() To remove kses filters if needed
- * @uses apply_filters() Calls 'bbp_edit_forum_pre_title' with the title and
- * forum id
- * @uses apply_filters() Calls 'bbp_edit_forum_pre_content' with the content
- * and forum id
- * @uses bbPress::errors::get_error_codes() To get the {@link WP_Error} errors
- * @uses wp_save_post_revision() To save a forum revision
- * @uses bbp_update_forum_revision_log() To update the forum revision log
- * @uses wp_update_post() To update the forum
- * @uses do_action() Calls 'bbp_edit_forum' with the forum id, forum id,
- * anonymous data and reply author
- * @uses bbp_move_forum_handler() To handle movement of a forum from one forum
- * to another
- * @uses bbp_get_forum_permalink() To get the forum permalink
- * @uses wp_safe_redirect() To redirect to the forum link
- * @uses bbPress::errors::get_error_messages() To get the {@link WP_Error} error
- * messages
- */
- function bbp_edit_forum_handler( $action = '' ) {
- // Bail if action is not bbp-edit-forum
- if ( 'bbp-edit-forum' !== $action )
- return;
- // Define local variable(s)
- $anonymous_data = array();
- $forum = $forum_id = $forum_parent_id = 0;
- $forum_title = $forum_content = $forum_edit_reason = '';
- /** Forum *****************************************************************/
- // Forum id was not passed
- if ( empty( $_POST['bbp_forum_id'] ) ) {
- bbp_add_error( 'bbp_edit_forum_id', __( '<strong>ERROR</strong>: Forum ID not found.', 'bbpress' ) );
- return;
- // Forum id was passed
- } elseif ( is_numeric( $_POST['bbp_forum_id'] ) ) {
- $forum_id = (int) $_POST['bbp_forum_id'];
- $forum = bbp_get_forum( $forum_id );
- }
- // Nonce check
- if ( ! bbp_verify_nonce_request( 'bbp-edit-forum_' . $forum_id ) ) {
- bbp_add_error( 'bbp_edit_forum_nonce', __( '<strong>ERROR</strong>: Are you sure you wanted to do that?', 'bbpress' ) );
- return;
- // Forum does not exist
- } elseif ( empty( $forum ) ) {
- bbp_add_error( 'bbp_edit_forum_not_found', __( '<strong>ERROR</strong>: The forum you want to edit was not found.', 'bbpress' ) );
- return;
- // User cannot edit this forum
- } elseif ( !current_user_can( 'edit_forum', $forum_id ) ) {
- bbp_add_error( 'bbp_edit_forum_permissions', __( '<strong>ERROR</strong>: You do not have permission to edit that forum.', 'bbpress' ) );
- return;
- }
- // Remove kses filters from title and content for capable users and if the nonce is verified
- if ( current_user_can( 'unfiltered_html' ) && !empty( $_POST['_bbp_unfiltered_html_forum'] ) && ( wp_create_nonce( 'bbp-unfiltered-html-forum_' . $forum_id ) == $_POST['_bbp_unfiltered_html_forum'] ) ) {
- remove_filter( 'bbp_edit_forum_pre_title', 'wp_filter_kses' );
- remove_filter( 'bbp_edit_forum_pre_content', 'bbp_encode_bad', 10 );
- remove_filter( 'bbp_edit_forum_pre_content', 'bbp_filter_kses', 30 );
- }
- /** Forum Parent ***********************************************************/
- // Forum parent id was passed
- if ( is_numeric( $_POST['bbp_forum_parent_id'] ) ) {
- $forum_parent_id = (int) $_POST['bbp_forum_parent_id'];
- }
- // Current forum this forum is in
- $current_parent_forum_id = bbp_get_forum_parent_id( $forum_id );
- // Forum exists
- if ( !empty( $forum_parent_id ) && ( $forum_parent_id !== $current_parent_forum_id ) ) {
- // Forum is closed and user cannot access
- if ( bbp_is_forum_closed( $forum_parent_id ) && !current_user_can( 'edit_forum', $forum_parent_id ) ) {
- bbp_add_error( 'bbp_edit_forum_forum_closed', __( '<strong>ERROR</strong>: This forum has been closed to new forums.', 'bbpress' ) );
- }
- // Forum is private and user cannot access
- if ( bbp_is_forum_private( $forum_parent_id ) && !current_user_can( 'read_private_forums' ) ) {
- bbp_add_error( 'bbp_edit_forum_forum_private', __( '<strong>ERROR</strong>: This forum is private and you do not have the capability to read or create new forums in it.', 'bbpress' ) );
- }
- // Forum is hidden and user cannot access
- if ( bbp_is_forum_hidden( $forum_parent_id ) && !current_user_can( 'read_hidden_forums' ) ) {
- bbp_add_error( 'bbp_edit_forum_forum_hidden', __( '<strong>ERROR</strong>: This forum is hidden and you do not have the capability to read or create new forums in it.', 'bbpress' ) );
- }
- }
- /** Forum Title ***********************************************************/
- if ( !empty( $_POST['bbp_forum_title'] ) )
- $forum_title = esc_attr( strip_tags( $_POST['bbp_forum_title'] ) );
- // Filter and sanitize
- $forum_title = apply_filters( 'bbp_edit_forum_pre_title', $forum_title, $forum_id );
- // No forum title
- if ( empty( $forum_title ) )
- bbp_add_error( 'bbp_edit_forum_title', __( '<strong>ERROR</strong>: Your forum needs a title.', 'bbpress' ) );
- /** Forum Content *********************************************************/
- if ( !empty( $_POST['bbp_forum_content'] ) )
- $forum_content = $_POST['bbp_forum_content'];
- // Filter and sanitize
- $forum_content = apply_filters( 'bbp_edit_forum_pre_content', $forum_content, $forum_id );
- // No forum content
- if ( empty( $forum_content ) )
- bbp_add_error( 'bbp_edit_forum_content', __( '<strong>ERROR</strong>: Your forum description cannot be empty.', 'bbpress' ) );
- /** Forum Blacklist *******************************************************/
- if ( !bbp_check_for_blacklist( $anonymous_data, bbp_get_forum_author_id( $forum_id ), $forum_title, $forum_content ) )
- bbp_add_error( 'bbp_forum_blacklist', __( '<strong>ERROR</strong>: Your forum cannot be edited at this time.', 'bbpress' ) );
- /** Forum Moderation ******************************************************/
- $post_status = bbp_get_public_status_id();
- if ( !bbp_check_for_moderation( $anonymous_data, bbp_get_forum_author_id( $forum_id ), $forum_title, $forum_content ) )
- $post_status = bbp_get_pending_status_id();
- /** Additional Actions (Before Save) **************************************/
- do_action( 'bbp_edit_forum_pre_extras', $forum_id );
- // Bail if errors
- if ( bbp_has_errors() )
- return;
- /** No Errors *************************************************************/
- // Add the content of the form to $forum_data as an array
- // Just in time manipulation of forum data before being edited
- $forum_data = apply_filters( 'bbp_edit_forum_pre_insert', array(
- 'ID' => $forum_id,
- 'post_title' => $forum_title,
- 'post_content' => $forum_content,
- 'post_status' => $post_status,
- 'post_parent' => $forum_parent_id
- ) );
- // Insert forum
- $forum_id = wp_update_post( $forum_data );
- /** Revisions *************************************************************/
- /**
- * @todo omitted for 2.1
- // Revision Reason
- if ( !empty( $_POST['bbp_forum_edit_reason'] ) )
- $forum_edit_reason = esc_attr( strip_tags( $_POST['bbp_forum_edit_reason'] ) );
- // Update revision log
- if ( !empty( $_POST['bbp_log_forum_edit'] ) && ( 1 == $_POST['bbp_log_forum_edit'] ) && ( $revision_id = wp_save_post_revision( $forum_id ) ) ) {
- bbp_update_forum_revision_log( array(
- 'forum_id' => $forum_id,
- 'revision_id' => $revision_id,
- 'author_id' => bbp_get_current_user_id(),
- 'reason' => $forum_edit_reason
- ) );
- }
- */
- /** No Errors *************************************************************/
- if ( !empty( $forum_id ) && !is_wp_error( $forum_id ) ) {
- // Update counts, etc...
- $forum_args = array(
- 'forum_id' => $forum_id,
- 'post_parent' => $forum_parent_id,
- 'forum_author' => $forum->post_author,
- 'last_topic_id' => 0,
- 'last_reply_id' => 0,
- 'last_active_id' => 0,
- 'last_active_time' => 0,
- 'last_active_status' => bbp_get_public_status_id()
- );
- do_action( 'bbp_edit_forum', $forum_args );
- // If the new forum parent id is not equal to the old forum parent
- // id, run the bbp_move_forum action and pass the forum's parent id
- // as the first arg and new forum parent id as the second.
- // @todo implement
- //if ( $forum_id != $forum->post_parent )
- // bbp_move_forum_handler( $forum_parent_id, $forum->post_parent, $forum_id );
- /** Additional Actions (After Save) ***********************************/
- do_action( 'bbp_edit_forum_post_extras', $forum_id );
- /** Redirect **********************************************************/
- // Redirect to
- $redirect_to = bbp_get_redirect_to();
- // View all?
- $view_all = bbp_get_view_all();
- // Get the forum URL
- $forum_url = bbp_get_forum_permalink( $forum_id, $redirect_to );
- // Add view all?
- if ( !empty( $view_all ) )
- $forum_url = bbp_add_view_all( $forum_url );
- // Allow to be filtered
- $forum_url = apply_filters( 'bbp_edit_forum_redirect_to', $forum_url, $view_all, $redirect_to );
- /** Successful Edit ***************************************************/
- // Redirect back to new forum
- wp_safe_redirect( $forum_url );
- // For good measure
- exit();
- /** Errors ****************************************************************/
- } else {
- $append_error = ( is_wp_error( $forum_id ) && $forum_id->get_error_message() ) ? $forum_id->get_error_message() . ' ' : '';
- bbp_add_error( 'bbp_forum_error', __( '<strong>ERROR</strong>: The following problem(s) have been found with your forum:' . $append_error . 'Please try again.', 'bbpress' ) );
- }
- }
- /**
- * Handle the saving of core forum metadata (Status, Visibility, and Type)
- *
- * @since bbPress (r3678)
- * @param int $forum_id
- * @uses bbp_is_forum_closed() To check if forum is closed
- * @uses bbp_close_forum() To close forum
- * @uses bbp_open_forum() To open forum
- * @uses bbp_is_forum_category() To check if forum is a category
- * @uses bbp_categorize_forum() To turn forum into a category
- * @uses bbp_normalize_forum() To turn category into forum
- * @uses bbp_get_public_status_id() To get the public status ID
- * @uses bbp_get_private_status_id() To get the private status ID
- * @uses bbp_get_hidden_status_id() To get the hidden status ID
- * @uses bbp_get_forum_visibility() To get the forums visibility
- * @uses bbp_hide_forum() To hide a forum
- * @uses bbp_privatize_forum() To make a forum private
- * @uses bbp_publicize_forum() To make a forum public
- * @return If forum ID is empty
- */
- function bbp_save_forum_extras( $forum_id = 0 ) {
- // Validate the forum ID
- $forum_id = bbp_get_forum_id( $forum_id );
- // Bail if forum ID is empty
- if ( empty( $forum_id ) || ! bbp_is_forum( $forum_id ) )
- return;
- /** Forum Status ******************************************************/
- if ( !empty( $_POST['bbp_forum_status'] ) && in_array( $_POST['bbp_forum_status'], array( 'open', 'closed' ) ) ) {
- if ( 'closed' == $_POST['bbp_forum_status'] && !bbp_is_forum_closed( $forum_id, false ) ) {
- bbp_close_forum( $forum_id );
- } elseif ( 'open' == $_POST['bbp_forum_status'] && bbp_is_forum_closed( $forum_id, false ) ) {
- bbp_open_forum( $forum_id );
- }
- }
- /** Forum Type ********************************************************/
- if ( !empty( $_POST['bbp_forum_type'] ) && in_array( $_POST['bbp_forum_type'], array( 'forum', 'category' ) ) ) {
- if ( 'category' == $_POST['bbp_forum_type'] && !bbp_is_forum_category( $forum_id ) ) {
- bbp_categorize_forum( $forum_id );
- } elseif ( 'forum' == $_POST['bbp_forum_type'] && bbp_is_forum_category( $forum_id ) ) {
- bbp_normalize_forum( $forum_id );
- }
- }
- /** Forum Visibility **************************************************/
- if ( !empty( $_POST['bbp_forum_visibility'] ) && in_array( $_POST['bbp_forum_visibility'], array( bbp_get_public_status_id(), bbp_get_private_status_id(), bbp_get_hidden_status_id() ) ) ) {
- // Get forums current visibility
- $visibility = bbp_get_forum_visibility( $forum_id );
- // What is the new forum visibility setting?
- switch ( $_POST['bbp_forum_visibility'] ) {
- // Hidden
- case bbp_get_hidden_status_id() :
- bbp_hide_forum( $forum_id, $visibility );
- break;
- // Private
- case bbp_get_private_status_id() :
- bbp_privatize_forum( $forum_id, $visibility );
- break;
- // Publish (default)
- case bbp_get_public_status_id() :
- default :
- bbp_publicize_forum( $forum_id, $visibility );
- break;
- }
- }
- }
- /** Forum Actions *************************************************************/
- /**
- * Closes a forum
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id forum id
- * @uses do_action() Calls 'bbp_close_forum' with the forum id
- * @uses update_post_meta() To add the previous status to a meta
- * @uses do_action() Calls 'bbp_opened_forum' with the forum id
- * @return mixed False or {@link WP_Error} on failure, forum id on success
- */
- function bbp_close_forum( $forum_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_close_forum', $forum_id );
- update_post_meta( $forum_id, '_bbp_status', 'closed' );
- do_action( 'bbp_closed_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Opens a forum
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id forum id
- * @uses do_action() Calls 'bbp_open_forum' with the forum id
- * @uses get_post_meta() To get the previous status
- * @uses update_post_meta() To delete the previous status meta
- * @uses do_action() Calls 'bbp_opened_forum' with the forum id
- * @return mixed False or {@link WP_Error} on failure, forum id on success
- */
- function bbp_open_forum( $forum_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_open_forum', $forum_id );
- update_post_meta( $forum_id, '_bbp_status', 'open' );
- do_action( 'bbp_opened_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Make the forum a category
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id Optional. Forum id
- * @uses update_post_meta() To update the forum category meta
- * @return bool False on failure, true on success
- */
- function bbp_categorize_forum( $forum_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_categorize_forum', $forum_id );
- update_post_meta( $forum_id, '_bbp_forum_type', 'category' );
- do_action( 'bbp_categorized_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Remove the category status from a forum
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id Optional. Forum id
- * @uses delete_post_meta() To delete the forum category meta
- * @return bool False on failure, true on success
- */
- function bbp_normalize_forum( $forum_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_normalize_forum', $forum_id );
- update_post_meta( $forum_id, '_bbp_forum_type', 'forum' );
- do_action( 'bbp_normalized_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Mark the forum as public
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id Optional. Forum id
- * @uses update_post_meta() To update the forum private meta
- * @return bool False on failure, true on success
- */
- function bbp_publicize_forum( $forum_id = 0, $current_visibility = '' ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_publicize_forum', $forum_id );
- // Get private forums
- $private = bbp_get_private_forum_ids();
- // Find this forum in the array
- if ( in_array( $forum_id, $private ) ) {
- $offset = array_search( $forum_id, $private );
- // Splice around it
- array_splice( $private, $offset, 1 );
- // Update private forums minus this one
- update_option( '_bbp_private_forums', array_unique( array_filter( array_values( $private ) ) ) );
- }
- // Get hidden forums
- $hidden = bbp_get_hidden_forum_ids();
- // Find this forum in the array
- if ( in_array( $forum_id, $hidden ) ) {
- $offset = array_search( $forum_id, $hidden );
- // Splice around it
- array_splice( $hidden, $offset, 1 );
- // Update hidden forums minus this one
- update_option( '_bbp_hidden_forums', array_unique( array_filter( array_values( $hidden ) ) ) );
- }
- // Only run queries if visibility is changing
- if ( bbp_get_public_status_id() != $current_visibility ) {
- // Update forum post_status
- global $wpdb;
- $wpdb->update( $wpdb->posts, array( 'post_status' => bbp_get_public_status_id() ), array( 'ID' => $forum_id ) );
- wp_transition_post_status( bbp_get_public_status_id(), $current_visibility, get_post( $forum_id ) );
- }
- do_action( 'bbp_publicized_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Mark the forum as private
- *
- * @since bbPress (r2746)
- *
- * @param int $forum_id Optional. Forum id
- * @uses update_post_meta() To update the forum private meta
- * @return bool False on failure, true on success
- */
- function bbp_privatize_forum( $forum_id = 0, $current_visibility = '' ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_privatize_forum', $forum_id );
- // Only run queries if visibility is changing
- if ( bbp_get_private_status_id() != $current_visibility ) {
- // Get hidden forums
- $hidden = bbp_get_hidden_forum_ids();
- // Find this forum in the array
- if ( in_array( $forum_id, $hidden ) ) {
- $offset = array_search( $forum_id, $hidden );
- // Splice around it
- array_splice( $hidden, $offset, 1 );
- // Update hidden forums minus this one
- update_option( '_bbp_hidden_forums', array_unique( array_filter( array_values( $hidden ) ) ) );
- }
- // Add to '_bbp_private_forums' site option
- $private = bbp_get_private_forum_ids();
- $private[] = $forum_id;
- update_option( '_bbp_private_forums', array_unique( array_filter( array_values( $private ) ) ) );
- // Update forums visibility setting
- global $wpdb;
- $wpdb->update( $wpdb->posts, array( 'post_status' => bbp_get_private_status_id() ), array( 'ID' => $forum_id ) );
- wp_transition_post_status( bbp_get_private_status_id(), $current_visibility, get_post( $forum_id ) );
- }
- do_action( 'bbp_privatized_forum', $forum_id );
- return $forum_id;
- }
- /**
- * Mark the forum as hidden
- *
- * @since bbPress (r2996)
- *
- * @param int $forum_id Optional. Forum id
- * @uses update_post_meta() To update the forum private meta
- * @return bool False on failure, true on success
- */
- function bbp_hide_forum( $forum_id = 0, $current_visibility = '' ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- do_action( 'bbp_hide_forum', $forum_id );
- // Only run queries if visibility is changing
- if ( bbp_get_hidden_status_id() != $current_visibility ) {
- // Get private forums
- $private = bbp_get_private_forum_ids();
- // Find this forum in the array
- if ( in_array( $forum_id, $private ) ) {
- $offset = array_search( $forum_id, $private );
- // Splice around it
- array_splice( $private, $offset, 1 );
- // Update private forums minus this one
- update_option( '_bbp_private_forums', array_unique( array_filter( array_values( $private ) ) ) );
- }
- // Add to '_bbp_hidden_forums' site option
- $hidden = bbp_get_hidden_forum_ids();
- $hidden[] = $forum_id;
- update_option( '_bbp_hidden_forums', array_unique( array_filter( array_values( $hidden ) ) ) );
- // Update forums visibility setting
- global $wpdb;
- $wpdb->update( $wpdb->posts, array( 'post_status' => bbp_get_hidden_status_id() ), array( 'ID' => $forum_id ) );
- wp_transition_post_status( bbp_get_hidden_status_id(), $current_visibility, get_post( $forum_id ) );
- }
- do_action( 'bbp_hid_forum', $forum_id );
- return $forum_id;
- }
- /** Count Bumpers *************************************************************/
- /**
- * Bump the total topic count of a forum
- *
- * @since bbPress (r3825)
- *
- * @param int $forum_id Optional. Forum id.
- * @param int $difference Optional. Default 1
- * @param bool $update_ancestors Optional. Default true
- * @uses bbp_get_forum_id() To get the forum id
- * @uses update_post_meta() To update the forum's topic count meta
- * @uses apply_filters() Calls 'bbp_bump_forum_topic_count' with the topic
- * count, forum id, and difference
- * @return int Forum topic count
- */
- function bbp_bump_forum_topic_count( $forum_id = 0, $difference = 1, $update_ancestors = true ) {
- // Get some counts
- $forum_id = bbp_get_forum_id( $forum_id );
- $topic_count = bbp_get_forum_topic_count( $forum_id, false, true );
- $total_topic_count = bbp_get_forum_topic_count( $forum_id, true, true );
- // Update this forum id
- update_post_meta( $forum_id, '_bbp_topic_count', (int) $topic_count + (int) $difference );
- update_post_meta( $forum_id, '_bbp_total_topic_count', (int) $total_topic_count + (int) $difference );
- // Check for ancestors
- if ( true === $update_ancestors ) {
- // Get post ancestors
- $forum = get_post( $forum_id );
- $ancestors = get_post_ancestors( $forum );
- // If has ancestors, loop through them...
- if ( !empty( $ancestors ) ) {
- foreach ( (array) $ancestors as $parent_forum_id ) {
- // Get forum counts
- $parent_topic_count = bbp_get_forum_topic_count( $parent_forum_id, false, true );
- $parent_total_topic_count = bbp_get_forum_topic_count( $parent_forum_id, true, true );
- // Update counts
- update_post_meta( $parent_forum_id, '_bbp_topic_count', (int) $parent_topic_count + (int) $difference );
- update_post_meta( $parent_forum_id, '_bbp_total_topic_count', (int) $parent_total_topic_count + (int) $difference );
- }
- }
- }
- return (int) apply_filters( 'bbp_bump_forum_topic_count', (int) $total_topic_count + (int) $difference, $forum_id, (int) $difference, (bool) $update_ancestors );
- }
- /**
- * Bump the total hidden topic count of a forum
- *
- * @since bbPress (r3825)
- *
- * @param int $forum_id Optional. Forum id.
- * @param int $difference Optional. Default 1
- * @uses bbp_get_forum_id() To get the forum id
- * @uses update_post_meta() To update the forum's topic count meta
- * @uses apply_filters() Calls 'bbp_bump_forum_topic_count_hidden' with the
- * topic count, forum id, and difference
- * @return int Forum hidden topic count
- */
- function bbp_bump_forum_topic_count_hidden( $forum_id = 0, $difference = 1 ) {
- // Get some counts
- $forum_id = bbp_get_forum_id( $forum_id );
- $topic_count = bbp_get_forum_topic_count_hidden( $forum_id, true );
- $new_count = (int) $topic_count + (int) $difference;
- // Update this forum id
- update_post_meta( $forum_id, '_bbp_topic_count_hidden', (int) $new_count );
- return (int) apply_filters( 'bbp_bump_forum_topic_count_hidden', (int) $new_count, $forum_id, (int) $difference );
- }
- /**
- * Bump the total topic count of a forum
- *
- * @since bbPress (r3825)
- *
- * @param int $forum_id Optional. Forum id.
- * @param int $difference Optional. Default 1
- * @param bool $update_ancestors Optional. Default true
- * @uses bbp_get_forum_id() To get the forum id
- * @uses update_post_meta() To update the forum's topic count meta
- * @uses apply_filters() Calls 'bbp_bump_forum_reply_count' with the topic
- * count, forum id, and difference
- * @return int Forum topic count
- */
- function bbp_bump_forum_reply_count( $forum_id = 0, $difference = 1, $update_ancestors = true ) {
- // Get some counts
- $forum_id = bbp_get_forum_id( $forum_id );
- $topic_count = bbp_get_forum_reply_count( $forum_id, false, true );
- $total_reply_count = bbp_get_forum_reply_count( $forum_id, true, true );
- // Update this forum id
- update_post_meta( $forum_id, '_bbp_reply_count', (int) $topic_count + (int) $difference );
- update_post_meta( $forum_id, '_bbp_total_reply_count', (int) $total_reply_count + (int) $difference );
- // Check for ancestors
- if ( true === $update_ancestors ) {
- // Get post ancestors
- $forum = get_post( $forum_id );
- $ancestors = get_post_ancestors( $forum );
- // If has ancestors, loop through them...
- if ( !empty( $ancestors ) ) {
- foreach ( (array) $ancestors as $parent_forum_id ) {
- // Get forum counts
- $parent_topic_count = bbp_get_forum_reply_count( $parent_forum_id, false, true );
- $parent_total_reply_count = bbp_get_forum_reply_count( $parent_forum_id, true, true );
- // Update counts
- update_post_meta( $parent_forum_id, '_bbp_reply_count', (int) $parent_topic_count + (int) $difference );
- update_post_meta( $parent_forum_id, '_bbp_total_reply_count', (int) $parent_total_reply_count + (int) $difference );
- }
- }
- }
- return (int) apply_filters( 'bbp_bump_forum_reply_count', (int) $total_reply_count + (int) $difference, $forum_id, (int) $difference, (bool) $update_ancestors );
- }
- /** Forum Updaters ************************************************************/
- /**
- * Update the forum last topic id
- *
- * @since bbPress (r2625)
- *
- * @param int $forum_id Optional. Forum id
- * @param int $topic_id Optional. Topic id
- * @uses bbp_get_forum_id() To get the forum id
- * @uses bbp_forum_query_subforum_ids() To get the subforum ids
- * @uses bbp_update_forum_last_topic_id() To update the last topic id of child
- * forums
- * @uses get_posts() To get the most recent topic in the forum
- * @uses update_post_meta() To update the forum's last active id meta
- * @uses apply_filters() Calls 'bbp_update_forum_last_topic_id' with the last
- * reply id and forum id
- * @return bool True on success, false on failure
- */
- function bbp_update_forum_last_topic_id( $forum_id = 0, $topic_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- // Define local variable(s)
- $children_last_topic = 0;
- // Do some calculation if not manually set
- if ( empty( $topic_id ) ) {
- // Loop through children and add together forum reply counts
- $children = bbp_forum_query_subforum_ids( $forum_id );
- if ( !empty( $children ) ) {
- foreach ( (array) $children as $child ) {
- $children_last_topic = bbp_update_forum_last_topic_id( $child ); // Recursive
- }
- }
- // Setup recent topic query vars
- $post_vars = array(
- 'post_parent' => $forum_id,
- 'post_type' => bbp_get_topic_post_type(),
- 'meta_key' => '_bbp_last_active_time',
- 'orderby' => 'meta_value',
- 'numberposts' => 1
- );
- // Get the most recent topic in this forum_id
- $recent_topic = get_posts( $post_vars );
- if ( !empty( $recent_topic ) ) {
- $topic_id = $recent_topic[0]->ID;
- }
- }
- // Cast as integer in case of empty or string
- $topic_id = (int) $topic_id;
- $children_last_topic = (int) $children_last_topic;
- // If child forums have higher id, use that instead
- if ( !empty( $children ) && ( $children_last_topic > $topic_id ) )
- $topic_id = $children_last_topic;
- // Update the last public topic ID
- if ( bbp_is_topic_published( $topic_id ) )
- update_post_meta( $forum_id, '_bbp_last_topic_id', $topic_id );
- return (int) apply_filters( 'bbp_update_forum_last_topic_id', $topic_id, $forum_id );
- }
- /**
- * Update the forum last reply id
- *
- * @since bbPress (r2625)
- *
- * @param int $forum_id Optional. Forum id
- * @param int $reply_id Optional. Reply id
- * @uses bbp_get_forum_id() To get the forum id
- * @uses bbp_forum_query_subforum_ids() To get the subforum ids
- * @uses bbp_update_forum_last_reply_id() To update the last reply id of child
- * forums
- * @uses bbp_forum_query_topic_ids() To get the topic ids in the forum
- * @uses bbp_forum_query_last_reply_id() To get the forum's last reply id
- * @uses bbp_is_reply_published() To make sure the reply is published
- * @uses update_post_meta() To update the forum's last active id meta
- * @uses apply_filters() Calls 'bbp_update_forum_last_reply_id' with the last
- * reply id and forum id
- * @return bool True on success, false on failure
- */
- function bbp_update_forum_last_reply_id( $forum_id = 0, $reply_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- // Define local variable(s)
- $children_last_reply = 0;
- // Do some calculation if not manually set
- if ( empty( $reply_id ) ) {
- // Loop through children and get the most recent reply id
- $children = bbp_forum_query_subforum_ids( $forum_id );
- if ( !empty( $children ) ) {
- foreach ( (array) $children as $child ) {
- $children_last_reply = bbp_update_forum_last_reply_id( $child ); // Recursive
- }
- }
- // If this forum has topics...
- $topic_ids = bbp_forum_query_topic_ids( $forum_id );
- if ( !empty( $topic_ids ) ) {
- // ...get the most recent reply from those topics...
- $reply_id = bbp_forum_query_last_reply_id( $forum_id, $topic_ids );
- // ...and compare it to the most recent topic id...
- $reply_id = ( $reply_id > max( $topic_ids ) ) ? $reply_id : max( $topic_ids );
- }
- }
- // Cast as integer in case of empty or string
- $reply_id = (int) $reply_id;
- $children_last_reply = (int) $children_last_reply;
- // If child forums have higher ID, check for newer reply id
- if ( !empty( $children ) && ( $children_last_reply > $reply_id ) )
- $reply_id = $children_last_reply;
- // Update the last public reply ID
- if ( bbp_is_reply_published( $reply_id ) )
- update_post_meta( $forum_id, '_bbp_last_reply_id', $reply_id );
- return (int) apply_filters( 'bbp_update_forum_last_reply_id', $reply_id, $forum_id );
- }
- /**
- * Update the forum last active post id
- *
- * @since bbPress (r2860)
- *
- * @param int $forum_id Optional. Forum id
- * @param int $active_id Optional. Active post id
- * @uses bbp_get_forum_id() To get the forum id
- * @uses bbp_forum_query_subforum_ids() To get the subforum ids
- * @uses bbp_update_forum_last_active_id() To update the last active id of
- * child forums
- * @uses bbp_forum_query_topic_ids() To get the topic ids in the forum
- * @uses bbp_forum_query_last_reply_id() To get the forum's last reply id
- * @uses get_post_status() To make sure the reply is published
- * @uses update_post_meta() To update the forum's last active id meta
- * @uses apply_filters() Calls 'bbp_update_forum_last_active_id' with the last
- * active post id and forum id
- * @return bool True on success, false on failure
- */
- function bbp_update_forum_last_active_id( $forum_id = 0, $active_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- // Define local variable(s)
- $children_last_active = 0;
- // Do some calculation if not manually set
- if ( empty( $active_id ) ) {
- // Loop through children and add together forum reply counts
- $children = bbp_forum_query_subforum_ids( $forum_id );
- if ( !empty( $children ) ) {
- foreach ( (array) $children as $child ) {
- $children_last_active = bbp_update_forum_last_active_id( $child, $active_id );
- }
- }
- // Don't count replies if the forum is a category
- $topic_ids = bbp_forum_query_topic_ids( $forum_id );
- if ( !empty( $topic_ids ) ) {
- $active_id = bbp_forum_query_last_reply_id( $forum_id, $topic_ids );
- $active_id = $active_id > max( $topic_ids ) ? $active_id : max( $topic_ids );
- // Forum has no topics
- } else {
- $active_id = 0;
- }
- }
- // Cast as integer in case of empty or string
- $active_id = (int) $active_id;
- $children_last_active = (int) $children_last_active;
- // If child forums have higher id, use that instead
- if ( !empty( $children ) && ( $children_last_active > $active_id ) )
- $active_id = $children_last_active;
- // Update only if published
- if ( bbp_get_public_status_id() == get_post_status( $active_id ) )
- update_post_meta( $forum_id, '_bbp_last_active_id', (int) $active_id );
- return (int) apply_filters( 'bbp_update_forum_last_active_id', (int) $active_id, $forum_id );
- }
- /**
- * Update the forums last active date/time (aka freshness)
- *
- * @since bbPress (r2680)
- *
- * @param int $forum_id Optional. Topic id
- * @param string $new_time Optional. New time in mysql format
- * @uses bbp_get_forum_id() To get the forum id
- * @uses bbp_get_forum_last_active_id() To get the forum's last post id
- * @uses get_post_field() To get the post date of the forum's last post
- * @uses update_post_meta() To update the forum last active time
- * @uses apply_filters() Calls 'bbp_update_forum_last_active' with the new time
- * and forum id
- * @return bool True on success, false on failure
- */
- function bbp_update_forum_last_active_time( $forum_id = 0, $new_time = '' ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- // Check time and use current if empty
- if ( empty( $new_time ) )
- $new_time = get_post_field( 'post_date', bbp_get_forum_last_active_id( $forum_id ) );
- // Update only if there is a time
- if ( !empty( $new_time ) )
- update_post_meta( $forum_id, '_bbp_last_active_time', $new_time );
- return (int) apply_filters( 'bbp_update_forum_last_active', $new_time, $forum_id );
- }
- /**
- * Update the forum sub-forum count
- *
- * @since bbPress (r2625)
- *
- * @param int $forum_id Optional. Forum id
- * @uses bbp_get_forum_id() To get the forum id
- * @return bool True on success, false on failure
- */
- function bbp_update_forum_subforum_count( $forum_id = 0, $subforums = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- if ( empty( $subforums ) )
- $subforums = count( bbp_forum_query_subforum_ids( $forum_id ) );
- update_post_meta( $forum_id, '_bbp_forum_subforum_count', (int) $subforums );
- return (int) apply_filters( 'bbp_update_forum_subforum_count', (int) $subforums, $forum_id );
- }
- /**
- * Adjust the total topic count of a forum
- *
- * @since bbPress (r2464)
- *
- * @param int $forum_id Optional. Forum id or topic id. It is checked whether it
- * is a topic or a forum. If it's a topic, its parent,
- * i.e. the forum is automatically retrieved.
- * @param bool $total_count Optional. To return the total count or normal
- * count?
- * @uses bbp_get_forum_id() To get the forum id
- * @uses bbp_forum_query_subforum_ids() To get the subforum ids
- * @uses bbp_update_forum_topic_count() To update the forum topic count
- * @uses bbp_forum_query_topic_ids() To get the forum topic ids
- * @uses update_post_meta() To update the forum's topic count meta
- * @uses apply_filters() Calls 'bbp_update_forum_topic_count' with the topic
- * count and forum id
- * @return int Forum topic count
- */
- function bbp_update_forum_topic_count( $forum_id = 0 ) {
- $forum_id = bbp_get_forum_id( $forum_id );
- $children_topic_count = 0;
- // Loop through subforums and add together forum topic counts
- $children = bbp_forum_query_subforum_ids( $forum_id );
- if ( !empty( $children ) ) {
- foreach ( (array) $children as $child ) {
- $children_topic_count += bbp_update_forum_topic_count( $child ); // Recursive
- }
- }
- // Get total topics for this forum
- $topics = (int) count( bbp_forum_query_topic_ids( $forum_id ) );
- // Calculate total topics in this forum
- $total_topics = $topics + $children_topic_count;
- // Update the count
- update_post_meta( $forum_id, '_bbp_topic_count', (int) $topics );
- update_post_meta( $forum_id, '_bbp_total_topic_count', (int) $total_topics );
- return (int) apply_filters( 'bbp_update_forum_topic_count', (int) $total_topics, $forum_id );
- }
- /**
- * Adjust the total hidden topic count of a forum (hidden includes trashed and spammed topics)
- *
- * @since bbPress (r2888)
- *
- * @param int $forum_id Optional. Topic id to update
- * @param int $topic_count Optional. Set the topic count manually
- * @uses bbp_is_topic() To check if the supplied id is a topic
- * @uses bbp_get_topic_id() To get the topic id
- * @uses bbp_get_topic_forum_id() To get the topic forum id
- * @uses bbp_get_forum_id() To get the forum id
- * @uses wpdb::prepare() To prepare our sql query
- * @uses wpdb::get_col() To execute our query and get the column back
- * @uses update_post_meta() To update the forum hidden topic count meta
- * @uses apply_filters() Calls 'bbp_update_forum_topic_count_hidden' with the
- * hidden topic count and forum id
- * @return int Topic hidden topic count
- */
- function bbp_update_forum_topic_count_hidden( $forum_id = 0, $topic_count = 0 ) {
- global $wpdb;
- // If topic_id was passed as $forum_id, then get its forum
- if ( bbp_is_topic( $forum_id ) ) {
- $topic_id = bbp_get_topic_id( $forum_id );
- $forum_id = bbp_get_topic_forum_id( $topic_id );
- // $forum_id is not a topic_id, so validate and proceed
- } else {
- $forum_id = bbp_get_forum_id( $forum_id );
- }
- // Can't update what isn't there
- if ( !empty( $forum_id ) ) {
- // Get topics of forum
- if ( empty( $topic_count ) )
- $topic_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(ID) FROM {$wpdb->posts} WHERE post_parent = %d AND post_status IN ( '" . join( '\',\'', array( bbp_get_trash_status_id(), bbp_get_spam_status_id() ) ) . "') AND post_type = '%s';", $forum_id, bbp_get_topic_post_type() ) );
- // Update the count
- update_post_meta( $forum_id, '_bbp_topic_count_h…
Large files files are truncated, but you can click here to view the full file