[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-content/themes/twentytwentyone/inc/ -> menu-functions.php (source)

   1  <?php
   2  /**
   3   * Functions and filters related to the menus.
   4   *
   5   * Makes the default WordPress navigation use an HTML structure similar
   6   * to the Navigation block.
   7   *
   8   * @link https://make.wordpress.org/themes/2020/07/06/printing-navigation-block-html-from-a-legacy-menu-in-themes/
   9   *
  10   * @package WordPress
  11   * @subpackage Twenty_Twenty_One
  12   * @since 1.0.0
  13   */
  14  
  15  /**
  16   * Add a button to top-level menu items that has sub-menus.
  17   * An icon is added using CSS depending on the value of aria-expanded.
  18   *
  19   * @since 1.0.0
  20   *
  21   * @param string $output Nav menu item start element.
  22   * @param object $item   Nav menu item.
  23   * @param int    $depth  Depth.
  24   * @param object $args   Nav menu args.
  25   *
  26   * @return string Nav menu item start element.
  27   */
  28  function twenty_twenty_one_add_sub_menu_toggle( $output, $item, $depth, $args ) {
  29      if ( 0 === $depth && in_array( 'menu-item-has-children', $item->classes, true ) ) {
  30  
  31          // Add toggle button.
  32          $output .= '<button class="sub-menu-toggle" aria-expanded="false" onClick="twentytwentyoneExpandSubMenu(this)">';
  33          $output .= '<span class="icon-plus">' . twenty_twenty_one_get_icon_svg( 'ui', 'plus', 18 ) . '</span>';
  34          $output .= '<span class="icon-minus">' . twenty_twenty_one_get_icon_svg( 'ui', 'minus', 18 ) . '</span>';
  35          $output .= '<span class="screen-reader-text">' . esc_html__( 'Open menu', 'twentytwentyone' ) . '</span>';
  36          $output .= '</button>';
  37      }
  38      return $output;
  39  }
  40  add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_add_sub_menu_toggle', 10, 4 );
  41  
  42  /**
  43   * Detects the social network from a URL and returns the SVG code for its icon.
  44   *
  45   * @since 1.0.0
  46   *
  47   * @param string $uri Social link.
  48   * @param int    $size The icon size in pixels.
  49   *
  50   * @return string
  51   */
  52  function twenty_twenty_one_get_social_link_svg( $uri, $size = 24 ) {
  53      return Twenty_Twenty_One_SVG_Icons::get_social_link_svg( $uri, $size );
  54  }
  55  
  56  /**
  57   * Displays SVG icons in the footer navigation.
  58   *
  59   * @param string   $item_output The menu item's starting HTML output.
  60   * @param WP_Post  $item        Menu item data object.
  61   * @param int      $depth       Depth of the menu. Used for padding.
  62   * @param stdClass $args        An object of wp_nav_menu() arguments.
  63   * @return string The menu item output with social icon.
  64   */
  65  function twenty_twenty_one_nav_menu_social_icons( $item_output, $item, $depth, $args ) {
  66      // Change SVG icon inside social links menu if there is supported URL.
  67      if ( 'footer' === $args->theme_location ) {
  68          $svg = twenty_twenty_one_get_social_link_svg( $item->url, 24 );
  69          if ( ! empty( $svg ) ) {
  70              $item_output = str_replace( $args->link_before, $svg, $item_output );
  71          }
  72      }
  73  
  74      return $item_output;
  75  }
  76  
  77  add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_nav_menu_social_icons', 10, 4 );
  78  
  79  /**
  80   * Filters the arguments for a single nav menu item.
  81   *
  82   * @since 1.0.0
  83   *
  84   * @param stdClass $args  An object of wp_nav_menu() arguments.
  85   * @param WP_Post  $item  Menu item data object.
  86   * @param int      $depth Depth of menu item. Used for padding.
  87   *
  88   * @return stdClass
  89   */
  90  function twenty_twenty_one_add_menu_description_args( $args, $item, $depth ) {
  91      $args->link_after = '';
  92      if ( 0 === $depth && isset( $item->description ) && $item->description ) {
  93          // The extra <span> element is here for styling purposes: Allows the description to not be underlined on hover.
  94          $args->link_after = '<p class="menu-item-description"><span>' . $item->description . '</span></p>';
  95      }
  96      return $args;
  97  }
  98  add_filter( 'nav_menu_item_args', 'twenty_twenty_one_add_menu_description_args', 10, 3 );


Generated: Mon Nov 30 01:00:03 2020 Cross-referenced by PHPXref 0.7.1