WordPressを読む　37 /blog/wp-includes/author-template.php

2014/11/30 2014/12/18

1 /blog/wp-includes/author-template.php
2 関数　get_the_author()
3 関数　the_author()
4 関数　get_the_modified_author()
5 関数　the_modified_author()
6 関数　get_the_author_meta()
7 関数　the_author_meta()
8 関数　get_the_author_link()
9 関数　the_author_link()
10 関数　get_the_author_posts()
11 関数　the_author_posts()
12 関数　the_author_posts_link()
13 関数　get_author_posts_url()
14 関数　wp_list_authors()
15 関数　is_multi_author()
16 関数　__clear_multi_author_cache()

/blog/wp-includes/author-template.php

関数　get_the_author()

<?php
/**
 * Author Template functions for use in themes.
 *
 * These functions must be used within the WordPress Loop.
 *
 * @link http://codex.wordpress.org/Author_Templates
 *
 * @package WordPress
 * @subpackage Template
 */

/**
 * Retrieve the author of the current post.
 *
 * @since 1.5.0
 *
 * @uses $authordata The current author's DB object.
 * @uses apply_filters() Calls 'the_author' hook on the author display name.
 *
 * @param string $deprecated Deprecated.
 * @return string The author's display name.
 */
function get_the_author($deprecated = '') {
	global $authordata;

	if ( !empty( $deprecated ) )
		_deprecated_argument( __FUNCTION__, '2.1' );

	/**
	 * Filter the display name of the current post's author.
	 *
	 * @since 2.9.0
	 *
	 * @param string $authordata->display_name The author's display name.
	 */
	return apply_filters('the_author', is_object($authordata) ? $authordata->display_name : null);
}

<?php

/**

* Author Template functions for use in themes.

* These functions must be used within the WordPress Loop.

* @link http://codex.wordpress.org/Author_Templates

* @package WordPress

* @subpackage Template

/**

* Retrieve the author of the current post.

* @since 1.5.0

* @uses $authordata The current author's DB object.

* @uses apply_filters() Calls 'the_author' hook on the author display name.

* @param string $deprecated Deprecated.

* @return string The author's display name.

function get_the_author($deprecated = '') {

global $authordata;

if ( !empty( $deprecated ) )

_deprecated_argument( __FUNCTION__, '2.1' );

/**

* Filter the display name of the current post's author.

* @since 2.9.0

* @param string $authordata->display_name The author's display name.

return apply_filters('the_author', is_object($authordata) ? $authordata->display_name : null);

}

関数　the_author()

/**
 * Display the name of the author of the current post.
 *
 * The behavior of this function is based off of old functionality predating
 * get_the_author(). This function is not deprecated, but is designed to echo
 * the value from get_the_author() and as an result of any old theme that might
 * still use the old behavior will also pass the value from get_the_author().
 *
 * The normal, expected behavior of this function is to echo the author and not
 * return it. However, backwards compatibility has to be maintained.
 *
 * @since 0.71
 * @see get_the_author()
 * @link http://codex.wordpress.org/Template_Tags/the_author
 *
 * @param string $deprecated Deprecated.
 * @param string $deprecated_echo Deprecated. Use get_the_author(). Echo the string or return it.
 * @return string The author's display name, from get_the_author().
 */
function the_author( $deprecated = '', $deprecated_echo = true ) {
	if ( !empty( $deprecated ) )
		_deprecated_argument( __FUNCTION__, '2.1' );
	if ( $deprecated_echo !== true )
		_deprecated_argument( __FUNCTION__, '1.5', __('Use <code>get_the_author()</code> instead if you do not want the value echoed.') );
	if ( $deprecated_echo )
		echo get_the_author();
	return get_the_author();
}

/**

* Display the name of the author of the current post.

* The behavior of this function is based off of old functionality predating

* get_the_author(). This function is not deprecated, but is designed to echo

* the value from get_the_author() and as an result of any old theme that might

* still use the old behavior will also pass the value from get_the_author().

* The normal, expected behavior of this function is to echo the author and not

* return it. However, backwards compatibility has to be maintained.

* @since 0.71

* @see get_the_author()

* @link http://codex.wordpress.org/Template_Tags/the_author

* @param string $deprecated Deprecated.

* @param string $deprecated_echo Deprecated. Use get_the_author(). Echo the string or return it.

* @return string The author's display name, from get_the_author().

function the_author( $deprecated = '', $deprecated_echo = true ) {

if ( !empty( $deprecated ) )

_deprecated_argument( __FUNCTION__, '2.1' );

if ( $deprecated_echo !== true )

_deprecated_argument( __FUNCTION__, '1.5', __('Use <code>get_the_author()</code> instead if you do not want the value echoed.') );

if ( $deprecated_echo )

echo get_the_author();

return get_the_author();

}

関数　get_the_modified_author()

/**
 * Retrieve the author who last edited the current post.
 *
 * @since 2.8.0
 *
 * @uses $post The current post's DB object.
 * @uses get_post_meta() Retrieves the ID of the author who last edited the current post.
 * @uses get_userdata() Retrieves the author's DB object.
 * @uses apply_filters() Calls 'the_modified_author' hook on the author display name.
 * @return string The author's display name.
 */
function get_the_modified_author() {
	if ( $last_id = get_post_meta( get_post()->ID, '_edit_last', true) ) {
		$last_user = get_userdata($last_id);

		/**
		 * Filter the display name of the author who last edited the current post.
		 *
		 * @since 2.8.0
		 *
		 * @param string $last_user->display_name The author's display name.
		 */
		return apply_filters('the_modified_author', $last_user->display_name);
	}
}

/**

* Retrieve the author who last edited the current post.

* @since 2.8.0

* @uses $post The current post's DB object.

* @uses get_post_meta() Retrieves the ID of the author who last edited the current post.

* @uses get_userdata() Retrieves the author's DB object.

* @uses apply_filters() Calls 'the_modified_author' hook on the author display name.

* @return string The author's display name.

function get_the_modified_author() {

if ( $last_id = get_post_meta( get_post()->ID, '_edit_last', true) ) {

$last_user = get_userdata($last_id);

/**

* Filter the display name of the author who last edited the current post.

* @since 2.8.0

* @param string $last_user->display_name The author's display name.

return apply_filters('the_modified_author', $last_user->display_name);

}

関数　the_modified_author()

/**
 * Display the name of the author who last edited the current post.
 *
 * @since 2.8.0
 *
 * @see get_the_author()
 * @return string The author's display name, from get_the_modified_author().
 */
function the_modified_author() {
	echo get_the_modified_author();
}

/**

* Display the name of the author who last edited the current post.

* @since 2.8.0

* @see get_the_author()

* @return string The author's display name, from get_the_modified_author().

function the_modified_author() {

echo get_the_modified_author();

}

関数　get_the_author_meta()

/**
 * Retrieve the requested data of the author of the current post.
 * @link http://codex.wordpress.org/Template_Tags/the_author_meta
 * @since 2.8.0
 * @uses $authordata The current author's DB object (if $user_id not specified).
 * @param string $field selects the field of the users record.
 * @param int $user_id Optional. User ID.
 * @return string The author's field from the current author's DB object.
 */
function get_the_author_meta( $field = '', $user_id = false ) {
	if ( ! $user_id ) {
		global $authordata;
		$user_id = isset( $authordata->ID ) ? $authordata->ID : 0;
	} else {
		$authordata = get_userdata( $user_id );
	}

	if ( in_array( $field, array( 'login', 'pass', 'nicename', 'email', 'url', 'registered', 'activation_key', 'status' ) ) )
		$field = 'user_' . $field;

	$value = isset( $authordata->$field ) ? $authordata->$field : '';

	/**
	 * Filter the value of the requested user metadata.
	 *
	 * The filter name is dynamic and depends on the $field parameter of the function.
	 *
	 * @since 2.8.0
	 *
	 * @param string $value   The value of the metadata.
	 * @param int    $user_id The user ID.
	 */
	return apply_filters( 'get_the_author_' . $field, $value, $user_id );
}

/**

* Retrieve the requested data of the author of the current post.

* @link http://codex.wordpress.org/Template_Tags/the_author_meta

* @since 2.8.0

* @uses $authordata The current author's DB object (if $user_id not specified).

* @param string $field selects the field of the users record.

* @param int $user_id Optional. User ID.

* @return string The author's field from the current author's DB object.

function get_the_author_meta( $field = '', $user_id = false ) {

if ( ! $user_id ) {

global $authordata;

$user_id = isset( $authordata->ID ) ? $authordata->ID : 0;

} else {

$authordata = get_userdata( $user_id );

}

if ( in_array( $field, array( 'login', 'pass', 'nicename', 'email', 'url', 'registered', 'activation_key', 'status' ) ) )

$field = 'user_' . $field;

$value = isset( $authordata->$field ) ? $authordata->$field : '';

/**

* Filter the value of the requested user metadata.

* The filter name is dynamic and depends on the $field parameter of the function.

* @since 2.8.0

* @param string $value The value of the metadata.

* @param int $user_id The user ID.

return apply_filters( 'get_the_author_' . $field, $value, $user_id );

}

関数　the_author_meta()

/**
 * Retrieve the requested data of the author of the current post.
 * @link http://codex.wordpress.org/Template_Tags/the_author_meta
 * @since 2.8.0
 * @param string $field selects the field of the users record.
 * @param int $user_id Optional. User ID.
 * @echo string The author's field from the current author's DB object.
 */
function the_author_meta( $field = '', $user_id = false ) {
	$author_meta = get_the_author_meta( $field, $user_id );

	/**
	 * The value of the requested user metadata.
	 *
	 * The filter name is dynamic and depends on the $field parameter of the function.
	 *
	 * @since 2.8.0
	 *
	 * @param string $author_meta The value of the metadata.
	 * @param int    $user_id     The user ID.
	 */
	echo apply_filters( 'the_author_' . $field, $author_meta, $user_id );
}

/**

* Retrieve the requested data of the author of the current post.

* @link http://codex.wordpress.org/Template_Tags/the_author_meta

* @since 2.8.0

* @param string $field selects the field of the users record.

* @param int $user_id Optional. User ID.

* @echo string The author's field from the current author's DB object.

function the_author_meta( $field = '', $user_id = false ) {

$author_meta = get_the_author_meta( $field, $user_id );

/**

* The value of the requested user metadata.

* The filter name is dynamic and depends on the $field parameter of the function.

* @since 2.8.0

* @param string $author_meta The value of the metadata.

* @param int $user_id The user ID.

echo apply_filters( 'the_author_' . $field, $author_meta, $user_id );

}

関数　get_the_author_link()

/**
 * Retrieve either author's link or author's name.
 *
 * If the author has a home page set, return an HTML link, otherwise just return the
 * author's name.
 *
 * @uses get_the_author_meta()
 * @uses get_the_author()
 */
