[ Index ] |
PHP Cross Reference of BuddyPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * BuddyPress Groups Activity Functions. 4 * 5 * These functions handle the recording, deleting and formatting of activity 6 * for the user and for this specific component. 7 * 8 * @package BuddyPress 9 * @subpackage GroupsActivity 10 * @since 1.5.0 11 */ 12 13 // Exit if accessed directly. 14 defined( 'ABSPATH' ) || exit; 15 16 /** 17 * Register activity actions for the Groups component. 18 * 19 * @since 1.1.0 20 * 21 * @return false|null False on failure. 22 */ 23 function groups_register_activity_actions() { 24 $bp = buddypress(); 25 26 if ( ! bp_is_active( 'activity' ) ) { 27 return false; 28 } 29 30 bp_activity_set_action( 31 $bp->groups->id, 32 'created_group', 33 __( 'Created a group', 'buddypress' ), 34 'bp_groups_format_activity_action_created_group', 35 __( 'New Groups', 'buddypress' ), 36 array( 'activity', 'member', 'member_groups' ) 37 ); 38 39 bp_activity_set_action( 40 $bp->groups->id, 41 'joined_group', 42 __( 'Joined a group', 'buddypress' ), 43 'bp_groups_format_activity_action_joined_group', 44 __( 'Group Memberships', 'buddypress' ), 45 array( 'activity', 'group', 'member', 'member_groups' ) 46 ); 47 48 bp_activity_set_action( 49 $bp->groups->id, 50 'group_details_updated', 51 __( 'Group details edited', 'buddypress' ), 52 'bp_groups_format_activity_action_group_details_updated', 53 __( 'Group Updates', 'buddypress' ), 54 array( 'activity', 'group', 'member', 'member_groups' ) 55 ); 56 57 bp_activity_set_action( 58 $bp->groups->id, 59 'activity_update', 60 __( 'Posted a status update in a Group', 'buddypress' ), 61 'bp_groups_format_activity_action_group_activity_update', 62 __( 'Group Activity Updates', 'buddypress' ), 63 array( 'activity', 'group', 'member', 'member_groups' ) 64 ); 65 66 /** 67 * Fires at end of registration of the default activity actions for the Groups component. 68 * 69 * @since 1.1.0 70 */ 71 do_action( 'groups_register_activity_actions' ); 72 } 73 add_action( 'bp_register_activity_actions', 'groups_register_activity_actions' ); 74 75 /** 76 * Get the group object the activity belongs to. 77 * 78 * @since 5.0.0 79 * 80 * @param integer $group_id The group ID the activity is linked to. 81 * @return BP_Groups_Group The group object the activity belongs to. 82 */ 83 function bp_groups_get_activity_group( $group_id = 0 ) { 84 // If displaying a specific group, check the activity belongs to it. 85 if ( bp_is_group() && bp_get_current_group_id() === (int) $group_id ) { 86 $group = groups_get_current_group(); 87 88 // Otherwise get the group the activity belongs to. 89 } else { 90 $group = groups_get_group( $group_id ); 91 } 92 93 return $group; 94 } 95 96 /** 97 * Format 'created_group' activity actions. 98 * 99 * @since 2.0.0 100 * 101 * @param string $action Static activity action. 102 * @param object $activity Activity data object. 103 * @return string 104 */ 105 function bp_groups_format_activity_action_created_group( $action, $activity ) { 106 $user_link = bp_core_get_userlink( $activity->user_id ); 107 108 $group = bp_groups_get_activity_group( $activity->item_id ); 109 $group_link = '<a href="' . esc_url( bp_get_group_permalink( $group ) ) . '">' . esc_html( $group->name ) . '</a>'; 110 111 /* translators: 1: the user link. 2: the group link. */ 112 $action = sprintf( esc_html__( '%1$s created the group %2$s', 'buddypress'), $user_link, $group_link ); 113 114 /** 115 * Filters the 'created_group' activity actions. 116 * 117 * @since 1.2.0 118 * 119 * @param string $action The 'created_group' activity action. 120 * @param object $activity Activity data object. 121 */ 122 return apply_filters( 'groups_activity_created_group_action', $action, $activity ); 123 } 124 125 /** 126 * Format 'joined_group' activity actions. 127 * 128 * @since 2.0.0 129 * 130 * @param string $action Static activity action. 131 * @param object $activity Activity data object. 132 * @return string 133 */ 134 function bp_groups_format_activity_action_joined_group( $action, $activity ) { 135 $user_link = bp_core_get_userlink( $activity->user_id ); 136 137 $group = bp_groups_get_activity_group( $activity->item_id ); 138 $group_link = '<a href="' . esc_url( bp_get_group_permalink( $group ) ) . '">' . esc_html( $group->name ) . '</a>'; 139 140 /* translators: 1: the user link. 2: the group link. */ 141 $action = sprintf( esc_html__( '%1$s joined the group %2$s', 'buddypress' ), $user_link, $group_link ); 142 143 // Legacy filters (do not follow parameter patterns of other activity 144 // action filters, and requires apply_filters_ref_array()). 145 if ( has_filter( 'groups_activity_membership_accepted_action' ) ) { 146 $action = apply_filters_ref_array( 'groups_activity_membership_accepted_action', array( $action, $user_link, &$group ) ); 147 } 148 149 // Another legacy filter. 150 if ( has_filter( 'groups_activity_accepted_invite_action' ) ) { 151 $action = apply_filters_ref_array( 'groups_activity_accepted_invite_action', array( $action, $activity->user_id, &$group ) ); 152 } 153 154 /** 155 * Filters the 'joined_group' activity actions. 156 * 157 * @since 2.0.0 158 * 159 * @param string $action The 'joined_group' activity actions. 160 * @param object $activity Activity data object. 161 */ 162 return apply_filters( 'bp_groups_format_activity_action_joined_group', $action, $activity ); 163 } 164 165 /** 166 * Format 'group_details_updated' activity actions. 167 * 168 * @since 2.2.0 169 * 170 * @param string $action Static activity action. 171 * @param object $activity Activity data object. 172 * @return string 173 */ 174 function bp_groups_format_activity_action_group_details_updated( $action, $activity ) { 175 $user_link = bp_core_get_userlink( $activity->user_id ); 176 177 $group = bp_groups_get_activity_group( $activity->item_id ); 178 $group_link = '<a href="' . esc_url( bp_get_group_permalink( $group ) ) . '">' . esc_html( $group->name ) . '</a>'; 179 180 /* 181 * Changed group details are stored in groupmeta, keyed by the activity 182 * timestamp. See {@link bp_groups_group_details_updated_add_activity()}. 183 */ 184 $changed = groups_get_groupmeta( $activity->item_id, 'updated_details_' . $activity->date_recorded ); 185 186 // No changed details were found, so use a generic message. 187 if ( empty( $changed ) ) { 188 /* translators: 1: the user link. 2: the group link. */ 189 $action = sprintf( esc_html__( '%1$s updated details for the group %2$s', 'buddypress' ), $user_link, $group_link ); 190 191 // Name and description changed - to keep things short, don't describe changes in detail. 192 } elseif ( isset( $changed['name'] ) && isset( $changed['description'] ) ) { 193 /* translators: 1: the user link. 2: the group link. */ 194 $action = sprintf( esc_html__( '%1$s changed the name and description of the group %2$s', 'buddypress' ), $user_link, $group_link ); 195 196 // Name only. 197 } elseif ( ! empty( $changed['name']['old'] ) && ! empty( $changed['name']['new'] ) ) { 198 /* translators: 1: the user link. 2: the group link. 3: the old group name. 4: the new group name. */ 199 $action = sprintf( esc_html__( '%1$s changed the name of the group %2$s from "%3$s" to "%4$s"', 'buddypress' ), $user_link, $group_link, esc_html( $changed['name']['old'] ), esc_html( $changed['name']['new'] ) ); 200 201 // Description only. 202 } elseif ( ! empty( $changed['description']['old'] ) && ! empty( $changed['description']['new'] ) ) { 203 /* translators: 1: the user link. 2: the group link. 3: the old group description. 4: the new group description. */ 204 $action = sprintf( esc_html__( '%1$s changed the description of the group %2$s from "%3$s" to "%4$s"', 'buddypress' ), $user_link, $group_link, esc_html( $changed['description']['old'] ), esc_html( $changed['description']['new'] ) ); 205 206 } elseif ( ! empty( $changed['slug']['old'] ) && ! empty( $changed['slug']['new'] ) ) { 207 /* translators: 1: the user link. 2: the group link. */ 208 $action = sprintf( esc_html__( '%1$s changed the permalink of the group %2$s.', 'buddypress' ), $user_link, $group_link ); 209 } 210 211 /** 212 * Filters the 'group_details_updated' activity actions. 213 * 214 * @since 2.0.0 215 * 216 * @param string $action The 'group_details_updated' activity actions. 217 * @param object $activity Activity data object. 218 */ 219 return apply_filters( 'bp_groups_format_activity_action_joined_group', $action, $activity ); 220 } 221 222 /** 223 * Format the action for activity updates posted in a Group. 224 * 225 * @since 5.0.0 226 * 227 * @param string $action Static activity action. 228 * @param object $activity Activity data object. 229 * @return string The formatted action for activity updates posted in a Group. 230 */ 231 function bp_groups_format_activity_action_group_activity_update( $action, $activity ) { 232 $user_link = bp_core_get_userlink( $activity->user_id ); 233 $group = bp_groups_get_activity_group( $activity->item_id ); 234 235 $group_link = '<a href="' . esc_url( bp_get_group_permalink( $group ) ) . '">' . esc_html( $group->name ) . '</a>'; 236 237 // Set the Activity update posted in a Group action. 238 $action = sprintf( 239 /* translators: 1: the user link. 2: the group link. */ 240 esc_html__( '%1$s posted an update in the group %2$s', 'buddypress' ), 241 $user_link, 242 $group_link 243 ); 244 245 /** This filter is documented in wp-includes/deprecated.php */ 246 $action = apply_filters_deprecated( 'groups_activity_new_update_action', array( $action ), '5.0.0', 'bp_groups_format_activity_action_group_activity_update' ); 247 248 /** 249 * Filters the Group's activity update action. 250 * 251 * @since 5.0.0 252 * 253 * @param string $action The Group's activity update action. 254 * @param object $activity Activity data object. 255 */ 256 return apply_filters( 'bp_groups_format_activity_action_group_activity_update', $action, $activity ); 257 } 258 259 /** 260 * Fetch data related to groups at the beginning of an activity loop. 261 * 262 * This reduces database overhead during the activity loop. 263 * 264 * @since 2.0.0 265 * 266 * @param array $activities Array of activity items. 267 * @return array 268 */ 269 function bp_groups_prefetch_activity_object_data( $activities ) { 270 $group_ids = array(); 271 272 if ( empty( $activities ) ) { 273 return $activities; 274 } 275 276 foreach ( $activities as $activity ) { 277 if ( buddypress()->groups->id !== $activity->component ) { 278 continue; 279 } 280 281 $group_ids[] = $activity->item_id; 282 } 283 284 if ( ! empty( $group_ids ) ) { 285 286 // TEMPORARY - Once the 'populate_extras' issue is solved 287 // in the groups component, we can do this with groups_get_groups() 288 // rather than manually. 289 $uncached_ids = array(); 290 foreach ( $group_ids as $group_id ) { 291 if ( false === wp_cache_get( $group_id, 'bp_groups' ) ) { 292 $uncached_ids[] = $group_id; 293 } 294 } 295 296 if ( ! empty( $uncached_ids ) ) { 297 global $wpdb; 298 $bp = buddypress(); 299 $uncached_ids_sql = implode( ',', wp_parse_id_list( $uncached_ids ) ); 300 $groups = $wpdb->get_results( "SELECT * FROM {$bp->groups->table_name} WHERE id IN ({$uncached_ids_sql})" ); 301 foreach ( $groups as $group ) { 302 wp_cache_set( $group->id, $group, 'bp_groups' ); 303 } 304 } 305 } 306 307 return $activities; 308 } 309 add_filter( 'bp_activity_prefetch_object_data', 'bp_groups_prefetch_activity_object_data' ); 310 311 /** 312 * Set up activity arguments for use with the 'groups' scope. 313 * 314 * @since 2.2.0 315 * 316 * @param array $retval Empty array by default. 317 * @param array $filter Current activity arguments. 318 * @return array 319 */ 320 function bp_groups_filter_activity_scope( $retval = array(), $filter = array() ) { 321 322 // Determine the user_id. 323 if ( ! empty( $filter['user_id'] ) ) { 324 $user_id = $filter['user_id']; 325 } else { 326 $user_id = bp_displayed_user_id() 327 ? bp_displayed_user_id() 328 : bp_loggedin_user_id(); 329 } 330 331 // Determine groups of user. 332 $groups = groups_get_user_groups( $user_id ); 333 if ( empty( $groups['groups'] ) ) { 334 $groups = array( 'groups' => 0 ); 335 } 336 337 // Should we show all items regardless of sitewide visibility? 338 $show_hidden = array(); 339 if ( ! empty( $user_id ) && ( $user_id !== bp_loggedin_user_id() ) ) { 340 $show_hidden = array( 341 'column' => 'hide_sitewide', 342 'value' => 0 343 ); 344 } 345 346 $retval = array( 347 'relation' => 'AND', 348 array( 349 'relation' => 'AND', 350 array( 351 'column' => 'component', 352 'value' => buddypress()->groups->id 353 ), 354 array( 355 'column' => 'item_id', 356 'compare' => 'IN', 357 'value' => (array) $groups['groups'] 358 ), 359 ), 360 $show_hidden, 361 362 // Overrides. 363 'override' => array( 364 'filter' => array( 'user_id' => 0 ), 365 'show_hidden' => true 366 ), 367 ); 368 369 return $retval; 370 } 371 add_filter( 'bp_activity_set_groups_scope_args', 'bp_groups_filter_activity_scope', 10, 2 ); 372 373 /** 374 * Enforces group membership restrictions on activity favorite queries. 375 * 376 * @since 4.3.0 377 378 * @param array $retval Query arguments. 379 * @param array $filter 380 * @return array 381 */ 382 function bp_groups_filter_activity_favorites_scope( $retval, $filter ) { 383 // Only process for viewers looking at their own favorites feed. 384 if ( ! empty( $filter['user_id'] ) ) { 385 $user_id = (int) $filter['user_id']; 386 } else { 387 $user_id = bp_displayed_user_id() ? bp_displayed_user_id() : bp_loggedin_user_id(); 388 } 389 390 if ( ! $user_id || ! is_user_logged_in() || $user_id !== bp_loggedin_user_id() ) { 391 return $retval; 392 } 393 394 $favs = bp_activity_get_user_favorites( $user_id ); 395 if ( empty( $favs ) ) { 396 return $retval; 397 } 398 399 $user_groups = bp_get_user_groups( 400 $user_id, 401 array( 402 'is_admin' => null, 403 'is_mod' => null, 404 ) 405 ); 406 407 $retval = array( 408 'relation' => 'OR', 409 410 // Allow hidden items for items unconnected to groups. 411 'non_groups' => array( 412 'relation' => 'AND', 413 array( 414 'column' => 'component', 415 'compare' => '!=', 416 'value' => buddypress()->groups->id, 417 ), 418 array( 419 'column' => 'hide_sitewide', 420 'compare' => 'IN', 421 'value' => array( 1, 0 ), 422 ), 423 array( 424 'column' => 'id', 425 'compare' => 'IN', 426 'value' => $favs, 427 ), 428 ), 429 430 // Trust the favorites list for group items that are not hidden sitewide. 431 'non_hidden_groups' => array( 432 'relation' => 'AND', 433 array( 434 'column' => 'component', 435 'compare' => '=', 436 'value' => buddypress()->groups->id, 437 ), 438 array( 439 'column' => 'hide_sitewide', 440 'compare' => '=', 441 'value' => 0, 442 ), 443 array( 444 'column' => 'id', 445 'compare' => 'IN', 446 'value' => $favs, 447 ), 448 ), 449 450 // For hidden group items, limit to those in the user's groups. 451 'hidden_groups' => array( 452 'relation' => 'AND', 453 array( 454 'column' => 'component', 455 'compare' => '=', 456 'value' => buddypress()->groups->id, 457 ), 458 array( 459 'column' => 'hide_sitewide', 460 'compare' => '=', 461 'value' => 1, 462 ), 463 array( 464 'column' => 'id', 465 'compare' => 'IN', 466 'value' => $favs, 467 ), 468 array( 469 'column' => 'item_id', 470 'compare' => 'IN', 471 'value' => wp_list_pluck( $user_groups, 'group_id' ), 472 ), 473 ), 474 475 'override' => array( 476 'display_comments' => true, 477 'filter' => array( 'user_id' => 0 ), 478 'show_hidden' => true, 479 ), 480 ); 481 482 return $retval; 483 } 484 add_filter( 'bp_activity_set_favorites_scope_args', 'bp_groups_filter_activity_favorites_scope', 20, 2 ); 485 486 /** 487 * Record an activity item related to the Groups component. 488 * 489 * A wrapper for {@link bp_activity_add()} that provides some Groups-specific 490 * defaults. 491 * 492 * @since 1.0.0 493 * 494 * @see bp_activity_add() for more detailed description of parameters and 495 * return values. 496 * 497 * @param array|string $args { 498 * An array of arguments for the new activity item. Accepts all parameters 499 * of {@link bp_activity_add()}. However, this wrapper provides some 500 * additional defaults, as described below: 501 * @type string $component Default: the id of your Groups component 502 * (usually 'groups'). 503 * @type bool $hide_sitewide Default: True if the current group is not 504 * public, otherwise false. 505 * } 506 * @return WP_Error|bool|int See {@link bp_activity_add()}. 507 */ 508 function groups_record_activity( $args = '' ) { 509 510 if ( ! bp_is_active( 'activity' ) ) { 511 return false; 512 } 513 514 // Set the default for hide_sitewide by checking the status of the group. 515 $hide_sitewide = false; 516 if ( ! empty( $args['item_id'] ) ) { 517 $group = bp_groups_get_activity_group( $args['item_id'] ); 518 519 if ( isset( $group->status ) && 'public' != $group->status ) { 520 $hide_sitewide = true; 521 } 522 } 523 524 $r = bp_parse_args( $args, array( 525 'id' => false, 526 'user_id' => bp_loggedin_user_id(), 527 'action' => '', 528 'content' => '', 529 'primary_link' => '', 530 'component' => buddypress()->groups->id, 531 'type' => false, 532 'item_id' => false, 533 'secondary_item_id' => false, 534 'recorded_time' => bp_core_current_time(), 535 'hide_sitewide' => $hide_sitewide, 536 'error_type' => 'bool' 537 ), 'groups_record_activity' ); 538 539 return bp_activity_add( $r ); 540 } 541 542 /** 543 * Post an Activity status update affiliated with a group. 544 * 545 * @since 1.2.0 546 * @since 2.6.0 Added 'error_type' parameter to $args. 547 * 548 * @param array|string $args { 549 * Array of arguments. 550 * @type string $content The content of the update. 551 * @type int $user_id Optional. ID of the user posting the update. Default: 552 * ID of the logged-in user. 553 * @type int $group_id Optional. ID of the group to be affiliated with the 554 * update. Default: ID of the current group. 555 * } 556 * @return WP_Error|bool|int Returns the ID of the new activity item on success, or false on failure. 557 */ 558 function groups_post_update( $args = '' ) { 559 $bp = buddypress(); 560 561 $r = bp_parse_args( $args, array( 562 'content' => false, 563 'user_id' => bp_loggedin_user_id(), 564 'group_id' => 0, 565 'error_type' => 'bool' 566 ), 'groups_post_update' ); 567 568 $group_id = (int) $r['group_id']; 569 if ( ! $group_id && ! empty( $bp->groups->current_group->id ) ) { 570 $group_id = (int) $bp->groups->current_group->id; 571 } 572 573 $content = $r['content']; 574 $user_id = (int) $r['user_id']; 575 if ( ! $content || ! strlen( trim( $content ) ) || ! $user_id || ! $group_id ) { 576 return false; 577 } 578 579 $bp->groups->current_group = groups_get_group( $group_id ); 580 581 // Be sure the user is a member of the group before posting. 582 if ( ! bp_current_user_can( 'bp_moderate' ) && ! groups_is_user_member( $user_id, $group_id ) ) { 583 return false; 584 } 585 586 /** 587 * Filters the content for the new group activity update. 588 * 589 * @since 1.2.0 590 * 591 * @param string $content The content of the update. 592 */ 593 $content_filtered = apply_filters( 'groups_activity_new_update_content', $content ); 594 595 $activity_id = groups_record_activity( array( 596 'user_id' => $user_id, 597 'content' => $content_filtered, 598 'type' => 'activity_update', 599 'item_id' => $group_id, 600 'error_type' => $r['error_type'], 601 ) ); 602 603 groups_update_groupmeta( $group_id, 'last_activity', bp_core_current_time() ); 604 605 /** 606 * Fires after posting of an Activity status update affiliated with a group. 607 * 608 * @since 1.2.0 609 * 610 * @param string $content The content of the update. 611 * @param int $user_id ID of the user posting the update. 612 * @param int $group_id ID of the group being posted to. 613 * @param bool $activity_id Whether or not the activity recording succeeded. 614 */ 615 do_action( 'bp_groups_posted_update', $content, $user_id, $group_id, $activity_id ); 616 617 return $activity_id; 618 } 619 620 /** 621 * Function used to determine if a user can delete a group activity item. 622 * 623 * Used as a filter callback to 'bp_activity_user_can_delete'. 624 * 625 * @since 6.0.0 626 * 627 * @param bool $retval True if item can receive comments. 628 * @param object $activity Activity item being checked. 629 * @return bool 630 */ 631 function bp_groups_filter_activity_user_can_delete( $retval, $activity ) { 632 // Bail if no current user. 633 if ( ! is_user_logged_in() ) { 634 return $retval; 635 } 636 637 if ( isset( $activity->component ) || 'groups' !== $activity->component ) { 638 return $retval; 639 } 640 641 // Trust the passed value for administrators. 642 if ( bp_current_user_can( 'bp_moderate' ) ) { 643 return $retval; 644 } 645 646 // Group administrators or moderators can delete content in that group that doesn't belong to them. 647 $group_id = $activity->item_id; 648 if ( groups_is_user_admin( bp_loggedin_user_id(), $group_id ) || groups_is_user_mod( bp_loggedin_user_id(), $group_id ) ) { 649 $retval = true; 650 } 651 652 return $retval; 653 } 654 add_filter( 'bp_activity_user_can_delete', 'bp_groups_filter_activity_user_can_delete', 10, 2 ); 655 656 /** 657 * Function used to determine if a user can comment on a group activity item. 658 * 659 * Used as a filter callback to 'bp_activity_can_comment'. 660 * 661 * @since 3.0.0 662 * 663 * @param bool $retval True if item can receive comments. 664 * @param null|BP_Activity_Activity $activity Null by default. Pass an activity object to check against that instead. 665 * @return bool 666 */ 667 function bp_groups_filter_activity_can_comment( $retval, $activity = null ) { 668 // Bail if item cannot receive comments or if no current user. 669 if ( empty( $retval ) || ! is_user_logged_in() ) { 670 return $retval; 671 } 672 673 // Use passed activity object, if available. 674 if ( is_a( $activity, 'BP_Activity_Activity' ) ) { 675 $component = $activity->component; 676 $group_id = $activity->item_id; 677 678 // Use activity info from current activity item in the loop. 679 } else { 680 $component = bp_get_activity_object_name(); 681 $group_id = bp_get_activity_item_id(); 682 } 683 684 // If not a group activity item, bail. 685 if ( 'groups' !== $component ) { 686 return $retval; 687 } 688 689 // If current user is not a group member or is banned, user cannot comment. 690 if ( ! bp_current_user_can( 'bp_moderate' ) && 691 ( ! groups_is_user_member( bp_loggedin_user_id(), $group_id ) || groups_is_user_banned( bp_loggedin_user_id(), $group_id ) ) 692 ) { 693 $retval = false; 694 } 695 696 return $retval; 697 } 698 add_filter( 'bp_activity_can_comment', 'bp_groups_filter_activity_can_comment', 99, 1 ); 699 700 /** 701 * Function used to determine if a user can reply on a group activity comment. 702 * 703 * Used as a filter callback to 'bp_activity_can_comment_reply'. 704 * 705 * @since 3.0.0 706 * 707 * @param bool $retval True if activity comment can be replied to. 708 * @param object|bool $comment Current activity comment object. If empty, parameter is boolean false. 709 * @return bool 710 */ 711 function bp_groups_filter_activity_can_comment_reply( $retval, $comment ) { 712 // Bail if no current user, if comment is empty or if retval is already empty. 713 if ( ! is_user_logged_in() || empty( $comment ) || empty( $retval ) ) { 714 return $retval; 715 } 716 717 // Grab parent activity item. 718 $parent = new BP_Activity_Activity( $comment->item_id ); 719 720 // Check to see if user can reply to parent group activity item. 721 return bp_groups_filter_activity_can_comment( $retval, $parent ); 722 } 723 add_filter( 'bp_activity_can_comment_reply', 'bp_groups_filter_activity_can_comment_reply', 99, 2 ); 724 725 /** 726 * Add an activity stream item when a member joins a group. 727 * 728 * @since 1.9.0 729 * 730 * @param int $user_id ID of the user joining the group. 731 * @param int $group_id ID of the group. 732 * @return false|null False on failure. 733 */ 734 function bp_groups_membership_accepted_add_activity( $user_id, $group_id ) { 735 736 // Bail if Activity is not active. 737 if ( ! bp_is_active( 'activity' ) ) { 738 return false; 739 } 740 741 // Get the group so we can get it's name. 742 $group = groups_get_group( $group_id ); 743 744 /** 745 * Filters the 'membership_accepted' activity actions. 746 * 747 * @since 1.2.0 748 * 749 * @param string $value The 'membership_accepted' activity action. 750 * @param int $user_id ID of the user joining the group. 751 * @param int $group_id ID of the group. Passed by reference. 752 */ 753 $action = apply_filters_ref_array( 'groups_activity_membership_accepted_action', array( sprintf( __( '%1$s joined the group %2$s', 'buddypress' ), bp_core_get_userlink( $user_id ), '<a href="' . bp_get_group_permalink( $group ) . '">' . esc_attr( $group->name ) . '</a>' ), $user_id, &$group ) ); 754 755 // Record in activity streams. 756 groups_record_activity( array( 757 'action' => $action, 758 'type' => 'joined_group', 759 'item_id' => $group_id, 760 'user_id' => $user_id 761 ) ); 762 } 763 add_action( 'groups_membership_accepted', 'bp_groups_membership_accepted_add_activity', 10, 2 ); 764 765 /** 766 * Add an activity item when a group's details are updated. 767 * 768 * @since 2.2.0 769 * 770 * @param int $group_id ID of the group. 771 * @param BP_Groups_Group $old_group Group object before the details had been changed. 772 * @param bool $notify_members True if the admin has opted to notify group members, otherwise false. 773 * @return null|WP_Error|bool|int The ID of the activity on success. False on error. 774 */ 775 function bp_groups_group_details_updated_add_activity( $group_id, $old_group, $notify_members ) { 776 777 // Bail if Activity is not active. 778 if ( ! bp_is_active( 'activity' ) ) { 779 return false; 780 } 781 782 if ( ! isset( $old_group->name ) || ! isset( $old_group->slug ) || ! isset( $old_group->description ) ) { 783 return false; 784 } 785 786 // If the admin has opted not to notify members, don't post an activity item either. 787 if ( empty( $notify_members ) ) { 788 return; 789 } 790 791 $group = groups_get_group( array( 792 'group_id' => $group_id, 793 ) ); 794 795 /* 796 * Store the changed data, which will be used to generate the activity 797 * action. Since we haven't yet created the activity item, we store the 798 * old group data in groupmeta, keyed by the timestamp that we'll put 799 * on the activity item. 800 */ 801 $changed = array(); 802 803 if ( $group->name !== $old_group->name ) { 804 $changed['name'] = array( 805 'old' => $old_group->name, 806 'new' => $group->name, 807 ); 808 } 809 810 if ( $group->slug !== $old_group->slug ) { 811 $changed['slug'] = array( 812 'old' => $old_group->slug, 813 'new' => $group->slug, 814 ); 815 } 816 817 if ( $group->description !== $old_group->description ) { 818 $changed['description'] = array( 819 'old' => $old_group->description, 820 'new' => $group->description, 821 ); 822 } 823 824 // If there are no changes, don't post an activity item. 825 if ( empty( $changed ) ) { 826 return; 827 } 828 829 $time = bp_core_current_time(); 830 groups_update_groupmeta( $group_id, 'updated_details_' . $time, $changed ); 831 832 // Record in activity streams. 833 return groups_record_activity( array( 834 'type' => 'group_details_updated', 835 'item_id' => $group_id, 836 'user_id' => bp_loggedin_user_id(), 837 'recorded_time' => $time, 838 839 ) ); 840 841 } 842 add_action( 'groups_details_updated', 'bp_groups_group_details_updated_add_activity', 10, 3 ); 843 844 /** 845 * Delete all activity items related to a specific group. 846 * 847 * @since 1.9.0 848 * 849 * @param int $group_id ID of the group. 850 */ 851 function bp_groups_delete_group_delete_all_activity( $group_id ) { 852 if ( bp_is_active( 'activity' ) ) { 853 bp_activity_delete_by_item_id( array( 854 'item_id' => $group_id, 855 'component' => buddypress()->groups->id 856 ) ); 857 } 858 } 859 add_action( 'groups_delete_group', 'bp_groups_delete_group_delete_all_activity', 10 ); 860 861 /** 862 * Delete group member activity if they leave or are removed within 5 minutes of membership modification. 863 * 864 * If the user joined this group less than five minutes ago, remove the 865 * joined_group activity so users cannot flood the activity stream by 866 * joining/leaving the group in quick succession. 867 * 868 * @since 1.9.0 869 * 870 * @param int $group_id ID of the group. 871 * @param int $user_id ID of the user leaving the group. 872 */ 873 function bp_groups_leave_group_delete_recent_activity( $group_id, $user_id ) { 874 875 // Bail if Activity component is not active. 876 if ( ! bp_is_active( 'activity' ) ) { 877 return; 878 } 879 880 // Get the member's group membership information. 881 $membership = new BP_Groups_Member( $user_id, $group_id ); 882 883 // Check the time period, and maybe delete their recent group activity. 884 if ( time() <= strtotime( '+5 minutes', (int) strtotime( $membership->date_modified ) ) ) { 885 bp_activity_delete( array( 886 'component' => buddypress()->groups->id, 887 'type' => 'joined_group', 888 'user_id' => $user_id, 889 'item_id' => $group_id 890 ) ); 891 } 892 } 893 add_action( 'groups_leave_group', 'bp_groups_leave_group_delete_recent_activity', 10, 2 ); 894 add_action( 'groups_remove_member', 'bp_groups_leave_group_delete_recent_activity', 10, 2 ); 895 add_action( 'groups_ban_member', 'bp_groups_leave_group_delete_recent_activity', 10, 2 );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
Generated: Mon Mar 8 01:01:35 2021 | Cross-referenced by PHPXref 0.7.1 |