钩子文档

manage_sites_action_links

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 manage_sites_action_links 过滤器,用于自定义站点列表表中每个站点的操作链接。默认链接包括编辑、仪表板、永久删除和访问,其他链接根据站点状态动态显示。

关键要点

  • 过滤器名称:manage_sites_action_links,用于修改站点列表中的操作链接数组。
  • 参数:$actions(操作链接数组)、$blog_id(站点ID)、$blogname(站点路径,格式取决于多站点安装类型)。
  • 默认链接:包括 'Edit'、'Dashboard'、'Delete Permanently' 和 'Visit'。
  • 状态相关链接:根据站点状态显示如 'Remove Deletion Flag'、'Flag for Deletion'、'Unarchive'、'Archive'、'Not Spam' 或 'Spam'。
  • 相关函数:WP_MS_Sites_List_Table::handle_row_actions() 用于生成和显示行操作链接。
  • 版本历史:自 WordPress 3.1.0 引入。

代码示例

$actions = apply_filters( 'manage_sites_action_links', array_filter( $actions ), $blog['blog_id'], $blogname );

📄 原文内容

Filters the action links displayed for each site in the Sites list table.

Description

The ‘Edit’, ‘Dashboard’, ‘Delete Permanently’, and ‘Visit’ links are displayed by default for each site. The site’s status determines whether to show the ‘Remove Deletion Flag’ or ‘Flag for Deletion’ link, ‘Unarchive’ or ‘Archive’ links, and ‘Not Spam’ or ‘Spam’ link for each site.

Parameters

$actionsstring[]
An array of action links to be displayed.
$blog_idint
The site ID.
$blognamestring
Site path, formatted depending on whether it is a sub-domain or subdirectory multisite installation.

Source

$actions = apply_filters( 'manage_sites_action_links', array_filter( $actions ), $blog['blog_id'], $blogname );

Changelog

Version Description
3.1.0 Introduced.