X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/8f374b7233bc2815ccc387e448d208c5434eb961..refs/tags/wordpress-3.7:/wp-includes/author-template.php diff --git a/wp-includes/author-template.php b/wp-includes/author-template.php index ab2737c5..557a1ab8 100644 --- a/wp-includes/author-template.php +++ b/wp-includes/author-template.php @@ -26,6 +26,13 @@ function get_the_author($deprecated = '') { 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); } @@ -69,9 +76,16 @@ function the_author( $deprecated = '', $deprecated_echo = true ) { * @return string The author's display name. */ function get_the_modified_author() { - global $post; - if ( $last_id = get_post_meta($post->ID, '_edit_last', true) ) { + 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); } } @@ -109,6 +123,16 @@ function get_the_author_meta( $field = '', $user_id = false ) { $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 ); } @@ -120,8 +144,20 @@ function get_the_author_meta( $field = '', $user_id = false ) { * @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) { - echo apply_filters('the_author_' . $field, get_the_author_meta($field, $user_id), $user_id); +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 ); } /** @@ -135,7 +171,7 @@ function the_author_meta($field = '', $user_id = false) { */ function get_the_author_link() { if ( get_the_author_meta('url') ) { - return '' . get_the_author() . ''; + return '' . get_the_author() . ''; } else { return get_the_author(); } @@ -164,8 +200,7 @@ function the_author_link() { * @return int The number of posts by the author. */ function get_the_author_posts() { - global $post; - return count_user_posts($post->post_author); + return count_user_posts( get_post()->post_author ); } /** @@ -202,10 +237,18 @@ function the_author_posts_link($deprecated = '') { return false; $link = sprintf( '', - get_author_posts_url( $authordata->ID, $authordata->user_nicename ), + 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 ); } @@ -234,7 +277,16 @@ function get_author_posts_url($author_id, $author_nicename = '') { $link = home_url( user_trailingslashit( $link ) ); } - $link = apply_filters('author_link', $link, $author_id, $author_nicename); + /** + * 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; } @@ -246,7 +298,7 @@ function get_author_posts_url($author_id, $author_nicename = '') { *
  • optioncount (boolean) (false): Show the count in parenthesis next to the * author's name.
    • *
  • exclude_admin (boolean) (true): Exclude the 'admin' user that is - * installed bydefault.
    • + * installed by default. *
  • show_fullname (boolean) (false): Show their full names.
    • *
  • hide_empty (boolean) (true): Don't show authors without any posts.
    • *
  • feed (string) (''): If isn't empty, show links to author's feeds.
    • @@ -374,12 +426,19 @@ function wp_list_authors($args = '') { function is_multi_author() { global $wpdb; - if ( false === ( $is_multi_author = wp_cache_get('is_multi_author', 'posts') ) ) { + 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; - wp_cache_set('is_multi_author', $is_multi_author, 'posts'); + 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 ); } @@ -389,6 +448,6 @@ function is_multi_author() { * @private */ function __clear_multi_author_cache() { - wp_cache_delete('is_multi_author', 'posts'); + delete_transient( 'is_multi_author' ); } add_action('transition_post_status', '__clear_multi_author_cache');