mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-12 07:38:33 +02:00
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI. Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov. Fixes #29748. Built from https://develop.svn.wordpress.org/trunk@55276 git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
259 lines
7.2 KiB
PHP
259 lines
7.2 KiB
PHP
<?php
|
|
/**
|
|
* Custom template tags for this theme
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Nineteen
|
|
* @since Twenty Nineteen 1.0
|
|
*/
|
|
|
|
if ( ! function_exists( 'twentynineteen_posted_on' ) ) :
|
|
/**
|
|
* Prints HTML with meta information for the current post-date/time.
|
|
*/
|
|
function twentynineteen_posted_on() {
|
|
$time_string = '<time class="entry-date published updated" datetime="%1$s">%2$s</time>';
|
|
if ( get_the_time( 'U' ) !== get_the_modified_time( 'U' ) ) {
|
|
$time_string = '<time class="entry-date published" datetime="%1$s">%2$s</time><time class="updated" datetime="%3$s">%4$s</time>';
|
|
}
|
|
|
|
$time_string = sprintf(
|
|
$time_string,
|
|
esc_attr( get_the_date( DATE_W3C ) ),
|
|
esc_html( get_the_date() ),
|
|
esc_attr( get_the_modified_date( DATE_W3C ) ),
|
|
esc_html( get_the_modified_date() )
|
|
);
|
|
|
|
printf(
|
|
'<span class="posted-on">%1$s<a href="%2$s" rel="bookmark">%3$s</a></span>',
|
|
twentynineteen_get_icon_svg( 'watch', 16 ),
|
|
esc_url( get_permalink() ),
|
|
$time_string
|
|
);
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_posted_by' ) ) :
|
|
/**
|
|
* Prints HTML with meta information about theme author.
|
|
*/
|
|
function twentynineteen_posted_by() {
|
|
printf(
|
|
/* translators: 1: SVG icon. 2: Post author, only visible to screen readers. 3: Author link. */
|
|
'<span class="byline">%1$s<span class="screen-reader-text">%2$s</span><span class="author vcard"><a class="url fn n" href="%3$s">%4$s</a></span></span>',
|
|
twentynineteen_get_icon_svg( 'person', 16 ),
|
|
/* translators: Hidden accessibility text. */
|
|
__( 'Posted by', 'twentynineteen' ),
|
|
esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ),
|
|
esc_html( get_the_author() )
|
|
);
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_comment_count' ) ) :
|
|
/**
|
|
* Prints HTML with the comment count for the current post.
|
|
*/
|
|
function twentynineteen_comment_count() {
|
|
if ( ! post_password_required() && ( comments_open() || get_comments_number() ) ) {
|
|
echo '<span class="comments-link">';
|
|
echo twentynineteen_get_icon_svg( 'comment', 16 );
|
|
|
|
/* translators: %s: Post title. Only visible to screen readers. */
|
|
comments_popup_link( sprintf( __( 'Leave a comment<span class="screen-reader-text"> on %s</span>', 'twentynineteen' ), get_the_title() ) );
|
|
|
|
echo '</span>';
|
|
}
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_entry_footer' ) ) :
|
|
/**
|
|
* Prints HTML with meta information for the categories, tags and comments.
|
|
*/
|
|
function twentynineteen_entry_footer() {
|
|
|
|
// Hide author, post date, category and tag text for pages.
|
|
if ( 'post' === get_post_type() ) {
|
|
|
|
// Posted by.
|
|
twentynineteen_posted_by();
|
|
|
|
// Posted on.
|
|
twentynineteen_posted_on();
|
|
|
|
$categories_list = get_the_category_list( wp_get_list_item_separator() );
|
|
if ( $categories_list ) {
|
|
printf(
|
|
/* translators: 1: SVG icon. 2: Posted in label, only visible to screen readers. 3: List of categories. */
|
|
'<span class="cat-links">%1$s<span class="screen-reader-text">%2$s</span>%3$s</span>',
|
|
twentynineteen_get_icon_svg( 'archive', 16 ),
|
|
/* translators: Hidden accessibility text. */
|
|
__( 'Posted in', 'twentynineteen' ),
|
|
$categories_list
|
|
); // WPCS: XSS OK.
|
|
}
|
|
|
|
$tags_list = get_the_tag_list( '', wp_get_list_item_separator() );
|
|
if ( $tags_list && ! is_wp_error( $tags_list ) ) {
|
|
printf(
|
|
/* translators: 1: SVG icon. 2: Posted in label, only visible to screen readers. 3: List of tags. */
|
|
'<span class="tags-links">%1$s<span class="screen-reader-text">%2$s </span>%3$s</span>',
|
|
twentynineteen_get_icon_svg( 'tag', 16 ),
|
|
/* translators: Hidden accessibility text. */
|
|
__( 'Tags:', 'twentynineteen' ),
|
|
$tags_list
|
|
); // WPCS: XSS OK.
|
|
}
|
|
}
|
|
|
|
// Comment count.
|
|
if ( ! is_singular() ) {
|
|
twentynineteen_comment_count();
|
|
}
|
|
|
|
// Edit post link.
|
|
edit_post_link(
|
|
sprintf(
|
|
wp_kses(
|
|
/* translators: %s: Post title. Only visible to screen readers. */
|
|
__( 'Edit <span class="screen-reader-text">%s</span>', 'twentynineteen' ),
|
|
array(
|
|
'span' => array(
|
|
'class' => array(),
|
|
),
|
|
)
|
|
),
|
|
get_the_title()
|
|
),
|
|
'<span class="edit-link">' . twentynineteen_get_icon_svg( 'edit', 16 ),
|
|
'</span>'
|
|
);
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_post_thumbnail' ) ) :
|
|
/**
|
|
* Displays an optional post thumbnail.
|
|
*
|
|
* Wraps the post thumbnail in an anchor element on index views, or a div
|
|
* element when on single views.
|
|
*/
|
|
function twentynineteen_post_thumbnail() {
|
|
if ( ! twentynineteen_can_show_post_thumbnail() ) {
|
|
return;
|
|
}
|
|
|
|
if ( is_singular() ) :
|
|
?>
|
|
|
|
<figure class="post-thumbnail">
|
|
<?php the_post_thumbnail(); ?>
|
|
</figure><!-- .post-thumbnail -->
|
|
|
|
<?php
|
|
else :
|
|
?>
|
|
|
|
<figure class="post-thumbnail">
|
|
<a class="post-thumbnail-inner" href="<?php the_permalink(); ?>" aria-hidden="true" tabindex="-1">
|
|
<?php the_post_thumbnail( 'post-thumbnail' ); ?>
|
|
</a>
|
|
</figure>
|
|
|
|
<?php
|
|
endif; // End is_singular().
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_get_user_avatar_markup' ) ) :
|
|
/**
|
|
* Returns the HTML markup to generate a user avatar.
|
|
*/
|
|
function twentynineteen_get_user_avatar_markup( $id_or_email = null ) {
|
|
|
|
if ( ! isset( $id_or_email ) ) {
|
|
$id_or_email = get_current_user_id();
|
|
}
|
|
|
|
return sprintf( '<div class="comment-user-avatar comment-author vcard">%s</div>', get_avatar( $id_or_email, twentynineteen_get_avatar_size() ) );
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_discussion_avatars_list' ) ) :
|
|
/**
|
|
* Displays a list of avatars involved in a discussion for a given post.
|
|
*/
|
|
function twentynineteen_discussion_avatars_list( $comment_authors ) {
|
|
if ( empty( $comment_authors ) ) {
|
|
return;
|
|
}
|
|
echo '<ol class="discussion-avatar-list">', "\n";
|
|
foreach ( $comment_authors as $id_or_email ) {
|
|
printf(
|
|
"<li>%s</li>\n",
|
|
twentynineteen_get_user_avatar_markup( $id_or_email )
|
|
);
|
|
}
|
|
echo '</ol><!-- .discussion-avatar-list -->', "\n";
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_comment_form' ) ) :
|
|
/**
|
|
* Documentation for function.
|
|
*/
|
|
function twentynineteen_comment_form( $order ) {
|
|
if ( true === $order || strtolower( $order ) === strtolower( get_option( 'comment_order', 'asc' ) ) ) {
|
|
|
|
comment_form(
|
|
array(
|
|
'title_reply' => null,
|
|
)
|
|
);
|
|
}
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'twentynineteen_the_posts_navigation' ) ) :
|
|
/**
|
|
* Documentation for function.
|
|
*/
|
|
function twentynineteen_the_posts_navigation() {
|
|
the_posts_pagination(
|
|
array(
|
|
'mid_size' => 2,
|
|
'prev_text' => sprintf(
|
|
'%s <span class="nav-prev-text">%s</span>',
|
|
twentynineteen_get_icon_svg( 'chevron_left', 22 ),
|
|
__( 'Newer posts', 'twentynineteen' )
|
|
),
|
|
'next_text' => sprintf(
|
|
'<span class="nav-next-text">%s</span> %s',
|
|
__( 'Older posts', 'twentynineteen' ),
|
|
twentynineteen_get_icon_svg( 'chevron_right', 22 )
|
|
),
|
|
)
|
|
);
|
|
}
|
|
endif;
|
|
|
|
if ( ! function_exists( 'wp_body_open' ) ) :
|
|
/**
|
|
* Fire the wp_body_open action.
|
|
*
|
|
* Added for backward compatibility to support pre-5.2.0 WordPress versions.
|
|
*
|
|
* @since Twenty Nineteen 1.4
|
|
*/
|
|
function wp_body_open() {
|
|
/**
|
|
* Triggered after the opening <body> tag.
|
|
*
|
|
* @since Twenty Nineteen 1.4
|
|
*/
|
|
do_action( 'wp_body_open' );
|
|
}
|
|
endif;
|