3 * WordPress Administration Bootstrap
6 * @subpackage Administration
10 * In WordPress Administration Screens
14 if ( ! defined( 'WP_ADMIN' ) ) {
15 define( 'WP_ADMIN', true );
18 if ( ! defined('WP_NETWORK_ADMIN') )
19 define('WP_NETWORK_ADMIN', false);
21 if ( ! defined('WP_USER_ADMIN') )
22 define('WP_USER_ADMIN', false);
24 if ( ! WP_NETWORK_ADMIN && ! WP_USER_ADMIN ) {
25 define('WP_BLOG_ADMIN', true);
28 if ( isset($_GET['import']) && !defined('WP_LOAD_IMPORTERS') )
29 define('WP_LOAD_IMPORTERS', true);
31 require_once(dirname(dirname(__FILE__)) . '/wp-load.php');
35 if ( get_option('db_upgraded') ) {
36 flush_rewrite_rules();
37 update_option( 'db_upgraded', false );
40 * Fires on the next page load after a successful DB upgrade.
44 do_action( 'after_db_upgrade' );
45 } elseif ( get_option('db_version') != $wp_db_version && empty($_POST) ) {
46 if ( !is_multisite() ) {
47 wp_redirect( admin_url( 'upgrade.php?_wp_http_referer=' . urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) );
51 * Filter whether to attempt to perform the multisite DB upgrade routine.
53 * In single site, the user would be redirected to wp-admin/upgrade.php.
54 * In multisite, the DB upgrade routine is automatically fired, but only
55 * when this filter returns true.
57 * If the network is 50 sites or less, it will run every time. Otherwise,
58 * it will throttle itself to reduce load.
62 * @param bool true Whether to perform the Multisite upgrade routine. Default true.
64 } elseif ( apply_filters( 'do_mu_upgrade', true ) ) {
65 $c = get_blog_count();
68 * If there are 50 or fewer sites, run every time. Otherwise, throttle to reduce load:
69 * attempt to do no more than threshold value, with some +/- allowed.
71 if ( $c <= 50 || ( $c > 50 && mt_rand( 0, (int)( $c / 50 ) ) == 1 ) ) {
72 require_once( ABSPATH . WPINC . '/http.php' );
73 $response = wp_remote_get( admin_url( 'upgrade.php?step=1' ), array( 'timeout' => 120, 'httpversion' => '1.1' ) );
74 /** This action is documented in wp-admin/network/upgrade.php */
75 do_action( 'after_mu_upgrade', $response );
82 require_once(ABSPATH . 'wp-admin/includes/admin.php');
86 // Schedule trash collection
87 if ( !wp_next_scheduled('wp_scheduled_delete') && !defined('WP_INSTALLING') )
88 wp_schedule_event(time(), 'daily', 'wp_scheduled_delete');
92 $date_format = get_option('date_format');
93 $time_format = get_option('time_format');
95 wp_enqueue_script( 'common' );
97 // $pagenow is set in vars.php
98 // $wp_importers is sometimes set in wp-admin/includes/import.php
100 // The remaining variables are imported as globals elsewhere,
101 // declared as globals here
102 global $pagenow, $wp_importers, $hook_suffix, $plugin_page, $typenow, $taxnow;
108 if ( isset($_GET['page']) ) {
109 $plugin_page = wp_unslash( $_GET['page'] );
110 $plugin_page = plugin_basename($plugin_page);
113 if ( isset( $_REQUEST['post_type'] ) && post_type_exists( $_REQUEST['post_type'] ) )
114 $typenow = $_REQUEST['post_type'];
118 if ( isset( $_REQUEST['taxonomy'] ) && taxonomy_exists( $_REQUEST['taxonomy'] ) )
119 $taxnow = $_REQUEST['taxonomy'];
123 if ( WP_NETWORK_ADMIN )
124 require(ABSPATH . 'wp-admin/network/menu.php');
125 elseif ( WP_USER_ADMIN )
126 require(ABSPATH . 'wp-admin/user/menu.php');
128 require(ABSPATH . 'wp-admin/menu.php');
130 if ( current_user_can( 'manage_options' ) ) {
132 * Filter the maximum memory limit available for administration screens.
134 * This only applies to administrators, who may require more memory for tasks like updates.
135 * Memory limits when processing images (uploaded or edited by users of any role) are
136 * handled separately.
138 * The WP_MAX_MEMORY_LIMIT constant specifically defines the maximum memory limit available
139 * when in the administration back-end. The default is 256M, or 256 megabytes of memory.
143 * @param string 'WP_MAX_MEMORY_LIMIT' The maximum WordPress memory limit. Default 256M.
145 @ini_set( 'memory_limit', apply_filters( 'admin_memory_limit', WP_MAX_MEMORY_LIMIT ) );
149 * Fires as an admin screen or script is being initialized.
151 * Note, this does not just run on user-facing admin screens.
152 * It runs on admin-ajax.php and admin-post.php as well.
154 * This is roughly analgous to the more general 'init' hook, which fires earlier.
158 do_action( 'admin_init' );
160 if ( isset($plugin_page) ) {
161 if ( !empty($typenow) )
162 $the_parent = $pagenow . '?post_type=' . $typenow;
164 $the_parent = $pagenow;
165 if ( ! $page_hook = get_plugin_page_hook($plugin_page, $the_parent) ) {
166 $page_hook = get_plugin_page_hook($plugin_page, $plugin_page);
168 // Backwards compatibility for plugins using add_management_page().
169 if ( empty( $page_hook ) && 'edit.php' == $pagenow && '' != get_plugin_page_hook($plugin_page, 'tools.php') ) {
170 // There could be plugin specific params on the URL, so we need the whole query string
171 if ( !empty($_SERVER[ 'QUERY_STRING' ]) )
172 $query_string = $_SERVER[ 'QUERY_STRING' ];
174 $query_string = 'page=' . $plugin_page;
175 wp_redirect( admin_url('tools.php?' . $query_string) );
183 if ( isset( $page_hook ) ) {
184 $hook_suffix = $page_hook;
185 } elseif ( isset( $plugin_page ) ) {
186 $hook_suffix = $plugin_page;
187 } elseif ( isset( $pagenow ) ) {
188 $hook_suffix = $pagenow;
191 set_current_screen();
193 // Handle plugin admin pages.
194 if ( isset($plugin_page) ) {
197 * Fires before a particular screen is loaded.
199 * The load-* hook fires in a number of contexts. This hook is for plugin screens
200 * where a callback is provided when the screen is registered.
202 * The dynamic portion of the hook name, `$page_hook`, refers to a mixture of plugin
203 * page information including:
204 * 1. The page type. If the plugin page is registered as a submenu page, such as for
205 * Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'.
206 * 2. A separator of '_page_'.
207 * 3. The plugin basename minus the file extension.
209 * Together, the three parts form the `$page_hook`. Citing the example above,
210 * the hook name used would be 'load-settings_page_pluginbasename'.
212 * @see get_plugin_page_hook()
216 do_action( 'load-' . $page_hook );
217 if (! isset($_GET['noheader']))
218 require_once(ABSPATH . 'wp-admin/admin-header.php');
221 * Used to call the registered callback for a plugin screen.
226 do_action( $page_hook );
228 if ( validate_file($plugin_page) )
229 wp_die(__('Invalid plugin page'));
231 if ( !( file_exists(WP_PLUGIN_DIR . "/$plugin_page") && is_file(WP_PLUGIN_DIR . "/$plugin_page") ) && !( file_exists(WPMU_PLUGIN_DIR . "/$plugin_page") && is_file(WPMU_PLUGIN_DIR . "/$plugin_page") ) )
232 wp_die(sprintf(__('Cannot load %s.'), htmlentities($plugin_page)));
235 * Fires before a particular screen is loaded.
237 * The load-* hook fires in a number of contexts. This hook is for plugin screens
238 * where the file to load is directly included, rather than the use of a function.
240 * The dynamic portion of the hook name, `$plugin_page`, refers to the plugin basename.
242 * @see plugin_basename()
246 do_action( 'load-' . $plugin_page );
248 if ( !isset($_GET['noheader']))
249 require_once(ABSPATH . 'wp-admin/admin-header.php');
251 if ( file_exists(WPMU_PLUGIN_DIR . "/$plugin_page") )
252 include(WPMU_PLUGIN_DIR . "/$plugin_page");
254 include(WP_PLUGIN_DIR . "/$plugin_page");
257 include(ABSPATH . 'wp-admin/admin-footer.php');
260 } elseif ( isset( $_GET['import'] ) ) {
262 $importer = $_GET['import'];
264 if ( ! current_user_can('import') )
265 wp_die(__('You are not allowed to import.'));
267 if ( validate_file($importer) ) {
268 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) );
272 if ( ! isset($wp_importers[$importer]) || ! is_callable($wp_importers[$importer][2]) ) {
273 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) );
278 * Fires before an importer screen is loaded.
280 * The dynamic portion of the hook name, `$importer`, refers to the importer slug.
284 do_action( 'load-importer-' . $importer );
286 $parent_file = 'tools.php';
287 $submenu_file = 'import.php';
288 $title = __('Import');
290 if (! isset($_GET['noheader']))
291 require_once(ABSPATH . 'wp-admin/admin-header.php');
293 require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
295 define('WP_IMPORTING', true);
298 * Whether to filter imported data through kses on import.
300 * Multisite uses this hook to filter all data through kses by default,
301 * as a super administrator may be assisting an untrusted user.
305 * @param bool false Whether to force data to be filtered through kses. Default false.
307 if ( apply_filters( 'force_filtered_html_on_import', false ) ) {
308 kses_init_filters(); // Always filter imported data with kses on multisite.
311 call_user_func($wp_importers[$importer][2]);
313 include(ABSPATH . 'wp-admin/admin-footer.php');
315 // Make sure rules are flushed
316 flush_rewrite_rules(false);
321 * Fires before a particular screen is loaded.
323 * The load-* hook fires in a number of contexts. This hook is for core screens.
325 * The dynamic portion of the hook name, `$pagenow`, is a global variable
326 * referring to the filename of the current page, such as 'admin.php',
327 * 'post-new.php' etc. A complete hook for the latter would be
328 * 'load-post-new.php'.
332 do_action( 'load-' . $pagenow );
335 * The following hooks are fired to ensure backward compatibility.
336 * In all other cases, 'load-' . $pagenow should be used instead.
338 if ( $typenow == 'page' ) {
339 if ( $pagenow == 'post-new.php' )
340 do_action( 'load-page-new.php' );
341 elseif ( $pagenow == 'post.php' )
342 do_action( 'load-page.php' );
343 } elseif ( $pagenow == 'edit-tags.php' ) {
344 if ( $taxnow == 'category' )
345 do_action( 'load-categories.php' );
346 elseif ( $taxnow == 'link_category' )
347 do_action( 'load-edit-link-categories.php' );
351 if ( ! empty( $_REQUEST['action'] ) ) {
353 * Fires when an 'action' request variable is sent.
355 * The dynamic portion of the hook name, `$_REQUEST['action']`,
356 * refers to the action derived from the `GET` or `POST` request.
360 do_action( 'admin_action_' . $_REQUEST['action'] );