Changeset 28393

Timestamp:

05/13/2014 06:27:11 AM (11 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' )