[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Twenty Sixteen functions and definitions
   4   *
   5   * Sets up the theme and provides some helper functions, which are used in the
   6   * theme as custom template tags. Others are attached to action and filter
   7   * hooks in WordPress to change core functionality.
   8   *
   9   * When using a child theme you can override certain functions (those wrapped
  10   * in a function_exists() call) by defining them first in your child theme's
  11   * functions.php file. The child theme's functions.php file is included before
  12   * the parent theme's file, so the child theme functions would be used.
  13   *
  14   * @link https://developer.wordpress.org/themes/basics/theme-functions/
  15   * @link https://developer.wordpress.org/themes/advanced-topics/child-themes/
  16   *
  17   * Functions that are not pluggable (not wrapped in function_exists()) are
  18   * instead attached to a filter or action hook.
  19   *
  20   * For more information on hooks, actions, and filters,
  21   * {@link https://developer.wordpress.org/plugins/}
  22   *
  23   * @package WordPress
  24   * @subpackage Twenty_Sixteen
  25   * @since Twenty Sixteen 1.0
  26   */
  27  
  28  /**
  29   * Twenty Sixteen only works in WordPress 4.4 or later.
  30   */
  31  if ( version_compare( $GLOBALS['wp_version'], '4.4-alpha', '<' ) ) {
  32      require get_template_directory() . '/inc/back-compat.php';
  33  }
  34  
  35  if ( ! function_exists( 'twentysixteen_setup' ) ) :
  36      /**
  37       * Sets up theme defaults and registers support for various WordPress features.
  38       *
  39       * Note that this function is hooked into the after_setup_theme hook, which
  40       * runs before the init hook. The init hook is too late for some features, such
  41       * as indicating support for post thumbnails.
  42       *
  43       * Create your own twentysixteen_setup() function to override in a child theme.
  44       *
  45       * @since Twenty Sixteen 1.0
  46       */
  47  	function twentysixteen_setup() {
  48          /*
  49           * Make theme available for translation.
  50           * Translations can be filed at WordPress.org. See: https://translate.wordpress.org/projects/wp-themes/twentysixteen
  51           * If you're building a theme based on Twenty Sixteen, use a find and replace
  52           * to change 'twentysixteen' to the name of your theme in all the template files.
  53           *
  54           * Manual loading of text domain is not required after the introduction of
  55           * just in time translation loading in WordPress version 4.6.
  56           *
  57           * @ticket 58318
  58           */
  59          if ( version_compare( $GLOBALS['wp_version'], '4.6', '<' ) ) {
  60              load_theme_textdomain( 'twentysixteen' );
  61          }
  62  
  63          // Add default posts and comments RSS feed links to head.
  64          add_theme_support( 'automatic-feed-links' );
  65  
  66          /*
  67           * Let WordPress manage the document title.
  68           * By adding theme support, we declare that this theme does not use a
  69           * hard-coded <title> tag in the document head, and expect WordPress to
  70           * provide it for us.
  71           */
  72          add_theme_support( 'title-tag' );
  73  
  74          /*
  75           * Enable support for custom logo.
  76           *
  77           *  @since Twenty Sixteen 1.2
  78           */
  79          add_theme_support(
  80              'custom-logo',
  81              array(
  82                  'height'      => 240,
  83                  'width'       => 240,
  84                  'flex-height' => true,
  85              )
  86          );
  87  
  88          /*
  89           * Enable support for Post Thumbnails on posts and pages.
  90           *
  91           * @link https://developer.wordpress.org/reference/functions/add_theme_support/#post-thumbnails
  92           */
  93          add_theme_support( 'post-thumbnails' );
  94          set_post_thumbnail_size( 1200, 9999 );
  95  
  96          // This theme uses wp_nav_menu() in two locations.
  97          register_nav_menus(
  98              array(
  99                  'primary' => __( 'Primary Menu', 'twentysixteen' ),
 100                  'social'  => __( 'Social Links Menu', 'twentysixteen' ),
 101              )
 102          );
 103  
 104          /*
 105           * Switch default core markup for search form, comment form, and comments
 106           * to output valid HTML5.
 107           */
 108          add_theme_support(
 109              'html5',
 110              array(
 111                  'search-form',
 112                  'comment-form',
 113                  'comment-list',
 114                  'gallery',
 115                  'caption',
 116                  'script',
 117                  'style',
 118                  'navigation-widgets',
 119              )
 120          );
 121  
 122          /*
 123           * Enable support for Post Formats.
 124           *
 125           * See: https://developer.wordpress.org/advanced-administration/wordpress/post-formats/
 126           */
 127          add_theme_support(
 128              'post-formats',
 129              array(
 130                  'aside',
 131                  'image',
 132                  'video',
 133                  'quote',
 134                  'link',
 135                  'gallery',
 136                  'status',
 137                  'audio',
 138                  'chat',
 139              )
 140          );
 141  
 142          /*
 143           * This theme styles the visual editor to resemble the theme style,
 144           * specifically font, colors, icons, and column width. When fonts are
 145           * self-hosted, the theme directory needs to be removed first.
 146           */
 147          $font_stylesheet = str_replace(
 148              array( get_template_directory_uri() . '/', get_stylesheet_directory_uri() . '/' ),
 149              '',
 150              (string) twentysixteen_fonts_url()
 151          );
 152          add_editor_style( array( 'css/editor-style.css', $font_stylesheet ) );
 153  
 154          // Load regular editor styles into the new block-based editor.
 155          add_theme_support( 'editor-styles' );
 156  
 157          // Load default block styles.
 158          add_theme_support( 'wp-block-styles' );
 159  
 160          // Add support for responsive embeds.
 161          add_theme_support( 'responsive-embeds' );
 162  
 163          // Add support for custom color scheme.
 164          add_theme_support(
 165              'editor-color-palette',
 166              array(
 167                  array(
 168                      'name'  => __( 'Dark Gray', 'twentysixteen' ),
 169                      'slug'  => 'dark-gray',
 170                      'color' => '#1a1a1a',
 171                  ),
 172                  array(
 173                      'name'  => __( 'Medium Gray', 'twentysixteen' ),
 174                      'slug'  => 'medium-gray',
 175                      'color' => '#686868',
 176                  ),
 177                  array(
 178                      'name'  => __( 'Light Gray', 'twentysixteen' ),
 179                      'slug'  => 'light-gray',
 180                      'color' => '#e5e5e5',
 181                  ),
 182                  array(
 183                      'name'  => __( 'White', 'twentysixteen' ),
 184                      'slug'  => 'white',
 185                      'color' => '#fff',
 186                  ),
 187                  array(
 188                      'name'  => __( 'Blue Gray', 'twentysixteen' ),
 189                      'slug'  => 'blue-gray',
 190                      'color' => '#4d545c',
 191                  ),
 192                  array(
 193                      'name'  => __( 'Bright Blue', 'twentysixteen' ),
 194                      'slug'  => 'bright-blue',
 195                      'color' => '#007acc',
 196                  ),
 197                  array(
 198                      'name'  => __( 'Light Blue', 'twentysixteen' ),
 199                      'slug'  => 'light-blue',
 200                      'color' => '#9adffd',
 201                  ),
 202                  array(
 203                      'name'  => __( 'Dark Brown', 'twentysixteen' ),
 204                      'slug'  => 'dark-brown',
 205                      'color' => '#402b30',
 206                  ),
 207                  array(
 208                      'name'  => __( 'Medium Brown', 'twentysixteen' ),
 209                      'slug'  => 'medium-brown',
 210                      'color' => '#774e24',
 211                  ),
 212                  array(
 213                      'name'  => __( 'Dark Red', 'twentysixteen' ),
 214                      'slug'  => 'dark-red',
 215                      'color' => '#640c1f',
 216                  ),
 217                  array(
 218                      'name'  => __( 'Bright Red', 'twentysixteen' ),
 219                      'slug'  => 'bright-red',
 220                      'color' => '#ff675f',
 221                  ),
 222                  array(
 223                      'name'  => __( 'Yellow', 'twentysixteen' ),
 224                      'slug'  => 'yellow',
 225                      'color' => '#ffef8e',
 226                  ),
 227              )
 228          );
 229  
 230          // Indicate widget sidebars can use selective refresh in the Customizer.
 231          add_theme_support( 'customize-selective-refresh-widgets' );
 232  
 233          // Add support for custom line height controls.
 234          add_theme_support( 'custom-line-height' );
 235      }
 236  endif; // twentysixteen_setup()
 237  add_action( 'after_setup_theme', 'twentysixteen_setup' );
 238  
 239  /**
 240   * Sets the content width in pixels, based on the theme's design and stylesheet.
 241   *
 242   * Priority 0 to make it available to lower priority callbacks.
 243   *
 244   * @global int $content_width
 245   *
 246   * @since Twenty Sixteen 1.0
 247   */
 248  function twentysixteen_content_width() {
 249      $GLOBALS['content_width'] = apply_filters( 'twentysixteen_content_width', 840 );
 250  }
 251  add_action( 'after_setup_theme', 'twentysixteen_content_width', 0 );
 252  
 253  /**
 254   * Adds preconnect for Google Fonts.
 255   *
 256   * @since Twenty Sixteen 1.6
 257   * @deprecated Twenty Sixteen 2.9 Disabled filter because, by default, fonts are self-hosted.
 258   *
 259   * @param array  $urls          URLs to print for resource hints.
 260   * @param string $relation_type The relation type the URLs are printed.
 261   * @return array URLs to print for resource hints.
 262   */
 263  function twentysixteen_resource_hints( $urls, $relation_type ) {
 264      if ( wp_style_is( 'twentysixteen-fonts', 'queue' ) && 'preconnect' === $relation_type ) {
 265          $urls[] = array(
 266              'href' => 'https://fonts.gstatic.com',
 267              'crossorigin',
 268          );
 269      }
 270  
 271      return $urls;
 272  }
 273  // add_filter( 'wp_resource_hints', 'twentysixteen_resource_hints', 10, 2 );
 274  
 275  /**
 276   * Registers a widget area.
 277   *
 278   * @link https://developer.wordpress.org/reference/functions/register_sidebar/
 279   *
 280   * @since Twenty Sixteen 1.0
 281   */
 282  function twentysixteen_widgets_init() {
 283      register_sidebar(
 284          array(
 285              'name'          => __( 'Sidebar', 'twentysixteen' ),
 286              'id'            => 'sidebar-1',
 287              'description'   => __( 'Add widgets here to appear in your sidebar.', 'twentysixteen' ),
 288              'before_widget' => '<section id="%1$s" class="widget %2$s">',
 289              'after_widget'  => '</section>',
 290              'before_title'  => '<h2 class="widget-title">',
 291              'after_title'   => '</h2>',
 292          )
 293      );
 294  
 295      register_sidebar(
 296          array(
 297              'name'          => __( 'Content Bottom 1', 'twentysixteen' ),
 298              'id'            => 'sidebar-2',
 299              'description'   => __( 'Appears at the bottom of the content on posts and pages.', 'twentysixteen' ),
 300              'before_widget' => '<section id="%1$s" class="widget %2$s">',
 301              'after_widget'  => '</section>',
 302              'before_title'  => '<h2 class="widget-title">',
 303              'after_title'   => '</h2>',
 304          )
 305      );
 306  
 307      register_sidebar(
 308          array(
 309              'name'          => __( 'Content Bottom 2', 'twentysixteen' ),
 310              'id'            => 'sidebar-3',
 311              'description'   => __( 'Appears at the bottom of the content on posts and pages.', 'twentysixteen' ),
 312              'before_widget' => '<section id="%1$s" class="widget %2$s">',
 313              'after_widget'  => '</section>',
 314              'before_title'  => '<h2 class="widget-title">',
 315              'after_title'   => '</h2>',
 316          )
 317      );
 318  }
 319  add_action( 'widgets_init', 'twentysixteen_widgets_init' );
 320  
 321  if ( ! function_exists( 'twentysixteen_fonts_url' ) ) :
 322      /**
 323       * Registers fonts for Twenty Sixteen.
 324       *
 325       * Create your own twentysixteen_fonts_url() function to override in a child theme.
 326       *
 327       * @since Twenty Sixteen 1.0
 328       * @since Twenty Sixteen 2.9 Replaced Google URL with self-hosted fonts.
 329       *
 330       * @return string Fonts URL for the theme.
 331       */
 332  	function twentysixteen_fonts_url() {
 333          $fonts_url = '';
 334          $fonts     = array();
 335  
 336          /*
 337           * translators: If there are characters in your language that are not supported
 338           * by Merriweather, translate this to 'off'. Do not translate into your own language.
 339           */
 340          if ( 'off' !== _x( 'on', 'Merriweather font: on or off', 'twentysixteen' ) ) {
 341              $fonts[] = 'merriweather';
 342          }
 343  
 344          /*
 345           * translators: If there are characters in your language that are not supported
 346           * by Montserrat, translate this to 'off'. Do not translate into your own language.
 347           */
 348          if ( 'off' !== _x( 'on', 'Montserrat font: on or off', 'twentysixteen' ) ) {
 349              $fonts[] = 'montserrat';
 350          }
 351  
 352          /*
 353           * translators: If there are characters in your language that are not supported
 354           * by Inconsolata, translate this to 'off'. Do not translate into your own language.
 355           */
 356          if ( 'off' !== _x( 'on', 'Inconsolata font: on or off', 'twentysixteen' ) ) {
 357              $fonts[] = 'inconsolata';
 358          }
 359  
 360          if ( $fonts ) {
 361              $fonts_url = get_template_directory_uri() . '/fonts/' . implode( '-plus-', $fonts ) . '.css';
 362          }
 363  
 364          return $fonts_url;
 365      }
 366  endif;
 367  
 368  /**
 369   * Handles JavaScript detection.
 370   *
 371   * Adds a `js` class to the root `<html>` element when JavaScript is detected.
 372   *
 373   * @since Twenty Sixteen 1.0
 374   */
 375  function twentysixteen_javascript_detection() {
 376      $js  = "(function(html){html.className = html.className.replace(/\bno-js\b/,'js')})(document.documentElement);";
 377      $js .= "\n//# sourceURL=" . rawurlencode( __FUNCTION__ );
 378  
 379      if ( function_exists( 'wp_print_inline_script_tag' ) ) {
 380          wp_print_inline_script_tag( $js );
 381      } else {
 382          echo "<script>$js</script>\n";
 383      }
 384  }
 385  add_action( 'wp_head', 'twentysixteen_javascript_detection', 0 );
 386  
 387  /**
 388   * Enqueues scripts and styles.
 389   *
 390   * @since Twenty Sixteen 1.0
 391   */
 392  function twentysixteen_scripts() {
 393      // Add custom fonts, used in the main stylesheet.
 394      $font_version = ( 0 === strpos( (string) twentysixteen_fonts_url(), get_template_directory_uri() . '/' ) ) ? '20230328' : null;
 395      wp_enqueue_style( 'twentysixteen-fonts', twentysixteen_fonts_url(), array(), $font_version );
 396  
 397      // Add Genericons, used in the main stylesheet.
 398      wp_enqueue_style( 'genericons', get_template_directory_uri() . '/genericons/genericons.css', array(), '20201208' );
 399  
 400      // Theme stylesheet.
 401      wp_enqueue_style( 'twentysixteen-style', get_stylesheet_uri(), array(), '20250715' );
 402  
 403      // Theme block stylesheet.
 404      wp_enqueue_style( 'twentysixteen-block-style', get_template_directory_uri() . '/css/blocks.css', array( 'twentysixteen-style' ), '20240817' );
 405  
 406      // Register handles for removed stylesheets and scripts.
 407      wp_register_style( 'twentysixteen-ie', false, array( 'twentysixteen-style' ) );
 408      wp_register_style( 'twentysixteen-ie8', false, array( 'twentysixteen-style' ) );
 409      wp_register_style( 'twentysixteen-ie7', false, array( 'twentysixteen-style' ) );
 410      wp_register_script( 'twentysixteen-html5', false );
 411      wp_register_script( 'twentysixteen-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20230526', array( 'in_footer' => true ) );
 412  
 413      if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
 414          wp_enqueue_script( 'comment-reply' );
 415      }
 416  
 417      if ( is_singular() && wp_attachment_is_image() ) {
 418          wp_enqueue_script( 'twentysixteen-keyboard-image-navigation', get_template_directory_uri() . '/js/keyboard-image-navigation.js', array( 'jquery' ), '20170530' );
 419      }
 420  
 421      wp_enqueue_script(
 422          'twentysixteen-script',
 423          get_template_directory_uri() . '/js/functions.js',
 424          array( 'jquery' ),
 425          '20230629',
 426          array(
 427              'in_footer' => false, // Because involves header.
 428              'strategy'  => 'defer',
 429          )
 430      );
 431  
 432      wp_localize_script(
 433          'twentysixteen-script',
 434          'screenReaderText',
 435          array(
 436              'expand'   => __( 'expand child menu', 'twentysixteen' ),
 437              'collapse' => __( 'collapse child menu', 'twentysixteen' ),
 438          )
 439      );
 440  }
 441  add_action( 'wp_enqueue_scripts', 'twentysixteen_scripts' );
 442  
 443  /**
 444   * Enqueues styles for the block-based editor.
 445   *
 446   * @since Twenty Sixteen 1.6
 447   */
 448  function twentysixteen_block_editor_styles() {
 449      // Block styles.
 450      wp_enqueue_style( 'twentysixteen-block-editor-style', get_template_directory_uri() . '/css/editor-blocks.css', array(), '20250715' );
 451      // Add custom fonts.
 452      $font_version = ( 0 === strpos( (string) twentysixteen_fonts_url(), get_template_directory_uri() . '/' ) ) ? '20230328' : null;
 453      wp_enqueue_style( 'twentysixteen-fonts', twentysixteen_fonts_url(), array(), $font_version );
 454  }
 455  add_action( 'enqueue_block_editor_assets', 'twentysixteen_block_editor_styles' );
 456  
 457  /**
 458   * Adds custom classes to the array of body classes.
 459   *
 460   * @since Twenty Sixteen 1.0
 461   *
 462   * @param array $classes Classes for the body element.
 463   * @return array (Maybe) filtered body classes.
 464   */
 465  function twentysixteen_body_classes( $classes ) {
 466      // Adds a class of custom-background-image to sites with a custom background image.
 467      if ( get_background_image() ) {
 468          $classes[] = 'custom-background-image';
 469      }
 470  
 471      // Adds a class of group-blog to sites with more than 1 published author.
 472      if ( is_multi_author() ) {
 473          $classes[] = 'group-blog';
 474      }
 475  
 476      // Adds a class of no-sidebar to sites without active sidebar.
 477      if ( ! is_active_sidebar( 'sidebar-1' ) ) {
 478          $classes[] = 'no-sidebar';
 479      }
 480  
 481      // Adds a class of hfeed to non-singular pages.
 482      if ( ! is_singular() ) {
 483          $classes[] = 'hfeed';
 484      }
 485  
 486      return $classes;
 487  }
 488  add_filter( 'body_class', 'twentysixteen_body_classes' );
 489  
 490  /**
 491   * Converts a HEX value to RGB.
 492   *
 493   * @since Twenty Sixteen 1.0
 494   *
 495   * @param string $color The original color, in 3- or 6-digit hexadecimal form.
 496   * @return array Array containing RGB (red, green, and blue) values for the given
 497   *               HEX code, empty array otherwise.
 498   */
 499  function twentysixteen_hex2rgb( $color ) {
 500      $color = trim( $color, '#' );
 501  
 502      if ( strlen( $color ) === 3 ) {
 503          $r = hexdec( substr( $color, 0, 1 ) . substr( $color, 0, 1 ) );
 504          $g = hexdec( substr( $color, 1, 1 ) . substr( $color, 1, 1 ) );
 505          $b = hexdec( substr( $color, 2, 1 ) . substr( $color, 2, 1 ) );
 506      } elseif ( strlen( $color ) === 6 ) {
 507          $r = hexdec( substr( $color, 0, 2 ) );
 508          $g = hexdec( substr( $color, 2, 2 ) );
 509          $b = hexdec( substr( $color, 4, 2 ) );
 510      } else {
 511          return array();
 512      }
 513  
 514      return array(
 515          'red'   => $r,
 516          'green' => $g,
 517          'blue'  => $b,
 518      );
 519  }
 520  
 521  /**
 522   * Custom template tags for this theme.
 523   */
 524  require get_template_directory() . '/inc/template-tags.php';
 525  
 526  
 527  /**
 528   * Registers block patterns and pattern categories.
 529   *
 530   * @since Twenty Sixteen 3.4
 531   */
 532  function twentysixteen_register_block_patterns() {
 533      require get_template_directory() . '/inc/block-patterns.php';
 534  }
 535  
 536  add_action( 'init', 'twentysixteen_register_block_patterns' );
 537  
 538  /**
 539   * Customizer additions.
 540   */
 541  require get_template_directory() . '/inc/customizer.php';
 542  
 543  /**
 544   * Adds custom image sizes attribute to enhance responsive image functionality
 545   * for content images
 546   *
 547   * @since Twenty Sixteen 1.0
 548   *
 549   * @param string $sizes A source size value for use in a 'sizes' attribute.
 550   * @param array  $size  Image size. Accepts an array of width and height
 551   *                      values in pixels (in that order).
 552   * @return string A source size value for use in a content image 'sizes' attribute.
 553   */
 554  function twentysixteen_content_image_sizes_attr( $sizes, $size ) {
 555      $width = $size[0];
 556  
 557      if ( 840 <= $width ) {
 558          $sizes = '(max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 1362px) 62vw, 840px';
 559      }
 560  
 561      if ( 'page' === get_post_type() ) {
 562          if ( 840 > $width ) {
 563              $sizes = '(max-width: ' . $width . 'px) 85vw, ' . $width . 'px';
 564          }
 565      } else {
 566          if ( 840 > $width && 600 <= $width ) {
 567              $sizes = '(max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 984px) 61vw, (max-width: 1362px) 45vw, 600px';
 568          } elseif ( 600 > $width ) {
 569              $sizes = '(max-width: ' . $width . 'px) 85vw, ' . $width . 'px';
 570          }
 571      }
 572  
 573      return $sizes;
 574  }
 575  add_filter( 'wp_calculate_image_sizes', 'twentysixteen_content_image_sizes_attr', 10, 2 );
 576  
 577  /**
 578   * Adds custom image sizes attribute to enhance responsive image functionality
 579   * for post thumbnails
 580   *
 581   * @since Twenty Sixteen 1.0
 582   *
 583   * @param string[]     $attr       Array of attribute values for the image markup, keyed by attribute name.
 584   *                                 See wp_get_attachment_image().
 585   * @param WP_Post      $attachment Image attachment post.
 586   * @param string|int[] $size       Requested image size. Can be any registered image size name, or
 587   *                                 an array of width and height values in pixels (in that order).
 588   * @return string[] The filtered attributes for the image markup.
 589   */
 590  function twentysixteen_post_thumbnail_sizes_attr( $attr, $attachment, $size ) {
 591      if ( 'post-thumbnail' === $size ) {
 592          if ( is_active_sidebar( 'sidebar-1' ) ) {
 593              $attr['sizes'] = '(max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 984px) 60vw, (max-width: 1362px) 62vw, 840px';
 594          } else {
 595              $attr['sizes'] = '(max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 1362px) 88vw, 1200px';
 596          }
 597      }
 598      return $attr;
 599  }
 600  add_filter( 'wp_get_attachment_image_attributes', 'twentysixteen_post_thumbnail_sizes_attr', 10, 3 );
 601  
 602  /**
 603   * Modifies tag cloud widget arguments to display all tags in the same font size
 604   * and use list format for better accessibility.
 605   *
 606   * @since Twenty Sixteen 1.1
 607   *
 608   * @param array $args Arguments for tag cloud widget.
 609   * @return array The filtered arguments for tag cloud widget.
 610   */
 611  function twentysixteen_widget_tag_cloud_args( $args ) {
 612      $args['largest']  = 1;
 613      $args['smallest'] = 1;
 614      $args['unit']     = 'em';
 615      $args['format']   = 'list';
 616  
 617      return $args;
 618  }
 619  add_filter( 'widget_tag_cloud_args', 'twentysixteen_widget_tag_cloud_args' );