WP_Posts_List_Table::extra_tablenav() │ protected │ WP 1.0

Method of the class: WP_Posts_List_Table{}

Return

null. Nothing (null).

Usage

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

$which(string) (required)

-

WP_Posts_List_Table::extra_tablenav() WP Posts List Table::extra tablenav code ^{WP 6.5.2}

<?php
protected function extra_tablenav( $which ) {
	?>
	<div class="alignleft actions">
	<?php
	if ( 'top' === $which ) {
		ob_start();

		$this->months_dropdown( $this->screen->post_type );
		$this->categories_dropdown( $this->screen->post_type );
		$this->formats_dropdown( $this->screen->post_type );

		/**
		 * Fires before the Filter button on the Posts and Pages list tables.
		 *
		 * The Filter button allows sorting by date and/or category on the
		 * Posts list table, and sorting by date on the Pages list table.
		 *
		 * @since 2.1.0
		 * @since 4.4.0 The `$post_type` parameter was added.
		 * @since 4.6.0 The `$which` parameter was added.
		 *
		 * @param string $post_type The post type slug.
		 * @param string $which     The location of the extra table nav markup:
		 *                          'top' or 'bottom' for WP_Posts_List_Table,
		 *                          'bar' for WP_Media_List_Table.
		 */
		do_action( 'restrict_manage_posts', $this->screen->post_type, $which );

		$output = ob_get_clean();

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

	if ( $this->is_trash && $this->has_items()
		&& current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_others_posts )
	) {
		submit_button( __( 'Empty Trash' ), 'apply', 'delete_all', false );
	}
	?>
	</div>
	<?php
	/**
	 * Fires immediately following the closing "actions" div in the tablenav for the posts
	 * list table.
	 *
	 * @since 4.4.0
	 *
	 * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
	 */
	do_action( 'manage_posts_extra_tablenav', $which );
}