1. 首页
  2. WordPress 函数手册

add_rewrite_endpoint()

add_rewrite_endpoint( string $name, int $places, string|bool $query_var = true )

添加端点,如/trackback/。
Add an endpoint, like /trackback/.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

说明#

说明

添加终结点将为提供的位掩码指定的每个匹配位置创建额外的重写规则。例如:

添加“重写”端点(“json”,EP_PERMALINK | EP_PAGES);

将添加以“json(/(*)”结尾的新重写规则吗?/?$”用于描述permalink(post)或page的每个permastruct。这将重写为“json=$match”,其中$match是端点regex匹配的URL部分(例如“[permalink]/json/foo/”中的“foo”)。

还将创建与端点同名的新查询变量。

当指定$places时,请确保您使用的是EP_*常量(或它们的组合使用位或运算符),因为它们的值不能保证保持静态(尤其是EP_ALL)。

当你的插件被激活和停用时,请确保刷新重写规则-请参阅flush_rewrite_rules()。


参数(Parameters)

参数 类型 必填 说明
$name (string) 必需 终结点的名称。
$places (int) 必需 描述应添加终结点的位置的终结点掩码。
$query_var (string | bool) 可选 相应查询变量的名称。传递false可跳过为此终结点注册查询变量。默认值为$name。

返回(Return)

无返回值


源码(Source)


更新版本 源码位置 使用 被使用
4.3.0 wp-includes/rewrite.php:314 0 1 function

笔记(Notes)

$places的可用值:
重写端点API教程:https://make.wordpress.org/plugins/2012/06/07/rewrite-endpoints-api/

add_rewrite_endpoint() 为WP2原创文章,链接:https://www.wp2.cn/functions/add_rewrite_endpoint/

发表评论

您的电子邮箱地址不会被公开。