钩子文档

network_edit_site_nav_links

💡 云策文档标注

概述

network_edit_site_nav_links 是一个 WordPress 过滤器,用于修改网络管理页面中站点编辑页面的导航链接。它允许开发者自定义或扩展默认链接数组,包括链接的标签、URL 和所需权限。

关键要点

  • 这是一个过滤器 Hook,用于过滤网络站点编辑页面的导航链接。
  • 默认链接包括 'site-info'、'site-users'、'site-themes' 和 'site-settings',每个链接包含 label、url 和 cap 属性。
  • 参数 $links 是一个数组,表示网络管理页面的链接数据,每个元素是一个关联数组,包含 label、url 和 cap。
  • 开发者可以通过此 Hook 添加、移除或修改链接,以定制网络管理界面。

代码示例

$links = apply_filters(
    'network_edit_site_nav_links',
    array(
        'site-info'     => array(
            'label' => __( 'Info' ),
            'url'   => 'site-info.php',
            'cap'   => 'manage_sites',
        ),
        'site-users'    => array(
            'label' => __( 'Users' ),
            'url'   => 'site-users.php',
            'cap'   => 'manage_sites',
        ),
        'site-themes'   => array(
            'label' => __( 'Themes' ),
            'url'   => 'site-themes.php',
            'cap'   => 'manage_sites',
        ),
        'site-settings' => array(
            'label' => __( 'Settings' ),
            'url'   => 'site-settings.php',
            'cap'   => 'manage_sites',
        ),
    )
);

📄 原文内容

Filters the links that appear on site-editing network pages.

Description

Default links: ‘site-info’, ‘site-users’, ‘site-themes’, and ‘site-settings’.

Parameters

$linksarray
An array of link data representing individual network admin pages.
  • link_slug array
    An array of information about the individual link to a page.
    $type string $label Label to use for the link.
    $type string $url URL, relative to network_admin_url() to use for the link.
    $type string $cap Capability required to see the link.
    }

Source

$links = apply_filters(
	'network_edit_site_nav_links',
	array(
		'site-info'     => array(
			'label' => __( 'Info' ),
			'url'   => 'site-info.php',
			'cap'   => 'manage_sites',
		),
		'site-users'    => array(
			'label' => __( 'Users' ),
			'url'   => 'site-users.php',
			'cap'   => 'manage_sites',
		),
		'site-themes'   => array(
			'label' => __( 'Themes' ),
			'url'   => 'site-themes.php',
			'cap'   => 'manage_sites',
		),
		'site-settings' => array(
			'label' => __( 'Settings' ),
			'url'   => 'site-settings.php',
			'cap'   => 'manage_sites',
		),
	)
);

Changelog

VersionDescription
4.6.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.