[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/ -> admin.php (source)

   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  }


Generated : Tue Oct 27 08:20:35 2026 Cross-referenced by PHPXref