# wpforo/2.2.9/admin/listtables/Members.php
wpForo Forum, version 2.2.9. 444 lines.
- Page: https://pluginprobe.com/plugins/wpforo/2.2.9/code/admin/listtables/Members.php
- Raw: https://pluginprobe.com/plugins/wpforo/2.2.9/raw/admin/listtables/Members.php
- Modified: 2023-12-15T20:18:44+00:00
Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/wpforo/2.2.9/code/admin/listtables/Members.php#L10-L20`.
```php
'member', //singular name of the listed records
'plural' => 'members', //plural name of the listed records
'ajax' => false, //does this table support ajax?
'screen' => 'wpForoMembers',
] );
}
/** ************************************************************************
* Recommended. This method is called when the parent class can't find a method
* specifically build for a given column. Generally, it's recommended to include
* one method for each column you want to render, keeping your package class
* neat and organized. For example, if the class needs to process a column
* named 'title', it would first see if a method named $this->column_title()
* exists - if it does, that method will be used. If it doesn't, this one will
* be used. Generally, you should try to use custom column methods as much as
* possible.
*
* Since we have defined a column_title() method later on, this method doesn't
* need to concern itself with any column with a name of 'title'. Instead, it
* needs to handle everything else.
*
* For more detailed insight into how columns are handled, take a look at
* WP_List_Table::single_row_columns()
*
* @param array $item A singular item (one full row's worth of data)
* @param string $column_name The name/slug of the column to be processed
*
* @return string Text or HTML to be placed inside the column
**************************************************************************/
function column_default( $item, $column_name ) {
switch( $column_name ) {
case 'groupid':
$usergroup = WPF()->usergroup->get_usergroup( $item[ $column_name ] );
return ! empty( $usergroup['name'] ) ? esc_html( $usergroup['name'] ) : __( 'default', 'wpforo' );
case 'secondary_groupids':
return implode( ', ', WPF()->usergroup->get_secondary_group_names( $item[ $column_name ] ) );
case 'blog_posts':
return WPF()->member->blog_posts( $item['userid'] );
case 'blog_comments':
return WPF()->member->blog_comments( $item['userid'], $item['user_email'] );
case 'online_time':
return ( $item['online_time'] ) ? wpforo_date_raw( $item['online_time'], 'datetime', false ) : '-';
default:
return $item[ $column_name ];
}
}
/** ************************************************************************
* Recommended. This is a custom column method and is responsible for what
* is rendered in any column with a name/slug of 'title'. Every time the class
* needs to render a column, it first looks for a method named
* column_{$column_title} - if it exists, that method is run. If it doesn't
* exist, column_default() is called instead.
*
* This example also illustrates how to implement rollover actions. Actions
* should be an associative array formatted as 'slug'=>'link html' - and you
* will need to generate the URLs yourself. You could even ensure the links
*
*
* @param array $item A singular item (one full row's worth of data)
*
* @return string Text to be placed inside the column
(movie title only)
**************************************************************************@see WP_List_Table::::single_row_columns()
*/
function column_cb( $item ) {
return sprintf(
'',
/*$1%s*/ 'userids', //Let's simply repurpose the table's singular label ("movie")
/*$2%s*/ $item['userid'], //The value of the checkbox should be the record's id
( intval( $item['userid'] ) === WPF()->current_userid ) ? 'disabled' : ''
);
}
/** ************************************************************************
* REQUIRED! This method dictates the table's columns and titles. This should
* return an array where the key is the column slug (and class) and the value
* is the column's title text. If you need a checkbox for bulk actions, refer
* to the $columns array below.
*
* The 'cb' column is treated differently than the rest. If including a checkbox
* column in your table you must create a column_cb() method. If you don't need
* to bulk actions or checkboxes, simply leave the 'cb' entry out of your array.
*
* @return array An associative array containing column information: 'slugs'=>'Visible Titles'
**************************************************************************@see WP_List_Table::::single_row_columns()
*/
function get_columns() {
$columns = [
'cb' => '', //Render a checkbox instead of text
'userid' => __( 'ID', 'wpforo' ),
'display_name' => __( 'Display Name', 'wpforo' ),
'user_login' => __( 'Login', 'wpforo' ),
'user_email' => __( 'Email', 'wpforo' ),
'groupid' => __( 'Group', 'wpforo' ),
'secondary_groupids' => __( 'Secondary Groups', 'wpforo' ),
'status' => __( 'Status', 'wpforo' ),
'online_time' => __( 'Last Login', 'wpforo' ),
'posts' => __( 'Forum Posts', 'wpforo' ),
'blog_posts' => __( 'Blog Posts', 'wpforo' ),
'blog_comments' => __( 'Blog Comments', 'wpforo' ),
];
return $this->unset_not_permitted_cols( $columns );
}
/** ************************************************************************
* Optional. If you want one or more columns to be sortable (ASC/DESC toggle),
* you will need to register it here. This should return an array where the
* key is the column that needs to be sortable, and the value is db column to
* sort by. Often, the key and value will be the same, but this is not always
* the case (as the value is a column name from the database, not the list table).
*
* This method merely defines which columns should be sortable and makes them
* clickable - it does not handle the actual sorting. You still need to detect
* the ORDERBY and ORDER querystring variables within prepare_items() and sort
* your data accordingly (usually by modifying your query).
*
* @return array An associative array containing all the columns that should be sortable: 'slugs'=>array('data_values',bool)
**************************************************************************/
function get_sortable_columns() {
$columns = [
'userid' => [ 'userid', false ], //true means it's already sorted
'display_name' => [ 'display_name', false ],
'user_login' => [ 'user_login', false ],
'user_email' => [ 'user_email', false ],
'groupid' => [ 'groupid', false ],
'status' => [ 'status', false ],
'online_time' => [ 'online_time', false ],
'posts' => [ 'posts', false ],
];
return $this->unset_not_permitted_cols( $columns );
}
private function unset_not_permitted_cols( $columns ) {
if( ! WPF()->usergroup->can( 'vmu' ) ) {
unset( $columns['user_login'] );
}
if( ! WPF()->usergroup->can( 'vmm' ) ) {
unset( $columns['user_email'] );
}
if( ! WPF()->usergroup->can( 'vmg' ) ) {
unset( $columns['groupid'], $columns['secondary_groupids'] );
}
if( ! WPF()->usergroup->can( 'bm' ) ) {
unset( $columns['status'] );
}
if( ! WPF()->usergroup->can( 'vms' ) ) {
unset( $columns['signature'] );
}
return $columns;
}
/** ************************************************************************
* Optional. If you need to include bulk actions in your list table, this is
* the place to define them. Bulk actions are an associative array in the format
* 'slug'=>'Visible Title'
*
* If this method returns an empty value, no bulk action will be rendered. If
* you specify any bulk actions, the bulk actions box will be rendered with
* the table automatically on display().
*
* Also note that list tables are not automatically wrapped in