mirror of
https://github.com/WordPress/WordPress.git
synced 2025-02-15 03:51:43 +01:00
a3ae67bd8f
Let Gutenberg shine with this simple, fast, and powerful theme. Initial development occurred on GitHub. See: https://github.com/WordPress/twentynineteen Props allancole, karmatosed, kjellr, yingling017, mrasharirfan, milana_cap, fabiankaegy, westonruter, aaronjorbin, netweb, b-07, khleomix, blowery, dereksmart, jasmussen, audrasjb, nielslange, mmaumio, dimadin, joyously, anevins12. Built from https://develop.svn.wordpress.org/branches/5.0@43808 git-svn-id: http://core.svn.wordpress.org/branches/5.0@43637 1a063a9b-81f0-0310-95a4-ce76da25c4cd
227 lines
7.0 KiB
PHP
227 lines
7.0 KiB
PHP
<?php
|
|
/**
|
|
* Functions which enhance the theme by hooking into WordPress
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Nineteen
|
|
*/
|
|
|
|
/**
|
|
* Adds custom classes to the array of body classes.
|
|
*
|
|
* @param array $classes Classes for the body element.
|
|
* @return array
|
|
*/
|
|
function twentynineteen_body_classes( $classes ) {
|
|
|
|
if ( is_singular() ) {
|
|
// Adds `singular` to singular pages.
|
|
$classes[] = 'singular';
|
|
} else {
|
|
// Adds `hfeed` to non singular pages.
|
|
$classes[] = 'hfeed';
|
|
}
|
|
|
|
// Adds a class if image filters are enabled.
|
|
if ( twentynineteen_image_filters_enabled() ) {
|
|
$classes[] = 'image-filters-enabled';
|
|
}
|
|
|
|
return $classes;
|
|
}
|
|
add_filter( 'body_class', 'twentynineteen_body_classes' );
|
|
|
|
/**
|
|
* Add a pingback url auto-discovery header for single posts, pages, or attachments.
|
|
*/
|
|
function twentynineteen_pingback_header() {
|
|
if ( is_singular() && pings_open() ) {
|
|
echo '<link rel="pingback" href="', esc_url( get_bloginfo( 'pingback_url' ) ), '">';
|
|
}
|
|
}
|
|
add_action( 'wp_head', 'twentynineteen_pingback_header' );
|
|
|
|
/**
|
|
* Changes comment form default fields.
|
|
*/
|
|
function twentynineteen_comment_form_defaults( $defaults ) {
|
|
$comment_field = $defaults['comment_field'];
|
|
|
|
// Adjust height of comment form.
|
|
$defaults['comment_field'] = preg_replace( '/rows="\d+"/', 'rows="5"', $comment_field );
|
|
|
|
return $defaults;
|
|
}
|
|
add_filter( 'comment_form_defaults', 'twentynineteen_comment_form_defaults' );
|
|
|
|
/**
|
|
* Filters the default archive titles.
|
|
*/
|
|
function twentynineteen_get_the_archive_title() {
|
|
if ( is_category() ) {
|
|
$title = esc_html__( 'Category Archives:', 'twentynineteen' );
|
|
} elseif ( is_tag() ) {
|
|
$title = esc_html__( 'Tag Archives:', 'twentynineteen' );
|
|
} elseif ( is_author() ) {
|
|
$title = esc_html__( 'Author Archives:', 'twentynineteen' );
|
|
} elseif ( is_year() ) {
|
|
$title = esc_html__( 'Yearly Archives:', 'twentynineteen' );
|
|
} elseif ( is_month() ) {
|
|
$title = esc_html__( 'Monthly Archives:', 'twentynineteen' );
|
|
} elseif ( is_day() ) {
|
|
$title = esc_html__( 'Daily Archives:', 'twentynineteen' );
|
|
} elseif ( is_post_type_archive() ) {
|
|
$title = esc_html__( 'Post Type Archives:', 'twentynineteen' );
|
|
} elseif ( is_tax() ) {
|
|
$tax = get_taxonomy( get_queried_object()->taxonomy );
|
|
/* translators: 1: Taxonomy singular name */
|
|
$title = sprintf( __( '%s Archives: ' ), $tax->labels->singular_name );
|
|
} else {
|
|
$title = esc_html__( 'Archives:', 'twentynineteen' );
|
|
}
|
|
return $title;
|
|
}
|
|
add_filter( 'get_the_archive_title', 'twentynineteen_get_the_archive_title' );
|
|
|
|
/**
|
|
* Filters the default archive descriptions.
|
|
*/
|
|
function twentynineteen_get_the_archive_description() {
|
|
if ( is_category() || is_tag() || is_tax() ) {
|
|
$description = single_term_title( '', false );
|
|
} elseif ( is_author() ) {
|
|
$description = get_the_author_meta( 'display_name' );
|
|
} elseif ( is_post_type_archive() ) {
|
|
$description = post_type_archive_title( '', false );
|
|
} elseif ( is_year() ) {
|
|
$description = get_the_date( _x( 'Y', 'yearly archives date format', 'twentynineteen' ) );
|
|
} elseif ( is_month() ) {
|
|
$description = get_the_date( _x( 'F Y', 'monthly archives date format', 'twentynineteen' ) );
|
|
} elseif ( is_day() ) {
|
|
$description = get_the_date();
|
|
} else {
|
|
$description = null;
|
|
}
|
|
return $description;
|
|
}
|
|
add_filter( 'get_the_archive_description', 'twentynineteen_get_the_archive_description' );
|
|
|
|
/**
|
|
* Determines if post thumbnail can be displayed.
|
|
*/
|
|
function twentynineteen_can_show_post_thumbnail() {
|
|
return ! post_password_required() && ! is_attachment() && has_post_thumbnail();
|
|
}
|
|
|
|
/**
|
|
* Returns true if image filters are enabled on the theme options.
|
|
*/
|
|
function twentynineteen_image_filters_enabled() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns the size for avatars used in the theme.
|
|
*/
|
|
function twentynineteen_get_avatar_size() {
|
|
return 60;
|
|
}
|
|
|
|
/**
|
|
* Returns true if comment is by author of the post.
|
|
*
|
|
* @see get_comment_class()
|
|
*/
|
|
function twentynineteen_is_comment_by_post_author( $comment = null ) {
|
|
if ( is_object( $comment ) && $comment->user_id > 0 ) {
|
|
$user = get_userdata( $comment->user_id );
|
|
$post = get_post( $comment->comment_post_ID );
|
|
if ( ! empty( $user ) && ! empty( $post ) ) {
|
|
return $comment->user_id === $post->post_author;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Returns information about the current post's discussion, with cache support.
|
|
*/
|
|
function twentynineteen_get_discussion_data() {
|
|
static $discussion, $post_id;
|
|
$current_post_id = get_the_ID();
|
|
if ( $current_post_id === $post_id ) { /* If we have discussion information for post ID, return cached object */
|
|
return $discussion;
|
|
}
|
|
$authors = array();
|
|
$commenters = array();
|
|
$user_id = is_user_logged_in() ? get_current_user_id() : -1;
|
|
$comments = get_comments(
|
|
array(
|
|
'post_id' => $current_post_id,
|
|
'orderby' => 'comment_date_gmt',
|
|
'order' => get_option( 'comment_order', 'asc' ), /* Respect comment order from Settings » Discussion. */
|
|
'status' => 'approve',
|
|
)
|
|
);
|
|
foreach ( $comments as $comment ) {
|
|
$comment_user_id = (int) $comment->user_id;
|
|
if ( $comment_user_id !== $user_id ) {
|
|
$authors[] = ( $comment_user_id > 0 ) ? $comment_user_id : $comment->comment_author_email;
|
|
$commenters[] = $comment->comment_author_email;
|
|
}
|
|
}
|
|
$authors = array_unique( $authors );
|
|
$responses = count( $commenters );
|
|
$commenters = array_unique( $commenters );
|
|
$post_id = $current_post_id;
|
|
$discussion = (object) array(
|
|
'authors' => array_slice( $authors, 0, 6 ), /* Unique authors commenting on post (a subset of), excluding current user. */
|
|
'commenters' => count( $commenters ), /* Number of commenters involved in discussion, excluding current user. */
|
|
'responses' => $responses, /* Number of responses, excluding responses from current user. */
|
|
);
|
|
return $discussion;
|
|
}
|
|
|
|
/**
|
|
* WCAG 2.0 Attributes for Dropdown Menus
|
|
*
|
|
* Adjustments to menu attributes tot support WCAG 2.0 recommendations
|
|
* for flyout and dropdown menus.
|
|
*
|
|
* @ref https://www.w3.org/WAI/tutorials/menus/flyout/
|
|
*/
|
|
function twentynineteen_nav_menu_link_attributes( $atts, $item, $args, $depth ) {
|
|
|
|
// Add [aria-haspopup] and [aria-expanded] to menu items that have children
|
|
$item_has_children = in_array( 'menu-item-has-children', $item->classes );
|
|
if ( $item_has_children ) {
|
|
$atts['aria-haspopup'] = 'true';
|
|
$atts['aria-expanded'] = 'false';
|
|
}
|
|
|
|
return $atts;
|
|
}
|
|
add_filter( 'nav_menu_link_attributes', 'twentynineteen_nav_menu_link_attributes', 10, 4 );
|
|
|
|
/**
|
|
* Add a dropdown icon to top-level menu items
|
|
*/
|
|
function twentynineteen_add_dropdown_icons( $output, $item, $depth, $args ) {
|
|
|
|
// Only add class to 'top level' items on the 'primary' menu.
|
|
if ( 'menu-1' == $args->theme_location && 0 === $depth ) {
|
|
|
|
if ( in_array( 'menu-item-has-children', $item->classes ) ) {
|
|
$output .= twentynineteen_get_icon_svg( 'arrow_drop_down_circle', 16 );
|
|
}
|
|
} else if ( 'menu-1' == $args->theme_location && $depth >= 1 ) {
|
|
|
|
if ( in_array( 'menu-item-has-children', $item->classes ) ) {
|
|
$output .= twentynineteen_get_icon_svg( 'keyboard_arrow_right', 24 );
|
|
}
|
|
}
|
|
|
|
return $output;
|
|
}
|
|
add_filter( 'walker_nav_menu_start_el', 'twentynineteen_add_dropdown_icons', 10, 4 );
|