WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
12/14/2018 02:32:33 AM (8 years ago)
Author:
pento
Message:

Default Themes: Import Twenty Nineteen from the 5.0 branch.

Merges [43808,43821,43842,43860,43892,43904,43909,43926-43929,43956,43961-43963] from the 5.0 branch to trunk.

Props allancole, karmatosed, kjellr, yingling017, mrasharirfan, milana_cap, fabiankaegy, westonruter, jorbin, netweb, b-07, khleomix, audrasjb, nielslange, mmaumio, richsalvucci, littlebigthing, dimadin, joyously, anevins, peterwilsoncc, dannycooper, iCaleb, siriokun, technosiren, travel_girl, azchughtai, ianbelanger, nadim1992, ismailelkorchi, nativeinside, chetan200891, grapplerulrich, ocean90, joshfeck, frankew, AbdulWahab610, mendezcode, eliorivero, melchoyce, joen, laurelfulford, mdawaffe, kraftbj, dsmart, nao, mayukojpn, enodekciw, ketuchetan, atanasangelovdev, poena, sharaz, artisticasad, mukesh27, burhandodhy, crunnells, aprakasa, themeroots, imonly_ik, tlxo, youthkee, brentswisher, smyoon315, mrahmadawais, desideveloper, Kau-Boy, mor10, mikeyarce, dingo_bastard, xkon, twoabove.

Fixes #45424.

Location:
trunk
Files:
2 edited
1 copied

Legend:

