Ticket #25586: wp-sites.diff

src/wp-admin/my-sites.php

@@ -67 +67 @@
 ?>
 <form id="myblogs" action="" method="post">
         <?php
-        choose_primary_blog();
+        choose_primary_blog();  
+        /** 
+         * Fires after displays the selectbox for choose primary blog.
+         * @since 3.0.0
+         */ 
         do_action( 'myblogs_allblogs_options' );
         ?>
         <br clear="all" />
         <table class="widefat fixed">
         <?php
+        /**
+         * Filter the myblogs options.
+         * 
+         * @since MU
+         * 
+         * @param string none     Blank.
+         * @param string 'global' The text "global".
+        */
         $settings_html = apply_filters( 'myblogs_options', '', 'global' );
         if ( $settings_html != '' ) {
                 echo '<tr><td valign="top"><h3>' . __( 'Global Settings' ) . '</h3></td><td>';
@@ -102 +114 @@
                         $s = $i == 3 ? '' : 'border-right: 1px solid #ccc;';
                         echo "<td valign='top' style='$s'>";
                         echo "<h3>{$user_blog->blogname}</h3>";
-                        echo "<p>" . apply_filters( 'myblogs_blog_actions', "<a href='" . esc_url( get_home_url( $user_blog->userblog_id ) ). "'>" . __( 'Visit' ) . "</a> | <a href='" . esc_url( get_admin_url( $user_blog->userblog_id ) ) . "'>" . __( 'Dashboard' ) . "</a>", $user_blog ) . "</p>";
+                        $blog_actions = "<a href='" . esc_url( get_home_url( $user_blog->userblog_id ) ). "'>" . __( 'Visit' ) . "</a> | <a href='" . esc_url( get_admin_url( $user_blog->userblog_id ) ) . "'>" . __( 'Dashboard' ) . "</a>";
+                        /**
+                         * Filter myblogs blog actions
+                         * 
+                         * @since MU
+                         * 
+                         * @param string $blog_actions The links of blog actions.
+                         * @param object $user_blog    An object of user's blog.
+                        */
+                        echo "<p>" . apply_filters( 'myblogs_blog_actions', $blog_actions, $user_blog ) . "</p>";                                               
+                        /**
+                         * Filter the myblogs options.
+                         * 
+                         * @since MU
+                         * 
+                         * @param string none       Blank.
+                         * @param object $user_blog An object of user's blog.
+                        */
                         echo apply_filters( 'myblogs_options', '', $user_blog );
                         echo "</td>";
                         $i++;