WordPress 6.1 新增 WP_List_Table::get_views_links() 生成当前视图链接

文章目录

问题

以前,必须在每个子类的get_views()方法中添加为视图链接生成标记的代码。这导致重复和不一致的代码来实现相同的结果,增加了内核和类似扩展器的维护负担。

解决方案

在工单 #42066中提出了一种新方法WP_List_Table::get_views_links(),它将链接生成抽离到父类完成。

这个新的protected方法接受一个$link_data数组参数,每个视图(view)包含以下内容:

  • $url (string) 链接URL。
  • $label (string) 链接标签。
  • $current (bool) 可选。这是否是当前选择的视图。

如果$current为真truearia-current="page"class="current"将被添加到项目的链接标记中。

用法

  1. get_views()方法中,创建如上所述的链接数据数组。
  2. 将数组传递给新方法。
class My_List_Table extends WP_List_Table {
	protected function get_views() {
		// Create link data.
		$base_url  = add_query_arg( 'post_type', 'my_cpt', admin_url( 'edit.php' ) );
		$link_data = array(
			'all' => array(
				'url'     => $base_url,
				'label'   => __( 'All', 'my_textdomain' ),
				'current' => true, // Optional.
			),
			'trash' => array(
				'url'   => add_query_arg( 'post_status', 'trash', $base_url ),
				'label' => __( 'Trash', 'my_text_domain' ),
			),
		);

		// Generate link markup.
		return $this->get_views_links( $link_data );
	}
}

核心子类更新

以下核心子类现在使用新方法:

  • WP_Posts_List_Table
  • WP_Comments_List_Table
  • WP_Post_Comments_List_Table
  • WP_Users_List_Table
  • WP_Plugins_List_Table
  • WP_Plugin_Install_List_Table
  • WP_Theme_Install_List_Table
  • WP_Privacy_Requests_Table
  • WP_MS_Sites_List_Table
  • WP_MS_Themes_List_Table
  • WP_MS_Users_List_Table
文章网址:https://www.wpbull.com/news/2011.html