W3cubDocs

/WordPress

WP_Comments_List_Table::extra_tablenav( string $which )

Parameters

$which

(string) (Required)

Source

File: wp-admin/includes/class-wp-comments-list-table.php 

protected function extra_tablenav( $which ) {
		global $comment_status, $comment_type;
		static $has_items;

		if ( ! isset( $has_items ) ) {
			$has_items = $this->has_items();
		}
		echo '<div class="alignleft actions">';
		if ( 'top' === $which ) {
			ob_start();

			$this->comment_status_dropdown( $comment_type );
			/**
			 * Fires just before the Filter submit button for comment types.
			 *
			 * @since 3.5.0
			 */
			do_action( 'restrict_manage_comments' );

			$output = ob_get_clean();

			if ( ! empty( $output ) && $this->has_items() ) {
				echo $output;
				submit_button( esc_html__( 'Filter' ), '', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
			}
		}

		if ( ( 'spam' === $comment_status || 'trash' === $comment_status ) && current_user_can( 'moderate_comments' ) && $has_items ) {
			wp_nonce_field( 'bulk-destroy', '_destroy_nonce' );
			$title = ( 'spam' === $comment_status ) ? esc_attr__( 'Empty Spam' ) : esc_attr__( 'Empty Trash' );
			submit_button( $title, 'apply', 'delete_all', false );
		}
		/**
		 * Fires after the Filter submit button for comment types.
		 *
		 * @since 2.5.0
		 *
		 * @param string $comment_status The comment status name. Default 'All'.
		 */
		do_action( 'manage_comments_nav', $comment_status );
		echo '</div>';
	}

Uses

Uses Description
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::comment_status_dropdown()

Displays a comment status drop-down for filtering on the Comments list table.
wp-admin/includes/template.php: submit_button()

Echoes a submit button, with provided text and appropriate class(es).
wp-admin/includes/class-wp-comments-list-table.php: restrict_manage_comments

Fires just before the Filter submit button for comment types.
wp-admin/includes/class-wp-comments-list-table.php: manage_comments_nav

Fires after the Filter submit button for comment types.
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/l10n.php: esc_html__()

Retrieve the translation of $text and escapes it for safe use in HTML output.
wp-includes/l10n.php: esc_attr__()

Retrieve the translation of $text and escapes it for safe use in an attribute.
wp-includes/functions.php: wp_nonce_field()

Retrieve or display nonce hidden field for forms.
wp-includes/plugin.php: do_action()

Execute functions hooked on a specific action hook.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_comments_list_table/extra_tablenav