Changeset 43842 for branches/5.0/src/wp-content/themes/twentynineteen/inc/template-functions.php

Timestamp:

10/30/2018 02:13:07 AM (7 years ago)

Author:

allancole

Message:

Importing Twenty Nineteen, our new default theme for 2019, set for 5.0.

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, peterwilsoncc, dannycooper, icaleb, siriokun, technosiren, travel_girl, azchughtai, ianbelanger, nadim1992, ismailelkorchi, nativeinside, chetan200891, icaleb, grapplerulrich, ocean90, joshfeck, frankew, abdulwahab610, mendezcode, eliorivero, melchoyce, joen, laurelfulford, mdawaffe, kraftbj, dsmart.

File:

• branches/5.0/src/wp-content/themes/twentynineteen/inc/template-functions.php (modified) (9 diffs)

branches/5.0/src/wp-content/themes/twentynineteen/inc/template-functions.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage Twenty_Nineteen
+ * @since 1.0.0
  */
 
@@ -33 +34 @@
 
 /**
+ * Adds custom class to the array of posts classes.
+ */
+function twentynineteen_post_classes( $classes, $class, $post_id ) {
+    $classes[] = 'entry';
+
+    return $classes;
+}
+add_filter( 'post_class', 'twentynineteen_post_classes', 10, 3 );
+
+
+/**
  * Add a pingback url auto-discovery header for single posts, pages, or attachments.
  */
