Ticket #25586: 25586.7.diff

src/wp-admin/my-sites.php

@@ -68 +68 @@
 <form id="myblogs" action="" method="post">
         <?php
         choose_primary_blog();
+        /**
+         * Fires after displaying the Choose Primary Site drop-down.
+         *
+         * @since 3.0.0
+         */
         do_action( 'myblogs_allblogs_options' );
         ?>
         <br clear="all" />
         <table class="widefat fixed">
         <?php
+        /**
+         * Enable the Global Settings section on the My Sites screen.
+         *
+         * By default, the Global Settings section is hidden. Passing a non-empty
+         * string to this filter will enable the section, and allow new settings
+         * to be added, either globally or for specific sites.
+         *
+         * @since MU
+         *
+         * @param string $settings_html The settings HTML markup. Default empty.
+         * @param object $context       Context of the setting (global or site-specific). Default 'global'.
+         */
         $settings_html = apply_filters( 'myblogs_options', '', 'global' );
         if ( $settings_html != '' ) {
                 echo '<tr><td valign="top"><h3>' . __( 'Global Settings' ) . '</h3></td><td>';
@@ -102 +119 @@
                         $s = $i == 3 ? '' : 'border-right: 1px solid #ccc;';
                         echo "<td valign='top' style='$s'>";
                         echo "<h3>{$user_blog->blogname}</h3>";
+                        /**
+                         * Filter the displayed links for each site.
+                         *
+                         * @since MU
+                         *
+                         * @param string $string    The HTML link markup.
+                         * @param object $user_blog An object containing the site data.
+                         */
                         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>";
+                        /** This filter is documented in wp-admin/my-sites.php */
                         echo apply_filters( 'myblogs_options', '', $user_blog );
                         echo "</td>";
                         $i++;