bbpress / includes / admin / users.php

users.php in bbPress 2.2.2, at includes/admin/users.php

255 lines 6.8 KB

Raw Download Zip

1	<?php
2
3	/**
4	* bbPress Users Admin Class
5	*
6	* @package bbPress
7	* @subpackage Administration
8	*/
9
10	// Exit if accessed directly
11	if ( !defined( 'ABSPATH' ) ) exit;
12
13	if ( !class_exists( 'BBP_Users_Admin' ) ) :
14	/**
15	* Loads bbPress users admin area
16	*
17	* @package bbPress
18	* @subpackage Administration
19	* @since bbPress (r2464)
20	*/
21	class BBP_Users_Admin {
22
23	/**
24	* The bbPress users admin loader
25	*
26	* @since bbPress (r2515)
27	*
28	* @uses BBP_Users_Admin::setup_globals() Setup the globals needed
29	* @uses BBP_Users_Admin::setup_actions() Setup the hooks and actions
30	*/
31	public function __construct() {
32	$this->setup_actions();
33	}
34
35	/**
36	* Setup the admin hooks, actions and filters
37	*
38	* @since bbPress (r2646)
39	* @access private
40	*
41	* @uses add_action() To add various actions
42	*/
43	function setup_actions() {
44
45	// Bail if in network admin
46	if ( is_network_admin() )
47	return;
48
49	// User profile edit/display actions
50	add_action( 'edit_user_profile', array( $this, 'secondary_role_display' ) );
51
52	// WordPress user screen
53	add_action( 'restrict_manage_users', array( $this, 'user_role_bulk_dropdown' ) );
54	add_filter( 'manage_users_columns', array( $this, 'user_role_column' ) );
55	add_filter( 'manage_users_custom_column', array( $this, 'user_role_row' ), 10, 3 );
56
57	// Process bulk role change
58	add_action( 'load-users.php', array( $this, 'user_role_bulk_change' ) );
59	}
60
61	/**
62	* Default interface for setting a forum role
63	*
64	* @since bbPress (r4285)
65	*
66	* @param WP_User $profileuser User data
67	* @return bool Always false
68	*/
69	public static function secondary_role_display( $profileuser ) {
70
71	// Bail if current user cannot edit users
72	if ( ! current_user_can( 'edit_user', $profileuser->ID ) )
73	return;
74
75	// Get the roles
76	$dynamic_roles = bbp_get_dynamic_roles();
77
78	// Only keymasters can set other keymasters
79	if ( ! current_user_can( 'keep_gate' ) )
80	unset( $dynamic_roles[ bbp_get_keymaster_role() ] ); ?>
81
82	<h3><?php _e( 'Forums', 'bbpress' ); ?></h3>
83
84	<table class="form-table">
85	<tbody>
86	<tr>
87	<th><label for="bbp-forums-role"><?php _e( 'Forum Role', 'bbpress' ); ?></label></th>
88	<td>
89
90	<?php $user_role = bbp_get_user_role( $profileuser->ID ); ?>
91
92	<select name="bbp-forums-role" id="bbp-forums-role">
93
94	<?php if ( ! empty( $user_role ) ) : ?>
95
96	<option value=""><?php _e( '— No role for this forum —', 'bbpress' ); ?></option>
97
98	<?php else : ?>
99
100	<option value="" selected="selected"><?php _e( '— No role for this forum —', 'bbpress' ); ?></option>
101
102	<?php endif; ?>
103
104	<?php foreach ( $dynamic_roles as $role => $details ) : ?>
105
106	<option <?php selected( $user_role, $role ); ?> value="<?php echo esc_attr( $role ); ?>"><?php echo translate_user_role( $details['name'] ); ?></option>
107
108	<?php endforeach; ?>
109
110	</select>
111	</td>
112	</tr>
113
114	</tbody>
115	</table>
116
117	<?php
118	}
119
120	/**
121	* Add bulk forums role dropdown to the WordPress users table
122	*
123	* @since bbPress (r4360)
124	*/
125	public static function user_role_bulk_dropdown() {
126
127	// Bail if current user cannot promote users
128	if ( !current_user_can( 'promote_users' ) )
129	return;
130
131	// Get the roles
132	$dynamic_roles = bbp_get_dynamic_roles();
133
134	// Only keymasters can set other keymasters
135	if ( ! current_user_can( 'keep_gate' ) )
136	unset( $dynamic_roles[ bbp_get_keymaster_role() ] ); ?>
137
138	<label class="screen-reader-text" for="bbp-new-role"><?php _e( 'Change forum role to…', 'bbpress' ) ?></label>
139	<select name="bbp-new-role" id="bbp-new-role" style="display:inline-block; float:none;">
140	<option value=''><?php _e( 'Change forum role to…', 'bbpress' ) ?></option>
141	<?php foreach ( $dynamic_roles as $role => $details ) : ?>
142
143	<option value="<?php echo esc_attr( $role ); ?>"><?php echo translate_user_role( $details['name'] ); ?></option>
144
145	<?php endforeach; ?>
146	</select>
147
148	<?php submit_button( __( 'Change', 'bbpress' ), 'secondary', 'bbp-change-role', false );
149	}
150
151	/**
152	* Process bulk dropdown form submission from the WordPress Users
153	* Table
154	*
155	* @uses current_user_can() to check for 'promote users' capability
156	* @uses bbp_get_dynamic_roles() to get forum roles
157	* @uses bbp_get_user_role() to get a user's current forums role
158	* @uses bbp_set_user_role() to set the user's new forums role
159	* @return bool Always false
160	*/
161	public function user_role_bulk_change() {
162
163	// Bail if current user cannot promote users
164	if ( !current_user_can( 'promote_users' ) )
165	return;
166
167	// Bail if no users specified
168	if ( empty( $_REQUEST['users'] ) )
169	return;
170
171	// Bail if this isn't a bbPress action
172	if ( empty( $_REQUEST['bbp-new-role'] ) \|\| empty( $_REQUEST['bbp-change-role'] ) )
173	return;
174
175	// Check that the new role exists
176	$dynamic_roles = bbp_get_dynamic_roles();
177	if ( empty( $dynamic_roles[ $_REQUEST['bbp-new-role'] ] ) )
178	return;
179
180	// Get the current user ID
181	$current_user_id = (int) bbp_get_current_user_id();
182
183	// Run through user ids
184	foreach ( (array) $_REQUEST['users'] as $user_id ) {
185	$user_id = (int) $user_id;
186
187	// Don't let a user change their own role
188	if ( $user_id == $current_user_id )
189	continue;
190
191	// Set up user and role data
192	$user_role = bbp_get_user_role( $user_id );
193	$new_role = sanitize_text_field( $_REQUEST['bbp-new-role'] );
194
195	// Only keymasters can set other keymasters
196	if ( in_array( bbp_get_keymaster_role(), array( $user_role, $new_role ) ) && ! current_user_can( 'keep_gate' ) )
197	continue;
198
199	// Set the new forums role
200	if ( $new_role != $user_role ) {
201	bbp_set_user_role( $user_id, $new_role );
202	}
203	}
204	}
205
206	/**
207	* Add Forum Role column to the WordPress Users table, and change the
208	* core role title to "Site Role"
209	*
210	* @since bbPress (r4337)
211	*
212	* @param array $columns Users table columns
213	* @return array $columns
214	*/
215	public static function user_role_column( $columns = array() ) {
216	$columns['role'] = __( 'Site Role', 'bbpress' );
217	$columns['bbp_user_role'] = __( 'Forum Role', 'bbpress' );
218
219	return $columns;
220	}
221
222	/**
223	* Return user's forums role for display in the WordPress Users list table
224	*
225	* @since bbPress (r4337)
226	*
227	* @param string $retval
228	* @param string $column_name
229	* @param int $user_id
230	*
231	* @return string Displayable bbPress user role
232	*/
233	public static function user_role_row( $retval = '', $column_name = '', $user_id = 0 ) {
234
235	// Only looking for bbPress's user role column
236	if ( 'bbp_user_role' == $column_name ) {
237
238	// Get the users role
239	$user_role = bbp_get_user_role( $user_id );
240	$retval = false;
241
242	// Translate user role for display
243	if ( ! empty( $user_role ) ) {
244	$roles = bbp_get_dynamic_roles();
245	$retval = translate_user_role( $roles[$user_role]['name'] );
246	}
247	}
248
249	// Pass retval through
250	return $retval;
251	}
252	}
253	new BBP_Users_Admin();
254	endif; // class exists
255