function get_the_author_link() {
	if ( get_the_author_meta('url') ) {
		return '<a href="' . esc_url( get_the_author_meta('url') ) . '" title="' . esc_attr( sprintf(__("Visit %s&#8217;s website"), get_the_author()) ) . '" rel="author external">' . get_the_author() . '</a>';
	} else {
		return get_the_author();
	}
}

/**

* Retrieve either author's link or author's name.

* If the author has a home page set, return an HTML link, otherwise just return the

* author's name.

* @uses get_the_author_meta()

* @uses get_the_author()

function get_the_author_link() {

if ( get_the_author_meta('url') ) {

return '<a href="' . esc_url( get_the_author_meta('url') ) . '" title="' . esc_attr( sprintf(__("Visit %s’s website"), get_the_author()) ) . '" rel="author external">' . get_the_author() . '</a>';

} else {

return get_the_author();

}

関数　the_author_link()

/**
 * Display either author's link or author's name.
 *
 * If the author has a home page set, echo an HTML link, otherwise just echo the
 * author's name.
 *
 * @link http://codex.wordpress.org/Template_Tags/the_author_link
 *
 * @since 2.1.0
 *
 * @uses get_the_author_link()
 */
function the_author_link() {
	echo get_the_author_link();
}

/**

* Display either author's link or author's name.

* If the author has a home page set, echo an HTML link, otherwise just echo the

* author's name.

* @link http://codex.wordpress.org/Template_Tags/the_author_link

* @since 2.1.0

* @uses get_the_author_link()

function the_author_link() {

echo get_the_author_link();

}

関数　get_the_author_posts()

/**
 * Retrieve the number of posts by the author of the current post.
 *
 * @since 1.5.0
 *
 * @uses $post The current post in the Loop's DB object.
 * @uses count_user_posts()
 * @return int The number of posts by the author.
 */
function get_the_author_posts() {
	$post = get_post();
	if ( ! $post ) {
		return 0;
	}
	return count_user_posts( $post->post_author );
}

/**

* Retrieve the number of posts by the author of the current post.

* @since 1.5.0

* @uses $post The current post in the Loop's DB object.

* @uses count_user_posts()

* @return int The number of posts by the author.

function get_the_author_posts() {

$post = get_post();

if ( ! $post ) {

return 0;

}

return count_user_posts( $post->post_author );

}

関数　the_author_posts()

/**
 * Display the number of posts by the author of the current post.
 *
 * @link http://codex.wordpress.org/Template_Tags/the_author_posts
 * @since 0.71
 * @uses get_the_author_posts() Echoes returned value from function.
 */
function the_author_posts() {
	echo get_the_author_posts();
}

/**

* Display the number of posts by the author of the current post.

* @link http://codex.wordpress.org/Template_Tags/the_author_posts

* @since 0.71

* @uses get_the_author_posts() Echoes returned value from function.

function the_author_posts() {

echo get_the_author_posts();

}

関数　the_author_posts_link()

/**
 * Display an HTML link to the author page of the author of the current post.
 *
 * Does just echo get_author_posts_url() function, like the others do. The
 * reason for this, is that another function is used to help in printing the
 * link to the author's posts.
 *
 * @link http://codex.wordpress.org/Template_Tags/the_author_posts_link
 * @since 1.2.0
 * @uses $authordata The current author's DB object.
 * @uses get_author_posts_url()
 * @uses get_the_author()
 * @param string $deprecated Deprecated.
 */
function the_author_posts_link($deprecated = '') {
	if ( !empty( $deprecated ) )
		_deprecated_argument( __FUNCTION__, '2.1' );

	global $authordata;
	if ( !is_object( $authordata ) )
		return false;
	$link = sprintf(
		'<a href="%1$s" title="%2$s" rel="author">%3$s</a>',
		esc_url( get_author_posts_url( $authordata->ID, $authordata->user_nicename ) ),
		esc_attr( sprintf( __( 'Posts by %s' ), get_the_author() ) ),
		get_the_author()
	);

	/**
	 * Filter the link to the author page of the author of the current post.
	 *
	 * @since 2.9.0
	 *
	 * @param string $link HTML link.
	 */
	echo apply_filters( 'the_author_posts_link', $link );
}

/**

* Display an HTML link to the author page of the author of the current post.

* Does just echo get_author_posts_url() function, like the others do. The

* reason for this, is that another function is used to help in printing the

* link to the author's posts.

* @link http://codex.wordpress.org/Template_Tags/the_author_posts_link

* @since 1.2.0

* @uses $authordata The current author's DB object.

* @uses get_author_posts_url()

* @uses get_the_author()

* @param string $deprecated Deprecated.

function the_author_posts_link($deprecated = '') {

if ( !empty( $deprecated ) )

_deprecated_argument( __FUNCTION__, '2.1' );

global $authordata;

if ( !is_object( $authordata ) )

return false;

$link = sprintf(

'<a href="%1$s" title="%2$s" rel="author">%3$s</a>',

esc_url( get_author_posts_url( $authordata->ID, $authordata->user_nicename ) ),

esc_attr( sprintf( __( 'Posts by %s' ), get_the_author() ) ),

get_the_author()

);

/**

* Filter the link to the author page of the author of the current post.

* @since 2.9.0

* @param string $link HTML link.

echo apply_filters( 'the_author_posts_link', $link );

}

関数　get_author_posts_url()

/**
 * Retrieve the URL to the author page for the user with the ID provided.
 *
 * @since 2.1.0
 * @uses $wp_rewrite WP_Rewrite
 * @return string The URL to the author's page.
 */
function get_author_posts_url($author_id, $author_nicename = '') {
	global $wp_rewrite;
	$auth_ID = (int) $author_id;
	$link = $wp_rewrite->get_author_permastruct();

	if ( empty($link) ) {
		$file = home_url( '/' );
		$link = $file . '?author=' . $auth_ID;
	} else {
		if ( '' == $author_nicename ) {
			$user = get_userdata($author_id);
			if ( !empty($user->user_nicename) )
				$author_nicename = $user->user_nicename;
		}
		$link = str_replace('%author%', $author_nicename, $link);
		$link = home_url( user_trailingslashit( $link ) );
	}

	/**
	 * Filter the URL to the author's page.
	 *
	 * @since 2.1.0
	 *
	 * @param string $link            The URL to the author's page.
	 * @param int    $author_id       The author's id.
	 * @param string $author_nicename The author's nice name.
	 */
	$link = apply_filters( 'author_link', $link, $author_id, $author_nicename );

	return $link;
}

/**

* Retrieve the URL to the author page for the user with the ID provided.

* @since 2.1.0

* @uses $wp_rewrite WP_Rewrite

* @return string The URL to the author's page.

function get_author_posts_url($author_id, $author_nicename = '') {

global $wp_rewrite;

$auth_ID = (int) $author_id;

$link = $wp_rewrite->get_author_permastruct();

if ( empty($link) ) {

$file = home_url( '/' );

$link = $file . '?author=' . $auth_ID;

} else {

if ( '' == $author_nicename ) {

$user = get_userdata($author_id);

if ( !empty($user->user_nicename) )

$author_nicename = $user->user_nicename;

}

$link = str_replace('%author%', $author_nicename, $link);

$link = home_url( user_trailingslashit( $link ) );

}

/**

* Filter the URL to the author's page.

* @since 2.1.0

* @param string $link The URL to the author's page.

* @param int $author_id The author's id.

* @param string $author_nicename The author's nice name.

$link = apply_filters( 'author_link', $link, $author_id, $author_nicename );

return $link;

}

関数　wp_list_authors()

/**
 * List all the authors of the blog, with several options available.
 *
 * @link http://codex.wordpress.org/Template_Tags/wp_list_authors
 *
 * @since 1.2.0
 *
 * @param string|array $args {
 *     Optional. Array or string of default arguments.
 *
 *     @type string $orderby       How to sort the authors. Accepts 'nicename', 'email', 'url', 'registered',
 *                                 'user_nicename', 'user_email', 'user_url', 'user_registered', 'name',
 *                                 'display_name', 'post_count', 'ID', 'meta_value', 'user_login'. Default 'name'.
 *     @type string $order         Sorting direction for $orderby. Accepts 'ASC', 'DESC'. Default 'ASC'.
 *     @type int    $number        Maximum authors to return or display. Default empty (all authors).
 *     @type bool   $optioncount   Show the count in parenthesis next to the author's name. Default false.
 *     @type bool   $exclude_admin Whether to exclude the 'admin' account, if it exists. Default false.
 *     @type bool   $show_fullname Whether to show the author's full name. Default false.
 *     @type bool   $hide_empty    Whether to hide any authors with no posts. Default true.
 *     @type string $feed          If not empty, show a link to the author's feed and use this text as the alt
 *                                 parameter of the link. Default empty.
 *     @type string $feed_image    If not empty, show a link to the author's feed and use this image URL as
 *                                 clickable anchor. Default empty.
 *     @type string $feed_type     The feed type to link to, such as 'rss2'. Defaults to default feed type.
 *     @type bool   $echo          Whether to output the result or instead return it. Default true.
 *     @type string $style         If 'list', each author is wrapped in an `<li>` element, otherwise the authors
 *                                 will be separated by commas.
 *     @type bool   $html          Whether to list the items in HTML form or plaintext. Default true.
 *     @type string $exclude       An array, comma-, or space-separated list of author IDs to exclude. Default empty.
 *     @type string $exclude       An array, comma-, or space-separated list of author IDs to include. Default empty.
 * }
 * @return null|string The output, if echo is set to false. Otherwise null.
 */
