PluginProbe
bbPress / 2.6.6
bbPress v2.6.6
trunk 2.0 2.0-beta-1 2.0-beta-2b 2.0-beta-3 2.0-beta-3b 2.0-rc-2 2.0-rc-3 2.0-rc-4 2.0-rc-5 2.0.1 2.0.2 2.0.3 2.1 2.1-beta-1 2.1-rc1 2.1-rc2 2.1-rc3 2.1-rc4 2.1.1 2.1.2 2.1.3 2.2 2.2.1 2.2.2 All 71 releases
bbpress / includes / topics / functions.php

functions.php in bbPress 2.6.6, at includes/topics/functions.php

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