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