function wp_list_authors( $args = '' ) {
	global $wpdb;

	$defaults = array(
		'orderby' => 'name', 'order' => 'ASC', 'number' => '',
		'optioncount' => false, 'exclude_admin' => true,
		'show_fullname' => false, 'hide_empty' => true,
		'feed' => '', 'feed_image' => '', 'feed_type' => '', 'echo' => true,
		'style' => 'list', 'html' => true, 'exclude' => '', 'include' => ''
	);

	$args = wp_parse_args( $args, $defaults );

	$return = '';

	$query_args = wp_array_slice_assoc( $args, array( 'orderby', 'order', 'number', 'exclude', 'include' ) );
	$query_args['fields'] = 'ids';
	$authors = get_users( $query_args );

	$author_count = array();
	foreach ( (array) $wpdb->get_results( "SELECT DISTINCT post_author, COUNT(ID) AS count FROM $wpdb->posts WHERE post_type = 'post' AND " . get_private_posts_cap_sql( 'post' ) . " GROUP BY post_author" ) as $row ) {
		$author_count[$row->post_author] = $row->count;
	}
	foreach ( $authors as $author_id ) {
		$author = get_userdata( $author_id );

		if ( $args['exclude_admin'] && 'admin' == $author->display_name ) {
			continue;
		}

		$posts = isset( $author_count[$author->ID] ) ? $author_count[$author->ID] : 0;

		if ( ! $posts && $args['hide_empty'] ) {
			continue;
		}

		if ( $args['show_fullname'] && $author->first_name && $author->last_name ) {
			$name = "$author->first_name $author->last_name";
		} else {
			$name = $author->display_name;
		}

		if ( ! $args['html'] ) {
			$return .= $name . ', ';

			continue; // No need to go further to process HTML.
		}

		if ( 'list' == $args['style'] ) {
			$return .= '<li>';
		}

		$link = '<a href="' . get_author_posts_url( $author->ID, $author->user_nicename ) . '" title="' . esc_attr( sprintf(__("Posts by %s"), $author->display_name) ) . '">' . $name . '</a>';

		if ( ! empty( $args['feed_image'] ) || ! empty( $args['feed'] ) ) {
			$link .= ' ';
			if ( empty( $args['feed_image'] ) ) {
				$link .= '(';
			}

			$link .= '<a href="' . get_author_feed_link( $author->ID, $args['feed_type'] ) . '"';

			$alt = '';
			if ( ! empty( $args['feed'] ) ) {
				$alt = ' alt="' . esc_attr( $args['feed'] ) . '"';
				$name = $args['feed'];
			}

			$link .= '>';

			if ( ! empty( $args['feed_image'] ) ) {
				$link .= '<img src="' . esc_url( $args['feed_image'] ) . '" style="border: none;"' . $alt . ' />';
			} else {
				$link .= $name;
			}

			$link .= '</a>';

			if ( empty( $args['feed_image'] ) ) {
				$link .= ')';
			}
		}

		if ( $args['optioncount'] ) {
			$link .= ' ('. $posts . ')';
		}

		$return .= $link;
		$return .= ( 'list' == $args['style'] ) ? '</li>' : ', ';
	}

	$return = rtrim( $return, ', ' );

	if ( ! $args['echo'] ) {
		return $return;
	}
	echo $return;
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

/**

* List all the authors of the blog, with several options available.

* @link http://codex.wordpress.org/Template_Tags/wp_list_authors

* @since 1.2.0

* @param string|array $args {

* Optional. Array or string of default arguments.

* @type string $orderby How to sort the authors. Accepts 'nicename', 'email', 'url', 'registered',

* 'user_nicename', 'user_email', 'user_url', 'user_registered', 'name',

* 'display_name', 'post_count', 'ID', 'meta_value', 'user_login'. Default 'name'.

* @type string $order Sorting direction for $orderby. Accepts 'ASC', 'DESC'. Default 'ASC'.

* @type int $number Maximum authors to return or display. Default empty (all authors).

* @type bool $optioncount Show the count in parenthesis next to the author's name. Default false.

* @type bool $exclude_admin Whether to exclude the 'admin' account, if it exists. Default false.

* @type bool $show_fullname Whether to show the author's full name. Default false.

* @type bool $hide_empty Whether to hide any authors with no posts. Default true.

* @type string $feed If not empty, show a link to the author's feed and use this text as the alt

* parameter of the link. Default empty.

* @type string $feed_image If not empty, show a link to the author's feed and use this image URL as

* clickable anchor. Default empty.

* @type string $feed_type The feed type to link to, such as 'rss2'. Defaults to default feed type.

* @type bool $echo Whether to output the result or instead return it. Default true.

* @type string $style If 'list', each author is wrapped in an `<li>` element, otherwise the authors

* will be separated by commas.

* @type bool $html Whether to list the items in HTML form or plaintext. Default true.

* @type string $exclude An array, comma-, or space-separated list of author IDs to exclude. Default empty.

* @type string $exclude An array, comma-, or space-separated list of author IDs to include. Default empty.

* }

* @return null|string The output, if echo is set to false. Otherwise null.

function wp_list_authors( $args = '' ) {

global $wpdb;

$defaults = array(

'orderby' => 'name', 'order' => 'ASC', 'number' => '',

'optioncount' => false, 'exclude_admin' => true,

'show_fullname' => false, 'hide_empty' => true,

'feed' => '', 'feed_image' => '', 'feed_type' => '', 'echo' => true,

'style' => 'list', 'html' => true, 'exclude' => '', 'include' => ''

);

$args = wp_parse_args( $args, $defaults );

$return = '';

$query_args = wp_array_slice_assoc( $args, array( 'orderby', 'order', 'number', 'exclude', 'include' ) );

$query_args['fields'] = 'ids';

$authors = get_users( $query_args );

$author_count = array();

foreach ( (array) $wpdb->get_results( "SELECT DISTINCT post_author, COUNT(ID) AS count FROM $wpdb->posts WHERE post_type = 'post' AND " . get_private_posts_cap_sql( 'post' ) . " GROUP BY post_author" ) as $row ) {

$author_count[$row->post_author] = $row->count;

}

foreach ( $authors as $author_id ) {

$author = get_userdata( $author_id );

if ( $args['exclude_admin'] && 'admin' == $author->display_name ) {

continue;

}

$posts = isset( $author_count[$author->ID] ) ? $author_count[$author->ID] : 0;

if ( ! $posts && $args['hide_empty'] ) {

continue;

}

if ( $args['show_fullname'] && $author->first_name && $author->last_name ) {

$name = "$author->first_name $author->last_name";

} else {

$name = $author->display_name;

}

if ( ! $args['html'] ) {

$return .= $name . ', ';

continue; // No need to go further to process HTML.

}

if ( 'list' == $args['style'] ) {

$return .= '<li>';

}

$link = '<a href="' . get_author_posts_url( $author->ID, $author->user_nicename ) . '" title="' . esc_attr( sprintf(__("Posts by %s"), $author->display_name) ) . '">' . $name . '</a>';

if ( ! empty( $args['feed_image'] ) || ! empty( $args['feed'] ) ) {

$link .= ' ';

if ( empty( $args['feed_image'] ) ) {

$link .= '(';

}

$link .= '<a href="' . get_author_feed_link( $author->ID, $args['feed_type'] ) . '"';

$alt = '';

if ( ! empty( $args['feed'] ) ) {

$alt = ' alt="' . esc_attr( $args['feed'] ) . '"';

$name = $args['feed'];

}

$link .= '>';

if ( ! empty( $args['feed_image'] ) ) {

$link .= '<img src="' . esc_url( $args['feed_image'] ) . '" style="border: none;"' . $alt . ' />';

} else {

$link .= $name;

}

$link .= '</a>';

if ( empty( $args['feed_image'] ) ) {

$link .= ')';

}

if ( $args['optioncount'] ) {

$link .= ' ('. $posts . ')';

}

$return .= $link;

$return .= ( 'list' == $args['style'] ) ? '</li>' : ', ';

}

$return = rtrim( $return, ', ' );

if ( ! $args['echo'] ) {

return $return;

}

echo $return;

}

関数　is_multi_author()

/**
 * Does this site have more than one author
 *
 * Checks to see if more than one author has published posts.
 *
 * @since 3.2.0
 * @return bool Whether or not we have more than one author
 */
function is_multi_author() {
	global $wpdb;

	if ( false === ( $is_multi_author = get_transient( 'is_multi_author' ) ) ) {
		$rows = (array) $wpdb->get_col("SELECT DISTINCT post_author FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish' LIMIT 2");
		$is_multi_author = 1 < count( $rows ) ? 1 : 0;
		set_transient( 'is_multi_author', $is_multi_author );
	}

	/**
	 * Filter whether the site has more than one author with published posts.
	 *
	 * @since 3.2.0
	 *
	 * @param bool $is_multi_author Whether $is_multi_author should evaluate as true.
	 */
	return apply_filters( 'is_multi_author', (bool) $is_multi_author );
}

/**

* Does this site have more than one author

* Checks to see if more than one author has published posts.

* @since 3.2.0

* @return bool Whether or not we have more than one author

function is_multi_author() {

global $wpdb;

if ( false === ( $is_multi_author = get_transient( 'is_multi_author' ) ) ) {

$rows = (array) $wpdb->get_col("SELECT DISTINCT post_author FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish' LIMIT 2");

$is_multi_author = 1 < count( $rows ) ? 1 : 0;

set_transient( 'is_multi_author', $is_multi_author );

}

/**

* Filter whether the site has more than one author with published posts.

* @since 3.2.0

* @param bool $is_multi_author Whether $is_multi_author should evaluate as true.

return apply_filters( 'is_multi_author', (bool) $is_multi_author );

}

関数　__clear_multi_author_cache()

/**
 * Helper function to clear the cache for number of authors.
 *
 * @private
 */
function __clear_multi_author_cache() {
	delete_transient( 'is_multi_author' );
}
add_action('transition_post_status', '__clear_multi_author_cache');

/**

* Helper function to clear the cache for number of authors.

* @private

function __clear_multi_author_cache() {

delete_transient( 'is_multi_author' );

}

add_action('transition_post_status', '__clear_multi_author_cache');

- Wordpress

: WordPressを読む　10-8　/blog/wp-includes/functions.php 8
目次1 /blog/wp-includes/functions.php 82 読 …

: WordPressを読む　68-2 /blog/wp-includes/widgets.php 2
/blog/wp-includes/widgets.php2 [crayon-6 …

: WordPressを読む　10-12　/blog/wp-includes/functions.php 12
目次1 /blog/wp-includes/functions.php 122 …

WordPressを読む　71 /blog/wp-includes/admin-bar.php

<?php
/**
 * Admin Bar
 *
 * This code handles the building and rendering of the press bar.
 */

/**
 * Instantiate the admin bar object and set it up as a global for access elsewhere.
 *
 * UNHOOKING THIS FUNCTION WILL NOT PROPERLY REMOVE THE ADMIN BAR.
 * For that, use show_admin_bar(false) or the 'show_admin_bar' filter.
 *
 * @since 3.1.0
 * @access private
 * @return bool Whether the admin bar was successfully initialized.
 */
function _wp_admin_bar_init() {
	global $wp_admin_bar;

	if ( ! is_admin_bar_showing() )
		return false;

	/* Load the admin bar class code ready for instantiation */
	require( ABSPATH . WPINC . '/class-wp-admin-bar.php' );

	/* Instantiate the admin bar */

	/**
	 * Filter the admin bar class to instantiate.
	 *
	 * @since 3.1.0
	 *
	 * @param string $wp_admin_bar_class Admin bar class to use. Default 'WP_Admin_Bar'.
	 */
	$admin_bar_class = apply_filters( 'wp_admin_bar_class', 'WP_Admin_Bar' );
	if ( class_exists( $admin_bar_class ) )
		$wp_admin_bar = new $admin_bar_class;
	else
		return false;

	$wp_admin_bar->initialize();
	$wp_admin_bar->add_menus();

	return true;
}
// Don't remove. Wrong way to disable.
add_action( 'template_redirect', '_wp_admin_bar_init', 0 );
add_action( 'admin_init', '_wp_admin_bar_init' );

/**
 * Render the admin bar to the page based on the $wp_admin_bar->menu member var.
 * This is called very late on the footer actions so that it will render after anything else being
 * added to the footer.
 *
 * It includes the action "admin_bar_menu" which should be used to hook in and
 * add new menus to the admin bar. That way you can be sure that you are adding at most optimal point,
 * right before the admin bar is rendered. This also gives you access to the $post global, among others.
 *
 * @since 3.1.0
 */
function wp_admin_bar_render() {
	global $wp_admin_bar;

	if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) )
		return false;

	/**
	 * Load all necessary admin bar items.
	 *
	 * This is the hook used to add, remove, or manipulate admin bar items.
	 *
	 * @since 3.1.0
	 *
	 * @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance, passed by reference
	 */
	do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );

	/**
	 * Fires before the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_before_admin_bar_render' );

	$wp_admin_bar->render();

	/**
	 * Fires after the admin bar is rendered.
	 *
	 * @since 3.1.0
	 */
	do_action( 'wp_after_admin_bar_render' );
}
add_action( 'wp_footer', 'wp_admin_bar_render', 1000 );
add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );

