<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"

"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />

<title>[24993] trunk: Deprecate get_dashboard_blog().</title>

</head>

<body>

<style type="text/css"><!--

#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }

#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }

#msg dt:after { content:':';}

#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }

#msg dl a { font-weight: bold}

#msg dl a:link    { color:#fc3; }

#msg dl a:active  { color:#ff0; }

#msg dl a:visited { color:#cc6; }

h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }

#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }

#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }

#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }

#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }

#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }

#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }

#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }

#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }

#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }

#logmsg pre { background: #eee; padding: 1em; }

#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}

#logmsg dl { margin: 0; }

#logmsg dt { font-weight: bold; }

#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }

#logmsg dd:before { content:'\00bb';}

#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }

#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }

#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }

#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }

#logmsg table th.Corner { text-align: left; }

#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }

#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }

#patch { width: 100%; }

#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}

#patch .propset h4, #patch .binary h4 {margin:0;}

#patch pre {padding:0;line-height:1.2em;margin:0;}

#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}

#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}

#patch span {display:block;padding:0 10px;}

#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}

#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}

#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}

#patch .lines, .info {color:#888;background:#fff;}

--></style>

<div id="msg">

<dl class="meta">

<dt>Revision</dt> <dd><a href="http://core.trac.wordpress.org/changeset/24993">24993</a></dd>

<dt>Author</dt> <dd>ryan</dd>

<dt>Date</dt> <dd>2013-08-06 16:07:46 +0000 (Tue, 06 Aug 2013)</dd>

</dl>

<h3>Log Message</h3>

<pre>Deprecate get_dashboard_blog().

Remove contextual help for Dashboard Site from the network settings screen.

Props sillybean, ocean90

fixes <a href="http://core.trac.wordpress.org/ticket/24838">#24838</a></pre>

<h3>Modified Paths</h3>

<ul>

<li><a href="#trunkwpadminnetworksettingsphp">trunk/wp-admin/network/settings.php</a></li>

<li><a href="#trunkwpincludesmsdeprecatedphp">trunk/wp-includes/ms-deprecated.php</a></li>

<li><a href="#trunkwpincludesmsfunctionsphp">trunk/wp-includes/ms-functions.php</a></li>

</ul>

</div>

<div id="patch">

<h3>Diff</h3>

<a id="trunkwpadminnetworksettingsphp"></a>

<div class="modfile"><h4>Modified: trunk/wp-admin/network/settings.php (24992 => 24993)</h4>

<pre class="diff"><span>

<span class="info">--- trunk/wp-admin/network/settings.php      2013-08-06 16:04:07 UTC (rev 24992)

+++ trunk/wp-admin/network/settings.php 2013-08-06 16:07:46 UTC (rev 24993)

</span><span class="lines">@@ -25,7 +25,6 @@

</span><span class="cx">          'content' =>

<span class="cx">                  '' . __('This screen sets and changes options for the network as a whole. The first site is the main site in the network and network options are pulled from that original site&#8217;s options.') . '' .

<span class="cx">                  '' . __('Operational settings has fields for the network&#8217;s name and admin email.') . '' .

<del>-                       '' . __('Dashboard Site is an option to give a site to users who do not have a site on the system. Their default role is Subscriber, but that default can be changed. The Admin Notice Feed can provide a notice on all dashboards of the latest post via RSS or Atom, or provide no such notice if left blank.') . '' .

</del><span class="cx">                   '' . __('Registration settings can disable/enable public signups. If you let others sign up for a site, install spam plugins. Spaces, not commas, should separate names banned as sites for this network.') . '' .

<span class="cx">                  '' . __('New site settings are defaults applied when a new site is created in the network. These include welcome email for when a new site or user account is registered, and what&#8127;s put in the first post, page, comment, comment author, and comment URL.') . '' .

<span class="cx">                  '' . __('Upload settings control the size of the uploaded files and the amount of available upload space for each site. You can change the default value for specific sites when you edit a particular site. Allowed file types are also listed (space separated only).') . '' .

</span></span></pre></div>

<a id="trunkwpincludesmsdeprecatedphp"></a>

<div class="modfile"><h4>Modified: trunk/wp-includes/ms-deprecated.php (24992 => 24993)</h4>

<pre class="diff"><span>

<span class="info">--- trunk/wp-includes/ms-deprecated.php      2013-08-06 16:04:07 UTC (rev 24992)

+++ trunk/wp-includes/ms-deprecated.php 2013-08-06 16:07:46 UTC (rev 24993)

</span><span class="lines">@@ -14,7 +14,24 @@

</span><span class="cx">  */

</span><span class="cx"> 

</span><span class="cx"> /**

<ins>+ * Get the "dashboard blog", the blog where users without a blog edit their profile data.

+ * Dashboard blog functionality was removed in WordPress 3.1, replaced by the user admin.

+ *

</ins><span class="cx">  * @since MU

</span><ins>+ * @deprecated 3.1.0

+ * @see get_blog_details()

+ * @return int

+ */

+function get_dashboard_blog() {

+    _deprecated_function( __FUNCTION__, '3.1' );

+    if ( $blog = get_site_option( 'dashboard_blog' ) )

+        return get_blog_details( $blog );

+

+    return get_blog_details( $GLOBALS['current_site']->blog_id );

+}

+

+/**

+ * @since MU

</ins><span class="cx">  * @deprecated 3.0.0

</span><span class="cx">  * @deprecated Use wp_generate_password()

</span><span class="cx">  * @see wp_generate_password()

</span></span></pre></div>

<a id="trunkwpincludesmsfunctionsphp"></a>

<div class="modfile"><h4>Modified: trunk/wp-includes/ms-functions.php (24992 => 24993)</h4>

<pre class="diff"><span>

<span class="info">--- trunk/wp-includes/ms-functions.php       2013-08-06 16:04:07 UTC (rev 24992)

+++ trunk/wp-includes/ms-functions.php  2013-08-06 16:07:46 UTC (rev 24993)

</span><span class="lines">@@ -1738,21 +1738,6 @@

</span><span class="cx"> add_action('update_option_blog_public', 'update_blog_public', 10, 2);

</span><span class="cx"> 

</span><span class="cx"> /**

<del>- * Get the "dashboard blog", the blog where users without a blog edit their profile data.

- *

- * @since MU

- * @uses get_blog_details()

- *

- * @return int

- */

-function get_dashboard_blog() {

-       if ( $blog = get_site_option( 'dashboard_blog' ) )

-               return get_blog_details( $blog );

-

-       return get_blog_details( $GLOBALS['current_site']->blog_id );

-}

-

-/**

</del><span class="cx">  * Check whether a usermeta key has to do with the current blog.

</span><span class="cx">  *

</span><span class="cx">  * @since MU

</span></span></pre>

</div>

</div>

</body>

</html>