bbp_new_forum_handler( string $action = '' )

Handles the front end forum submission

Description

Parameters

$action

(Optional) The requested action to compare this function to

Default value: ''

Source

File: bp-forums/forums/functions.php

117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
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?', 'buddyboss' ) );
        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.', 'buddyboss' ) );
        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.', 'buddyboss' ) );
 
    /** 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.', 'buddyboss' ) );
 
    /** Forum Parent **********************************************************/
 
    // Forum parent was passed (the norm)
    if ( !empty( $_POST['bbp_forum_parent_id'] ) ) {
        $forum_parent_id = bbp_get_forum_id( $_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.', 'buddyboss' ) );
 
    // 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.', 'buddyboss' ) );
        }
 
        // 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.', 'buddyboss' ) );
        }
 
        // 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.', 'buddyboss' ) );
        }
 
        // 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.', 'buddyboss' ) );
        }
    }
 
    /** 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.', 'buddyboss' ) );
 
    /** 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.', 'buddyboss' ) );
 
    /** 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.', 'buddyboss' ) );
 
    /** 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... *********************************************/
 
        do_action( 'bbp_new_forum', 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()
        ) );
 
        /** 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, 'buddyboss' ) );
    }
}

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.