/**
 * Add the WordPress logo menu.
 *
 * @since 3.3.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_wp_menu( $wp_admin_bar ) {
	$wp_admin_bar->add_menu( array(
		'id'    => 'wp-logo',
		'title' => '<span class="ab-icon"></span>',
		'href'  => self_admin_url( 'about.php' ),
		'meta'  => array(
			'title' => __('About WordPress'),
		),
	) );

	if ( is_user_logged_in() ) {
		// Add "About WordPress" link
		$wp_admin_bar->add_menu( array(
			'parent' => 'wp-logo',
			'id'     => 'about',
			'title'  => __('About WordPress'),
			'href'  => self_admin_url( 'about.php' ),
		) );
	}

	// Add WordPress.org link
	$wp_admin_bar->add_menu( array(
		'parent'    => 'wp-logo-external',
		'id'        => 'wporg',
		'title'     => __('WordPress.org'),
		'href'      => __('https://wordpress.org/'),
	) );

	// Add codex link
	$wp_admin_bar->add_menu( array(
		'parent'    => 'wp-logo-external',
		'id'        => 'documentation',
		'title'     => __('Documentation'),
		'href'      => __('http://codex.wordpress.org/'),
	) );

	// Add forums link
	$wp_admin_bar->add_menu( array(
		'parent'    => 'wp-logo-external',
		'id'        => 'support-forums',
		'title'     => __('Support Forums'),
		'href'      => __('https://wordpress.org/support/'),
	) );

	// Add feedback link
	$wp_admin_bar->add_menu( array(
		'parent'    => 'wp-logo-external',
		'id'        => 'feedback',
		'title'     => __('Feedback'),
		'href'      => __('https://wordpress.org/support/forum/requests-and-feedback'),
	) );
}

/**
 * Add the sidebar toggle button.
 *
 * @since 3.8.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_sidebar_toggle( $wp_admin_bar ) {
	if ( is_admin() ) {
		$wp_admin_bar->add_menu( array(
			'id'    => 'menu-toggle',
			'title' => '<span class="ab-icon"></span><span class="screen-reader-text">' . __( 'Menu' ) . '</span>',
			'href'  => '#',
		) );
	}
}

/**
 * Add the "My Account" item.
 *
 * @since 3.3.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_my_account_item( $wp_admin_bar ) {
	$user_id      = get_current_user_id();
	$current_user = wp_get_current_user();
	$profile_url  = get_edit_profile_url( $user_id );

	if ( ! $user_id )
		return;

	$avatar = get_avatar( $user_id, 26 );
	$howdy  = sprintf( __('Howdy, %1$s'), $current_user->display_name );
	$class  = empty( $avatar ) ? '' : 'with-avatar';

	$wp_admin_bar->add_menu( array(
		'id'        => 'my-account',
		'parent'    => 'top-secondary',
		'title'     => $howdy . $avatar,
		'href'      => $profile_url,
		'meta'      => array(
			'class'     => $class,
			'title'     => __('My Account'),
		),
	) );
}

/**
 * Add the "My Account" submenu items.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_my_account_menu( $wp_admin_bar ) {
	$user_id      = get_current_user_id();
	$current_user = wp_get_current_user();
	$profile_url  = get_edit_profile_url( $user_id );

	if ( ! $user_id )
		return;

	$wp_admin_bar->add_group( array(
		'parent' => 'my-account',
		'id'     => 'user-actions',
	) );

	$user_info  = get_avatar( $user_id, 64 );
	$user_info .= "<span class='display-name'>{$current_user->display_name}</span>";

	if ( $current_user->display_name !== $current_user->user_login )
		$user_info .= "<span class='username'>{$current_user->user_login}</span>";

	$wp_admin_bar->add_menu( array(
		'parent' => 'user-actions',
		'id'     => 'user-info',
		'title'  => $user_info,
		'href'   => $profile_url,
		'meta'   => array(
			'tabindex' => -1,
		),
	) );
	$wp_admin_bar->add_menu( array(
		'parent' => 'user-actions',
		'id'     => 'edit-profile',
		'title'  => __( 'Edit My Profile' ),
		'href' => $profile_url,
	) );
	$wp_admin_bar->add_menu( array(
		'parent' => 'user-actions',
		'id'     => 'logout',
		'title'  => __( 'Log Out' ),
		'href'   => wp_logout_url(),
	) );
}

/**
 * Add the "Site Name" menu.
 *
 * @since 3.3.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_site_menu( $wp_admin_bar ) {
	// Don't show for logged out users.
	if ( ! is_user_logged_in() )
		return;

	// Show only when the user is a member of this site, or they're a super admin.
	if ( ! is_user_member_of_blog() && ! is_super_admin() )
		return;

	$blogname = get_bloginfo('name');

	if ( empty( $blogname ) )
		$blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );

	if ( is_network_admin() ) {
		$blogname = sprintf( __('Network Admin: %s'), esc_html( get_current_site()->site_name ) );
	} elseif ( is_user_admin() ) {
		$blogname = sprintf( __('Global Dashboard: %s'), esc_html( get_current_site()->site_name ) );
	}

	$title = wp_html_excerpt( $blogname, 40, '&hellip;' );

	$wp_admin_bar->add_menu( array(
		'id'    => 'site-name',
		'title' => $title,
		'href'  => is_admin() ? home_url( '/' ) : admin_url(),
	) );

	// Create submenu items.

	if ( is_admin() ) {
		// Add an option to visit the site.
		$wp_admin_bar->add_menu( array(
			'parent' => 'site-name',
			'id'     => 'view-site',
			'title'  => __( 'Visit Site' ),
			'href'   => home_url( '/' ),
		) );

		if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {
			$wp_admin_bar->add_menu( array(
				'parent' => 'site-name',
				'id'     => 'edit-site',
				'title'  => __( 'Edit Site' ),
				'href'   => network_admin_url( 'site-info.php?id=' . get_current_blog_id() ),
			) );
		}

	} else {
		// We're on the front end, link to the Dashboard.
		$wp_admin_bar->add_menu( array(
			'parent' => 'site-name',
			'id'     => 'dashboard',
			'title'  => __( 'Dashboard' ),
			'href'   => admin_url(),
		) );

		// Add the appearance submenu items.
		wp_admin_bar_appearance_menu( $wp_admin_bar );
	}
}

/**
 * Add the "My Sites/[Site Name]" menu and all submenus.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
	// Don't show for logged out users or single site mode.
	if ( ! is_user_logged_in() || ! is_multisite() )
		return;

	// Show only when the user has at least one site, or they're a super admin.
	if ( count( $wp_admin_bar->user->blogs ) < 1 && ! is_super_admin() )
		return;

	$wp_admin_bar->add_menu( array(
		'id'    => 'my-sites',
		'title' => __( 'My Sites' ),
		'href'  => admin_url( 'my-sites.php' ),
	) );

	if ( is_super_admin() ) {
		$wp_admin_bar->add_group( array(
			'parent' => 'my-sites',
			'id'     => 'my-sites-super-admin',
		) );

		$wp_admin_bar->add_menu( array(
			'parent' => 'my-sites-super-admin',
			'id'     => 'network-admin',
			'title'  => __('Network Admin'),
			'href'   => network_admin_url(),
		) );

		$wp_admin_bar->add_menu( array(
			'parent' => 'network-admin',
			'id'     => 'network-admin-d',
			'title'  => __( 'Dashboard' ),
			'href'   => network_admin_url(),
		) );
		$wp_admin_bar->add_menu( array(
			'parent' => 'network-admin',
			'id'     => 'network-admin-s',
			'title'  => __( 'Sites' ),
			'href'   => network_admin_url( 'sites.php' ),
		) );
		$wp_admin_bar->add_menu( array(
			'parent' => 'network-admin',
			'id'     => 'network-admin-u',
			'title'  => __( 'Users' ),
			'href'   => network_admin_url( 'users.php' ),
		) );
		$wp_admin_bar->add_menu( array(
			'parent' => 'network-admin',
			'id'     => 'network-admin-t',
			'title'  => __( 'Themes' ),
			'href'   => network_admin_url( 'themes.php' ),
		) );
		$wp_admin_bar->add_menu( array(
			'parent' => 'network-admin',
			'id'     => 'network-admin-p',
			'title'  => __( 'Plugins' ),
			'href'   => network_admin_url( 'plugins.php' ),
		) );
	}

	// Add site links
	$wp_admin_bar->add_group( array(
		'parent' => 'my-sites',
		'id'     => 'my-sites-list',
		'meta'   => array(
			'class' => is_super_admin() ? 'ab-sub-secondary' : '',
		),
	) );

	foreach ( (array) $wp_admin_bar->user->blogs as $blog ) {
		switch_to_blog( $blog->userblog_id );

		$blavatar = '<div class="blavatar"></div>';

		$blogname = empty( $blog->blogname ) ? $blog->domain : $blog->blogname;
		$menu_id  = 'blog-' . $blog->userblog_id;

		$wp_admin_bar->add_menu( array(
			'parent'    => 'my-sites-list',
			'id'        => $menu_id,
			'title'     => $blavatar . $blogname,
			'href'      => admin_url(),
		) );

		$wp_admin_bar->add_menu( array(
			'parent' => $menu_id,
			'id'     => $menu_id . '-d',
			'title'  => __( 'Dashboard' ),
			'href'   => admin_url(),
		) );

		if ( current_user_can( get_post_type_object( 'post' )->cap->create_posts ) ) {
			$wp_admin_bar->add_menu( array(
				'parent' => $menu_id,
				'id'     => $menu_id . '-n',
				'title'  => __( 'New Post' ),
				'href'   => admin_url( 'post-new.php' ),
			) );
		}

		if ( current_user_can( 'edit_posts' ) ) {
			$wp_admin_bar->add_menu( array(
				'parent' => $menu_id,
				'id'     => $menu_id . '-c',
				'title'  => __( 'Manage Comments' ),
				'href'   => admin_url( 'edit-comments.php' ),
			) );
		}

		$wp_admin_bar->add_menu( array(
			'parent' => $menu_id,
			'id'     => $menu_id . '-v',
			'title'  => __( 'Visit Site' ),
			'href'   => home_url( '/' ),
		) );

		restore_current_blog();
	}
}

/**
 * Provide a shortlink.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_shortlink_menu( $wp_admin_bar ) {
	$short = wp_get_shortlink( 0, 'query' );
	$id = 'get-shortlink';

	if ( empty( $short ) )
		return;

	$html = '<input class="shortlink-input" type="text" readonly="readonly" value="' . esc_attr( $short ) . '" />';

	$wp_admin_bar->add_menu( array(
		'id' => $id,
		'title' => __( 'Shortlink' ),
		'href' => $short,
		'meta' => array( 'html' => $html ),
	) );
}

/**
 * Provide an edit link for posts and terms.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_edit_menu( $wp_admin_bar ) {
	global $tag, $wp_the_query;

	if ( is_admin() ) {
		$current_screen = get_current_screen();
		$post = get_post();

		if ( 'post' == $current_screen->base
			&& 'add' != $current_screen->action
			&& ( $post_type_object = get_post_type_object( $post->post_type ) )
			&& current_user_can( 'read_post', $post->ID )
			&& ( $post_type_object->public )
			&& ( $post_type_object->show_in_admin_bar ) )
		{
			if( 'draft' == $post->post_status ) {
				$preview_link = set_url_scheme( get_permalink( $post->ID ) );
				/** This filter is documented in wp-admin/includes/meta-boxes.php */
				$preview_link = apply_filters( 'preview_post_link', add_query_arg( 'preview', 'true', $preview_link ), $post );
				$wp_admin_bar->add_menu( array(
					'id' => 'preview',
					'title' => $post_type_object->labels->view_item,
					'href' => esc_url( $preview_link ),
					'meta' => array( 'target' => 'wp-preview-' . $post->ID ),
				) );
			} else {
				$wp_admin_bar->add_menu( array(
					'id' => 'view',
					'title' => $post_type_object->labels->view_item,
					'href' => get_permalink( $post->ID )
				) );
			}
		} elseif ( 'edit-tags' == $current_screen->base
			&& isset( $tag ) && is_object( $tag )
			&& ( $tax = get_taxonomy( $tag->taxonomy ) )
			&& $tax->public )
		{
			$wp_admin_bar->add_menu( array(
				'id' => 'view',
				'title' => $tax->labels->view_item,
				'href' => get_term_link( $tag )
			) );
		}
	} else {
		$current_object = $wp_the_query->get_queried_object();

		if ( empty( $current_object ) )
			return;

		if ( ! empty( $current_object->post_type )
			&& ( $post_type_object = get_post_type_object( $current_object->post_type ) )
			&& current_user_can( 'edit_post', $current_object->ID )
			&& $post_type_object->show_ui && $post_type_object->show_in_admin_bar )
		{
			$wp_admin_bar->add_menu( array(
				'id' => 'edit',
				'title' => $post_type_object->labels->edit_item,
				'href' => get_edit_post_link( $current_object->ID )
			) );
		} elseif ( ! empty( $current_object->taxonomy )
			&& ( $tax = get_taxonomy( $current_object->taxonomy ) )
			&& current_user_can( $tax->cap->edit_terms )
			&& $tax->show_ui )
		{
			$wp_admin_bar->add_menu( array(
				'id' => 'edit',
				'title' => $tax->labels->edit_item,
				'href' => get_edit_term_link( $current_object->term_id, $current_object->taxonomy )
			) );
		}
	}
}

