WordPress开发手册:add_permastruct()

函数原型

add_permastruct( string $name, string $struct, array $args = array() )

函数描述

是否弃用

未弃用

函数参数

$name
string
Required

Name for permalink structure.

$struct
string
Required

Permalink structure.

$args
array
Optional

Arguments for building the rules from the permalink structure, see WP_Rewrite::add_permastruct() for full details.

More Arguments from WP_Rewrite::add_permastruct( … $args )

Arguments for building rewrite rules based on the permalink structure.

• with_front bool
  Whether the structure should be prepended with WP_Rewrite::$front.
  Default true.
• ep_mask int
  The endpoint mask defining which endpoints are added to the structure.
  Accepts a mask of:

  • EP_ALL
  • EP_NONE
  • EP_ALL_ARCHIVES
  • EP_ATTACHMENT
  • EP_AUTHORS
  • EP_CATEGORIES
  • EP_COMMENTS
  • EP_DATE
  • EP_DAY
  • EP_MONTH
  • EP_PAGES
  • EP_PERMALINK
  • EP_ROOT
  • EP_SEARCH
  • EP_TAGS
  • EP_YEAR Default EP_NONE.
• paged bool
  Whether archive pagination rules should be added for the structure.
  Default true.
• feed bool
  Whether feed rewrite rules should be added for the structure. Default true.
• forcomments bool
  Whether the feed rules should be a query for a comments feed. Default false.
• walk_dirs bool
  Whether the 'directories' making up the structure should be walked over and rewrite rules built for each in-turn. Default true.
• endpoints bool
  Whether endpoints should be applied to the generated rules. Default true.

Default: array()

函数返回值

函数位置

函数源码

function add_permastruct( $name, $struct, $args = array() ) {
	global $wp_rewrite;

	// Back-compat for the old parameters: $with_front and $ep_mask.
	if ( ! is_array( $args ) ) {
		$args = array( 'with_front' => $args );
	}
	if ( func_num_args() == 4 ) {
		$args['ep_mask'] = func_get_arg( 3 );
	}

	$wp_rewrite->add_permastruct( $name, $struct, $args );
}

源码链接

WordPress
Github

变更日志