[ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * WordPress Administration Bootstrap 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** 10 * In WordPress Administration Screens 11 * 12 * @since 2.3.2 13 */ 14 if ( ! defined( 'WP_ADMIN' ) ) { 15 define( 'WP_ADMIN', true ); 16 } 17 18 if ( ! defined( 'WP_NETWORK_ADMIN' ) ) { 19 define( 'WP_NETWORK_ADMIN', false ); 20 } 21 22 if ( ! defined( 'WP_USER_ADMIN' ) ) { 23 define( 'WP_USER_ADMIN', false ); 24 } 25 26 if ( ! WP_NETWORK_ADMIN && ! WP_USER_ADMIN ) { 27 define( 'WP_BLOG_ADMIN', true ); 28 } 29 30 if ( isset( $_GET['import'] ) && ! defined( 'WP_LOAD_IMPORTERS' ) ) { 31 define( 'WP_LOAD_IMPORTERS', true ); 32 } 33 34 require_once dirname( __DIR__ ) . '/wp-load.php'; 35 36 nocache_headers(); 37 38 if ( get_option( 'db_upgraded' ) ) { 39 40 flush_rewrite_rules(); 41 update_option( 'db_upgraded', false, true ); 42 43 /** 44 * Fires on the next page load after a successful DB upgrade. 45 * 46 * @since 2.8.0 47 */ 48 do_action( 'after_db_upgrade' ); 49 50 } elseif ( ! wp_doing_ajax() && empty( $_POST ) 51 && (int) get_option( 'db_version' ) !== $wp_db_version 52 ) { 53 54 if ( ! is_multisite() ) { 55 wp_redirect( admin_url( 'upgrade.php?_wp_http_referer=' . urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) ); 56 exit; 57 } 58 59 /** 60 * Filters whether to attempt to perform the multisite DB upgrade routine. 61 * 62 * In single site, the user would be redirected to wp-admin/upgrade.php. 63 * In multisite, the DB upgrade routine is automatically fired, but only 64 * when this filter returns true. 65 * 66 * If the network is 50 sites or less, it will run every time. Otherwise, 67 * it will throttle itself to reduce load. 68 * 69 * @since MU (3.0.0) 70 * 71 * @param bool $do_mu_upgrade Whether to perform the Multisite upgrade routine. Default true. 72 */ 73 if ( apply_filters( 'do_mu_upgrade', true ) ) { 74 $c = get_blog_count(); 75 76 /* 77 * If there are 50 or fewer sites, run every time. Otherwise, throttle to reduce load: 78 * attempt to do no more than threshold value, with some +/- allowed. 79 */ 80 if ( $c <= 50 || ( $c > 50 && mt_rand( 0, (int) ( $c / 50 ) ) === 1 ) ) { 81 require_once ABSPATH . WPINC . '/http.php'; 82 $response = wp_remote_get( 83 admin_url( 'upgrade.php?step=1' ), 84 array( 85 'timeout' => 120, 86 'httpversion' => '1.1', 87 ) 88 ); 89 /** This action is documented in wp-admin/network/upgrade.php */ 90 do_action( 'after_mu_upgrade', $response ); 91 unset( $response ); 92 } 93 unset( $c ); 94 } 95 } 96 97 require_once ABSPATH . 'wp-admin/includes/admin.php'; 98 99 auth_redirect(); 100 101 // Schedule Trash collection. 102 if ( ! wp_next_scheduled( 'wp_scheduled_delete' ) && ! wp_installing() ) { 103 wp_schedule_event( time(), 'daily', 'wp_scheduled_delete' ); 104 } 105 106 // Schedule transient cleanup. 107 if ( ! wp_next_scheduled( 'delete_expired_transients' ) && ! wp_installing() ) { 108 wp_schedule_event( time(), 'daily', 'delete_expired_transients' ); 109 } 110 111 set_screen_options(); 112 113 $date_format = __( 'F j, Y' ); 114 $time_format = __( 'g:i a' ); 115 116 wp_enqueue_script( 'common' ); 117 118 /** 119 * $pagenow is set in vars.php. 120 * $wp_importers is sometimes set in wp-admin/includes/import.php. 121 * The remaining variables are imported as globals elsewhere, declared as globals here. 122 * 123 * @global string $pagenow The filename of the current screen. 124 * @global array $wp_importers 125 * @global string $hook_suffix 126 * @global string $plugin_page 127 * @global string $typenow The post type of the current screen. 128 * @global string $taxnow The taxonomy of the current screen. 129 */ 130 global $pagenow, $wp_importers, $hook_suffix, $plugin_page, $typenow, $taxnow; 131 132 $page_hook = null; 133 134 $editing = false; 135 136 if ( isset( $_GET['page'] ) ) { 137 $plugin_page = wp_unslash( $_GET['page'] ); 138 $plugin_page = plugin_basename( $plugin_page ); 139 } 140 141 if ( isset( $_REQUEST['post_type'] ) && post_type_exists( $_REQUEST['post_type'] ) ) { 142 $typenow = $_REQUEST['post_type']; 143 } else { 144 $typenow = ''; 145 } 146 147 if ( isset( $_REQUEST['taxonomy'] ) && taxonomy_exists( $_REQUEST['taxonomy'] ) ) { 148 $taxnow = $_REQUEST['taxonomy']; 149 } else { 150 $taxnow = ''; 151 } 152 153 if ( WP_NETWORK_ADMIN ) { 154 require ABSPATH . 'wp-admin/network/menu.php'; 155 } elseif ( WP_USER_ADMIN ) { 156 require ABSPATH . 'wp-admin/user/menu.php'; 157 } else { 158 require ABSPATH . 'wp-admin/menu.php'; 159 } 160 161 if ( current_user_can( 'manage_options' ) ) { 162 wp_raise_memory_limit( 'admin' ); 163 } 164 165 /** 166 * Fires as an admin screen or script is being initialized. 167 * 168 * Note, this does not just run on user-facing admin screens. 169 * It runs on admin-ajax.php and admin-post.php as well. 170 * 171 * This is roughly analogous to the more general {@see 'init'} hook, which fires earlier. 172 * 173 * @since 2.5.0 174 */ 175 do_action( 'admin_init' ); 176 177 if ( isset( $plugin_page ) ) { 178 if ( ! empty( $typenow ) ) { 179 $the_parent = $pagenow . '?post_type=' . $typenow; 180 } else { 181 $the_parent = $pagenow; 182 } 183 184 $page_hook = get_plugin_page_hook( $plugin_page, $the_parent ); 185 if ( ! $page_hook ) { 186 $page_hook = get_plugin_page_hook( $plugin_page, $plugin_page ); 187 188 // Back-compat for plugins using add_management_page(). 189 if ( empty( $page_hook ) && 'edit.php' === $pagenow && get_plugin_page_hook( $plugin_page, 'tools.php' ) ) { 190 // There could be plugin specific params on the URL, so we need the whole query string. 191 if ( ! empty( $_SERVER['QUERY_STRING'] ) ) { 192 $query_string = $_SERVER['QUERY_STRING']; 193 } else { 194 $query_string = 'page=' . $plugin_page; 195 } 196 wp_redirect( admin_url( 'tools.php?' . $query_string ) ); 197 exit; 198 } 199 } 200 unset( $the_parent ); 201 } 202 203 $hook_suffix = ''; 204 if ( isset( $page_hook ) ) { 205 $hook_suffix = $page_hook; 206 } elseif ( isset( $plugin_page ) ) { 207 $hook_suffix = $plugin_page; 208 } elseif ( isset( $pagenow ) ) { 209 $hook_suffix = $pagenow; 210 } 211 212 set_current_screen(); 213 214 // Handle plugin admin pages. 215 if ( isset( $plugin_page ) ) { 216 if ( $page_hook ) { 217 /** 218 * Fires before a particular screen is loaded. 219 * 220 * The load-* hook fires in a number of contexts. This hook is for plugin screens 221 * where a callback is provided when the screen is registered. 222 * 223 * The dynamic portion of the hook name, `$page_hook`, refers to a mixture of plugin 224 * page information including: 225 * 1. The page type. If the plugin page is registered as a submenu page, such as for 226 * Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'. 227 * 2. A separator of '_page_'. 228 * 3. The plugin basename minus the file extension. 229 * 230 * Together, the three parts form the `$page_hook`. Citing the example above, 231 * the hook name used would be 'load-settings_page_pluginbasename'. 232 * 233 * @see get_plugin_page_hook() 234 * 235 * @since 2.1.0 236 */ 237 do_action( "load-{$page_hook}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 238 if ( ! isset( $_GET['noheader'] ) ) { 239 require_once ABSPATH . 'wp-admin/admin-header.php'; 240 } 241 242 /** 243 * Used to call the registered callback for a plugin screen. 244 * 245 * This hook uses a dynamic hook name, `$page_hook`, which refers to a mixture of plugin 246 * page information including: 247 * 1. The page type. If the plugin page is registered as a submenu page, such as for 248 * Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'. 249 * 2. A separator of '_page_'. 250 * 3. The plugin basename minus the file extension. 251 * 252 * Together, the three parts form the `$page_hook`. Citing the example above, 253 * the hook name used would be 'settings_page_pluginbasename'. 254 * 255 * @see get_plugin_page_hook() 256 * 257 * @since 1.5.0 258 */ 259 do_action( $page_hook ); 260 } else { 261 if ( validate_file( $plugin_page ) ) { 262 wp_die( __( 'Invalid plugin page.' ) ); 263 } 264 265 if ( ! ( file_exists( WP_PLUGIN_DIR . "/$plugin_page" ) && is_file( WP_PLUGIN_DIR . "/$plugin_page" ) ) 266 && ! ( file_exists( WPMU_PLUGIN_DIR . "/$plugin_page" ) && is_file( WPMU_PLUGIN_DIR . "/$plugin_page" ) ) 267 ) { 268 /* translators: %s: Admin page generated by a plugin. */ 269 wp_die( sprintf( __( 'Cannot load %s.' ), htmlentities( $plugin_page ) ) ); 270 } 271 272 /** 273 * Fires before a particular screen is loaded. 274 * 275 * The load-* hook fires in a number of contexts. This hook is for plugin screens 276 * where the file to load is directly included, rather than the use of a function. 277 * 278 * The dynamic portion of the hook name, `$plugin_page`, refers to the plugin basename. 279 * 280 * @see plugin_basename() 281 * 282 * @since 1.5.0 283 */ 284 do_action( "load-{$plugin_page}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 285 286 if ( ! isset( $_GET['noheader'] ) ) { 287 require_once ABSPATH . 'wp-admin/admin-header.php'; 288 } 289 290 if ( file_exists( WPMU_PLUGIN_DIR . "/$plugin_page" ) ) { 291 include WPMU_PLUGIN_DIR . "/$plugin_page"; 292 } else { 293 include WP_PLUGIN_DIR . "/$plugin_page"; 294 } 295 } 296 297 require_once ABSPATH . 'wp-admin/admin-footer.php'; 298 299 exit; 300 } elseif ( isset( $_GET['import'] ) ) { 301 302 $importer = $_GET['import']; 303 304 if ( ! current_user_can( 'import' ) ) { 305 wp_die( __( 'Sorry, you are not allowed to import content into this site.' ) ); 306 } 307 308 if ( validate_file( $importer ) ) { 309 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) ); 310 exit; 311 } 312 313 if ( ! isset( $wp_importers[ $importer ] ) || ! is_callable( $wp_importers[ $importer ][2] ) ) { 314 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) ); 315 exit; 316 } 317 318 /** 319 * Fires before an importer screen is loaded. 320 * 321 * The dynamic portion of the hook name, `$importer`, refers to the importer slug. 322 * 323 * Possible hook names include: 324 * 325 * - `load-importer-blogger` 326 * - `load-importer-wpcat2tag` 327 * - `load-importer-livejournal` 328 * - `load-importer-mt` 329 * - `load-importer-rss` 330 * - `load-importer-tumblr` 331 * - `load-importer-wordpress` 332 * 333 * @since 3.5.0 334 */ 335 do_action( "load-importer-{$importer}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 336 337 // Used in the HTML title tag. 338 $title = __( 'Import' ); 339 $parent_file = 'tools.php'; 340 $submenu_file = 'import.php'; 341 342 if ( ! isset( $_GET['noheader'] ) ) { 343 require_once ABSPATH . 'wp-admin/admin-header.php'; 344 } 345 346 require_once ABSPATH . 'wp-admin/includes/upgrade.php'; 347 348 define( 'WP_IMPORTING', true ); 349 350 /** 351 * Filters whether to filter imported data through kses on import. 352 * 353 * Multisite uses this hook to filter all data through kses by default, 354 * as a super administrator may be assisting an untrusted user. 355 * 356 * @since 3.1.0 357 * 358 * @param bool $force Whether to force data to be filtered through kses. Default false. 359 */ 360 if ( apply_filters( 'force_filtered_html_on_import', false ) ) { 361 kses_init_filters(); // Always filter imported data with kses on multisite. 362 } 363 364 call_user_func( $wp_importers[ $importer ][2] ); 365 366 require_once ABSPATH . 'wp-admin/admin-footer.php'; 367 368 // Make sure rules are flushed. 369 flush_rewrite_rules( false ); 370 371 exit; 372 } else { 373 /** 374 * Fires before a particular screen is loaded. 375 * 376 * The load-* hook fires in a number of contexts. This hook is for core screens. 377 * 378 * The dynamic portion of the hook name, `$pagenow`, is a global variable 379 * referring to the filename of the current screen, such as 'admin.php', 380 * 'post-new.php' etc. A complete hook for the latter would be 381 * 'load-post-new.php'. 382 * 383 * @since 2.1.0 384 */ 385 do_action( "load-{$pagenow}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 386 387 /* 388 * The following hooks are fired to ensure backward compatibility. 389 * In all other cases, 'load-' . $pagenow should be used instead. 390 */ 391 if ( 'page' === $typenow ) { 392 if ( 'post-new.php' === $pagenow ) { 393 do_action( 'load-page-new.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 394 } elseif ( 'post.php' === $pagenow ) { 395 do_action( 'load-page.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 396 } 397 } elseif ( 'edit-tags.php' === $pagenow ) { 398 if ( 'category' === $taxnow ) { 399 do_action( 'load-categories.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 400 } elseif ( 'link_category' === $taxnow ) { 401 do_action( 'load-edit-link-categories.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 402 } 403 } elseif ( 'term.php' === $pagenow ) { 404 do_action( 'load-edit-tags.php' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 405 } 406 } 407 408 if ( ! empty( $_REQUEST['action'] ) ) { 409 $action = $_REQUEST['action']; 410 411 /** 412 * Fires when an 'action' request variable is sent. 413 * 414 * The dynamic portion of the hook name, `$action`, refers to 415 * the action derived from the `GET` or `POST` request. 416 * 417 * @since 2.6.0 418 */ 419 do_action( "admin_action_{$action}" ); 420 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
Generated : Thu Nov 21 08:20:01 2024 | Cross-referenced by PHPXref |