钩子文档

subdirectory_reserved_names

💡 云策文档标注

概述

本文档介绍 WordPress 子目录多站点安装中的保留站点名称过滤器 subdirectory_reserved_names。它允许开发者修改或扩展在子目录多站点中不能用作站点名称的保留名称列表。

关键要点

  • subdirectory_reserved_names 是一个过滤器,用于在子目录多站点安装中过滤保留的站点名称。
  • 参数 $subdirectory_reserved_names 是一个字符串数组,包含保留名称列表。
  • 相关函数 get_subdirectory_reserved_names() 用于检索子目录多站点安装中的保留站点名称列表。
  • 自 WordPress 4.4.0 起,保留名称列表新增了 'wp-admin'、'wp-content'、'wp-includes'、'wp-json' 和 'embed'。

代码示例

apply_filters( 'subdirectory_reserved_names', $names );

注意事项

  • 此过滤器在 WordPress 3.0.0 中引入,适用于子目录多站点安装。
  • 开发者可以通过此过滤器自定义保留名称,以避免与系统路径冲突。

📄 原文内容

Filters reserved site names on a sub-directory Multisite installation.

Parameters

$subdirectory_reserved_namesstring[]
Array of reserved names.

Source

return apply_filters( 'subdirectory_reserved_names', $names );

Changelog

Version Description
4.4.0 'wp-admin', 'wp-content', 'wp-includes', 'wp-json', and 'embed' were added to the reserved names list.
3.0.0 Introduced.