/**
 * Add "Add New" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_new_content_menu( $wp_admin_bar ) {
	$actions = array();

	$cpts = (array) get_post_types( array( 'show_in_admin_bar' => true ), 'objects' );

	if ( isset( $cpts['post'] ) && current_user_can( $cpts['post']->cap->create_posts ) )
		$actions[ 'post-new.php' ] = array( $cpts['post']->labels->name_admin_bar, 'new-post' );

	if ( isset( $cpts['attachment'] ) && current_user_can( 'upload_files' ) )
		$actions[ 'media-new.php' ] = array( $cpts['attachment']->labels->name_admin_bar, 'new-media' );

	if ( current_user_can( 'manage_links' ) )
		$actions[ 'link-add.php' ] = array( _x( 'Link', 'add new from admin bar' ), 'new-link' );

	if ( isset( $cpts['page'] ) && current_user_can( $cpts['page']->cap->create_posts ) )
		$actions[ 'post-new.php?post_type=page' ] = array( $cpts['page']->labels->name_admin_bar, 'new-page' );

	unset( $cpts['post'], $cpts['page'], $cpts['attachment'] );

	// Add any additional custom post types.
	foreach ( $cpts as $cpt ) {
		if ( ! current_user_can( $cpt->cap->create_posts ) )
			continue;

		$key = 'post-new.php?post_type=' . $cpt->name;
		$actions[ $key ] = array( $cpt->labels->name_admin_bar, 'new-' . $cpt->name );
	}
	// Avoid clash with parent node and a 'content' post type.
	if ( isset( $actions['post-new.php?post_type=content'] ) )
		$actions['post-new.php?post_type=content'][1] = 'add-new-content';

	if ( current_user_can( 'create_users' ) || current_user_can( 'promote_users' ) )
		$actions[ 'user-new.php' ] = array( _x( 'User', 'add new from admin bar' ), 'new-user' );

	if ( ! $actions )
		return;

	$title = '<span class="ab-icon"></span><span class="ab-label">' . _x( 'New', 'admin bar menu group label' ) . '</span>';

	$wp_admin_bar->add_menu( array(
		'id'    => 'new-content',
		'title' => $title,
		'href'  => admin_url( current( array_keys( $actions ) ) ),
		'meta'  => array(
			'title' => _x( 'Add New', 'admin bar menu group label' ),
		),
	) );

	foreach ( $actions as $link => $action ) {
		list( $title, $id ) = $action;

		$wp_admin_bar->add_menu( array(
			'parent'    => 'new-content',
			'id'        => $id,
			'title'     => $title,
			'href'      => admin_url( $link )
		) );
	}
}

/**
 * Add edit comments link with awaiting moderation count bubble.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_comments_menu( $wp_admin_bar ) {
	if ( !current_user_can('edit_posts') )
		return;

	$awaiting_mod = wp_count_comments();
	$awaiting_mod = $awaiting_mod->moderated;
	$awaiting_title = esc_attr( sprintf( _n( '%s comment awaiting moderation', '%s comments awaiting moderation', $awaiting_mod ), number_format_i18n( $awaiting_mod ) ) );

	$icon  = '<span class="ab-icon"></span>';
	$title = '<span id="ab-awaiting-mod" class="ab-label awaiting-mod pending-count count-' . $awaiting_mod . '">' . number_format_i18n( $awaiting_mod ) . '</span>';

	$wp_admin_bar->add_menu( array(
		'id'    => 'comments',
		'title' => $icon . $title,
		'href'  => admin_url('edit-comments.php'),
		'meta'  => array( 'title' => $awaiting_title ),
	) );
}

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu( $wp_admin_bar ) {
	$wp_admin_bar->add_group( array( 'parent' => 'site-name', 'id' => 'appearance' ) );

	if ( current_user_can( 'switch_themes' ) || current_user_can( 'edit_theme_options' ) )
		$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php') ) );

	if ( ! current_user_can( 'edit_theme_options' ) )
		return;

	if ( current_user_can( 'customize' ) ) {
		$current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
		$wp_admin_bar->add_menu( array(
			'parent' => 'appearance',
			'id'     => 'customize',
			'title'  => __('Customize'),
			'href'   => add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() ),
			'meta'   => array(
				'class' => 'hide-if-no-customize',
			),
		) );
		add_action( 'wp_before_admin_bar_render', 'wp_customize_support_script' );
	}

	if ( current_theme_supports( 'widgets' )  )
		$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php') ) );

	if ( current_theme_supports( 'menus' ) || current_theme_supports( 'widgets' ) )
		$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php') ) );

	if ( current_theme_supports( 'custom-background' ) )
		$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background') ) );

	if ( current_theme_supports( 'custom-header' ) )
		$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header') ) );
}

/**
 * Provide an update link if theme/plugin/core updates are available.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_updates_menu( $wp_admin_bar ) {

	$update_data = wp_get_update_data();

	if ( !$update_data['counts']['total'] )
		return;

	$title = '<span class="ab-icon"></span><span class="ab-label">' . number_format_i18n( $update_data['counts']['total'] ) . '</span>';
	$title .= '<span class="screen-reader-text">' . $update_data['title'] . '</span>';

	$wp_admin_bar->add_menu( array(
		'id'    => 'updates',
		'title' => $title,
		'href'  => network_admin_url( 'update-core.php' ),
		'meta'  => array(
			'title' => $update_data['title'],
		),
	) );
}

/**
 * Add search form.
 *
 * @since 3.3.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_search_menu( $wp_admin_bar ) {
	if ( is_admin() )
		return;

	$form  = '<form action="' . esc_url( home_url( '/' ) ) . '" method="get" id="adminbarsearch">';
	$form .= '<input class="adminbar-input" name="s" id="adminbar-search" type="text" value="" maxlength="150" />';
	$form .= '<input type="submit" class="adminbar-button" value="' . __('Search') . '"/>';
	$form .= '</form>';

	$wp_admin_bar->add_menu( array(
		'parent' => 'top-secondary',
		'id'     => 'search',
		'title'  => $form,
		'meta'   => array(
			'class'    => 'admin-bar-search',
			'tabindex' => -1,
		)
	) );
}

/**
 * Add secondary menus.
 *
 * @since 3.3.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {
	$wp_admin_bar->add_group( array(
		'id'     => 'top-secondary',
		'meta'   => array(
			'class' => 'ab-top-secondary',
		),
	) );

	$wp_admin_bar->add_group( array(
		'parent' => 'wp-logo',
		'id'     => 'wp-logo-external',
		'meta'   => array(
			'class' => 'ab-sub-secondary',
		),
	) );
}

/**
 * Style and scripts for the admin bar.
 *
 * @since 3.1.0
 */
