add_rewrite_endpoint()

Add an endpoint, like /trackback/.

Adding an endpoint creates extra rewrite rules for each of the matching places specified by the provided bitmask. For example:

add_rewrite_endpoint( 'json', EP_PERMALINK | EP_PAGES );

will add a new rewrite rule ending with “json(/(.*))?/?$” for every permastruct that describes a permalink (post) or page. This is rewritten to “json=$match” where $match is the part of the URL matched by the endpoint regex (e.g. “foo” in “ /json/foo/”).

A new query var with the same name as the endpoint will also be created.

When specifying $places ensure that you are using the EP_* constants (or a combination of them using the bitwise OR operator) as their values are not guaranteed to remain static (especially EP_ALL).

Be sure to flush the rewrite rules – flush_rewrite_rules() – when your plugin gets activated and deactivated.

Signature

add_rewrite_endpoint( $name, $places )

name

 (string) Name of the endpoint.

places

 (int) Endpoint mask describing the places the endpoint should be added.

Return

(void)

Source

function add_rewrite_endpoint( $name, $places ) {
	global $wp_rewrite;
	$wp_rewrite->add_endpoint( $name, $places );
}

WP Trac GitHub Bitbucket