| [ Index ] |
PHP Cross Reference of GlotPress |
[Summary view] [Print] [Text view]
1 <?php 2 3 class GP_Router { 4 5 public $api_prefix = 'api'; 6 private $urls = array(); 7 8 public function __construct( $urls = array() ) { 9 $this->urls = $urls; 10 } 11 12 /** 13 * Sets the default routes that GlotPress needs. 14 */ 15 public function set_default_routes() { 16 $this->urls = array_merge( $this->urls, $this->default_routes() ); 17 18 /** 19 * Fires after default routes have been set. 20 * 21 * @since 1.0.0 22 * 23 * @param GP_Router $router The router object. 24 */ 25 do_action( 'gp_router_default_routes_set', $this ); 26 } 27 28 /** 29 * Returns the current request URI path, relative to 30 * the application URI and without the query string 31 */ 32 public function request_uri() { 33 global $wp; 34 return urldecode( '/' . rtrim( $wp->query_vars['gp_route'], '/' ) ); 35 } 36 37 public function request_method() { 38 return wp_unslash( gp_array_get( $_SERVER, 'REQUEST_METHOD', 'GET' ) ); 39 } 40 41 public function add( $re, $function, $method = 'get' ) { 42 $this->urls[ "$method:$re" ] = $function; 43 } 44 45 public function prepend( $re, $function, $method = 'get' ) { 46 $this->urls = array( "$method:$re" => $function ) + $this->urls; 47 } 48 49 public function remove( $re, $method = 'get' ) { 50 if ( isset( $this->urls[ "$method:$re" ] ) ) { 51 unset( $this->urls[ "$method:$re" ] ); 52 return true; 53 } 54 55 return false; 56 } 57 58 private function default_routes() { 59 $dir = '([^_/][^/]*)'; 60 $path = '(.+?)'; 61 $projects = 'projects'; 62 $project = $projects . '/' . $path; 63 $id = '(\d+)'; 64 $locale = '(' . implode( '|', wp_list_pluck( GP_Locales::locales(), 'slug' ) ) . ')'; 65 $set = "$project/$locale/$dir"; 66 67 // overall structure 68 return array( 69 '/' => array( 'GP_Route_Index', 'index' ), 70 71 'get:/profile' => array( 'GP_Route_Profile', 'profile_view' ), 72 "get:/profile/$path" => array( 'GP_Route_Profile', 'profile_view' ), 73 74 'get:/settings' => array( 'GP_Route_Settings', 'settings_get' ), 75 'post:/settings' => array( 'GP_Route_Settings', 'settings_post' ), 76 77 "get:(/languages)/$locale/$dir/glossary" => array( 'GP_Route_Glossary_Entry', 'glossary_entries_get' ), 78 "post:(/languages)/$locale/$dir/glossary" => array( 'GP_Route_Glossary_Entry', 'glossary_entries_post' ), 79 "post:(/languages)/$locale/$dir/glossary/-new" => array( 'GP_Route_Glossary_Entry', 'glossary_entry_add_post' ), 80 "post:(/languages)/$locale/$dir/glossary/-delete" => array( 'GP_Route_Glossary_Entry', 'glossary_entry_delete_post' ), 81 "get:(/languages)/$locale/$dir/glossary/-export" => array( 'GP_Route_Glossary_Entry', 'export_glossary_entries_get' ), 82 "get:(/languages)/$locale/$dir/glossary/-import" => array( 'GP_Route_Glossary_Entry', 'import_glossary_entries_get' ), 83 "post:(/languages)/$locale/$dir/glossary/-import" => array( 'GP_Route_Glossary_Entry', 'import_glossary_entries_post' ), 84 85 'get:/languages' => array( 'GP_Route_Locale', 'locales_get' ), 86 "get:/languages/$locale/$path" => array( 'GP_Route_Locale', 'single' ), 87 "get:/languages/$locale" => array( 'GP_Route_Locale', 'single' ), 88 89 "get:/$set/glossary" => array( 'GP_Route_Glossary_Entry', 'glossary_entries_get' ), 90 "post:/$set/glossary" => array( 'GP_Route_Glossary_Entry', 'glossary_entries_post' ), 91 "post:/$set/glossary/-new" => array( 'GP_Route_Glossary_Entry', 'glossary_entry_add_post' ), 92 "post:/$set/glossary/-delete" => array( 'GP_Route_Glossary_Entry', 'glossary_entry_delete_post' ), 93 "get:/$set/glossary/-export" => array( 'GP_Route_Glossary_Entry', 'export_glossary_entries_get' ), 94 "get:/$set/glossary/-import" => array( 'GP_Route_Glossary_Entry', 'import_glossary_entries_get' ), 95 "post:/$set/glossary/-import" => array( 'GP_Route_Glossary_Entry', 'import_glossary_entries_post' ), 96 97 "get:/$project/import-originals" => array( 'GP_Route_Project', 'import_originals_get' ), 98 "post:/$project/import-originals" => array( 'GP_Route_Project', 'import_originals_post' ), 99 100 "get:/$project/-edit" => array( 'GP_Route_Project', 'edit_get' ), 101 "post:/$project/-edit" => array( 'GP_Route_Project', 'edit_post' ), 102 103 "get:/$project/-delete" => array( 'GP_Route_Project', 'delete_get' ), 104 "post:/$project/-delete" => array( 'GP_Route_Project', 'delete_post' ), 105 106 "post:/$project/-personal" => array( 'GP_Route_Project', 'personal_options_post' ), 107 108 "get:/$project/-permissions" => array( 'GP_Route_Project', 'permissions_get' ), 109 "post:/$project/-permissions" => array( 'GP_Route_Project', 'permissions_post' ), 110 "get:/$project/-permissions/-delete/$dir" => array( 'GP_Route_Project', 'permissions_delete' ), 111 112 "get:/$project/-mass-create-sets" => array( 'GP_Route_Project', 'mass_create_sets_get' ), 113 "post:/$project/-mass-create-sets" => array( 'GP_Route_Project', 'mass_create_sets_post' ), 114 "post:/$project/-mass-create-sets/preview" => array( 'GP_Route_Project', 'mass_create_sets_preview_post' ), 115 116 "get:/$project/-branch" => array( 'GP_Route_Project', 'branch_project_get' ), 117 "post:/$project/-branch" => array( 'GP_Route_Project', 'branch_project_post' ), 118 119 "get:/$projects" => array( 'GP_Route_Project', 'index' ), 120 "get:/$projects/-new" => array( 'GP_Route_Project', 'new_get' ), 121 "post:/$projects/-new" => array( 'GP_Route_Project', 'new_post' ), 122 123 "post:/$set/-bulk" => array( 'GP_Route_Translation', 'bulk_post' ), 124 "get:/$set/import-translations" => array( 'GP_Route_Translation', 'import_translations_get' ), 125 "post:/$set/import-translations" => array( 'GP_Route_Translation', 'import_translations_post' ), 126 "post:/$set/-discard-warning" => array( 'GP_Route_Translation', 'discard_warning' ), 127 "post:/$set/-set-status" => array( 'GP_Route_Translation', 'set_status' ), 128 129 "/$set/export-translations" => array( 'GP_Route_Translation', 'export_translations_get' ), 130 // Keep this below all URLs ending with a literal string, because it may catch one of them. 131 "get:/$set" => array( 'GP_Route_Translation', 'translations_get' ), 132 "post:/$set" => array( 'GP_Route_Translation', 'translations_post' ), 133 134 // Keep this one at the bottom of the project, because it will catch anything starting with project. 135 "/$project" => array( 'GP_Route_Project', 'single' ), 136 137 'get:/sets/-new' => array( 'GP_Route_Translation_Set', 'new_get' ), 138 'post:/sets/-new' => array( 'GP_Route_Translation_Set', 'new_post' ), 139 "get:/sets/$id" => array( 'GP_Route_Translation_Set', 'single' ), 140 "get:/sets/$id/-edit" => array( 'GP_Route_Translation_Set', 'edit_get' ), 141 "post:/sets/$id/-edit" => array( 'GP_Route_Translation_Set', 'edit_post' ), 142 "get:/sets/$id/-delete" => array( 'GP_Route_Translation_Set', 'delete_get' ), 143 "post:/sets/$id/-delete" => array( 'GP_Route_Translation_Set', 'delete_post' ), 144 145 'get:/glossaries/-new' => array( 'GP_Route_Glossary', 'new_get' ), 146 'post:/glossaries/-new' => array( 'GP_Route_Glossary', 'new_post' ), 147 "get:/glossaries/$id/-edit" => array( 'GP_Route_Glossary', 'edit_get' ), 148 "post:/glossaries/$id/-edit" => array( 'GP_Route_Glossary', 'edit_post' ), 149 "get:/glossaries/$id/-delete" => array( 'GP_Route_Glossary', 'delete_get' ), 150 "post:/glossaries/$id/-delete" => array( 'GP_Route_Glossary', 'delete_post' ), 151 152 "post:/originals/$id/set_priority" => array( 'GP_Route_Original', 'set_priority' ), 153 ); 154 } 155 156 157 public function route() { 158 global $wp_query; 159 160 $real_request_uri = $this->request_uri(); 161 $api_request_uri = $real_request_uri; 162 $request_method = strtolower( $this->request_method() ); 163 $api = gp_startswith( $real_request_uri, '/' . $this->api_prefix . '/' ); 164 165 /** 166 * Filter the list of HTTP methods allowed 167 * 168 * @since 2.1 169 * 170 * @param array $http_methods Allowed http methods 171 */ 172 $http_methods = apply_filters( 'gp_router_http_methods', array( 'get', 'post', 'head', 'put', 'delete' ) ); 173 174 if ( $api ) { 175 $real_request_uri = substr( $real_request_uri, strlen( $this->api_prefix ) + 1 ); 176 } 177 178 $url_path = gp_url_path( gp_url_public_root() ); 179 180 // If the request URL doesn't match our base URL, don't bother trying to match 181 if ( $url_path && ! gp_startswith( wp_unslash( $_SERVER['REQUEST_URI'] ), $url_path ) ) { 182 return; 183 } 184 185 foreach ( array( $api_request_uri, $real_request_uri ) as $request_uri ) { 186 foreach ( $this->urls as $re => $func ) { 187 foreach ( $http_methods as $http_method ) { 188 if ( gp_startswith( $re, $http_method . ':' ) ) { 189 if ( $http_method != $request_method ) { 190 continue; 191 } 192 $re = substr( $re, strlen( $http_method . ':' ) ); 193 break; 194 } 195 } 196 197 if ( preg_match( "@^$re$@", $request_uri, $matches ) ) { 198 /* 199 * WordPress will be returning a 404 status header by default for GlotPress pages 200 * as nothing is found by WP_Query. 201 * This overrides the status header and the `$is_404` property of WP_Query if we've matched 202 * something here. Route controllers still can return a 404 status header. 203 */ 204 status_header( '200' ); 205 $wp_query->is_404 = false; 206 207 if ( is_array( $func ) ) { 208 list( $class, $method ) = $func; 209 $route = new $class(); 210 $route->api = $api; 211 $route->last_method_called = $method; 212 $route->class_name = $class; 213 GP::$current_route = &$route; 214 $route->before_request(); 215 $route->request_running = true; 216 // Make sure after_request() is called even if we $this->exit_() in the request. 217 register_shutdown_function( array( &$route, 'after_request' ) ); 218 $route->$method( ...array_slice( $matches, 1 ) ); 219 $route->after_request(); 220 $route->request_running = false; 221 } else { 222 $func( ...array_slice( $matches, 1 ) ); 223 } 224 exit; 225 } 226 } 227 } 228 229 gp_tmpl_404(); 230 } 231 232 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Thu Nov 21 01:01:07 2024 | Cross-referenced by PHPXref 0.7.1 |