WP_Users_List_Table::extra_tablenav() │ protected │ WP 3.1.0

Outputs the controls to allow user roles to be changed in bulk.

Method of the class: WP_Users_List_Table{}

Return

null. Ничего (null).

Usage

// protected - for code of main (parent) or child class
$result = $this->extra_tablenav( $which );

$which(string) (required)

Whether this is being invoked above ("top") or below the table ("bottom").

Changelog

WP_Users_List_Table::extra_tablenav() WP Users List Table::extra tablenav code ^{WP 6.4.1}

<?php
protected function extra_tablenav( $which ) {
	$id        = 'bottom' === $which ? 'new_role2' : 'new_role';
	$button_id = 'bottom' === $which ? 'changeit2' : 'changeit';
	?>
<div class="alignleft actions">
	<?php if ( current_user_can( 'promote_users' ) && $this->has_items() ) : ?>
	<label class="screen-reader-text" for="<?php echo $id; ?>">
		<?php
		/* translators: Hidden accessibility text. */
		_e( 'Change role to&hellip;' );
		?>
	</label>
	<select name="<?php echo $id; ?>" id="<?php echo $id; ?>">
		<option value=""><?php _e( 'Change role to&hellip;' ); ?></option>
		<?php wp_dropdown_roles(); ?>
		<option value="none"><?php _e( '&mdash; No role for this site &mdash;' ); ?></option>
	</select>
		<?php
		submit_button( __( 'Change' ), '', $button_id, false );
	endif;

	/**
	 * Fires just before the closing div containing the bulk role-change controls
	 * in the Users list table.
	 *
	 * @since 3.5.0
	 * @since 4.6.0 The `$which` parameter was added.
	 *
	 * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
	 */
	do_action( 'restrict_manage_users', $which );
	?>
	</div>
	<?php
	/**
	 * Fires immediately following the closing "actions" div in the tablenav for the users
	 * list table.
	 *
	 * @since 4.9.0
	 *
	 * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
	 */
	do_action( 'manage_users_extra_tablenav', $which );
}