Unmodified
Added
Removed

  • trunk

  • trunk/src/wp-content/themes/twentynineteen/inc/template-functions.php

    r43808 r44149  
    55 * @package WordPress
    66 * @subpackage Twenty_Nineteen
     7 * @since 1.0.0
    78 */
    89
    … …  
    3334
    3435/**
     36 * Adds custom class to the array of posts classes.
     37 */
     38function twentynineteen_post_classes( $classes, $class, $post_id ) {
     39        $classes[] = 'entry';
     40
     41        return $classes;
     42}
     43add_filter( 'post_class', 'twentynineteen_post_classes', 10, 3 );
     44
     45
     46/**
    3547 * Add a pingback url auto-discovery header for single posts, pages, or attachments.
    3648 */
    … …  
    6072function twentynineteen_get_the_archive_title() {
    6173        if ( is_category() ) {
    62                 $title = esc_html__( 'Category Archives:', 'twentynineteen' );
     74                $title = __( 'Category Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>';
    6375        } elseif ( is_tag() ) {
    64                 $title = esc_html__( 'Tag Archives:', 'twentynineteen' );
     76                $title = __( 'Tag Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>';
    6577        } elseif ( is_author() ) {
    66                 $title = esc_html__( 'Author Archives:', 'twentynineteen' );
     78                $title = __( 'Author Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_author_meta( 'display_name' ) . '</span>';
    6779        } elseif ( is_year() ) {
    68                 $title = esc_html__( 'Yearly Archives:', 'twentynineteen' );
     80                $title = __( 'Yearly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'Y', 'yearly archives date format', 'twentynineteen' ) ) . '</span>';
    6981        } elseif ( is_month() ) {
    70                 $title = esc_html__( 'Monthly Archives:', 'twentynineteen' );
     82                $title = __( 'Monthly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'F Y', 'monthly archives date format', 'twentynineteen' ) ) . '</span>';
    7183        } elseif ( is_day() ) {
    72                 $title = esc_html__( 'Daily Archives:', 'twentynineteen' );
     84                $title = __( 'Daily Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date() . '</span>';
    7385        } elseif ( is_post_type_archive() ) {
    74                 $title = esc_html__( 'Post Type Archives:', 'twentynineteen' );
     86                $title = __( 'Post Type Archives: ', 'twentynineteen' ) . '<span class="page-description">' . post_type_archive_title( '', false ) . '</span>';
    7587        } elseif ( is_tax() ) {
    7688                $tax = get_taxonomy( get_queried_object()->taxonomy );
    77                 /* translators: 1: Taxonomy singular name */
    78                 $title = sprintf( __( '%s Archives: ' ), $tax->labels->singular_name );
     89                /* translators: %s: Taxonomy singular name */
     90                $title = sprintf( esc_html__( '%s Archives:', 'twentynineteen' ), $tax->labels->singular_name );
    7991        } else {
    80                 $title = esc_html__( 'Archives:', 'twentynineteen' );
     92                $title = __( 'Archives:', 'twentynineteen' );
    8193        }
    8294        return $title;
    … …  
    8597
    8698/**
    87  * Filters the default archive descriptions.
    88  */
    89 function twentynineteen_get_the_archive_description() {
    90         if ( is_category() || is_tag() || is_tax() ) {
    91                 $description = single_term_title( '', false );
    92         } elseif ( is_author() ) {
    93                 $description = get_the_author_meta( 'display_name' );
    94         } elseif ( is_post_type_archive() ) {
    95                 $description = post_type_archive_title( '', false );
    96         } elseif ( is_year() ) {
    97                 $description = get_the_date( _x( 'Y', 'yearly archives date format', 'twentynineteen' ) );
    98         } elseif ( is_month() ) {
    99                 $description = get_the_date( _x( 'F Y', 'monthly archives date format', 'twentynineteen' ) );
    100         } elseif ( is_day() ) {
    101                 $description = get_the_date();
    102         } else {
    103                 $description = null;
    104         }
    105         return $description;
    106 }
    107 add_filter( 'get_the_archive_description', 'twentynineteen_get_the_archive_description' );
    108 
    109 /**
    11099 * Determines if post thumbnail can be displayed.
    111100 */
    112101function twentynineteen_can_show_post_thumbnail() {
    113         return ! post_password_required() && ! is_attachment() && has_post_thumbnail();
     102        return apply_filters( 'twentynineteen_can_show_post_thumbnail', ! post_password_required() && ! is_attachment() && has_post_thumbnail() );
    114103}
    115104
    … …  
    118107 */
    119108function twentynineteen_image_filters_enabled() {
    120         return true;
    121 }
     109        if ( get_theme_mod( 'image_filter', 1 ) ) {
     110                return true;
     111        }
     112        return false;
     113}
     114
     115/**
     116 * Add custom sizes attribute to responsive image functionality for post thumbnails.
     117 *
     118 * @origin Twenty Nineteen 1.0
     119 *
     120 * @param array $attr  Attributes for the image markup.
     121 * @return string Value for use in post thumbnail 'sizes' attribute.
     122 */
     123function twentynineteen_post_thumbnail_sizes_attr( $attr ) {
     124
     125        if ( is_admin() ) {
     126                return $attr;
     127        }
     128
     129        if ( ! is_singular() ) {
     130                $attr['sizes'] = '(max-width: 34.9rem) calc(100vw - 2rem), (max-width: 53rem) calc(8 * (100vw / 12)), (min-width: 53rem) calc(6 * (100vw / 12)), 100vw';
     131        }
     132
     133        return $attr;
     134}
     135add_filter( 'wp_get_attachment_image_attributes', 'twentynineteen_post_thumbnail_sizes_attr', 10, 1 );
    122136
    123137/**
    … …  
    149163function twentynineteen_get_discussion_data() {
    150164        static $discussion, $post_id;
     165
    151166        $current_post_id = get_the_ID();
    152         if ( $current_post_id === $post_id ) { /* If we have discussion information for post ID, return cached object */
    153                 return $discussion;
    154         }
    155         $authors    = array();
    156         $commenters = array();
    157         $user_id    = is_user_logged_in() ? get_current_user_id() : -1;
    158         $comments   = get_comments(
     167        if ( $current_post_id === $post_id ) {
     168                return $discussion; /* If we have discussion information for post ID, return cached object */
     169        } else {
     170                $post_id = $current_post_id;
     171        }
     172
     173        $comments = get_comments(
    159174                array(
    160175                        'post_id' => $current_post_id,
    … …  
    162177                        'order'   => get_option( 'comment_order', 'asc' ), /* Respect comment order from Settings » Discussion. */
    163178                        'status'  => 'approve',
     179                        'number'  => 20, /* Only retrieve the last 20 comments, as the end goal is just 6 unique authors */
    164180                )
    165181        );
     182
     183        $authors = array();
    166184        foreach ( $comments as $comment ) {
    167                 $comment_user_id = (int) $comment->user_id;
    168                 if ( $comment_user_id !== $user_id ) {
    169                         $authors[]    = ( $comment_user_id > 0 ) ? $comment_user_id : $comment->comment_author_email;
    170                         $commenters[] = $comment->comment_author_email;
    171                 }
    172         }
     185                $authors[] = ( (int) $comment->user_id > 0 ) ? (int) $comment->user_id : $comment->comment_author_email;
     186        }
     187
    173188        $authors    = array_unique( $authors );
    174         $responses  = count( $commenters );
    175         $commenters = array_unique( $commenters );
    176         $post_id    = $current_post_id;
    177189        $discussion = (object) array(
    178                 'authors'    => array_slice( $authors, 0, 6 ), /* Unique authors commenting on post (a subset of), excluding current user. */
    179                 'commenters' => count( $commenters ),          /* Number of commenters involved in discussion, excluding current user. */
    180                 'responses'  => $responses,                    /* Number of responses, excluding responses from current user. */
     190                'authors'   => array_slice( $authors, 0, 6 ),           /* Six unique authors commenting on the post. */
     191                'responses' => get_comments_number( $current_post_id ), /* Number of responses. */
    181192        );
     193
    182194        return $discussion;
    183195}
     196
     197/**
     198 * Add an extra menu to our nav for our priority+ navigation to use
     199 *
     200 * @param object $nav_menu  Nav menu.
     201 * @param object $args      Nav menu args.
     202 * @return string More link for hidden menu items.
     203 */
     204function twentynineteen_add_ellipses_to_nav( $nav_menu, $args ) {
     205
     206        if ( 'menu-1' === $args->theme_location ) :
     207
     208                $nav_menu .= '<div class="main-menu-more">';
     209                $nav_menu .= '<ul class="main-menu" tabindex="0">';
     210                $nav_menu .= '<li class="menu-item menu-item-has-children">';
     211                $nav_menu .= '<a href="#" class="screen-reader-text" aria-label="More" aria-haspopup="true" aria-expanded="false">' . esc_html__( 'More', 'twentynineteen' ) . '</a>';
     212                $nav_menu .= '<span class="submenu-expand main-menu-more-toggle is-empty" tabindex="-1">';
     213                $nav_menu .= twentynineteen_get_icon_svg( 'arrow_drop_down_ellipsis' );
     214                $nav_menu .= '</span>';
     215                $nav_menu .= '<ul class="sub-menu hidden-links">';
     216                $nav_menu .= '<li id="menu-item--1" class="mobile-parent-nav-menu-item menu-item--1">';
     217                $nav_menu .= '<span class="menu-item-link-return">';
     218                $nav_menu .= twentynineteen_get_icon_svg( 'chevron_left' );
     219                $nav_menu .= esc_html__( 'Back', 'twentynineteen' );
     220                $nav_menu .= '</span>';
     221                $nav_menu .= '</li>';
     222                $nav_menu .= '</ul>';
     223                $nav_menu .= '</li>';
     224                $nav_menu .= '</ul>';
     225                $nav_menu .= '</div>';
     226
     227        endif;
     228
     229        return $nav_menu;
     230}
     231add_filter( 'wp_nav_menu', 'twentynineteen_add_ellipses_to_nav', 10, 2 );
    184232
    185233/**
    … …  
    205253
    206254/**
     255 * Add a dropdown icon to top-level menu items.
     256 *
     257 * @param string $output Nav menu item start element.
     258 * @param object $item   Nav menu item.
     259 * @param int    $depth  Depth.
     260 * @param object $args   Nav menu args.
     261 * @return string Nav menu item start element.
    207262 * Add a dropdown icon to top-level menu items
    208263 */
    … …  
    210265
    211266        // Only add class to 'top level' items on the 'primary' menu.
    212         if ( 'menu-1' == $args->theme_location && 0 === $depth ) {
    213 
    214                 if ( in_array( 'menu-item-has-children', $item->classes ) ) {
    215                         $output .= twentynineteen_get_icon_svg( 'arrow_drop_down_circle', 16 );
     267        if ( ! isset( $args->theme_location ) || 'menu-1' !== $args->theme_location ) {
     268                return $output;
     269        }
     270
     271        if ( in_array( 'mobile-parent-nav-menu-item', $item->classes, true ) && isset( $item->original_id ) ) {
     272                // Inject the keyboard_arrow_left SVG inside the parent nav menu item, and let the item link to the parent item.
     273                // @todo Only do this for nested submenus? If on a first-level submenu, then really the link could be "#" since the desire is to remove the target entirely.
     274                $link = sprintf(
     275                        '<span class="menu-item-link-return" tabindex="-1">%s',
     276                        twentynineteen_get_icon_svg( 'chevron_left', 24 )
     277                );
     278
     279                // replace opening <a> with <span>
     280                $output = preg_replace(
     281                        '/<a\s.*?>/',
     282                        $link,
     283                        $output,
     284                        1 // Limit.
     285                );
     286
     287                // replace closing </a> with </span>
     288                $output = preg_replace(
     289                        '#</a>#i',
     290                        '</span>',
     291                        $output,
     292                        1 // Limit.
     293                );
     294
     295        } elseif ( in_array( 'menu-item-has-children', $item->classes, true ) ) {
     296
     297                // Add SVG icon to parent items.
     298                $icon = twentynineteen_get_icon_svg( 'keyboard_arrow_down', 24 );
     299
     300                $output .= sprintf(
     301                        '<span class="submenu-expand" tabindex="-1">%s</span>',
     302                        $icon
     303                );
     304        }
     305
     306        return $output;
     307}
     308add_filter( 'walker_nav_menu_start_el', 'twentynineteen_add_dropdown_icons', 10, 4 );
     309
     310/**
     311 * Create a nav menu item to be displayed on mobile to navigate from submenu back to the parent.
     312 *
     313 * This duplicates each parent nav menu item and makes it the first child of itself.
     314 *
     315 * @param array  $sorted_menu_items Sorted nav menu items.
     316 * @param object $args              Nav menu args.
     317 * @return array Amended nav menu items.
     318 */
     319function twentynineteen_add_mobile_parent_nav_menu_items( $sorted_menu_items, $args ) {
     320        static $pseudo_id = 0;
     321        if ( ! isset( $args->theme_location ) || 'menu-1' !== $args->theme_location ) {
     322                return $sorted_menu_items;
     323        }
     324
     325        $amended_menu_items = array();
     326        foreach ( $sorted_menu_items as $nav_menu_item ) {
     327                $amended_menu_items[] = $nav_menu_item;
     328                if ( in_array( 'menu-item-has-children', $nav_menu_item->classes, true ) ) {
     329                        $parent_menu_item                   = clone $nav_menu_item;
     330                        $parent_menu_item->original_id      = $nav_menu_item->ID;
     331                        $parent_menu_item->ID               = --$pseudo_id;
     332                        $parent_menu_item->db_id            = $parent_menu_item->ID;
     333                        $parent_menu_item->object_id        = $parent_menu_item->ID;
     334                        $parent_menu_item->classes          = array( 'mobile-parent-nav-menu-item' );
     335                        $parent_menu_item->menu_item_parent = $nav_menu_item->ID;
     336
     337                        $amended_menu_items[] = $parent_menu_item;
    216338                }
    217         } else if ( 'menu-1' == $args->theme_location && $depth >= 1 ) {
    218 
    219                 if ( in_array( 'menu-item-has-children', $item->classes ) ) {
    220                         $output .= twentynineteen_get_icon_svg( 'keyboard_arrow_right', 24 );
     339        }
     340
     341        return $amended_menu_items;
     342}
     343add_filter( 'wp_nav_menu_objects', 'twentynineteen_add_mobile_parent_nav_menu_items', 10, 2 );
     344
     345/**
     346 * Convert HSL to HEX colors
     347 */
     348function twentynineteen_hsl_hex( $h, $s, $l, $to_hex = true ) {
     349
     350        $h /= 360;
     351        $s /= 100;
     352        $l /= 100;
     353
     354        $r = $l;
     355        $g = $l;
     356        $b = $l;
     357        $v = ( $l <= 0.5 ) ? ( $l * ( 1.0 + $s ) ) : ( $l + $s - $l * $s );
     358        if ( $v > 0 ) {
     359                $m;
     360                $sv;
     361                $sextant;
     362                $fract;
     363                $vsf;
     364                $mid1;
     365                $mid2;
     366
     367                $m = $l + $l - $v;
     368                $sv = ( $v - $m ) / $v;
     369                $h *= 6.0;
     370                $sextant = floor( $h );
     371                $fract = $h - $sextant;
     372                $vsf = $v * $sv * $fract;
     373                $mid1 = $m + $vsf;
     374                $mid2 = $v - $vsf;
     375
     376                switch ( $sextant ) {
     377                        case 0:
     378                                $r = $v;
     379                                $g = $mid1;
     380                                $b = $m;
     381                                break;
     382                        case 1:
     383                                $r = $mid2;
     384                                $g = $v;
     385                                $b = $m;
     386                                break;
     387                        case 2:
     388                                $r = $m;
     389                                $g = $v;
     390                                $b = $mid1;
     391                                break;
     392                        case 3:
     393                                $r = $m;
     394                                $g = $mid2;
     395                                $b = $v;
     396                                break;
     397                        case 4:
     398                                $r = $mid1;
     399                                $g = $m;
     400                                $b = $v;
     401                                break;
     402                        case 5:
     403                                $r = $v;
     404                                $g = $m;
     405                                $b = $mid2;
     406                                break;
    221407                }
    222408        }
    223 
    224         return $output;
    225 }
    226 add_filter( 'walker_nav_menu_start_el', 'twentynineteen_add_dropdown_icons', 10, 4 );
     409        $r = round( $r * 255, 0 );
     410        $g = round( $g * 255, 0 );
     411        $b = round( $b * 255, 0 );
     412
     413        if ( $to_hex ) {
     414
     415                $r = ( $r < 15 ) ? '0' . dechex( $r ) : dechex( $r );
     416                $g = ( $g < 15 ) ? '0' . dechex( $g ) : dechex( $g );
     417                $b = ( $b < 15 ) ? '0' . dechex( $b ) : dechex( $b );
     418
     419                return "#$r$g$b";
     420
     421        } else {
     422
     423                return "rgb($r, $g, $b)";
     424        }
     425}
Note: See TracChangeset for help on using the changeset viewer.