/**
* Return value of forum mods field
*
* @since 2.6.0 bbPress (r5837)
*
* @uses bbp_is_forum_edit() To check if it's the forum edit page
* @uses apply_filters() Calls 'bbp_get_form_forum_mods' with the mods
*
* @return string Value of forum mods field
*/
function bbp_get_form_forum_mods()
{
// Get _POST data
if (bbp_is_forum_form_post_request() && isset($_POST['bbp_forum_mods'])) {
$forum_mods = wp_unslash($_POST['bbp_forum_mods']);
// Get edit data
} elseif (bbp_is_single_forum() || bbp_is_forum_edit()) {
// Get the forum ID
$forum_id = bbp_get_forum_id(get_the_ID());
// Forum exists
if (!empty($forum_id)) {
$forum_mods = bbp_get_forum_mod_names($forum_id);
}
// No data
} else {
$forum_mods = '';
}
return apply_filters('bbp_get_form_forum_mods', $forum_mods);
}
/**
* 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 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 bbp_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 (!empty($_POST['bbp_forum_parent_id'])) {
$forum_parent_id = bbp_get_forum_id($_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 = sanitize_text_field($_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();
}
/** Forum Mods ************************************************************/
// Either replace terms
if (bbp_allow_forum_mods() && current_user_can('assign_forum_mods') && !empty($_POST['bbp_forum_mods'])) {
// Escape tag input
$terms = sanitize_text_field($_POST['bbp_forum_mods']);
// Explode by comma
if (strstr($terms, ',')) {
$terms = explode(',', $terms);
}
// Add forum mod ID as main key
$terms = array(bbp_get_forum_mod_tax_id() => $terms);
// ...or remove them.
} elseif (isset($_POST['bbp_forum_mods'])) {
$terms = array(bbp_get_forum_mod_tax_id() => array());
// Existing terms
} else {
$terms = array(bbp_get_forum_mod_tax_id() => explode(',', bbp_get_forum_mod_names($forum_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 = sanitize_text_field( $_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...
do_action('bbp_edit_forum', 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()));
// 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
bbp_redirect($forum_url);
/** 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'));
}
}