function wp_admin_bar_header() { ?>
<style type="text/css" media="print">#wpadminbar { display:none; }</style>
<?php
}

/**
 * Default admin bar callback.
 *
 * @since 3.1.0
 */
function _admin_bar_bump_cb() { ?>
<style type="text/css" media="screen">
	html { margin-top: 32px !important; }
	* html body { margin-top: 32px !important; }
	@media screen and ( max-width: 782px ) {
		html { margin-top: 46px !important; }
		* html body { margin-top: 46px !important; }
	}
</style>
<?php
}

/**
 * Set the display status of the admin bar.
 *
 * This can be called immediately upon plugin load. It does not need to be called from a function hooked to the init action.
 *
 * @since 3.1.0
 *
 * @param bool $show Whether to allow the admin bar to show.
 * @return void
 */
function show_admin_bar( $show ) {
	global $show_admin_bar;
	$show_admin_bar = (bool) $show;
}

/**
 * Determine whether the admin bar should be showing.
 *
 * @since 3.1.0
 *
 * @return bool Whether the admin bar should be showing.
 */
function is_admin_bar_showing() {
	global $show_admin_bar, $pagenow;

	// For all these types of requests, we never want an admin bar.
	if ( defined('XMLRPC_REQUEST') || defined('DOING_AJAX') || defined('IFRAME_REQUEST') )
		return false;

	// Integrated into the admin.
	if ( is_admin() )
		return true;

	if ( ! isset( $show_admin_bar ) ) {
		if ( ! is_user_logged_in() || 'wp-login.php' == $pagenow ) {
			$show_admin_bar = false;
		} else {
			$show_admin_bar = _get_admin_bar_pref();
		}
	}

	/**
	 * Filter whether to show the admin bar.
	 *
	 * Returning false to this hook is the recommended way to hide the admin bar.
	 * The user's display preference is used for logged in users.
	 *
	 * @since 3.1.0
	 *
	 * @param bool $show_admin_bar Whether the admin bar should be shown. Default false.
	 */
	$show_admin_bar = apply_filters( 'show_admin_bar', $show_admin_bar );

	return $show_admin_bar;
}

/**
 * Retrieve the admin bar display preference of a user.
 *
 * @since 3.1.0
 * @access private
 *
 * @param string $context Context of this preference check. Defaults to 'front'. The 'admin'
 * 	preference is no longer used.
 * @param int $user Optional. ID of the user to check, defaults to 0 for current user.
 * @return bool Whether the admin bar should be showing for this user.
 */
