{"id":213081,"date":"2011-05-23T08:00:00","date_gmt":"2011-05-23T08:00:00","guid":{"rendered":"https:\/\/www.weixiaoduo.com\/plugins\/2024\/02\/22\/wp-router\/"},"modified":"2012-08-06T23:06:00","modified_gmt":"2012-08-06T23:06:00","slug":"wp-router","status":"publish","type":"post","link":"https:\/\/www.weixiaoduo.com\/plugins\/wp-router\/","title":{"rendered":"WP Router"},"content":{"rendered":"

WordPress\u2019s rewrite rules and query variables provide a powerful system
\nfor mapping URL strings to collections of posts. Every request is parsed
\ninto query variables and turned into a SQL query via $wp_query->query()<\/code>.<\/p>\n

Sometimes, though, you don\u2019t want to display a list of posts. You just want
\na URL to map to a callback function, with the output displayed in place of
\nposts in whatever theme you happen to be using.<\/p>\n

That\u2019s where WP Router comes in. It handles all the messy bits of registering
\npost types, query variables, rewrite rules, etc., and lets you write code to
\ndo what you want it to do. One function call is all it takes to map a
\nURL to your designated callback function and display the return value in the page.<\/p>\n

Created by Flightless<\/a><\/p>\n

Usage<\/h3>\n

Creating Routes<\/h4>\n
    \n
  • Your plugin should hook into the wp_router_generate_routes<\/code> action.
    \nThe callback should take one argument, a WP_Router<\/code> object.<\/li>\n
  • \n

    Register a route and its callback using WP_Router::add_route( $id, $args )<\/code><\/p>\n

      \n
    • $id<\/code> is a unique string your plugin should use to identify the route<\/li>\n
    • \n

      $args<\/code> is an associative array, that sets the following properties for your route.
      \nAny omitted argument will use the default value.<\/p>\n

        \n
      • \n

        path<\/code> (required) \u2013 A regular expression to match against the request path.
        \nThis corresponds to the array key you would use when creating rewrite rules for WordPress.<\/p>\n<\/li>\n

      • \n

        query_vars<\/code> \u2013 An associative array, with the keys being query vars, and the
        \nvalues being explicit strings or integers corresponding to matches in the path regexp.
        \n Any query variables included here will be automatically registered.<\/p>\n<\/li>\n

      • \n

        title<\/code> \u2013 The title of the page.<\/p>\n<\/li>\n

      • \n

        title_callback<\/code> \u2013 A callback to use for dynamically generating the title.
        \nDefaults to __()<\/code>. If NULL<\/code>, the title<\/code> argument will be used as-is. if
        \n page_callback or access_callback<\/code> returns FALSE<\/code>, title_callback<\/code> will not be called.<\/p>\n

        title_callback can be either a single callback function or an array specifying\n<\/code><\/pre>\n
        callback functions for specific HTTP methods (e.g., GET<\/code>, POST<\/code>, PUT<\/code>, DELETE<\/code>, etc.).
        \nIf the latter, the default<\/code> key will be used if no other keys match the current
        \nrequest method.<\/p>\n<\/li>\n
      • \n
        title_arguments<\/code> \u2013 An array of query variables whose values will be passed
        \nas arguments to title_callback<\/code>. Defaults to the value of title<\/code>. If an argument
        \nis not a registered query variable, it will be passed as-is.<\/p>\n<\/li>\n
      • \n
        page_callback<\/code> (required) \u2013 A callback to use for dynamically generating the
        \ncontents of the page. The callback should either echo or return the contents of
        \nthe page (if both, the returned value will be appended to the echoed value). If
        \n    FALSE is returned, nothing will be output, and control of the page contents will
        \nbe handed back to WordPress. The callback will be called during the parse_request<\/code>
        \nphase of WordPress\u2019s page load. If access_callback<\/code> returns FALSE<\/code>, page_callback<\/code>
        \nwill not be called.<\/p>\n
        page_callback can be either a single callback function or an array specifying\n<\/code><\/pre>\n
        callback functions for specific HTTP methods (e.g., GET<\/code>, POST<\/code>, PUT<\/code>, DELETE<\/code>, etc.).
        \nIf the latter, the default<\/code> key will be used if no other keys match the current
        \nrequest method.<\/p>\n<\/li>\n
      • \n
        page_arguments<\/code> \u2013 An array of query variables whose values will be passed as
        \narguments to page_callback<\/code>. If an argument is not a registered query variable,
        \nit will be passed as-is.<\/p>\n<\/li>\n
      • \n
        access_callback<\/code> \u2013 A callback to determine if the user has permission to access
        \nthis page. If access_arguments<\/code> is provided, default is current_user_can<\/code>, otherwise
        \ndefault is TRUE<\/code>. If the callback returns FALSE<\/code>, anonymous users are redirected to
        \nthe login page, authenticated users get a 403 error.<\/p>\n
        access_callback can be either a single callback function or an array specifying\n<\/code><\/pre>\n
        callback functions for specific HTTP methods (e.g., GET<\/code>, POST<\/code>, PUT<\/code>, DELETE<\/code>, etc.).
        \nIf the latter, the default<\/code> key will be used if no other keys match the current
        \nrequest method.<\/p>\n<\/li>\n
      • \n
        access_arguments<\/code> \u2013 An array of query variables whose values will be passed
        \nas arguments to access_callback<\/code>. If an argument is not a registered query variable,
        \nit will be passed as-is.<\/p>\n<\/li>\n
      • \n
        template<\/code> \u2013 An array of templates that can be used to display the page. If a path
        \nis absolute, it will be used as-is; relative paths allow for overrides by the theme.
        \nThe string $id<\/code> will be replaced with the ID of the route. If no template is found,
        \nfallback templates are (in this order): route-$id.php<\/code>, route.php<\/code>, page-$id.php<\/code>,
        \n    page.php, index.php<\/code>. If FALSE is given instead of an array, the page contents will
        \nbe printed before calling exit()<\/code> (you can also accomplish this by printing your output
        \nand exiting directly from your callback function).<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
        Example:
        \n    $router->add_route(\u2018wp-router-sample\u2019, array(
        \n        \u2018path\u2019 => \u2018^wp_router\/(.*?)$\u2019,
        \n        \u2018query_vars\u2019 => array(
        \n            \u2018sample_argument\u2019 => 1,
        \n        ),
        \n        \u2018page_callback\u2019 => array(get_class(), \u2018sample_callback\u2019),
        \n        \u2018page_arguments\u2019 => array(\u2018sample_argument\u2019),
        \n        \u2018access_callback\u2019 => TRUE,
        \n        \u2018title\u2019 => \u2018WP Router Sample Page\u2019,
        \n        \u2018template\u2019 => array(\u2018sample-page.php\u2019, dirname(FILE<\/strong>).DIRECTORY_SEPARATOR.\u2019sample-page.php\u2019)
        \n    ));<\/p>\n
        In this example, the path http:\/\/example.com\/wp_router\/my_sample_path\/<\/code> will call
        \nthe function sample_callback<\/code> in the calling class. The value of the sample_argument<\/code>
        \nquery variable, in this case \u201cmy_sample_path\u201d, will be provided as the first and only
        \nargument to the callback function. If the file sample-page.php<\/code> is found in the theme,
        \nit will be used as the template, otherwise sample-page.php<\/code> in your plugin directory will
        \nbe used (if that\u2019s not found either, fall back to route-wp-router-sample.php<\/code>, etc.).<\/p>\n
        Editing Routes<\/h4>\n
          \n
        • You can hook into the wp_router_alter_routes<\/code> action to modify routes created by other plugins. The callback should take one argument, a WP_Router<\/code> object.<\/li>\n<\/ul>\n
          Public API Functions<\/h4>\n
          Creating or changing routes should always occur in the context of the wp_router_generate_routes<\/code> or wp_router_alter_routes<\/code> actions, using the WP_Router<\/code> object supplied to your callback function.<\/p>\n
            \n
          • WP_Router::edit_route( string $id, array $changes )<\/code> \u2013 update each
            \nproperty given in $changes<\/code> for the route with the given ID. Any properties
            \nnot given in $changes<\/code> will be left unaltered.<\/li>\n
          • WP_Router::remove_route( string $id )<\/code> \u2013 delete the route with the given ID<\/li>\n
          • WP_Router::get_route( string $id )<\/code> \u2013 get the WP_Route<\/code> object for the given ID<\/li>\n
          • WP_Router::get_url( string $id, array $arguments )<\/code> \u2013 get the URL to reach the route with the given ID, with the given query variables and their values<\/li>\n
          • WP_Route::get( string $property )<\/code> \u2013 get the value of the specified property for
            \nthe WP_Route<\/code> instance<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
            Provides a simple API for mapping requests to callback functions.<\/p>\n","protected":false},"author":65,"featured_media":228505,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"WP Router - \u8587\u6653\u6735\u63d2\u4ef6\u76ee\u5f55","description":"Provides a simple API for mapping requests to callback functions."},"footnotes":""},"categories":[1],"tags":[51335,51336],"class_list":["post-213081","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-callback-functions","tag-url-mapping"],"_links":{"self":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/213081","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/comments?post=213081"}],"version-history":[{"count":0,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/213081\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media\/228505"}],"wp:attachment":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media?parent=213081"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/categories?post=213081"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/tags?post=213081"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}