From 4a86f7028051314f6010980f38861d5a738ceb83 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Mon, 7 Oct 2013 17:18:00 +0000
Subject: [PATCH] Inline documentation for wp-admin/options-reading.php.

Props siobhyb for the initial patch.
Fixes #25430.


git-svn-id: https://develop.svn.wordpress.org/trunk@25717 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/options-reading.php | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/src/wp-admin/options-reading.php b/src/wp-admin/options-reading.php
index 3302fb5fd2..ccd919d0df 100644
--- a/src/wp-admin/options-reading.php
+++ b/src/wp-admin/options-reading.php
@@ -150,7 +150,22 @@ else :
 	<input id="blog-norobots" type="radio" name="blog_public" value="0" <?php checked('0', get_option('blog_public')); ?> />
 	<label for="blog-norobots"><?php _e( 'Discourage search engines from indexing this site' ); ?></label>
 	<p class="description"><?php _e( 'Note: Neither of these options blocks access to your site &mdash; it is up to search engines to honor your request.' ); ?></p>
-	<?php do_action('blog_privacy_selector'); ?>
+	<?php 
+	/**
+	 * Enable the legacy 'Site Visibility' privacy options.
+	 *
+	 * By default the privacy options form displays a single checkbox to 'discourage' search
+	 * engines from indexing the site. Hooking to this action serves a dual purpose:
+	 * 1. Disable the single checkbox in favor of a multiple-choice list of radio buttons.
+	 * 2. Open the door to adding additional radio button choices to the list.
+	 *
+	 * Hooking to this action also converts the 'Search Engine Visibility' heading to the more
+	 * open-ended 'Site Visibility' heading.
+	 *
+	 * @since 2.1.0
+	 */
+	do_action( 'blog_privacy_selector' );
+	?>
 <?php else : ?>
 	<label for="blog_public"><input name="blog_public" type="checkbox" id="blog_public" value="0" <?php checked( '0', get_option( 'blog_public' ) ); ?> />
 	<?php _e( 'Discourage search engines from indexing this site' ); ?></label>