function _get_admin_bar_pref( $context = 'front', $user = 0 ) {
	$pref = get_user_option( "show_admin_bar_{$context}", $user );
	if ( false === $pref )
		return true;

	return 'true' === $pref;
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

471

472

473

474

475

476

477

478

479

480

481

482

483

484

485

486

487

488

489

490

491

492

493

494

495

496

497

498

499

500

501

502

503

504

505

506

507

508

509

510

511

512

513

514

515

516

517

518

519

520

521

522

523

524

525

526

527

528

529

530

531

532

533

534

535

536

537

538

539

540

541

542

543

544

545

546

547

548

549

550

551

552

553

554

555

556

557

558

559

560

561

562

563

564

565

566

567

568

569

570

571

572

573

574

575

576

577

578

579

580

581

582

583

584

585

586

587

588

589

590

591

592

593

594

595

596

597

598

599

600

601

602

603

604

605

606

607

608

609

610

611

612

613

614

615

616

617

618

619

620

621

622

623

624

625

626

627

628

629

630

631

632

633

634

635

636

637

638

639

640

641

642

643

644

645

646

647

648

649

650

651

652

653

654

655

656

657

658

659

660

661

662

663

664

665

666

667

668

669

670

671

672

673

674

675

676

677

678

679

680

681

682

683

684

685

686

687

688

689

690

691

692

693

694

695

696

697

698

699

700

701

702

703

704

705

706

707

708

709

710

711

712

713

714

715

716

717

718

719

720

721

722

723

724

725

726

727

728

729

730

731

732

733

734

735

736

737

738

739

740

741

742

743

744

745

746

747

748

749

750

751

752

753

754

755

756

757

758

759

760

761

762

763

764

765

766

767

768

769

770

771

772

773

774

775

776

777

778

779

780

781

782

783

784

785

786

787

788

789

790

791

792

793

794

795

796

797

798

799

800

801

802

803

804

805

806

807

808

809

810

811

812

813

814

815

816

817

818

819

820

821

822

823

824

825

826

827

828

829

830

831

832

833

834

835

836

837

838

839

840

841

842

843

844

845

846

847

848

849

850

851

852

853

854

855

856

857

858

859

860

861

862

863

864

865

866

867

868

<?php

/**

* Admin Bar

* This code handles the building and rendering of the press bar.

/**

* Instantiate the admin bar object and set it up as a global for access elsewhere.

* UNHOOKING THIS FUNCTION WILL NOT PROPERLY REMOVE THE ADMIN BAR.

* For that, use show_admin_bar(false) or the 'show_admin_bar' filter.

* @since 3.1.0

* @access private

* @return bool Whether the admin bar was successfully initialized.

function _wp_admin_bar_init() {

global $wp_admin_bar;

if ( ! is_admin_bar_showing() )

return false;

/* Load the admin bar class code ready for instantiation */

require( ABSPATH . WPINC . '/class-wp-admin-bar.php' );

/* Instantiate the admin bar */

/**

* Filter the admin bar class to instantiate.

* @since 3.1.0

* @param string $wp_admin_bar_class Admin bar class to use. Default 'WP_Admin_Bar'.

$admin_bar_class = apply_filters( 'wp_admin_bar_class', 'WP_Admin_Bar' );

if ( class_exists( $admin_bar_class ) )

$wp_admin_bar = new $admin_bar_class;

else

return false;

$wp_admin_bar->initialize();

$wp_admin_bar->add_menus();

return true;

}

// Don't remove. Wrong way to disable.

add_action( 'template_redirect', '_wp_admin_bar_init', 0 );

add_action( 'admin_init', '_wp_admin_bar_init' );

/**

* Render the admin bar to the page based on the $wp_admin_bar->menu member var.

* This is called very late on the footer actions so that it will render after anything else being

* added to the footer.

* It includes the action "admin_bar_menu" which should be used to hook in and

* add new menus to the admin bar. That way you can be sure that you are adding at most optimal point,

* right before the admin bar is rendered. This also gives you access to the $post global, among others.

* @since 3.1.0

function wp_admin_bar_render() {

global $wp_admin_bar;

if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) )

return false;

/**

* Load all necessary admin bar items.

* This is the hook used to add, remove, or manipulate admin bar items.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance, passed by reference

do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );

/**

* Fires before the admin bar is rendered.

* @since 3.1.0

do_action( 'wp_before_admin_bar_render' );

$wp_admin_bar->render();

/**

* Fires after the admin bar is rendered.

* @since 3.1.0

do_action( 'wp_after_admin_bar_render' );

}

add_action( 'wp_footer', 'wp_admin_bar_render', 1000 );

add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );

/**

* Add the WordPress logo menu.

* @since 3.3.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_wp_menu( $wp_admin_bar ) {

$wp_admin_bar->add_menu( array(

'id' => 'wp-logo',

'title' => '<span class="ab-icon"></span>',

'href' => self_admin_url( 'about.php' ),

'meta' => array(

'title' => __('About WordPress'),

) );

if ( is_user_logged_in() ) {

// Add "About WordPress" link

$wp_admin_bar->add_menu( array(

'parent' => 'wp-logo',

'id' => 'about',

'title' => __('About WordPress'),

'href' => self_admin_url( 'about.php' ),

) );

}

// Add WordPress.org link

$wp_admin_bar->add_menu( array(

'parent' => 'wp-logo-external',

'id' => 'wporg',

'title' => __('WordPress.org'),

'href' => __('https://wordpress.org/'),

) );

// Add codex link

$wp_admin_bar->add_menu( array(

'parent' => 'wp-logo-external',

'id' => 'documentation',

'title' => __('Documentation'),

'href' => __('http://codex.wordpress.org/'),

) );

// Add forums link

$wp_admin_bar->add_menu( array(

'parent' => 'wp-logo-external',

'id' => 'support-forums',

'title' => __('Support Forums'),

'href' => __('https://wordpress.org/support/'),

) );

// Add feedback link

$wp_admin_bar->add_menu( array(

'parent' => 'wp-logo-external',

'id' => 'feedback',

'title' => __('Feedback'),

'href' => __('https://wordpress.org/support/forum/requests-and-feedback'),

) );

}

/**

* Add the sidebar toggle button.

* @since 3.8.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_sidebar_toggle( $wp_admin_bar ) {

if ( is_admin() ) {

$wp_admin_bar->add_menu( array(

'id' => 'menu-toggle',

'title' => '<span class="ab-icon"></span><span class="screen-reader-text">' . __( 'Menu' ) . '</span>',

'href' => '#',

) );

}

/**

* Add the "My Account" item.

* @since 3.3.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_my_account_item( $wp_admin_bar ) {

$user_id = get_current_user_id();

$current_user = wp_get_current_user();

$profile_url = get_edit_profile_url( $user_id );

if ( ! $user_id )

return;

$avatar = get_avatar( $user_id, 26 );

$howdy = sprintf( __('Howdy, %1$s'), $current_user->display_name );

$class = empty( $avatar ) ? '' : 'with-avatar';

$wp_admin_bar->add_menu( array(

'id' => 'my-account',

'parent' => 'top-secondary',

'title' => $howdy . $avatar,

'href' => $profile_url,

'meta' => array(

'class' => $class,

'title' => __('My Account'),

) );

}

/**

* Add the "My Account" submenu items.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_my_account_menu( $wp_admin_bar ) {

$user_id = get_current_user_id();

$current_user = wp_get_current_user();

$profile_url = get_edit_profile_url( $user_id );

if ( ! $user_id )

return;

$wp_admin_bar->add_group( array(

'parent' => 'my-account',

'id' => 'user-actions',

) );

$user_info = get_avatar( $user_id, 64 );

$user_info .= "<span class='display-name'>{$current_user->display_name}</span>";

if ( $current_user->display_name !== $current_user->user_login )

$user_info .= "<span class='username'>{$current_user->user_login}</span>";

$wp_admin_bar->add_menu( array(

'parent' => 'user-actions',

'id' => 'user-info',

'title' => $user_info,

'href' => $profile_url,

'meta' => array(

'tabindex' => -1,

) );

$wp_admin_bar->add_menu( array(

'parent' => 'user-actions',

'id' => 'edit-profile',

'title' => __( 'Edit My Profile' ),

'href' => $profile_url,

) );

$wp_admin_bar->add_menu( array(

'parent' => 'user-actions',

'id' => 'logout',

'title' => __( 'Log Out' ),

'href' => wp_logout_url(),

) );

}

/**

* Add the "Site Name" menu.

* @since 3.3.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_site_menu( $wp_admin_bar ) {

// Don't show for logged out users.

if ( ! is_user_logged_in() )

return;

// Show only when the user is a member of this site, or they're a super admin.

if ( ! is_user_member_of_blog() && ! is_super_admin() )

return;

$blogname = get_bloginfo('name');

if ( empty( $blogname ) )

$blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );

if ( is_network_admin() ) {

$blogname = sprintf( __('Network Admin: %s'), esc_html( get_current_site()->site_name ) );

} elseif ( is_user_admin() ) {

$blogname = sprintf( __('Global Dashboard: %s'), esc_html( get_current_site()->site_name ) );

}

$title = wp_html_excerpt( $blogname, 40, '…' );

$wp_admin_bar->add_menu( array(

'id' => 'site-name',

'title' => $title,

'href' => is_admin() ? home_url( '/' ) : admin_url(),

) );

// Create submenu items.

if ( is_admin() ) {

// Add an option to visit the site.

$wp_admin_bar->add_menu( array(

'parent' => 'site-name',

'id' => 'view-site',

'title' => __( 'Visit Site' ),

'href' => home_url( '/' ),

) );

if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {

$wp_admin_bar->add_menu( array(

'parent' => 'site-name',

'id' => 'edit-site',

'title' => __( 'Edit Site' ),

'href' => network_admin_url( 'site-info.php?id=' . get_current_blog_id() ),

) );

}

} else {

// We're on the front end, link to the Dashboard.

$wp_admin_bar->add_menu( array(

'parent' => 'site-name',

'id' => 'dashboard',

'title' => __( 'Dashboard' ),

'href' => admin_url(),

) );

// Add the appearance submenu items.

wp_admin_bar_appearance_menu( $wp_admin_bar );

}

/**

* Add the "My Sites/[Site Name]" menu and all submenus.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {

// Don't show for logged out users or single site mode.

if ( ! is_user_logged_in() || ! is_multisite() )

return;

// Show only when the user has at least one site, or they're a super admin.

if ( count( $wp_admin_bar->user->blogs ) < 1 && ! is_super_admin() )

return;

$wp_admin_bar->add_menu( array(

'id' => 'my-sites',

'title' => __( 'My Sites' ),

'href' => admin_url( 'my-sites.php' ),

) );

if ( is_super_admin() ) {

$wp_admin_bar->add_group( array(

'parent' => 'my-sites',

'id' => 'my-sites-super-admin',

) );

$wp_admin_bar->add_menu( array(

'parent' => 'my-sites-super-admin',

'id' => 'network-admin',

'title' => __('Network Admin'),

'href' => network_admin_url(),

) );

$wp_admin_bar->add_menu( array(

'parent' => 'network-admin',

'id' => 'network-admin-d',

'title' => __( 'Dashboard' ),

'href' => network_admin_url(),

) );

$wp_admin_bar->add_menu( array(

'parent' => 'network-admin',

'id' => 'network-admin-s',

'title' => __( 'Sites' ),

'href' => network_admin_url( 'sites.php' ),

) );

$wp_admin_bar->add_menu( array(

'parent' => 'network-admin',

'id' => 'network-admin-u',

'title' => __( 'Users' ),

'href' => network_admin_url( 'users.php' ),

) );

$wp_admin_bar->add_menu( array(

'parent' => 'network-admin',

'id' => 'network-admin-t',

'title' => __( 'Themes' ),

'href' => network_admin_url( 'themes.php' ),

) );

$wp_admin_bar->add_menu( array(

'parent' => 'network-admin',

'id' => 'network-admin-p',

'title' => __( 'Plugins' ),

'href' => network_admin_url( 'plugins.php' ),

) );

}

// Add site links

$wp_admin_bar->add_group( array(

'parent' => 'my-sites',

'id' => 'my-sites-list',

'meta' => array(

'class' => is_super_admin() ? 'ab-sub-secondary' : '',

) );

foreach ( (array) $wp_admin_bar->user->blogs as $blog ) {

switch_to_blog( $blog->userblog_id );

$blavatar = '<div class="blavatar"></div>';

$blogname = empty( $blog->blogname ) ? $blog->domain : $blog->blogname;

$menu_id = 'blog-' . $blog->userblog_id;

$wp_admin_bar->add_menu( array(

'parent' => 'my-sites-list',

'id' => $menu_id,

'title' => $blavatar . $blogname,

'href' => admin_url(),

) );

$wp_admin_bar->add_menu( array(

'parent' => $menu_id,

'id' => $menu_id . '-d',

'title' => __( 'Dashboard' ),

'href' => admin_url(),

) );

if ( current_user_can( get_post_type_object( 'post' )->cap->create_posts ) ) {

$wp_admin_bar->add_menu( array(

'parent' => $menu_id,

'id' => $menu_id . '-n',

'title' => __( 'New Post' ),

'href' => admin_url( 'post-new.php' ),

) );

}

if ( current_user_can( 'edit_posts' ) ) {

$wp_admin_bar->add_menu( array(

'parent' => $menu_id,

'id' => $menu_id . '-c',

'title' => __( 'Manage Comments' ),

'href' => admin_url( 'edit-comments.php' ),

) );

}

$wp_admin_bar->add_menu( array(

'parent' => $menu_id,

'id' => $menu_id . '-v',

'title' => __( 'Visit Site' ),

'href' => home_url( '/' ),

) );

restore_current_blog();

}

/**

* Provide a shortlink.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_shortlink_menu( $wp_admin_bar ) {

$short = wp_get_shortlink( 0, 'query' );

$id = 'get-shortlink';

if ( empty( $short ) )

return;

$html = '<input class="shortlink-input" type="text" readonly="readonly" value="' . esc_attr( $short ) . '" />';

$wp_admin_bar->add_menu( array(

'id' => $id,

'title' => __( 'Shortlink' ),

'href' => $short,

'meta' => array( 'html' => $html ),

) );

}

/**

* Provide an edit link for posts and terms.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_edit_menu( $wp_admin_bar ) {

global $tag, $wp_the_query;

if ( is_admin() ) {

$current_screen = get_current_screen();

$post = get_post();

if ( 'post' == $current_screen->base

&& 'add' != $current_screen->action

&& ( $post_type_object = get_post_type_object( $post->post_type ) )

&& current_user_can( 'read_post', $post->ID )

&& ( $post_type_object->public )

&& ( $post_type_object->show_in_admin_bar ) )

{

if( 'draft' == $post->post_status ) {

$preview_link = set_url_scheme( get_permalink( $post->ID ) );

/** This filter is documented in wp-admin/includes/meta-boxes.php */

$preview_link = apply_filters( 'preview_post_link', add_query_arg( 'preview', 'true', $preview_link ), $post );

$wp_admin_bar->add_menu( array(

'id' => 'preview',

'title' => $post_type_object->labels->view_item,

'href' => esc_url( $preview_link ),

'meta' => array( 'target' => 'wp-preview-' . $post->ID ),

) );

} else {

$wp_admin_bar->add_menu( array(

'id' => 'view',

'title' => $post_type_object->labels->view_item,

'href' => get_permalink( $post->ID )

) );

}

} elseif ( 'edit-tags' == $current_screen->base

&& isset( $tag ) && is_object( $tag )

&& ( $tax = get_taxonomy( $tag->taxonomy ) )

&& $tax->public )

