Ticket #25229: admin-footer.diff

wp-admin/admin-footer.php

@@ -16 +16 @@
 <div class="clear"></div></div><!-- wpcontent -->
 
 <div id="wpfooter">
-<?php do_action( 'in_admin_footer' ); ?>
-<p id="footer-left" class="alignleft"><?php
+<?php
+/**
+ * Fires immediatly after the opening div for the admin footer
+ *
+ * @since 2.5.0
+ */ 
+do_action( 'in_admin_footer' ); 
+?>
+<p id="footer-left" class="alignleft">
+<?php
+/**
+ * Replace the text displayed in the left side of the admin footer
+ * 
+ * @since unknown
+ * 
+ * @param string The content that will be printed in the left footer of the admin pages.
+ */     
 echo apply_filters( 'admin_footer_text', '<span id="footer-thankyou">' . __( 'Thank you for creating with <a href="http://wordpress.org/">WordPress</a>.' ) . '</span>' );
-?></p>
-<p id="footer-upgrade" class="alignright"><?php echo apply_filters( 'update_footer', '' ); ?></p>
+?>
+</p>
+<p id="footer-upgrade" class="alignright">
+<?php
+/**
+ * Replace the text displayed in the right side of the admin footer
+ *
+ * Need to use a priority higher than 10 in order to overwite the string passed in the function core_update_footer in wp-admin/includes/update.php.
+ * 
+ * @since unknown
+ * 
+ * @param string The content that will be printed in the right footer of the admin pages.
+ */
+echo apply_filters( 'update_footer', '' ); 
+?>
+</p>
 <div class="clear"></div>
 </div>
 <?php
+/**
+ * Prints scripts before the default footer scripts
+ * 
+ * @since unknown
+ * 
+ * @param string The script to print.
+ */
 do_action('admin_footer', '');
+
+/**
+ * Prints the default scripts followed by any external scripts that were queued for the footer
+ * 
+ * @since unknown
+ */
 do_action('admin_print_footer_scripts');
+
+/**
+ * Prints scripts that should appear on a specific admin page only
+ * 
+ * @since unknown
+ * 
+ * @param type $GLOBALS['hook_suffix'] The specific admin page the script should appear on.
+ */
 do_action("admin_footer-" . $GLOBALS['hook_suffix']);
 
 // get_site_option() won't exist when auto upgrading from <= 2.7