[ Index ]

PHP Cross Reference of BuddyPress

title

Body

[close]

/src/bp-groups/classes/ -> class-bp-groups-list-table.php (source)

   1  <?php
   2  /**
   3   * BuddyPress Groups admin list table class.
   4   *
   5   * Props to WordPress core for the Comments admin screen, and its contextual
   6   * help text, on which this implementation is heavily based.
   7   *
   8   * @package BuddyPress
   9   * @subpackage Groups
  10   * @since 1.7.0
  11   */
  12  
  13  // Exit if accessed directly.
  14  defined( 'ABSPATH' ) || exit;
  15  
  16  /**
  17   * List table class for the Groups component admin page.
  18   *
  19   * @since 1.7.0
  20   */
  21  class BP_Groups_List_Table extends WP_List_Table {
  22  
  23      /**
  24       * The type of view currently being displayed.
  25       *
  26       * E.g. "All", "Pending", "Approved", "Spam"...
  27       *
  28       * @since 1.7.0
  29       * @var string
  30       */
  31      public $view = 'all';
  32  
  33      /**
  34       * Group counts for each group type.
  35       *
  36       * @since 1.7.0
  37       * @var int
  38       */
  39      public $group_counts = 0;
  40  
  41      /**
  42       * Multidimensional array of group visibility (status) types and their groups.
  43       *
  44       * @link https://buddypress.trac.wordpress.org/ticket/6277
  45       * @var array
  46       */
  47      public $group_type_ids = array();
  48  
  49      /**
  50       * Constructor
  51       *
  52       * @since 1.7.0
  53       */
  54  	public function __construct() {
  55  
  56          // Define singular and plural labels, as well as whether we support AJAX.
  57          parent::__construct( array(
  58              'ajax'     => false,
  59              'plural'   => 'groups',
  60              'singular' => 'group',
  61          ) );
  62  
  63          // Add Group Type column and bulk change controls.
  64          if ( bp_groups_get_group_types() ) {
  65              // Add Group Type column.
  66              add_filter( 'bp_groups_list_table_get_columns',        array( $this, 'add_type_column' )                  );
  67              add_filter( 'bp_groups_admin_get_group_custom_column', array( $this, 'column_content_group_type' ), 10, 3 );
  68              // Add the bulk change select.
  69              add_action( 'bp_groups_list_table_after_bulk_actions', array( $this, 'add_group_type_bulk_change_select' ) );
  70          }
  71      }
  72  
  73      /**
  74       * Set up items for display in the list table.
  75       *
  76       * Handles filtering of data, sorting, pagination, and any other data
  77       * manipulation required prior to rendering.
  78       *
  79       * @since 1.7.0
  80       */
  81  	public function prepare_items() {
  82          global $groups_template;
  83  
  84          $screen = get_current_screen();
  85  
  86          // Option defaults.
  87          $include_id   = false;
  88          $search_terms = false;
  89  
  90          // Set current page.
  91          $page = $this->get_pagenum();
  92  
  93          // Set per page from the screen options.
  94          $per_page = $this->get_items_per_page( str_replace( '-', '_', "{$screen->id}_per_page" ) );
  95  
  96          // Sort order.
  97          $order = 'DESC';
  98          if ( ! empty( $_REQUEST['order'] ) ) {
  99              $order = bp_esc_sql_order( $_REQUEST['order'] );
 100          }
 101  
 102          // Order by - default to newest.
 103          $orderby = 'last_activity';
 104          if ( ! empty( $_REQUEST['orderby'] ) ) {
 105              switch ( $_REQUEST['orderby'] ) {
 106                  case 'name' :
 107                      $orderby = 'name';
 108                      break;
 109                  case 'id' :
 110                      $orderby = 'date_created';
 111                      break;
 112                  case 'members' :
 113                      $orderby = 'total_member_count';
 114                      break;
 115                  case 'last_active' :
 116                      $orderby = 'last_activity';
 117                      break;
 118              }
 119          }
 120  
 121          // Are we doing a search?
 122          if ( ! empty( $_REQUEST['s'] ) ) {
 123              $search_terms = $_REQUEST['s'];
 124  
 125              // Set the view as a search request.
 126              $this->view = 'search';
 127          }
 128  
 129          // Check if user has clicked on a specific group (if so, fetch only that group).
 130          if ( ! empty( $_REQUEST['gid'] ) ) {
 131              $include_id = (int) $_REQUEST['gid'];
 132  
 133              // Set the view as a single activity.
 134              $this->view = 'single';
 135          }
 136  
 137          // Use the status request to set the current view.
 138          if ( isset( $_GET['group_status'] ) && in_array( $_GET['group_status'], array( 'public', 'private', 'hidden' ) ) ) {
 139              $this->view = $_GET['group_status'];
 140          }
 141  
 142          // We'll use the ids of group status types for the 'include' param.
 143          $this->group_type_ids = BP_Groups_Group::get_group_type_ids();
 144  
 145          // Pass a dummy array if there are no groups of this type.
 146          $include = false;
 147          if ( 'all' != $this->view && isset( $this->group_type_ids[ $this->view ] ) ) {
 148              $include = ! empty( $this->group_type_ids[ $this->view ] ) ? $this->group_type_ids[ $this->view ] : array( 0 );
 149          }
 150  
 151          // Get group type counts for display in the filter tabs.
 152          $this->group_counts = array();
 153          foreach ( $this->group_type_ids as $group_type => $group_ids ) {
 154              $this->group_counts[ $group_type ] = count( $group_ids );
 155          }
 156  
 157          // Group types
 158          $group_type = false;
 159          if ( isset( $_GET['bp-group-type'] ) && null !== bp_groups_get_group_type_object( $_GET['bp-group-type'] ) ) {
 160              $group_type = $_GET['bp-group-type'];
 161          }
 162  
 163          // If we're viewing a specific group, flatten all activities into a single array.
 164          if ( $include_id ) {
 165              $groups = array( (array) groups_get_group( $include_id ) );
 166          } else {
 167              $groups_args = array(
 168                  'include'  => $include,
 169                  'per_page' => $per_page,
 170                  'page'     => $page,
 171                  'orderby'  => $orderby,
 172                  'order'    => $order
 173              );
 174  
 175              if ( $group_type ) {
 176                  $groups_args['group_type'] = $group_type;
 177              }
 178  
 179              $groups = array();
 180              if ( bp_has_groups( $groups_args ) ) {
 181                  while ( bp_groups() ) {
 182                      bp_the_group();
 183                      $groups[] = (array) $groups_template->group;
 184                  }
 185              }
 186          }
 187  
 188          // Set raw data to display.
 189          $this->items = $groups;
 190  
 191          // Store information needed for handling table pagination.
 192          $this->set_pagination_args( array(
 193              'per_page'    => $per_page,
 194              'total_items' => $groups_template->total_group_count,
 195              'total_pages' => ceil( $groups_template->total_group_count / $per_page )
 196          ) );
 197  
 198          // Set the Total number of groups.
 199          if ( 'all' === $this->view ) {
 200              $this->group_counts['all'] = (int) $groups_template->total_group_count;
 201  
 202          // Only perform a query if not on the main list view.
 203          } elseif ( 'single' !== $this->view ) {
 204              $count_groups = groups_get_groups(
 205                  array(
 206                      'fields'      => 'ids',
 207                      'show_hidden' => true,
 208                  )
 209              );
 210  
 211              if ( $count_groups['total'] ) {
 212                  $this->group_counts['all'] = (int) $count_groups['total'];
 213              }
 214          }
 215      }
 216  
 217      /**
 218       * Get an array of all the columns on the page.
 219       *
 220       * @since 1.7.0
 221       *
 222       * @return array Array of column headers.
 223       */
 224  	public function get_column_info() {
 225          $this->_column_headers = array(
 226              $this->get_columns(),
 227              array(),
 228              $this->get_sortable_columns(),
 229              $this->get_default_primary_column_name(),
 230          );
 231  
 232          return $this->_column_headers;
 233      }
 234  
 235      /**
 236       * Get name of default primary column
 237       *
 238       * @since 2.3.3
 239       *
 240       * @return string
 241       */
 242  	protected function get_default_primary_column_name() {
 243          // Comment column is mapped to Group's name.
 244          return 'comment';
 245      }
 246  
 247      /**
 248       * Display a message on screen when no items are found ("No groups found").
 249       *
 250       * @since 1.7.0
 251       */
 252  	public function no_items() {
 253          _e( 'No groups found.', 'buddypress' );
 254      }
 255  
 256      /**
 257       * Output the Groups data table.
 258       *
 259       * @since 1.7.0
 260       */
 261  	public function display() {
 262          $this->display_tablenav( 'top' ); ?>
 263  
 264          <h2 class="screen-reader-text"><?php
 265              /* translators: accessibility text */
 266              _e( 'Groups list', 'buddypress' );
 267          ?></h2>
 268  
 269          <table class="wp-list-table <?php echo implode( ' ', $this->get_table_classes() ); ?>" cellspacing="0">
 270              <thead>
 271                  <tr>
 272                      <?php $this->print_column_headers(); ?>
 273                  </tr>
 274              </thead>
 275  
 276              <tbody id="the-comment-list">
 277                  <?php $this->display_rows_or_placeholder(); ?>
 278              </tbody>
 279  
 280              <tfoot>
 281                  <tr>
 282                      <?php $this->print_column_headers( false ); ?>
 283                  </tr>
 284              </tfoot>
 285          </table>
 286          <?php
 287  
 288          $this->display_tablenav( 'bottom' );
 289      }
 290  
 291      /**
 292       * Extra controls to be displayed between bulk actions and pagination
 293       *
 294       * @since 2.7.0
 295       * @access protected
 296       *
 297       * @param string $which
 298       */
 299  	protected function extra_tablenav( $which ) {
 300          /**
 301           * Fires just after the bulk action controls in the WP Admin groups list table.
 302           *
 303           * @since 2.7.0
 304           *
 305           * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
 306           */
 307          do_action( 'bp_groups_list_table_after_bulk_actions', $which );
 308      }
 309  
 310      /**
 311       * Generate content for a single row of the table.
 312       *
 313       * @since 1.7.0
 314       *
 315       * @param object|array $item The current group item in the loop.
 316       */
 317  	public function single_row( $item = array() ) {
 318          static $even = false;
 319  
 320          $row_classes = array();
 321  
 322          if ( $even ) {
 323              $row_classes = array( 'even' );
 324          } else {
 325              $row_classes = array( 'alternate', 'odd' );
 326          }
 327  
 328          /**
 329           * Filters the classes applied to a single row in the groups list table.
 330           *
 331           * @since 1.9.0
 332           *
 333           * @param array  $row_classes Array of classes to apply to the row.
 334           * @param string $value       ID of the current group being displayed.
 335           */
 336          $row_classes = apply_filters( 'bp_groups_admin_row_class', $row_classes, $item['id'] );
 337          $row_class = ' class="' . implode( ' ', $row_classes ) . '"';
 338  
 339          echo '<tr' . $row_class . ' id="group-' . esc_attr( $item['id'] ) . '" data-parent_id="' . esc_attr( $item['id'] ) . '" data-root_id="' . esc_attr( $item['id'] ) . '">';
 340          echo $this->single_row_columns( $item );
 341          echo '</tr>';
 342  
 343          $even = ! $even;
 344      }
 345  
 346      /**
 347       * Get the list of views available on this table (e.g. "all", "public").
 348       *
 349       * @since 1.7.0
 350       */
 351  	public function get_views() {
 352          $url_base = bp_get_admin_url( 'admin.php?page=bp-groups' ); ?>
 353  
 354          <h2 class="screen-reader-text"><?php
 355              /* translators: accessibility text */
 356              _e( 'Filter groups list', 'buddypress' );
 357          ?></h2>
 358  
 359          <ul class="subsubsub">
 360              <li class="all">
 361                  <a href="<?php echo esc_url( $url_base ); ?>" class="<?php if ( 'all' === $this->view ) echo 'current'; ?>">
 362                      <?php printf(
 363                          /* translators: %s is the placeholder for the count html tag `<span class="count"/>` */
 364                          esc_html__( 'All %s', 'buddypress' ),
 365                          sprintf(
 366                              '<span class="count">(%s)</span>',
 367                              number_format_i18n( $this->group_counts['all'] )
 368                          )
 369                      ); ?>
 370                  </a> |
 371              </li>
 372              <li class="public">
 373                  <a href="<?php echo esc_url( add_query_arg( 'group_status', 'public', $url_base ) ); ?>" class="<?php if ( 'public' === $this->view ) echo 'current'; ?>">
 374                      <?php printf(
 375                          /* translators: %s is the placeholder for the count html `<span class="count"/>` */
 376                          _n( 'Public %s', 'Public %s', $this->group_counts['public'], 'buddypress' ),
 377                          sprintf(
 378                              '<span class="count">(%s)</span>',
 379                              number_format_i18n( $this->group_counts['public'] )
 380                          )
 381                      ); ?>
 382                  </a> |
 383              </li>
 384              <li class="private">
 385                  <a href="<?php echo esc_url( add_query_arg( 'group_status', 'private', $url_base ) ); ?>" class="<?php if ( 'private' === $this->view ) echo 'current'; ?>">
 386                      <?php printf(
 387                          /* translators: %s is the placeholder for the count html `<span class="count"/>` */
 388                          _n( 'Private %s', 'Private %s', $this->group_counts['private'], 'buddypress' ),
 389                          sprintf(
 390                              '<span class="count">(%s)</span>',
 391                              number_format_i18n( $this->group_counts['private'] )
 392                          )
 393                      ); ?>
 394                  </a> |
 395              </li>
 396              <li class="hidden">
 397                  <a href="<?php echo esc_url( add_query_arg( 'group_status', 'hidden', $url_base ) ); ?>" class="<?php if ( 'hidden' === $this->view ) echo 'current'; ?>">
 398                      <?php printf(
 399                          /* translators: %s is the placeholder for the count html tag */
 400                          _n( 'Hidden %s', 'Hidden %s', $this->group_counts['hidden'], 'buddypress' ),
 401                          sprintf(
 402                              '<span class="count">(%s)</span>',
 403                              number_format_i18n( $this->group_counts['hidden'] )
 404                          )
 405                      ); ?>
 406                  </a>
 407              </li>
 408  
 409              <?php
 410  
 411              /**
 412               * Fires inside listing of views so plugins can add their own.
 413               *
 414               * @since 1.7.0
 415               *
 416               * @param string $url_base Current URL base for view.
 417               * @param string $view     Current view being displayed.
 418               */
 419              do_action( 'bp_groups_list_table_get_views', $url_base, $this->view ); ?>
 420          </ul>
 421      <?php
 422      }
 423  
 424      /**
 425       * Get bulk actions for single group row.
 426       *
 427       * @since 1.7.0
 428       *
 429       * @return array Key/value pairs for the bulk actions dropdown.
 430       */
 431  	public function get_bulk_actions() {
 432  
 433          /**
 434           * Filters the list of bulk actions to display on a single group row.
 435           *
 436           * @since 1.7.0
 437           *
 438           * @param array $value Array of bulk actions to display.
 439           */
 440          return apply_filters( 'bp_groups_list_table_get_bulk_actions', array(
 441              'delete' => __( 'Delete', 'buddypress' )
 442          ) );
 443      }
 444  
 445      /**
 446       * Get the table column titles.
 447       *
 448       * @since 1.7.0
 449       *
 450       * @see WP_List_Table::single_row_columns()
 451       *
 452       * @return array Array of column titles.
 453       */
 454  	public function get_columns() {
 455  
 456          /**
 457           * Filters the titles for the columns for the groups list table.
 458           *
 459           * @since 2.0.0
 460           *
 461           * @param array $value Array of slugs and titles for the columns.
 462           */
 463          return apply_filters( 'bp_groups_list_table_get_columns', array(
 464              'cb'          => '<input name type="checkbox" />',
 465              'comment'     => _x( 'Name', 'Groups admin Group Name column header',               'buddypress' ),
 466              'description' => _x( 'Description', 'Groups admin Group Description column header', 'buddypress' ),
 467              'status'      => _x( 'Status', 'Groups admin Privacy Status column header',         'buddypress' ),
 468              'members'     => _x( 'Members', 'Groups admin Members column header',               'buddypress' ),
 469              'last_active' => _x( 'Last Active', 'Groups admin Last Active column header',       'buddypress' )
 470          ) );
 471      }
 472  
 473      /**
 474       * Get the column names for sortable columns.
 475       *
 476       * Note: It's not documented in WP, but the second item in the
 477       * nested arrays below is $desc_first. Normally, we would set
 478       * last_active to be desc_first (since you're generally interested in
 479       * the *most* recently active group, not the *least*). But because
 480       * the default sort for the Groups admin screen is DESC by last_active,
 481       * we want the first click on the Last Active column header to switch
 482       * the sort order - ie, to make it ASC. Thus last_active is set to
 483       * $desc_first = false.
 484       *
 485       * @since 1.7.0
 486       *
 487       * @return array Array of sortable column names.
 488       */
 489  	public function get_sortable_columns() {
 490  
 491          /**
 492           * Filters the column names for the sortable columns.
 493           *
 494           * @since 5.0.0
 495           *
 496           * @param array $value Array of keys and their values.
 497           */
 498          return apply_filters( 'bp_groups_list_table_get_sortable_columns', array(
 499              'gid'         => array( 'gid', false ),
 500              'comment'     => array( 'name', false ),
 501              'members'     => array( 'members', false ),
 502              'last_active' => array( 'last_active', false ),
 503          ) );
 504      }
 505  
 506      /**
 507       * Override WP_List_Table::row_actions().
 508       *
 509       * Basically a duplicate of the row_actions() method, but removes the
 510       * unnecessary <button> addition.
 511       *
 512       * @since 2.3.3
 513       * @since 2.3.4 Visibility set to public for compatibility with WP < 4.0.0.
 514       *
 515       * @param array $actions        The list of actions.
 516       * @param bool  $always_visible Whether the actions should be always visible.
 517       * @return string
 518       */
 519  	public function row_actions( $actions, $always_visible = false ) {
 520          $action_count = count( $actions );
 521          $i = 0;
 522  
 523          if ( !$action_count )
 524              return '';
 525  
 526          $out = '<div class="' . ( $always_visible ? 'row-actions visible' : 'row-actions' ) . '">';
 527          foreach ( $actions as $action => $link ) {
 528              ++$i;
 529              ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
 530              $out .= "<span class='$action'>$link$sep</span>";
 531          }
 532          $out .= '</div>';
 533  
 534          return $out;
 535      }
 536  
 537      /**
 538       * Markup for the Checkbox column.
 539       *
 540       * @since 1.7.0
 541       *
 542       * @see WP_List_Table::single_row_columns()
 543       *
 544       * @param array $item A singular item (one full row).
 545       */
 546  	public function column_cb( $item = array() ) {
 547          /* translators: accessibility text */
 548          printf( '<label class="screen-reader-text" for="gid-%1$d">' . __( 'Select group %1$d', 'buddypress' ) . '</label><input type="checkbox" name="gid[]" value="%1$d" id="gid-%1$d" />', $item['id'] );
 549      }
 550  
 551      /**
 552       * Markup for the Group ID column.
 553       *
 554       * @since 1.7.0
 555       *
 556       * @see WP_List_Table::single_row_columns()
 557       *
 558       * @param array $item A singular item (one full row).
 559       */
 560  	public function column_gid( $item = array() ) {
 561          echo '<strong>' . absint( $item['id'] ) . '</strong>';
 562      }
 563  
 564      /**
 565       * Name column, and "quick admin" rollover actions.
 566       *
 567       * Called "comment" in the CSS so we can re-use some WP core CSS.
 568       *
 569       * @since 1.7.0
 570       *
 571       * @see WP_List_Table::single_row_columns()
 572       *
 573       * @param array $item A singular item (one full row).
 574       */
 575  	public function column_comment( $item = array() ) {
 576  
 577          // Preorder items: Edit | Delete | View.
 578          $actions = array(
 579              'edit'   => '',
 580              'delete' => '',
 581              'view'   => '',
 582          );
 583  
 584          // We need the group object for some BP functions.
 585          $item_obj = (object) $item;
 586  
 587          // Build actions URLs.
 588          $base_url   = bp_get_admin_url( 'admin.php?page=bp-groups&amp;gid=' . $item['id'] );
 589          $delete_url = wp_nonce_url( $base_url . "&amp;action=delete", 'bp-groups-delete' );
 590          $edit_url   = $base_url . '&amp;action=edit';
 591          $view_url   = bp_get_group_permalink( $item_obj );
 592  
 593          /**
 594           * Filters the group name for a group's column content.
 595           *
 596           * @since 1.7.0
 597           *
 598           * @param string $value Name of the group being rendered.
 599           * @param array  $item  Array for the current group item.
 600           */
 601          $group_name = apply_filters_ref_array( 'bp_get_group_name', array( $item['name'], $item ) );
 602  
 603          // Rollover actions.
 604          // Edit.
 605          $actions['edit']   = sprintf( '<a href="%s">%s</a>', esc_url( $edit_url   ), __( 'Edit',   'buddypress' ) );
 606  
 607          // Delete.
 608          $actions['delete'] = sprintf( '<a href="%s">%s</a>', esc_url( $delete_url ), __( 'Delete', 'buddypress' ) );
 609  
 610          // Visit.
 611          $actions['view']   = sprintf( '<a href="%s">%s</a>', esc_url( $view_url   ), __( 'View',   'buddypress' ) );
 612  
 613          /**
 614           * Filters the actions that will be shown for the column content.
 615           *
 616           * @since 1.7.0
 617           *
 618           * @param array $value Array of actions to be displayed for the column content.
 619           * @param array $item  The current group item in the loop.
 620           */
 621          $actions = apply_filters( 'bp_groups_admin_comment_row_actions', array_filter( $actions ), $item );
 622  
 623          // Get group name and avatar.
 624          $avatar = '';
 625  
 626          if ( buddypress()->avatar->show_avatars ) {
 627              $avatar  = bp_core_fetch_avatar( array(
 628                  'item_id'    => $item['id'],
 629                  'object'     => 'group',
 630                  'type'       => 'thumb',
 631                  'avatar_dir' => 'group-avatars',
 632                  'alt'        => sprintf( __( 'Group logo of %s', 'buddypress' ), $group_name ),
 633                  'width'      => '32',
 634                  'height'     => '32',
 635                  'title'      => $group_name
 636              ) );
 637          }
 638  
 639          $content = sprintf( '<strong><a href="%s">%s</a></strong>', esc_url( $edit_url ), $group_name );
 640  
 641          echo $avatar . ' ' . $content . ' ' . $this->row_actions( $actions );
 642      }
 643  
 644      /**
 645       * Markup for the Description column.
 646       *
 647       * @since 1.7.0
 648       *
 649       * @param array $item Information about the current row.
 650       */
 651  	public function column_description( $item = array() ) {
 652  
 653          /**
 654           * Filters the markup for the Description column.
 655           *
 656           * @since 1.0.0
 657           *
 658           * @param string $value Markup for the Description column.
 659           * @param array  $item  The current group item in the loop.
 660           */
 661          echo apply_filters_ref_array( 'bp_get_group_description', array( $item['description'], $item ) );
 662      }
 663  
 664      /**
 665       * Markup for the Status column.
 666       *
 667       * @since 1.7.0
 668       *
 669       * @param array $item Information about the current row.
 670       */
 671  	public function column_status( $item = array() ) {
 672          $status      = $item['status'];
 673          $status_desc = '';
 674  
 675          // @todo This should be abstracted out somewhere for the whole
 676          // Groups component.
 677          switch ( $status ) {
 678              case 'public' :
 679                  $status_desc = __( 'Public', 'buddypress' );
 680                  break;
 681              case 'private' :
 682                  $status_desc = __( 'Private', 'buddypress' );
 683                  break;
 684              case 'hidden' :
 685                  $status_desc = __( 'Hidden', 'buddypress' );
 686                  break;
 687          }
 688  
 689          /**
 690           * Filters the markup for the Status column.
 691           *
 692           * @since 1.7.0
 693           *
 694           * @param string $status_desc Markup for the Status column.
 695           * @parma array  $item        The current group item in the loop.
 696           */
 697          echo apply_filters_ref_array( 'bp_groups_admin_get_group_status', array( $status_desc, $item ) );
 698      }
 699  
 700      /**
 701       * Markup for the Number of Members column.
 702       *
 703       * @since 1.7.0
 704       * @since 10.0.0 Updated to use `groups_get_total_member_count`.
 705       *
 706       * @param array $item Information about the current row.
 707       */
 708  	public function column_members( $item = array() ) {
 709          $count = groups_get_total_member_count( absint( $item['id'] ) );
 710  
 711          /**
 712           * Filters the markup for the number of Members column.
 713           *
 714           * @since 1.7.0
 715           *
 716           * @param int   $count Markup for the number of Members column.
 717           * @parma array $item  The current group item in the loop.
 718           */
 719          echo apply_filters_ref_array( 'bp_groups_admin_get_group_member_count', array( (int) $count, $item ) );
 720      }
 721  
 722      /**
 723       * Markup for the Last Active column.
 724       *
 725       * @since 1.7.0
 726       *
 727       * @param array $item Information about the current row.
 728       */
 729  	public function column_last_active( $item = array() ) {
 730          $last_active = groups_get_groupmeta( $item['id'], 'last_activity' );
 731  
 732          /**
 733           * Filters the markup for the Last Active column.
 734           *
 735           * @since 1.7.0
 736           *
 737           * @param string $last_active Markup for the Last Active column.
 738           * @parma array  $item        The current group item in the loop.
 739           */
 740          echo apply_filters_ref_array( 'bp_groups_admin_get_group_last_active', array( $last_active, $item ) );
 741      }
 742  
 743      /**
 744       * Allow plugins to add their custom column.
 745       *
 746       * @since 2.0.0
 747       *
 748       * @param array  $item        Information about the current row.
 749       * @param string $column_name The column name.
 750       * @return string
 751       */
 752  	public function column_default( $item = array(), $column_name = '' ) {
 753  
 754          /**
 755           * Filters a string to allow plugins to add custom column content.
 756           *
 757           * @since 2.0.0
 758           *
 759           * @param string $value       Empty string.
 760           * @param string $column_name Name of the column being rendered.
 761           * @param array  $item        The current group item in the loop.
 762           */
 763          return apply_filters( 'bp_groups_admin_get_group_custom_column', '', $column_name, $item );
 764      }
 765  
 766      // Group Types
 767  
 768      /**
 769       * Add group type column to the WordPress admin groups list table.
 770       *
 771       * @since 2.7.0
 772       *
 773       * @param array $columns Groups table columns.
 774       *
 775       * @return array $columns
 776       */
 777  	public function add_type_column( $columns = array() ) {
 778          $columns['bp_group_type'] = _x( 'Group Type', 'Label for the WP groups table group type column', 'buddypress' );
 779  
 780          return $columns;
 781      }
 782  
 783      /**
 784       * Markup for the Group Type column.
 785       *
 786       * @since 2.7.0
 787       *
 788       * @param string $retval      Empty string.
 789       * @param string $column_name Name of the column being rendered.
 790       * @param array  $item        The current group item in the loop.
 791       * @return string
 792       */
 793  	public function column_content_group_type( $retval = '', $column_name = '', $item = array() ) {
 794          if ( 'bp_group_type' !== $column_name ) {
 795              return $retval;
 796          }
 797  
 798          add_filter( 'bp_get_group_type_directory_permalink', array( $this, 'group_type_permalink_use_admin_filter' ), 10, 2 );
 799          $retval = bp_get_group_type_list( $item['id'], array(
 800              'parent_element' => '',
 801              'label_element'  => '',
 802              'label'          => '',
 803              'show_all'       => true
 804          ) );
 805          remove_filter( 'bp_get_group_type_directory_permalink', array( $this, 'group_type_permalink_use_admin_filter' ), 10 );
 806  
 807          /**
 808           * Filters the markup for the Group Type column.
 809           *
 810           * @since 2.7.0
 811           *
 812           * @param string $retval Markup for the Group Type column.
 813           * @parma array  $item   The current group item in the loop.
 814           */
 815          echo apply_filters_ref_array( 'bp_groups_admin_get_group_type_column', array( $retval, $item ) );
 816      }
 817  
 818      /**
 819       * Filters the group type list permalink in the Group Type column.
 820       *
 821       * Changes the group type permalink to use the admin URL.
 822       *
 823       * @since 2.7.0
 824       *
 825       * @param  string $retval Current group type permalink.
 826       * @param  object $type   Group type object.
 827       * @return string
 828       */
 829  	public function group_type_permalink_use_admin_filter( $retval, $type ) {
 830          return add_query_arg( array( 'bp-group-type' => urlencode( $type->name ) ) );
 831      }
 832  
 833      /**
 834       * Markup for the Group Type bulk change select.
 835       *
 836       * @since 2.7.0
 837       *
 838       * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
 839       */
 840  	public function add_group_type_bulk_change_select( $which ) {
 841          // `$which` is only passed in WordPress 4.6+. Avoid duplicating controls in earlier versions.
 842          static $displayed = false;
 843          if ( version_compare( bp_get_major_wp_version(), '4.6', '<' ) && $displayed ) {
 844              return;
 845          }
 846          $displayed = true;
 847          $id_name = 'bottom' === $which ? 'bp_change_type2' : 'bp_change_type';
 848  
 849          $types = bp_groups_get_group_types( array(), 'objects' );
 850          ?>
 851          <div class="alignleft actions">
 852              <label class="screen-reader-text" for="<?php echo $id_name; ?>"><?php _e( 'Change group type to&hellip;', 'buddypress' ) ?></label>
 853              <select name="<?php echo $id_name; ?>" id="<?php echo $id_name; ?>" style="display:inline-block;float:none;">
 854                  <option value=""><?php _e( 'Change group type to&hellip;', 'buddypress' ) ?></option>
 855  
 856                  <?php foreach( $types as $type ) : ?>
 857  
 858                      <option value="<?php echo esc_attr( $type->name ); ?>"><?php echo esc_html( $type->labels['singular_name'] ); ?></option>
 859  
 860                  <?php endforeach; ?>
 861  
 862                  <option value="remove_group_type"><?php _e( 'No Group Type', 'buddypress' ) ?></option>
 863  
 864              </select>
 865              <?php
 866              wp_nonce_field( 'bp-bulk-groups-change-type-' . bp_loggedin_user_id(), 'bp-bulk-groups-change-type-nonce' );
 867              submit_button( __( 'Change', 'buddypress' ), 'button', 'bp_change_group_type', false );
 868          ?>
 869          </div>
 870          <?php
 871      }
 872  }


Generated: Sun Dec 22 01:00:54 2024 Cross-referenced by PHPXref 0.7.1