@@ -60 +72 @@
 function twentynineteen_get_the_archive_title() {
     if ( is_category() ) {
-        $title = esc_html__( 'Category Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Category Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>';
     } elseif ( is_tag() ) {
-        $title = esc_html__( 'Tag Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Tag Archives: ', 'twentynineteen' ) . '<span class="page-description">' . single_term_title( '', false ) . '</span>';
     } elseif ( is_author() ) {
-        $title = esc_html__( 'Author Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Author Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_author_meta( 'display_name' ) . '</span>';
     } elseif ( is_year() ) {
-        $title = esc_html__( 'Yearly Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Yearly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'Y', 'yearly archives date format', 'twentynineteen' ) ) . '</span>';
     } elseif ( is_month() ) {
-        $title = esc_html__( 'Monthly Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Monthly Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date( _x( 'F Y', 'monthly archives date format', 'twentynineteen' ) ) . '</span>';
     } elseif ( is_day() ) {
-        $title = esc_html__( 'Daily Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Daily Archives: ', 'twentynineteen' ) . '<span class="page-description">' . get_the_date() . '</span>';
     } elseif ( is_post_type_archive() ) {
-        $title = esc_html__( 'Post Type Archives:', 'twentynineteen' );
+        $title = esc_html__( 'Post Type Archives: ', 'twentynineteen' ) . '<span class="page-description">' . post_type_archive_title( '', false ) . '</span>';
     } elseif ( is_tax() ) {
         $tax = get_taxonomy( get_queried_object()->taxonomy );
-        /* translators: 1: Taxonomy singular name */
-        $title = sprintf( __( '%s Archives: ' ), $tax->labels->singular_name );
+        /* translators: %s: Taxonomy singular name */
+        $title = sprintf( esc_html__( '%s Archives:', 'twentynineteen' ), $tax->labels->singular_name );
     } else {
         $title = esc_html__( 'Archives:', 'twentynineteen' );
@@ -85 +97 @@
 
 /**
- * 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();
+    return apply_filters( 'twentynineteen_can_show_post_thumbnail', ! post_password_required() && ! is_attachment() && has_post_thumbnail() );
 }
 
@@ -118 +107 @@
  */
 function twentynineteen_image_filters_enabled() {
+    if ( 'inactive' === get_theme_mod( 'image_filter' ) ) {
+        return false;
+    }
     return true;
 }
@@ -155 +147 @@
     $authors    = array();
     $commenters = array();
-    $user_id    = is_user_logged_in() ? get_current_user_id() : -1;
+    $user_id    = -1; // is_user_logged_in() ? get_current_user_id() : -1;
     $comments   = get_comments(
         array(
@@ -205 +197 @@
 
 /**
+ * Add a dropdown icon to top-level menu items.
+ *
+ * @param string $output Nav menu item start element.
+ * @param object $item   Nav menu item.
+ * @param int    $depth  Depth.
+ * @param object $args   Nav menu args.
+ * @return string Nav menu item start element.
  * Add a dropdown icon to top-level menu items
  */
@@ -210 +209 @@
 
     // 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 );
-        }
+    if ( ! isset( $args->theme_location ) || 'menu-1' !== $args->theme_location ) {
+        return $output;
+    }
+
+    if ( in_array( 'mobile-parent-nav-menu-item', $item->classes, true ) && isset( $item->original_id ) ) {
+        // Inject the keyboard_arrow_left SVG inside the parent nav menu item, and let the item link to the parent item.
+        // @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.
+        $link = sprintf(
+            '<a class="menu-item-link-return" id="%1$s" href="%2$s" onclick="%3$s" tabindex="-1">%4$s',
+            esc_attr( "menu-item-link-return-{$item->original_id}" ),
+            esc_attr( "#menu-item-link-{$item->original_id}" ),
+            esc_attr( 'event.preventDefault();' ),
+            twentynineteen_get_icon_svg( 'chevron_left', 24 )
+        );
+
+        $output = preg_replace(
+            '/<a\s.*?>/',
+            $link,
+            $output,
+            1 // Limit.
+        );
+    } elseif ( in_array( 'menu-item-has-children', $item->classes, true ) ) {
+        // Add an ID to the link element itself to facilitate navigation from submenu back to parent.
+        $output = preg_replace( '/(?<=<a\s)/', sprintf( ' id="%s" ', esc_attr( "menu-item-link-{$item->ID}" ) ), $output );
+
+        // Add SVG icon to parent items.
+        if ( 0 === $depth ) {
+            $icon = twentynineteen_get_icon_svg( 'keyboard_arrow_down', 24 );
+        } else {
+            $icon = twentynineteen_get_icon_svg( 'chevron_right', 24 );
+        }
+
+        // @todo We might as well just go back to using the SVG element if the link approach is not suitable for no-JS environments.
+        $link = sprintf(
+            '<a class="mobile-submenu-expand" href="%s" onclick="%s" tabindex="-1">%s</a>',
+            esc_attr( "#menu-item-link-return-{$item->ID}" ),
+            esc_attr( 'event.preventDefault();' ),
+            $icon
+        );
+
+        $output .= $link;
+        $output .= "<span class='desktop-submenu-expand'>$icon</span>";
     }
 
@@ -225 +256 @@
 }
 add_filter( 'walker_nav_menu_start_el', 'twentynineteen_add_dropdown_icons', 10, 4 );
+
+/**
+ * Create a nav menu item to be displayed on mobile to navigate from submenu back to the parent.
+ *
+ * This duplicates each parent nav menu item and makes it the first child of itself.
+ *
+ * @param array  $sorted_menu_items Sorted nav menu items.
+ * @param object $args              Nav menu args.
+ * @return array Amended nav menu items.
+ */
+function twentynineteen_add_mobile_parent_nav_menu_items( $sorted_menu_items, $args ) {
+    static $pseudo_id = 0;
+    if ( ! isset( $args->theme_location ) || 'menu-1' !== $args->theme_location ) {
+        return $sorted_menu_items;
+    }
+
+    $amended_menu_items = array();
+    foreach ( $sorted_menu_items as $nav_menu_item ) {
+        $amended_menu_items[] = $nav_menu_item;
+        if ( in_array( 'menu-item-has-children', $nav_menu_item->classes, true ) ) {
+            $parent_menu_item                   = clone $nav_menu_item;
+            $parent_menu_item->original_id      = $nav_menu_item->ID;
+            $parent_menu_item->ID               = --$pseudo_id;
+            $parent_menu_item->db_id            = $parent_menu_item->ID;
+            $parent_menu_item->object_id        = $parent_menu_item->ID;
+            $parent_menu_item->classes          = array( 'mobile-parent-nav-menu-item' );
+            $parent_menu_item->menu_item_parent = $nav_menu_item->ID;
+
+            $amended_menu_items[] = $parent_menu_item;
+        }
+    }
+
+    return $amended_menu_items;
+}
+add_filter( 'wp_nav_menu_objects', 'twentynineteen_add_mobile_parent_nav_menu_items', 10, 2 );
+
+/**
+ * Convert HSL to HEX colors
+ */
+function twentynineteen_hsl_hex( $h, $s, $l, $to_hex = true ) {
+
+    $h /= 360;
+    $s /= 100;
+    $l /= 100;
+
+    $r = $l;
+    $g = $l;
+    $b = $l;
+    $v = ( $l <= 0.5 ) ? ( $l * ( 1.0 + $s ) ) : ( $l + $s - $l * $s );
+    if ( $v > 0 ) {
+        $m;
+        $sv;
+        $sextant;
+        $fract;
+        $vsf;
+        $mid1;
+        $mid2;
+
+        $m = $l + $l - $v;
+        $sv = ( $v - $m ) / $v;
+        $h *= 6.0;
+        $sextant = floor( $h );
+        $fract = $h - $sextant;
+        $vsf = $v * $sv * $fract;
+        $mid1 = $m + $vsf;
+        $mid2 = $v - $vsf;
+
+        switch ( $sextant ) {
+            case 0:
+                $r = $v;
+                $g = $mid1;
+                $b = $m;
+                break;
+            case 1:
+                $r = $mid2;
+                $g = $v;
+                $b = $m;
+                break;
+            case 2:
+                $r = $m;
+                $g = $v;
+                $b = $mid1;
+                break;
+            case 3:
+                $r = $m;
+                $g = $mid2;
+                $b = $v;
+                break;
+            case 4:
+                $r = $mid1;
+                $g = $m;
+                $b = $v;
+                break;
+            case 5:
+                $r = $v;
+                $g = $m;
+                $b = $mid2;
+                break;
+        }
+    }
+    $r = round( $r * 255, 0 );
+    $g = round( $g * 255, 0 );
+    $b = round( $b * 255, 0 );
+
+    if ( $to_hex ) {
+
+        $r = ( $r < 15 ) ? '0' . dechex( $r ) : dechex( $r );
+        $g = ( $g < 15 ) ? '0' . dechex( $g ) : dechex( $g );
+        $b = ( $b < 15 ) ? '0' . dechex( $b ) : dechex( $b );
+
+        return "#$r$g$b";
+
+    } else {
+
+        return "rgb($r, $g, $b)";
+    }
+}