{

$wp_admin_bar->add_menu( array(

'id' => 'view',

'title' => $tax->labels->view_item,

'href' => get_term_link( $tag )

) );

}

} else {

$current_object = $wp_the_query->get_queried_object();

if ( empty( $current_object ) )

return;

if ( ! empty( $current_object->post_type )

&& ( $post_type_object = get_post_type_object( $current_object->post_type ) )

&& current_user_can( 'edit_post', $current_object->ID )

&& $post_type_object->show_ui && $post_type_object->show_in_admin_bar )

{

$wp_admin_bar->add_menu( array(

'id' => 'edit',

'title' => $post_type_object->labels->edit_item,

'href' => get_edit_post_link( $current_object->ID )

) );

} elseif ( ! empty( $current_object->taxonomy )

&& ( $tax = get_taxonomy( $current_object->taxonomy ) )

&& current_user_can( $tax->cap->edit_terms )

&& $tax->show_ui )

{

$wp_admin_bar->add_menu( array(

'id' => 'edit',

'title' => $tax->labels->edit_item,

'href' => get_edit_term_link( $current_object->term_id, $current_object->taxonomy )

) );

}

/**

* Add "Add New" menu.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_new_content_menu( $wp_admin_bar ) {

$actions = array();

$cpts = (array) get_post_types( array( 'show_in_admin_bar' => true ), 'objects' );

if ( isset( $cpts['post'] ) && current_user_can( $cpts['post']->cap->create_posts ) )

$actions[ 'post-new.php' ] = array( $cpts['post']->labels->name_admin_bar, 'new-post' );

if ( isset( $cpts['attachment'] ) && current_user_can( 'upload_files' ) )

$actions[ 'media-new.php' ] = array( $cpts['attachment']->labels->name_admin_bar, 'new-media' );

if ( current_user_can( 'manage_links' ) )

$actions[ 'link-add.php' ] = array( _x( 'Link', 'add new from admin bar' ), 'new-link' );

if ( isset( $cpts['page'] ) && current_user_can( $cpts['page']->cap->create_posts ) )

$actions[ 'post-new.php?post_type=page' ] = array( $cpts['page']->labels->name_admin_bar, 'new-page' );

unset( $cpts['post'], $cpts['page'], $cpts['attachment'] );

// Add any additional custom post types.

foreach ( $cpts as $cpt ) {

if ( ! current_user_can( $cpt->cap->create_posts ) )

continue;

$key = 'post-new.php?post_type=' . $cpt->name;

$actions[ $key ] = array( $cpt->labels->name_admin_bar, 'new-' . $cpt->name );

}

// Avoid clash with parent node and a 'content' post type.

if ( isset( $actions['post-new.php?post_type=content'] ) )

$actions['post-new.php?post_type=content'][1] = 'add-new-content';

if ( current_user_can( 'create_users' ) || current_user_can( 'promote_users' ) )

$actions[ 'user-new.php' ] = array( _x( 'User', 'add new from admin bar' ), 'new-user' );

if ( ! $actions )

return;

$title = '<span class="ab-icon"></span><span class="ab-label">' . _x( 'New', 'admin bar menu group label' ) . '</span>';

$wp_admin_bar->add_menu( array(

'id' => 'new-content',

'title' => $title,

'href' => admin_url( current( array_keys( $actions ) ) ),

'meta' => array(

'title' => _x( 'Add New', 'admin bar menu group label' ),

) );

foreach ( $actions as $link => $action ) {

list( $title, $id ) = $action;

$wp_admin_bar->add_menu( array(

'parent' => 'new-content',

'id' => $id,

'title' => $title,

'href' => admin_url( $link )

) );

}

/**

* Add edit comments link with awaiting moderation count bubble.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_comments_menu( $wp_admin_bar ) {

if ( !current_user_can('edit_posts') )

return;

$awaiting_mod = wp_count_comments();

$awaiting_mod = $awaiting_mod->moderated;

$awaiting_title = esc_attr( sprintf( _n( '%s comment awaiting moderation', '%s comments awaiting moderation', $awaiting_mod ), number_format_i18n( $awaiting_mod ) ) );

$icon = '<span class="ab-icon"></span>';

$title = '<span id="ab-awaiting-mod" class="ab-label awaiting-mod pending-count count-' . $awaiting_mod . '">' . number_format_i18n( $awaiting_mod ) . '</span>';

$wp_admin_bar->add_menu( array(

'id' => 'comments',

'title' => $icon . $title,

'href' => admin_url('edit-comments.php'),

'meta' => array( 'title' => $awaiting_title ),

) );

}

/**

* Add appearance submenu items to the "Site Name" menu.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_appearance_menu( $wp_admin_bar ) {

$wp_admin_bar->add_group( array( 'parent' => 'site-name', 'id' => 'appearance' ) );

if ( current_user_can( 'switch_themes' ) || current_user_can( 'edit_theme_options' ) )

$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php') ) );

if ( ! current_user_can( 'edit_theme_options' ) )

return;

if ( current_user_can( 'customize' ) ) {

$current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];

$wp_admin_bar->add_menu( array(

'parent' => 'appearance',

'id' => 'customize',

'title' => __('Customize'),

'href' => add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() ),

'meta' => array(

'class' => 'hide-if-no-customize',

) );

add_action( 'wp_before_admin_bar_render', 'wp_customize_support_script' );

}

if ( current_theme_supports( 'widgets' ) )

$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php') ) );

if ( current_theme_supports( 'menus' ) || current_theme_supports( 'widgets' ) )

$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php') ) );

if ( current_theme_supports( 'custom-background' ) )

$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background') ) );

if ( current_theme_supports( 'custom-header' ) )

$wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header') ) );

}

/**

* Provide an update link if theme/plugin/core updates are available.

* @since 3.1.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_updates_menu( $wp_admin_bar ) {

$update_data = wp_get_update_data();

if ( !$update_data['counts']['total'] )

return;

$title = '<span class="ab-icon"></span><span class="ab-label">' . number_format_i18n( $update_data['counts']['total'] ) . '</span>';

$title .= '<span class="screen-reader-text">' . $update_data['title'] . '</span>';

$wp_admin_bar->add_menu( array(

'id' => 'updates',

'title' => $title,

'href' => network_admin_url( 'update-core.php' ),

'meta' => array(

'title' => $update_data['title'],

) );

}

/**

* Add search form.

* @since 3.3.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_search_menu( $wp_admin_bar ) {

if ( is_admin() )

return;

$form = '<form action="' . esc_url( home_url( '/' ) ) . '" method="get" id="adminbarsearch">';

$form .= '<input class="adminbar-input" name="s" id="adminbar-search" type="text" value="" maxlength="150" />';

$form .= '<input type="submit" class="adminbar-button" value="' . __('Search') . '"/>';

$form .= '</form>';

$wp_admin_bar->add_menu( array(

'parent' => 'top-secondary',

'id' => 'search',

'title' => $form,

'meta' => array(

'class' => 'admin-bar-search',

'tabindex' => -1,

)

) );

}

/**

* Add secondary menus.

* @since 3.3.0

* @param WP_Admin_Bar $wp_admin_bar

function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {

$wp_admin_bar->add_group( array(

'id' => 'top-secondary',

'meta' => array(

'class' => 'ab-top-secondary',

) );

$wp_admin_bar->add_group( array(

'parent' => 'wp-logo',

'id' => 'wp-logo-external',

'meta' => array(

'class' => 'ab-sub-secondary',

) );

}

/**

* Style and scripts for the admin bar.

* @since 3.1.0

function wp_admin_bar_header() { ?>

<?php

}

/**

* Default admin bar callback.

* @since 3.1.0

function _admin_bar_bump_cb() { ?>

html { margin-top: 32px !important; }

* html body { margin-top: 32px !important; }

@media screen and ( max-width: 782px ) {

html { margin-top: 46px !important; }

* html body { margin-top: 46px !important; }

}

</style>

<?php

}

/**

* Set the display status of the admin bar.

* This can be called immediately upon plugin load. It does not need to be called from a function hooked to the init action.

* @since 3.1.0

* @param bool $show Whether to allow the admin bar to show.

* @return void

function show_admin_bar( $show ) {

global $show_admin_bar;

$show_admin_bar = (bool) $show;

}

/**

* Determine whether the admin bar should be showing.

* @since 3.1.0

* @return bool Whether the admin bar should be showing.

function is_admin_bar_showing() {

global $show_admin_bar, $pagenow;

// For all these types of requests, we never want an admin bar.

if ( defined('XMLRPC_REQUEST') || defined('DOING_AJAX') || defined('IFRAME_REQUEST') )

return false;

// Integrated into the admin.

if ( is_admin() )

return true;

if ( ! isset( $show_admin_bar ) ) {

if ( ! is_user_logged_in() || 'wp-login.php' == $pagenow ) {

$show_admin_bar = false;

} else {

$show_admin_bar = _get_admin_bar_pref();

}

/**

* Filter whether to show the admin bar.

* Returning false to this hook is the recommended way to hide the admin bar.

* The user's display preference is used for logged in users.

* @since 3.1.0

* @param bool $show_admin_bar Whether the admin bar should be shown. Default false.

$show_admin_bar = apply_filters( 'show_admin_bar', $show_admin_bar );

return $show_admin_bar;

}

/**

* Retrieve the admin bar display preference of a user.

* @since 3.1.0

* @access private

* @param string $context Context of this preference check. Defaults to 'front'. The 'admin'

* preference is no longer used.

* @param int $user Optional. ID of the user to check, defaults to 0 for current user.

* @return bool Whether the admin bar should be showing for this user.

function _get_admin_bar_pref( $context = 'front', $user = 0 ) {

$pref = get_user_option( "show_admin_bar_{$context}", $user );

if ( false === $pref )

return true;

return 'true' === $pref;

}

: WordPressを読む　107 /blog/wp-content/themes/twentytwelve/comments.php
/blog/wp-content/themes/twentytwelve/com …

: WordPressを読む　36-2 /blog/wp-includes/link-template.php 2
目次1 /blog/wp-includes/link-template.php …

: WordPressを読む　4　/blog/wp-config.php
目次1 /blog/wp-config.php2 読込元:/blog/wp-lo …

: WordPressを読む　75 /blog/wp-content/plugins/akismet/class.akismet-widget.php
/blog/wp-content/plugins/akismet/class.a …

: WordPressを読む　11-7 /blog/wp-includes/option.php 7
目次1 /blog/wp-includes/option.php 72 読込元 …

: WordPressを読む　29-2 /blog/wp-includes/theme.php 2
目次1 /blog/wp-includes/theme.php 22 関数　ge …

PREV: WordPressを読む　36-7 /blog/wp-includes/link-template.php 7
NEXT: WordPressを読む　38-1 /blog/wp-includes/post.php 1

2024年4月
月	火	水	木	金	土	日
« 4月
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30

WordPressを読む 37 /blog/wp-includes/author-template.php

/blog/wp-includes/author-template.php

WordPressを読む　37 /blog/wp-includes/author-template.php