Changeset 28393 for trunk/src/wp-admin/admin.php

Timestamp:

05/13/2014 06:27:11 AM (12 years ago)

Author:

DrewAPicture

Message:

Clarify inline documentation for back-compat load-* action hooks.

See #26869.

File:

• trunk/src/wp-admin/admin.php (modified) (2 diffs)

trunk/src/wp-admin/admin.php

@@ -289 +289 @@
          * @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]);
@@ -308 +309 @@
          * 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' )