*
* @since 2.3.2
*/
-if ( ! defined('WP_ADMIN') )
- define('WP_ADMIN', true);
+if ( ! defined( 'WP_ADMIN' ) ) {
+ define( 'WP_ADMIN', true );
+}
if ( ! defined('WP_NETWORK_ADMIN') )
define('WP_NETWORK_ADMIN', false);
* Filter whether to attempt to perform the multisite DB upgrade routine.
*
* In single site, the user would be redirected to wp-admin/upgrade.php.
- * In multisite, it is automatically fired, but only when this filter
- * returns true.
+ * In multisite, the DB upgrade routine is automatically fired, but only
+ * when this filter returns true.
*
* If the network is 50 sites or less, it will run every time. Otherwise,
* it will throttle itself to reduce load.
$the_parent = $pagenow;
if ( ! $page_hook = get_plugin_page_hook($plugin_page, $the_parent) ) {
$page_hook = get_plugin_page_hook($plugin_page, $plugin_page);
- // backwards compatibility for plugins using add_management_page
+
+ // Backwards compatibility for plugins using add_management_page().
if ( empty( $page_hook ) && 'edit.php' == $pagenow && '' != get_plugin_page_hook($plugin_page, 'tools.php') ) {
// There could be plugin specific params on the URL, so we need the whole query string
if ( !empty($_SERVER[ 'QUERY_STRING' ]) )
* The load-* hook fires in a number of contexts. This hook is for plugin screens
* where a callback is provided when the screen is registered.
*
- * The dynamic portion of the hook name, $page_hook, refers to a mixture of plugin
+ * The dynamic portion of the hook name, `$page_hook`, refers to a mixture of plugin
* page information including:
* 1. The page type. If the plugin page is registered as a submenu page, such as for
* Settings, the page type would be 'settings'. Otherwise the type is 'toplevel'.
* 2. A separator of '_page_'.
* 3. The plugin basename minus the file extension.
*
- * Together, the three parts form the $page_hook. Citing the example above,
+ * Together, the three parts form the `$page_hook`. Citing the example above,
* the hook name used would be 'load-settings_page_pluginbasename'.
*
* @see get_plugin_page_hook()
/**
* Used to call the registered callback for a plugin screen.
*
- * @access private
- *
+ * @internal
* @since 1.5.0
*/
do_action( $page_hook );
* The load-* hook fires in a number of contexts. This hook is for plugin screens
* where the file to load is directly included, rather than the use of a function.
*
- * The dynamic portion of the hook name, $plugin_page, refers to the plugin basename.
+ * The dynamic portion of the hook name, `$plugin_page`, refers to the plugin basename.
*
* @see plugin_basename()
*
/**
* Fires before an importer screen is loaded.
*
- * The dynamic portion of the hook name, $importer, refers to the importer slug.
+ * The dynamic portion of the hook name, `$importer`, refers to the importer slug.
*
* @since 3.5.0
*/
*
* @param bool false Whether to force data to be filtered through kses. Default false.
*/
- if ( apply_filters( 'force_filtered_html_on_import', false ) )
+ if ( apply_filters( 'force_filtered_html_on_import', false ) ) {
kses_init_filters(); // Always filter imported data with kses on multisite.
+ }
call_user_func($wp_importers[$importer][2]);
*
* The load-* hook fires in a number of contexts. This hook is for core screens.
*
- * The dynamic portion of the hook name, $pagenow, is a global variable
+ * The dynamic portion of the hook name, `$pagenow`, is a global variable
* referring to the filename of the current page, such as 'admin.php',
- * 'post-new.php' etc. A complete hook for the latter would be 'load-post-new.php'.
+ * 'post-new.php' etc. A complete hook for the latter would be
+ * 'load-post-new.php'.
*
* @since 2.1.0
*/
do_action( 'load-' . $pagenow );
- // Backwards compatibility with old load-page-new.php, load-page.php,
- // and load-categories.php actions.
+
+ /*
+ * The following hooks are fired to ensure backward compatibility.
+ * In all other cases, 'load-' . $pagenow should be used instead.
+ */
if ( $typenow == 'page' ) {
if ( $pagenow == 'post-new.php' )
do_action( 'load-page-new.php' );
/**
* Fires when an 'action' request variable is sent.
*
- * The dynamic portion of the hook name, $_REQUEST['action'],
- * refers to the action derived from the GET or POST request.
+ * The dynamic portion of the hook name, `$_REQUEST['action']`,
+ * refers to the action derived from the `GET` or `POST` request.
*
* @since 2.6.0
*/