add_rewrite_endpoint()

热度:68
Function:添加端点,例如/ trackback /。
版本 20190729
所属分类 Functions
可使用页面 All
默认值

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

  • 添加端点,例如/ trackback /


描述:

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

add_rewrite_endpoint( 'json', EP_PERMALINK | EP_PAGES );

将为每个描述固定链接(post)或页面的permastruct添加一个以“json(/(.*))?/?$”结尾的新重写规则。这被重写为“json = $ match”,其中$ match是端点正则表达式匹配的URL的一部分(例如“[permalink] / json / foo /”中的“foo”)。

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

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


参数:

$name

(string) (Required) 端点的名称。


$places

(int) (Required) 描述端点应添加的位置的端点掩码。


$query_var

(string|bool) (Optional) 相应查询变量的名称。传递false跳过为此端点注册query_var。默认值为$name。

Default value: true


示例:

function add_rewrite_endpoint( $name, $places, $query_var = true ) {

    global $wp_rewrite;

    $wp_rewrite->add_endpoint( $name, $places, $query_var );

}


问题反馈反馈和建议QQ群:785318993