enmi-conf.org: comparison wp/wp-includes/author-template.php

equal deleted inserted replaced

-:be944660c56a
+:3d72ae0968f4
 * @package WordPress
 * @subpackage Template
 */
 /**
-* Retrieve the author of the current post.
+* Retrieves the author of the current post.
 *
 * @since 1.5.0
 *
 * @global WP_User $authordata The current author's data.
 *
 	 */
 	return apply_filters( 'the_author', is_object( $authordata ) ? $authordata->display_name : null );
 }
 /**
-* Display the name of the author of the current post.
+* Displays 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().
 	return get_the_author();
 }
 /**
-* Retrieve the author who last edited the current post.
+* Retrieves the author who last edited the current post.
 *
 * @since 2.8.0
 *
-* @return string|void The author's display name.
+* @return string|void The author's display name, empty string if unknown.
 */
 function get_the_modified_author() {
 	$last_id = get_post_meta( get_post()->ID, '_edit_last', true );
 	if ( $last_id ) {
 		/**
 		 * Filters the display name of the author who last edited the current post.
 		 *
 		 * @since 2.8.0
 		 *
-		 * @param string $display_name The author's display name.
+		 * @param string $display_name The author's display name, empty string if unknown.
 		 */
-		return apply_filters( 'the_modified_author', $last_user->display_name );
+		return apply_filters( 'the_modified_author', $last_user ? $last_user->display_name : '' );
 	}
 }
 /**
-* Display the name of the author who last edited the current post,
+* Displays the name of the author who last edited the current post,
 * if the author's ID is available.
 *
 * @since 2.8.0
 *
 * @see get_the_author()
 */
 function the_author_meta( $field = '', $user_id = false ) {
 	$author_meta = get_the_author_meta( $field, $user_id );
 	/**
-	 * The value of the requested user metadata.
+	 * Filters 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
 	 *
 	 */
 	echo apply_filters( "the_author_{$field}", $author_meta, $user_id );
 }
 /**
-* Retrieve either author's link or author's name.
+* Retrieves 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.
 *
 * @since 3.0.0
 *
+* @global WP_User $authordata The current author's data.
+*
 * @return string|null An HTML link if the author's url exist in user meta,
 *                     else the result of get_the_author().
 */
 function get_the_author_link() {
 	if ( get_the_author_meta( 'url' ) ) {
-		return sprintf(
+		global $authordata;
+		$author_url          = get_the_author_meta( 'url' );
+		$author_display_name = get_the_author();
+		$link = sprintf(
 			'<a href="%1$s" title="%2$s" rel="author external">%3$s</a>',
-			esc_url( get_the_author_meta( 'url' ) ),
+			esc_url( $author_url ),
 			/* translators: %s: Author's display name. */
-			esc_attr( sprintf( __( 'Visit %s&#8217;s website' ), get_the_author() ) ),
+			esc_attr( sprintf( __( 'Visit %s&#8217;s website' ), $author_display_name ) ),
-			get_the_author()
+			$author_display_name
 		);
+		/**
+		 * Filters the author URL link HTML.
+		 *
+		 * @since 6.0.0
+		 *
+		 * @param string  $link       The default rendered author HTML link.
+		 * @param string  $author_url Author's URL.
+		 * @param WP_User $authordata Author user data.
+		 */
+		return apply_filters( 'the_author_link', $link, $author_url, $authordata );
 	} else {
 		return get_the_author();
 	}
 }
 /**
-* Display either author's link or author's name.
+* Displays 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 https://developer.wordpress.org/reference/functions/the_author_link/
 function the_author_link() {
 	echo get_the_author_link();
 }
 /**
-* Retrieve the number of posts by the author of the current post.
+* Retrieves the number of posts by the author of the current post.
 *
 * @since 1.5.0
 *
 * @return int The number of posts by the author.
 */
 	}
 	return count_user_posts( $post->post_author, $post->post_type );
 }
 /**
-* Display the number of posts by the author of the current post.
+* Displays the number of posts by the author of the current post.
 *
 * @link https://developer.wordpress.org/reference/functions/the_author_posts/
 * @since 0.71
 */
 function the_author_posts() {
 	}
 	echo get_the_author_posts_link();
 }
 /**
-* Retrieve the URL to the author page for the user with the ID provided.
+* Retrieves the URL to the author page for the user with the ID provided.
 *
 * @since 2.1.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $author_nicename Optional. The author's nicename (slug). Default empty.
 * @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();
+	$author_id = (int) $author_id;
+	$link      = $wp_rewrite->get_author_permastruct();
 	if ( empty( $link ) ) {
 		$file = home_url( '/' );
-		$link = $file . '?author=' . $auth_ID;
+		$link = $file . '?author=' . $author_id;
 	} else {
 		if ( '' === $author_nicename ) {
 			$user = get_userdata( $author_id );
 			if ( ! empty( $user->user_nicename ) ) {
 				$author_nicename = $user->user_nicename;
 	return $link;
 }
 /**
-* List all the authors of the site, with several options available.
+* Lists all the authors of the site, with several options available.
 *
 * @link https://developer.wordpress.org/reference/functions/wp_list_authors/
 *
 * @since 1.2.0
 *

changeset 19	3d72ae0968f4
parent 18	be944660c56a
child 21	48c4eec2b7e6