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();
66 // If 50 or fewer sites, run every time. Else, run "about ten percent" of the time. Shh, don't check that math.
67 if ( $c <= 50 || ( $c > 50 && mt_rand( 0, (int)( $c / 50 ) ) == 1 ) ) {
68 require_once( ABSPATH . WPINC . '/http.php' );
69 $response = wp_remote_get( admin_url( 'upgrade.php?step=1' ), array( 'timeout' => 120, 'httpversion' => '1.1' ) );
70 /** This action is documented in wp-admin/network/upgrade.php */
71 do_action( 'after_mu_upgrade', $response );
78 require_once(ABSPATH . 'wp-admin/includes/admin.php');
82 // Schedule trash collection
83 if ( !wp_next_scheduled('wp_scheduled_delete') && !defined('WP_INSTALLING') )
84 wp_schedule_event(time(), 'daily', 'wp_scheduled_delete');
88 $date_format = get_option('date_format');
89 $time_format = get_option('time_format');
91 wp_enqueue_script( 'common' );
95 if ( isset($_GET['page']) ) {
96 $plugin_page = wp_unslash( $_GET['page'] );
97 $plugin_page = plugin_basename($plugin_page);
100 if ( isset( $_REQUEST['post_type'] ) && post_type_exists( $_REQUEST['post_type'] ) )
101 $typenow = $_REQUEST['post_type'];
105 if ( isset( $_REQUEST['taxonomy'] ) && taxonomy_exists( $_REQUEST['taxonomy'] ) )
106 $taxnow = $_REQUEST['taxonomy'];
110 if ( WP_NETWORK_ADMIN )
111 require(ABSPATH . 'wp-admin/network/menu.php');
112 elseif ( WP_USER_ADMIN )
113 require(ABSPATH . 'wp-admin/user/menu.php');
115 require(ABSPATH . 'wp-admin/menu.php');
117 if ( current_user_can( 'manage_options' ) ) {
119 * Filter the maximum memory limit available for administration screens.
121 * This only applies to administrators, who may require more memory for tasks like updates.
122 * Memory limits when processing images (uploaded or edited by users of any role) are
123 * handled separately.
125 * The WP_MAX_MEMORY_LIMIT constant specifically defines the maximum memory limit available
126 * when in the administration back-end. The default is 256M, or 256 megabytes of memory.
130 * @param string 'WP_MAX_MEMORY_LIMIT' The maximum WordPress memory limit. Default 256M.
132 @ini_set( 'memory_limit', apply_filters( 'admin_memory_limit', WP_MAX_MEMORY_LIMIT ) );
136 * Fires as an admin screen or script is being initialized.
138 * Note, this does not just run on user-facing admin screens.
139 * It runs on admin-ajax.php and admin-post.php as well.
141 * This is roughly analgous to the more general 'init' hook, which fires earlier.
145 do_action( 'admin_init' );
147 if ( isset($plugin_page) ) {
148 if ( !empty($typenow) )
149 $the_parent = $pagenow . '?post_type=' . $typenow;
151 $the_parent = $pagenow;
152 if ( ! $page_hook = get_plugin_page_hook($plugin_page, $the_parent) ) {
153 $page_hook = get_plugin_page_hook($plugin_page, $plugin_page);
155 // Backwards compatibility for plugins using add_management_page().
156 if ( empty( $page_hook ) && 'edit.php' == $pagenow && '' != get_plugin_page_hook($plugin_page, 'tools.php') ) {
157 // There could be plugin specific params on the URL, so we need the whole query string
158 if ( !empty($_SERVER[ 'QUERY_STRING' ]) )
159 $query_string = $_SERVER[ 'QUERY_STRING' ];
161 $query_string = 'page=' . $plugin_page;
162 wp_redirect( admin_url('tools.php?' . $query_string) );
170 if ( isset($page_hook) )
171 $hook_suffix = $page_hook;
172 else if ( isset($plugin_page) )
173 $hook_suffix = $plugin_page;
174 else if ( isset($pagenow) )
175 $hook_suffix = $pagenow;
177 set_current_screen();
179 // Handle plugin admin pages.
180 if ( isset($plugin_page) ) {
183 * Fires before a particular screen is loaded.
185 * The load-* hook fires in a number of contexts. This hook is for plugin screens
186 * where a callback is provided when the screen is registered.
188 * The dynamic portion of the hook name, $page_hook, refers to a mixture of plugin
189 * page information including:
190 * 1. The page type. If the plugin page is registered as a submenu page, such as for
191 * Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'.
192 * 2. A separator of '_page_'.
193 * 3. The plugin basename minus the file extension.
195 * Together, the three parts form the $page_hook. Citing the example above,
196 * the hook name used would be 'load-settings_page_pluginbasename'.
198 * @see get_plugin_page_hook()
202 do_action( 'load-' . $page_hook );
203 if (! isset($_GET['noheader']))
204 require_once(ABSPATH . 'wp-admin/admin-header.php');
207 * Used to call the registered callback for a plugin screen.
212 do_action( $page_hook );
214 if ( validate_file($plugin_page) )
215 wp_die(__('Invalid plugin page'));
217 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") ) )
218 wp_die(sprintf(__('Cannot load %s.'), htmlentities($plugin_page)));
221 * Fires before a particular screen is loaded.
223 * The load-* hook fires in a number of contexts. This hook is for plugin screens
224 * where the file to load is directly included, rather than the use of a function.
226 * The dynamic portion of the hook name, $plugin_page, refers to the plugin basename.
228 * @see plugin_basename()
232 do_action( 'load-' . $plugin_page );
234 if ( !isset($_GET['noheader']))
235 require_once(ABSPATH . 'wp-admin/admin-header.php');
237 if ( file_exists(WPMU_PLUGIN_DIR . "/$plugin_page") )
238 include(WPMU_PLUGIN_DIR . "/$plugin_page");
240 include(WP_PLUGIN_DIR . "/$plugin_page");
243 include(ABSPATH . 'wp-admin/admin-footer.php');
246 } else if (isset($_GET['import'])) {
248 $importer = $_GET['import'];
250 if ( ! current_user_can('import') )
251 wp_die(__('You are not allowed to import.'));
253 if ( validate_file($importer) ) {
254 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) );
258 if ( ! isset($wp_importers[$importer]) || ! is_callable($wp_importers[$importer][2]) ) {
259 wp_redirect( admin_url( 'import.php?invalid=' . $importer ) );
264 * Fires before an importer screen is loaded.
266 * The dynamic portion of the hook name, $importer, refers to the importer slug.
270 do_action( 'load-importer-' . $importer );
272 $parent_file = 'tools.php';
273 $submenu_file = 'import.php';
274 $title = __('Import');
276 if (! isset($_GET['noheader']))
277 require_once(ABSPATH . 'wp-admin/admin-header.php');
279 require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
281 define('WP_IMPORTING', true);
284 * Whether to filter imported data through kses on import.
286 * Multisite uses this hook to filter all data through kses by default,
287 * as a super administrator may be assisting an untrusted user.
291 * @param bool false Whether to force data to be filtered through kses. Default false.
293 if ( apply_filters( 'force_filtered_html_on_import', false ) ) {
294 kses_init_filters(); // Always filter imported data with kses on multisite.
297 call_user_func($wp_importers[$importer][2]);
299 include(ABSPATH . 'wp-admin/admin-footer.php');
301 // Make sure rules are flushed
302 flush_rewrite_rules(false);
307 * Fires before a particular screen is loaded.
309 * The load-* hook fires in a number of contexts. This hook is for core screens.
311 * The dynamic portion of the hook name, $pagenow, is a global variable
312 * referring to the filename of the current page, such as 'admin.php',
313 * 'post-new.php' etc. A complete hook for the latter would be
314 * 'load-post-new.php'.
318 do_action( 'load-' . $pagenow );
321 * The following hooks are fired to ensure backward compatibility.
322 * In all other cases, 'load-' . $pagenow should be used instead.
324 if ( $typenow == 'page' ) {
325 if ( $pagenow == 'post-new.php' )
326 do_action( 'load-page-new.php' );
327 elseif ( $pagenow == 'post.php' )
328 do_action( 'load-page.php' );
329 } elseif ( $pagenow == 'edit-tags.php' ) {
330 if ( $taxnow == 'category' )
331 do_action( 'load-categories.php' );
332 elseif ( $taxnow == 'link_category' )
333 do_action( 'load-edit-link-categories.php' );
337 if ( ! empty( $_REQUEST['action'] ) ) {
339 * Fires when an 'action' request variable is sent.
341 * The dynamic portion of the hook name, $_REQUEST['action'],
342 * refers to the action derived from the GET or POST request.
346 do_action( 'admin_action_' . $_REQUEST['action'] );