W3cubDocs

/WordPress

choose_primary_blog()

Handles the display of choosing a user’s primary site.

Description

This displays the user’s primary site and allows the user to choose which site is primary.

Source

File: wp-admin/includes/ms.php 

function choose_primary_blog() {
	?>
	<table class="form-table" role="presentation">
	<tr>
	<?php /* translators: My Sites label. */ ?>
		<th scope="row"><label for="primary_blog"><?php _e( 'Primary Site' ); ?></label></th>
		<td>
		<?php
		$all_blogs    = get_blogs_of_user( get_current_user_id() );
		$primary_blog = get_user_meta( get_current_user_id(), 'primary_blog', true );
		if ( count( $all_blogs ) > 1 ) {
			$found = false;
			?>
			<select name="primary_blog" id="primary_blog">
				<?php
				foreach ( (array) $all_blogs as $blog ) {
					if ( $primary_blog == $blog->userblog_id ) {
						$found = true;
					}
					?>
					<option value="<?php echo $blog->userblog_id; ?>"<?php selected( $primary_blog, $blog->userblog_id ); ?>><?php echo esc_url( get_home_url( $blog->userblog_id ) ); ?></option>
					<?php
				}
				?>
			</select>
			<?php
			if ( ! $found ) {
				$blog = reset( $all_blogs );
				update_user_meta( get_current_user_id(), 'primary_blog', $blog->userblog_id );
			}
		} elseif ( count( $all_blogs ) == 1 ) {
			$blog = reset( $all_blogs );
			echo esc_url( get_home_url( $blog->userblog_id ) );
			if ( $primary_blog != $blog->userblog_id ) { // Set the primary blog again if it's out of sync with blog list.
				update_user_meta( get_current_user_id(), 'primary_blog', $blog->userblog_id );
			}
		} else {
			echo 'N/A';
		}
		?>
		</td>
	</tr>
	</table>
	<?php
}

Uses

Uses Description
wp-includes/l10n.php: _e()

Display translated text.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/general-template.php: selected()

Outputs the HTML selected attribute.
wp-includes/link-template.php: get_home_url()

Retrieves the URL for a given site where the front end is accessible.
wp-includes/user.php: get_blogs_of_user()

Get the sites a user belongs to.
wp-includes/user.php: get_user_meta()

Retrieve user meta field for a user.
wp-includes/user.php: update_user_meta()

Update user meta field based on user ID.
wp-includes/user.php: get_current_user_id()

Get the current user’s ID

Changelog

Version Description
3.0.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/choose_primary_blog