RECENT POSTS FOR
Numerous influences – from finances to the desire for inter-generational joy, to health monitoring – are fueling the surge in multi-generational households. In our last post we looked at some of our most popular multi-generational home designs, showcasing various bedroom arrangements. Herein we’ll look at designs that also provide separate living areas.
Design Basics values the relationships we have with select companies that also market our home plans. Quite simply, more people have the opportunity to consider our company’s designs when searching for a house plan. Which then begs the question, “Why buy directly from Design Basics?”
Whether the basis for new home design or modifying an existing home plan for enhanced livability and style, Woman-Centric home design is how we help buyers get the best home for their investment. Woman-Centric home design is having a profound impact on American housing.
TRAFFIC! Just hearing that word can make us cringe. The last thing we need inside our ‘home sweet home’ is issues with traffic! Whether we’re unwinding from the outside world or interacting with family members inside, we need our house design to foster tranquility.
We long for our homes to be our retreats. We yearn for sanctuary, for extended moments of peace and quiet, for an escape from all that life is throwing at us. Still, scarce attention is paid to what we can do to achieve the freedom we seek from unwanted noises.
Home designers know natural light is one of the most important elements of residential design. We are drawn to places in our homes that are bathed in natural light and oftentimes we don’t even realize it. But whether we’re having friends over or simply curling up with...
“When the price is higher, people tend to focus on the things that make it higher. When the price is lower people tend to focus on things explaining why it’s lower,” William Poundstone wrote in his book, Priceless. Which do you want? Prospective buyers touring your...
Prospective customers rule you “in” or “out” based on your homes’ exteriors. It’s a fact. Overwhelmed by too many choices, buyers use shortcuts to narrow the number of home builders they will consider. One of those shortcuts is your elevation designs. Photographs can...
Problem: Most families enter their home through the garage, but once you get inside, where does your stuff go? Where do you hang your jackets, stash your shoes, backpacks, handbags, etc.? And, when you leave in the morning how can you make it more convenient to get...
Problem: Statements like, "When I get home, everything seems to end up on the kitchen table," or "Everything the kids walk in with gets left on the island," these and similar comments inspired one of our most popular Woman-Centric design innovations, the Drop Zone...
Current Dir: /var/www/designbasics/wp-includes/ [DIR] ID3 [ delete | rename ] [DIR] IXR [ delete | rename ] [DIR] PHPMailer [ delete | rename ] [DIR] Requests [ delete | rename ] [DIR] SimplePie [ delete | rename ] [DIR] Text [ delete | rename ] [FILE] admin-bar.php [ edit | delete | rename ] [DIR] assets [ delete | rename ] [FILE] atomlib.php [ edit | delete | rename ] [FILE] author-template.php [ edit | delete | rename ] [DIR] block-bindings [ delete | rename ] [FILE] block-bindings.php [ edit | delete | rename ] [FILE] block-editor.php [ edit | delete | rename ] [FILE] block-i18n.json [ edit | delete | rename ] [DIR] block-patterns [ delete | rename ] [FILE] block-patterns.php [ edit | delete | rename ] [DIR] block-supports [ delete | rename ] [FILE] block-template-utils.php [ edit | delete | rename ] [FILE] block-template.php [ edit | delete | rename ] [DIR] blocks [ delete | rename ] [FILE] blocks.php [ edit | delete | rename ] [FILE] bookmark-template.php [ edit | delete | rename ] [FILE] bookmark.php [ edit | delete | rename ] [FILE] cache-compat.php [ edit | delete | rename ] [FILE] cache.php [ edit | delete | rename ] [FILE] canonical.php [ edit | delete | rename ] [FILE] capabilities.php [ edit | delete | rename ] [FILE] category-template.php [ edit | delete | rename ] [FILE] category.php [ edit | delete | rename ] [DIR] certificates [ delete | rename ] [FILE] class-IXR.php [ edit | delete | rename ] [FILE] class-avif-info.php [ edit | delete | rename ] [FILE] class-feed.php [ edit | delete | rename ] [FILE] class-http.php [ edit | delete | rename ] [FILE] class-json.php [ edit | delete | rename ] [FILE] class-oembed.php [ edit | delete | rename ] [FILE] class-phpass.php [ edit | delete | rename ] [FILE] class-phpmailer.php [ edit | delete | rename ] [FILE] class-pop3.php [ edit | delete | rename ] [FILE] class-requests.php [ edit | delete | rename ] [FILE] class-simplepie.php [ edit | delete | rename ] [FILE] class-smtp.php [ edit | delete | rename ] [FILE] class-snoopy.php [ edit | delete | rename ] [FILE] class-walker-category-dropdown.php [ edit | delete | rename ] [FILE] class-walker-category.php [ edit | delete | rename ] [FILE] class-walker-comment.php [ edit | delete | rename ] [FILE] class-walker-nav-menu.php [ edit | delete | rename ] [FILE] class-walker-page-dropdown.php [ edit | delete | rename ] [FILE] class-walker-page.php [ edit | delete | rename ] [FILE] class-wp-admin-bar.php [ edit | delete | rename ] [FILE] class-wp-ajax-response.php [ edit | delete | rename ] [FILE] class-wp-application-passwords.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-registry.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-source.php [ edit | delete | rename ] [FILE] class-wp-block-editor-context.php [ edit | delete | rename ] [FILE] class-wp-block-list.php [ edit | delete | rename ] [FILE] class-wp-block-parser-block.php [ edit | delete | rename ] [FILE] class-wp-block-parser-frame.php [ edit | delete | rename ] [FILE] class-wp-block-parser.php [ edit | delete | rename ] [FILE] class-wp-block-pattern-categories-registry.php [ edit | delete | rename ] [FILE] class-wp-block-patterns-registry.php [ edit | delete | rename ] [FILE] class-wp-block-styles-registry.php [ edit | delete | rename ] [FILE] class-wp-block-supports.php [ edit | delete | rename ] [FILE] class-wp-block-template.php [ edit | delete | rename ] [FILE] class-wp-block-type-registry.php [ edit | delete | rename ] [FILE] class-wp-block-type.php [ edit | delete | rename ] [FILE] class-wp-block.php [ edit | delete | rename ] [FILE] class-wp-classic-to-block-menu-converter.php [ edit | delete | rename ] [FILE] class-wp-comment-query.php [ edit | delete | rename ] [FILE] class-wp-comment.php [ edit | delete | rename ] [FILE] class-wp-customize-control.php [ edit | delete | rename ] [FILE] class-wp-customize-manager.php [ edit | delete | rename ] [FILE] class-wp-customize-nav-menus.php [ edit | delete | rename ] [FILE] class-wp-customize-panel.php [ edit | delete | rename ] [FILE] class-wp-customize-section.php [ edit | delete | rename ] [FILE] class-wp-customize-setting.php [ edit | delete | rename ] [FILE] class-wp-customize-widgets.php [ edit | delete | rename ] [FILE] class-wp-date-query.php [ edit | delete | rename ] [FILE] class-wp-dependencies.php [ edit | delete | rename ] [FILE] class-wp-dependency.php [ edit | delete | rename ] [FILE] class-wp-duotone.php [ edit | delete | rename ] [FILE] class-wp-editor.php [ edit | delete | rename ] [FILE] class-wp-embed.php [ edit | delete | rename ] [FILE] class-wp-error.php [ edit | delete | rename ] [FILE] class-wp-fatal-error-handler.php [ edit | delete | rename ] [FILE] class-wp-feed-cache-transient.php [ edit | delete | rename ] [FILE] class-wp-feed-cache.php [ edit | delete | rename ] [FILE] class-wp-hook.php [ edit | delete | rename ] [FILE] class-wp-http-cookie.php [ edit | delete | rename ] [FILE] class-wp-http-curl.php [ edit | delete | rename ] [FILE] class-wp-http-encoding.php [ edit | delete | rename ] [FILE] class-wp-http-ixr-client.php [ edit | delete | rename ] [FILE] class-wp-http-proxy.php [ edit | delete | rename ] [FILE] class-wp-http-requests-hooks.php [ edit | delete | rename ] [FILE] class-wp-http-requests-response.php [ edit | delete | rename ] [FILE] class-wp-http-response.php [ edit | delete | rename ] [FILE] class-wp-http-streams.php [ edit | delete | rename ] [FILE] class-wp-http.php [ edit | delete | rename ] [FILE] class-wp-image-editor-gd.php [ edit | delete | rename ] [FILE] class-wp-image-editor-imagick.php [ edit | delete | rename ] [FILE] class-wp-image-editor.php [ edit | delete | rename ] [FILE] class-wp-list-util.php [ edit | delete | rename ] [FILE] class-wp-locale-switcher.php [ edit | delete | rename ] [FILE] class-wp-locale.php [ edit | delete | rename ] [FILE] class-wp-matchesmapregex.php [ edit | delete | rename ] [FILE] class-wp-meta-query.php [ edit | delete | rename ] [FILE] class-wp-metadata-lazyloader.php [ edit | delete | rename ] [FILE] class-wp-navigation-fallback.php [ edit | delete | rename ] [FILE] class-wp-network-query.php [ edit | delete | rename ] [FILE] class-wp-network.php [ edit | delete | rename ] [FILE] class-wp-object-cache.php [ edit | delete | rename ] [FILE] class-wp-oembed-controller.php [ edit | delete | rename ] [FILE] class-wp-oembed.php [ edit | delete | rename ] [FILE] class-wp-paused-extensions-storage.php [ edit | delete | rename ] [FILE] class-wp-plugin-dependencies.php [ edit | delete | rename ] [FILE] class-wp-post-type.php [ edit | delete | rename ] [FILE] class-wp-post.php [ edit | delete | rename ] [FILE] class-wp-query.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-cookie-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-email-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-key-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-link-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode.php [ edit | delete | rename ] [FILE] class-wp-rewrite.php [ edit | delete | rename ] [FILE] class-wp-role.php [ edit | delete | rename ] [FILE] class-wp-roles.php [ edit | delete | rename ] [FILE] class-wp-script-modules.php [ edit | delete | rename ] [FILE] class-wp-scripts.php [ edit | delete | rename ] [FILE] class-wp-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-simplepie-file.php [ edit | delete | rename ] [FILE] class-wp-simplepie-sanitize-kses.php [ edit | delete | rename ] [FILE] class-wp-site-query.php [ edit | delete | rename ] [FILE] class-wp-site.php [ edit | delete | rename ] [FILE] class-wp-styles.php [ edit | delete | rename ] [FILE] class-wp-tax-query.php [ edit | delete | rename ] [FILE] class-wp-taxonomy.php [ edit | delete | rename ] [FILE] class-wp-term-query.php [ edit | delete | rename ] [FILE] class-wp-term.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-inline.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-table.php [ edit | delete | rename ] [FILE] class-wp-textdomain-registry.php [ edit | delete | rename ] [FILE] class-wp-theme-json-data.php [ edit | delete | rename ] [FILE] class-wp-theme-json-resolver.php [ edit | delete | rename ] [FILE] class-wp-theme-json-schema.php [ edit | delete | rename ] [FILE] class-wp-theme-json.php [ edit | delete | rename ] [FILE] class-wp-theme.php [ edit | delete | rename ] [FILE] class-wp-token-map.php [ edit | delete | rename ] [FILE] class-wp-user-meta-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-user-query.php [ edit | delete | rename ] [FILE] class-wp-user-request.php [ edit | delete | rename ] [FILE] class-wp-user.php [ edit | delete | rename ] [FILE] class-wp-walker.php [ edit | delete | rename ] [FILE] class-wp-widget-factory.php [ edit | delete | rename ] [FILE] class-wp-widget.php [ edit | delete | rename ] [FILE] class-wp-xmlrpc-server.php [ edit | delete | rename ] [FILE] class-wp.php [ edit | delete | rename ] [FILE] class-wpdb.php [ edit | delete | rename ] [FILE] class.wp-dependencies.php [ edit | delete | rename ] [FILE] class.wp-scripts.php [ edit | delete | rename ] [FILE] class.wp-styles.php [ edit | delete | rename ] [FILE] comment-template.php [ edit | delete | rename ] [FILE] comment.php [ edit | delete | rename ] [FILE] compat.php [ edit | delete | rename ] [FILE] cron.php [ edit | delete | rename ] [DIR] css [ delete | rename ] [DIR] customize [ delete | rename ] [FILE] date.php [ edit | delete | rename ] [FILE] default-constants.php [ edit | delete | rename ] [FILE] default-filters.php [ edit | delete | rename ] [FILE] default-widgets.php [ edit | delete | rename ] [FILE] deprecated.php [ edit | delete | rename ] [FILE] embed-template.php [ edit | delete | rename ] [FILE] embed.php [ edit | delete | rename ] [FILE] error-protection.php [ edit | delete | rename ] [FILE] feed-atom-comments.php [ edit | delete | rename ] [FILE] feed-atom.php [ edit | delete | rename ] [FILE] feed-rdf.php [ edit | delete | rename ] [FILE] feed-rss.php [ edit | delete | rename ] [FILE] feed-rss2-comments.php [ edit | delete | rename ] [FILE] feed-rss2.php [ edit | delete | rename ] [FILE] feed.php [ edit | delete | rename ] [DIR] fonts [ delete | rename ] [FILE] fonts.php [ edit | delete | rename ] [FILE] formatting.php [ edit | delete | rename ] [FILE] functions.php [ edit | delete | rename ] [FILE] functions.wp-scripts.php [ edit | delete | rename ] [FILE] functions.wp-styles.php [ edit | delete | rename ] [FILE] general-template.php [ edit | delete | rename ] [FILE] global-styles-and-settings.php [ edit | delete | rename ] [DIR] html-api [ delete | rename ] [FILE] http.php [ edit | delete | rename ] [FILE] https-detection.php [ edit | delete | rename ] [FILE] https-migration.php [ edit | delete | rename ] [DIR] images [ delete | rename ] [DIR] interactivity-api [ delete | rename ] [DIR] js [ delete | rename ] [FILE] kses.php [ edit | delete | rename ] [DIR] l10n [ delete | rename ] [FILE] l10n.php [ edit | delete | rename ] [FILE] link-template.php [ edit | delete | rename ] [FILE] load.php [ edit | delete | rename ] [FILE] locale.php [ edit | delete | rename ] [FILE] media-template.php [ edit | delete | rename ] [FILE] media.php [ edit | delete | rename ] [FILE] meta.php [ edit | delete | rename ] [FILE] ms-blogs.php [ edit | delete | rename ] [FILE] ms-default-constants.php [ edit | delete | rename ] [FILE] ms-default-filters.php [ edit | delete | rename ] [FILE] ms-deprecated.php [ edit | delete | rename ] [FILE] ms-files.php [ edit | delete | rename ] [FILE] ms-functions.php [ edit | delete | rename ] [FILE] ms-load.php [ edit | delete | rename ] [FILE] ms-network.php [ edit | delete | rename ] [FILE] ms-settings.php [ edit | delete | rename ] [FILE] ms-site.php [ edit | delete | rename ] [FILE] nav-menu-template.php [ edit | delete | rename ] [FILE] nav-menu.php [ edit | delete | rename ] [FILE] option.php [ edit | delete | rename ] [DIR] php-compat [ delete | rename ] [FILE] pluggable-deprecated.php [ edit | delete | rename ] [FILE] pluggable.php [ edit | delete | rename ] [FILE] plugin.php [ edit | delete | rename ] [DIR] pomo [ delete | rename ] [FILE] post-formats.php [ edit | delete | rename ] [FILE] post-template.php [ edit | delete | rename ] [FILE] post-thumbnail-template.php [ edit | delete | rename ] [FILE] post.php [ edit | delete | rename ] [FILE] query.php [ edit | delete | rename ] [FILE] registration-functions.php [ edit | delete | rename ] [FILE] registration.php [ edit | delete | rename ] [DIR] rest-api [ delete | rename ] [FILE] rest-api.php [ edit | delete | rename ] [FILE] revision.php [ edit | delete | rename ] [FILE] rewrite.php [ edit | delete | rename ] [FILE] robots-template.php [ edit | delete | rename ] [FILE] rss-functions.php [ edit | delete | rename ] [FILE] rss.php [ edit | delete | rename ] [FILE] script-loader.php [ edit | delete | rename ] [FILE] script-modules.php [ edit | delete | rename ] [FILE] session.php [ edit | delete | rename ] [FILE] shortcodes.php [ edit | delete | rename ] [DIR] sitemaps [ delete | rename ] [FILE] sitemaps.php [ edit | delete | rename ] [DIR] sodium_compat [ delete | rename ] [FILE] spl-autoload-compat.php [ edit | delete | rename ] [DIR] style-engine [ delete | rename ] [FILE] style-engine.php [ edit | delete | rename ] [FILE] taxonomy.php [ edit | delete | rename ] [FILE] template-canvas.php [ edit | delete | rename ] [FILE] template-loader.php [ edit | delete | rename ] [FILE] template.php [ edit | delete | rename ] [DIR] theme-compat [ delete | rename ] [FILE] theme-i18n.json [ edit | delete | rename ] [FILE] theme-previews.php [ edit | delete | rename ] [FILE] theme-templates.php [ edit | delete | rename ] [FILE] theme.json [ edit | delete | rename ] [FILE] theme.php [ edit | delete | rename ] [FILE] update.php [ edit | delete | rename ] [FILE] user.php [ edit | delete | rename ] [FILE] vars.php [ edit | delete | rename ] [FILE] version.php [ edit | delete | rename ] [DIR] widgets [ delete | rename ] [FILE] widgets.php [ edit | delete | rename ] [FILE] wp-db.php [ edit | delete | rename ] [FILE] wp-diff.php [ edit | delete | rename ] Viewing: /var/www/designbasics/wp-includes/nav-menu-template.php <?php /** * Nav Menu API: Template functions * * @package WordPress * @subpackage Nav_Menus * @since 3.0.0 */ /** Walker_Nav_Menu class */ require_once ABSPATH . WPINC . '/class-walker-nav-menu.php'; /** * Displays a navigation menu. * * @since 3.0.0 * @since 4.7.0 Added the `item_spacing` argument. * @since 5.5.0 Added the `container_aria_label` argument. * * @param array $args { * Optional. Array of nav menu arguments. * * @type int|string|WP_Term $menu Desired menu. Accepts a menu ID, slug, name, or object. * Default empty. * @type string $menu_class CSS class to use for the ul element which forms the menu. * Default 'menu'. * @type string $menu_id The ID that is applied to the ul element which forms the menu. * Default is the menu slug, incremented. * @type string $container Whether to wrap the ul, and what to wrap it with. * Default 'div'. * @type string $container_class Class that is applied to the container. * Default 'menu-{menu slug}-container'. * @type string $container_id The ID that is applied to the container. Default empty. * @type string $container_aria_label The aria-label attribute that is applied to the container * when it's a nav element. Default empty. * @type callable|false $fallback_cb If the menu doesn't exist, a callback function will fire. * Default is 'wp_page_menu'. Set to false for no fallback. * @type string $before Text before the link markup. Default empty. * @type string $after Text after the link markup. Default empty. * @type string $link_before Text before the link text. Default empty. * @type string $link_after Text after the link text. Default empty. * @type bool $echo Whether to echo the menu or return it. Default true. * @type int $depth How many levels of the hierarchy are to be included. * 0 means all. Default 0. * Default 0. * @type object $walker Instance of a custom walker class. Default empty. * @type string $theme_location Theme location to be used. Must be registered with * register_nav_menu() in order to be selectable by the user. * @type string $items_wrap How the list items should be wrapped. Uses printf() format with * numbered placeholders. Default is a ul with an id and class. * @type string $item_spacing Whether to preserve whitespace within the menu's HTML. * Accepts 'preserve' or 'discard'. Default 'preserve'. * } * @return void|string|false Void if 'echo' argument is true, menu output if 'echo' is false. * False if there are no items or no menu was found. */ function wp_nav_menu( $args = array() ) { static $menu_id_slugs = array(); $defaults = array( 'menu' => '', 'container' => 'div', 'container_class' => '', 'container_id' => '', 'container_aria_label' => '', 'menu_class' => 'menu', 'menu_id' => '', 'echo' => true, 'fallback_cb' => 'wp_page_menu', 'before' => '', 'after' => '', 'link_before' => '', 'link_after' => '', 'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>', 'item_spacing' => 'preserve', 'depth' => 0, 'walker' => '', 'theme_location' => '', ); $args = wp_parse_args( $args, $defaults ); if ( ! in_array( $args['item_spacing'], array( 'preserve', 'discard' ), true ) ) { // Invalid value, fall back to default. $args['item_spacing'] = $defaults['item_spacing']; } /** * Filters the arguments used to display a navigation menu. * * @since 3.0.0 * * @see wp_nav_menu() * * @param array $args Array of wp_nav_menu() arguments. */ $args = apply_filters( 'wp_nav_menu_args', $args ); $args = (object) $args; /** * Filters whether to short-circuit the wp_nav_menu() output. * * Returning a non-null value from the filter will short-circuit wp_nav_menu(), * echoing that value if $args->echo is true, returning that value otherwise. * * @since 3.9.0 * * @see wp_nav_menu() * * @param string|null $output Nav menu output to short-circuit with. Default null. * @param stdClass $args An object containing wp_nav_menu() arguments. */ $nav_menu = apply_filters( 'pre_wp_nav_menu', null, $args ); if ( null !== $nav_menu ) { if ( $args->echo ) { echo $nav_menu; return; } return $nav_menu; } // Get the nav menu based on the requested menu. $menu = wp_get_nav_menu_object( $args->menu ); // Get the nav menu based on the theme_location. $locations = get_nav_menu_locations(); if ( ! $menu && $args->theme_location && $locations && isset( $locations[ $args->theme_location ] ) ) { $menu = wp_get_nav_menu_object( $locations[ $args->theme_location ] ); } // Get the first menu that has items if we still can't find a menu. if ( ! $menu && ! $args->theme_location ) { $menus = wp_get_nav_menus(); foreach ( $menus as $menu_maybe ) { $menu_items = wp_get_nav_menu_items( $menu_maybe->term_id, array( 'update_post_term_cache' => false ) ); if ( $menu_items ) { $menu = $menu_maybe; break; } } } if ( empty( $args->menu ) ) { $args->menu = $menu; } // If the menu exists, get its items. if ( $menu && ! is_wp_error( $menu ) && ! isset( $menu_items ) ) { $menu_items = wp_get_nav_menu_items( $menu->term_id, array( 'update_post_term_cache' => false ) ); } /* * If no menu was found: * - Fall back (if one was specified), or bail. * * If no menu items were found: * - Fall back, but only if no theme location was specified. * - Otherwise, bail. */ if ( ( ! $menu || is_wp_error( $menu ) || ( isset( $menu_items ) && empty( $menu_items ) && ! $args->theme_location ) ) && isset( $args->fallback_cb ) && $args->fallback_cb && is_callable( $args->fallback_cb ) ) { return call_user_func( $args->fallback_cb, (array) $args ); } if ( ! $menu || is_wp_error( $menu ) ) { return false; } $nav_menu = ''; $items = ''; $show_container = false; if ( $args->container ) { /** * Filters the list of HTML tags that are valid for use as menu containers. * * @since 3.0.0 * * @param string[] $tags The acceptable HTML tags for use as menu containers. * Default is array containing 'div' and 'nav'. */ $allowed_tags = apply_filters( 'wp_nav_menu_container_allowedtags', array( 'div', 'nav' ) ); if ( is_string( $args->container ) && in_array( $args->container, $allowed_tags, true ) ) { $show_container = true; $class = $args->container_class ? ' class="' . esc_attr( $args->container_class ) . '"' : ' class="menu-' . $menu->slug . '-container"'; $id = $args->container_id ? ' id="' . esc_attr( $args->container_id ) . '"' : ''; $aria_label = ( 'nav' === $args->container && $args->container_aria_label ) ? ' aria-label="' . esc_attr( $args->container_aria_label ) . '"' : ''; $nav_menu .= '<' . $args->container . $id . $class . $aria_label . '>'; } } // Set up the $menu_item variables. _wp_menu_item_classes_by_context( $menu_items ); $sorted_menu_items = array(); $menu_items_with_children = array(); foreach ( (array) $menu_items as $menu_item ) { /* * Fix invalid `menu_item_parent`. See: https://core.trac.wordpress.org/ticket/56926. * Compare as strings. Plugins may change the ID to a string. */ if ( (string) $menu_item->ID === (string) $menu_item->menu_item_parent ) { $menu_item->menu_item_parent = 0; } $sorted_menu_items[ $menu_item->menu_order ] = $menu_item; if ( $menu_item->menu_item_parent ) { $menu_items_with_children[ $menu_item->menu_item_parent ] = true; } } // Add the menu-item-has-children class where applicable. if ( $menu_items_with_children ) { foreach ( $sorted_menu_items as &$menu_item ) { if ( isset( $menu_items_with_children[ $menu_item->ID ] ) ) { $menu_item->classes[] = 'menu-item-has-children'; } } } unset( $menu_items, $menu_item ); /** * Filters the sorted list of menu item objects before generating the menu's HTML. * * @since 3.1.0 * * @param array $sorted_menu_items The menu items, sorted by each menu item's menu order. * @param stdClass $args An object containing wp_nav_menu() arguments. */ $sorted_menu_items = apply_filters( 'wp_nav_menu_objects', $sorted_menu_items, $args ); $items .= walk_nav_menu_tree( $sorted_menu_items, $args->depth, $args ); unset( $sorted_menu_items ); // Attributes. if ( ! empty( $args->menu_id ) ) { $wrap_id = $args->menu_id; } else { $wrap_id = 'menu-' . $menu->slug; while ( in_array( $wrap_id, $menu_id_slugs, true ) ) { if ( preg_match( '#-(\d+)$#', $wrap_id, $matches ) ) { $wrap_id = preg_replace( '#-(\d+)$#', '-' . ++$matches[1], $wrap_id ); } else { $wrap_id = $wrap_id . '-1'; } } } $menu_id_slugs[] = $wrap_id; $wrap_class = $args->menu_class ? $args->menu_class : ''; /** * Filters the HTML list content for navigation menus. * * @since 3.0.0 * * @see wp_nav_menu() * * @param string $items The HTML list content for the menu items. * @param stdClass $args An object containing wp_nav_menu() arguments. */ $items = apply_filters( 'wp_nav_menu_items', $items, $args ); /** * Filters the HTML list content for a specific navigation menu. * * @since 3.0.0 * * @see wp_nav_menu() * * @param string $items The HTML list content for the menu items. * @param stdClass $args An object containing wp_nav_menu() arguments. */ $items = apply_filters( "wp_nav_menu_{$menu->slug}_items", $items, $args ); // Don't print any markup if there are no items at this point. if ( empty( $items ) ) { return false; } $nav_menu .= sprintf( $args->items_wrap, esc_attr( $wrap_id ), esc_attr( $wrap_class ), $items ); unset( $items ); if ( $show_container ) { $nav_menu .= '</' . $args->container . '>'; } /** * Filters the HTML content for navigation menus. * * @since 3.0.0 * * @see wp_nav_menu() * * @param string $nav_menu The HTML content for the navigation menu. * @param stdClass $args An object containing wp_nav_menu() arguments. */ $nav_menu = apply_filters( 'wp_nav_menu', $nav_menu, $args ); if ( $args->echo ) { echo $nav_menu; } else { return $nav_menu; } } /** * Adds the class property classes for the current context, if applicable. * * @access private * @since 3.0.0 * * @global WP_Query $wp_query WordPress Query object. * @global WP_Rewrite $wp_rewrite WordPress rewrite component. * * @param array $menu_items The current menu item objects to which to add the class property information. */ function _wp_menu_item_classes_by_context( &$menu_items ) { global $wp_query, $wp_rewrite; $queried_object = $wp_query->get_queried_object(); $queried_object_id = (int) $wp_query->queried_object_id; $active_object = ''; $active_ancestor_item_ids = array(); $active_parent_item_ids = array(); $active_parent_object_ids = array(); $possible_taxonomy_ancestors = array(); $possible_object_parents = array(); $home_page_id = (int) get_option( 'page_for_posts' ); if ( $wp_query->is_singular && ! empty( $queried_object->post_type ) && ! is_post_type_hierarchical( $queried_object->post_type ) ) { foreach ( (array) get_object_taxonomies( $queried_object->post_type ) as $taxonomy ) { if ( is_taxonomy_hierarchical( $taxonomy ) ) { $term_hierarchy = _get_term_hierarchy( $taxonomy ); $terms = wp_get_object_terms( $queried_object_id, $taxonomy, array( 'fields' => 'ids' ) ); if ( is_array( $terms ) ) { $possible_object_parents = array_merge( $possible_object_parents, $terms ); $term_to_ancestor = array(); foreach ( (array) $term_hierarchy as $ancestor => $descendents ) { foreach ( (array) $descendents as $desc ) { $term_to_ancestor[ $desc ] = $ancestor; } } foreach ( $terms as $desc ) { do { $possible_taxonomy_ancestors[ $taxonomy ][] = $desc; if ( isset( $term_to_ancestor[ $desc ] ) ) { $_desc = $term_to_ancestor[ $desc ]; unset( $term_to_ancestor[ $desc ] ); $desc = $_desc; } else { $desc = 0; } } while ( ! empty( $desc ) ); } } } } } elseif ( ! empty( $queried_object->taxonomy ) && is_taxonomy_hierarchical( $queried_object->taxonomy ) ) { $term_hierarchy = _get_term_hierarchy( $queried_object->taxonomy ); $term_to_ancestor = array(); foreach ( (array) $term_hierarchy as $ancestor => $descendents ) { foreach ( (array) $descendents as $desc ) { $term_to_ancestor[ $desc ] = $ancestor; } } $desc = $queried_object->term_id; do { $possible_taxonomy_ancestors[ $queried_object->taxonomy ][] = $desc; if ( isset( $term_to_ancestor[ $desc ] ) ) { $_desc = $term_to_ancestor[ $desc ]; unset( $term_to_ancestor[ $desc ] ); $desc = $_desc; } else { $desc = 0; } } while ( ! empty( $desc ) ); } $possible_object_parents = array_filter( $possible_object_parents ); $front_page_url = home_url(); $front_page_id = (int) get_option( 'page_on_front' ); $privacy_policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' ); foreach ( (array) $menu_items as $key => $menu_item ) { $menu_items[ $key ]->current = false; $classes = (array) $menu_item->classes; $classes[] = 'menu-item'; $classes[] = 'menu-item-type-' . $menu_item->type; $classes[] = 'menu-item-object-' . $menu_item->object; // This menu item is set as the 'Front Page'. if ( 'post_type' === $menu_item->type && $front_page_id === (int) $menu_item->object_id ) { $classes[] = 'menu-item-home'; } // This menu item is set as the 'Privacy Policy Page'. if ( 'post_type' === $menu_item->type && $privacy_policy_page_id === (int) $menu_item->object_id ) { $classes[] = 'menu-item-privacy-policy'; } // If the menu item corresponds to a taxonomy term for the currently queried non-hierarchical post object. if ( $wp_query->is_singular && 'taxonomy' === $menu_item->type && in_array( (int) $menu_item->object_id, $possible_object_parents, true ) ) { $active_parent_object_ids[] = (int) $menu_item->object_id; $active_parent_item_ids[] = (int) $menu_item->db_id; $active_object = $queried_object->post_type; // If the menu item corresponds to the currently queried post or taxonomy object. } elseif ( (int) $menu_item->object_id === $queried_object_id && ( ( ! empty( $home_page_id ) && 'post_type' === $menu_item->type && $wp_query->is_home && $home_page_id === (int) $menu_item->object_id ) || ( 'post_type' === $menu_item->type && $wp_query->is_singular ) || ( 'taxonomy' === $menu_item->type && ( $wp_query->is_category || $wp_query->is_tag || $wp_query->is_tax ) && $queried_object->taxonomy === $menu_item->object ) ) ) { $classes[] = 'current-menu-item'; $menu_items[ $key ]->current = true; $ancestor_id = (int) $menu_item->db_id; while ( ( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) ) && ! in_array( $ancestor_id, $active_ancestor_item_ids, true ) ) { $active_ancestor_item_ids[] = $ancestor_id; } if ( 'post_type' === $menu_item->type && 'page' === $menu_item->object ) { // Back compat classes for pages to match wp_page_menu(). $classes[] = 'page_item'; $classes[] = 'page-item-' . $menu_item->object_id; $classes[] = 'current_page_item'; } $active_parent_item_ids[] = (int) $menu_item->menu_item_parent; $active_parent_object_ids[] = (int) $menu_item->post_parent; $active_object = $menu_item->object; // If the menu item corresponds to the currently queried post type archive. } elseif ( 'post_type_archive' === $menu_item->type && is_post_type_archive( array( $menu_item->object ) ) ) { $classes[] = 'current-menu-item'; $menu_items[ $key ]->current = true; $ancestor_id = (int) $menu_item->db_id; while ( ( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) ) && ! in_array( $ancestor_id, $active_ancestor_item_ids, true ) ) { $active_ancestor_item_ids[] = $ancestor_id; } $active_parent_item_ids[] = (int) $menu_item->menu_item_parent; // If the menu item corresponds to the currently requested URL. } elseif ( 'custom' === $menu_item->object && isset( $_SERVER['HTTP_HOST'] ) ) { $_root_relative_current = untrailingslashit( $_SERVER['REQUEST_URI'] ); // If it's the customize page then it will strip the query var off the URL before entering the comparison block. if ( is_customize_preview() ) { $_root_relative_current = strtok( untrailingslashit( $_SERVER['REQUEST_URI'] ), '?' ); } $current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_root_relative_current ); $raw_item_url = strpos( $menu_item->url, '#' ) ? substr( $menu_item->url, 0, strpos( $menu_item->url, '#' ) ) : $menu_item->url; $item_url = set_url_scheme( untrailingslashit( $raw_item_url ) ); $_indexless_current = untrailingslashit( preg_replace( '/' . preg_quote( $wp_rewrite->index, '/' ) . '$/', '', $current_url ) ); $matches = array( $current_url, urldecode( $current_url ), $_indexless_current, urldecode( $_indexless_current ), $_root_relative_current, urldecode( $_root_relative_current ), ); if ( $raw_item_url && in_array( $item_url, $matches, true ) ) { $classes[] = 'current-menu-item'; $menu_items[ $key ]->current = true; $ancestor_id = (int) $menu_item->db_id; while ( ( $ancestor_id = (int) get_post_meta( $ancestor_id, '_menu_item_menu_item_parent', true ) ) && ! in_array( $ancestor_id, $active_ancestor_item_ids, true ) ) { $active_ancestor_item_ids[] = $ancestor_id; } if ( in_array( home_url(), array( untrailingslashit( $current_url ), untrailingslashit( $_indexless_current ) ), true ) ) { // Back compat for home link to match wp_page_menu(). $classes[] = 'current_page_item'; } $active_parent_item_ids[] = (int) $menu_item->menu_item_parent; $active_parent_object_ids[] = (int) $menu_item->post_parent; $active_object = $menu_item->object; // Give front page item the 'current-menu-item' class when extra query arguments are involved. } elseif ( $item_url === $front_page_url && is_front_page() ) { $classes[] = 'current-menu-item'; } if ( untrailingslashit( $item_url ) === home_url() ) { $classes[] = 'menu-item-home'; } } // Back-compat with wp_page_menu(): add "current_page_parent" to static home page link for any non-page query. if ( ! empty( $home_page_id ) && 'post_type' === $menu_item->type && empty( $wp_query->is_page ) && $home_page_id === (int) $menu_item->object_id ) { $classes[] = 'current_page_parent'; } $menu_items[ $key ]->classes = array_unique( $classes ); } $active_ancestor_item_ids = array_filter( array_unique( $active_ancestor_item_ids ) ); $active_parent_item_ids = array_filter( array_unique( $active_parent_item_ids ) ); $active_parent_object_ids = array_filter( array_unique( $active_parent_object_ids ) ); // Set parent's class. foreach ( (array) $menu_items as $key => $parent_item ) { $classes = (array) $parent_item->classes; $menu_items[ $key ]->current_item_ancestor = false; $menu_items[ $key ]->current_item_parent = false; if ( isset( $parent_item->type ) && ( // Ancestral post object. ( 'post_type' === $parent_item->type && ! empty( $queried_object->post_type ) && is_post_type_hierarchical( $queried_object->post_type ) && in_array( (int) $parent_item->object_id, $queried_object->ancestors, true ) && (int) $parent_item->object_id !== $queried_object->ID ) || // Ancestral term. ( 'taxonomy' === $parent_item->type && isset( $possible_taxonomy_ancestors[ $parent_item->object ] ) && in_array( (int) $parent_item->object_id, $possible_taxonomy_ancestors[ $parent_item->object ], true ) && ( ! isset( $queried_object->term_id ) || (int) $parent_item->object_id !== $queried_object->term_id ) ) ) ) { if ( ! empty( $queried_object->taxonomy ) ) { $classes[] = 'current-' . $queried_object->taxonomy . '-ancestor'; } else { $classes[] = 'current-' . $queried_object->post_type . '-ancestor'; } } if ( in_array( (int) $parent_item->db_id, $active_ancestor_item_ids, true ) ) { $classes[] = 'current-menu-ancestor'; $menu_items[ $key ]->current_item_ancestor = true; } if ( in_array( (int) $parent_item->db_id, $active_parent_item_ids, true ) ) { $classes[] = 'current-menu-parent'; $menu_items[ $key ]->current_item_parent = true; } if ( in_array( (int) $parent_item->object_id, $active_parent_object_ids, true ) ) { $classes[] = 'current-' . $active_object . '-parent'; } if ( 'post_type' === $parent_item->type && 'page' === $parent_item->object ) { // Back compat classes for pages to match wp_page_menu(). if ( in_array( 'current-menu-parent', $classes, true ) ) { $classes[] = 'current_page_parent'; } if ( in_array( 'current-menu-ancestor', $classes, true ) ) { $classes[] = 'current_page_ancestor'; } } $menu_items[ $key ]->classes = array_unique( $classes ); } } /** * Retrieves the HTML list content for nav menu items. * * @uses Walker_Nav_Menu to create HTML list content. * @since 3.0.0 * * @param array $items The menu items, sorted by each menu item's menu order. * @param int $depth Depth of the item in reference to parents. * @param stdClass $args An object containing wp_nav_menu() arguments. * @return string The HTML list content for the menu items. */ function walk_nav_menu_tree( $items, $depth, $args ) { $walker = ( empty( $args->walker ) ) ? new Walker_Nav_Menu() : $args->walker; return $walker->walk( $items, $depth, $args ); } /** * Prevents a menu item ID from being used more than once. * * @since 3.0.1 * @access private * * @param string $id * @param object $item * @return string */ function _nav_menu_item_id_use_once( $id, $item ) { static $_used_ids = array(); if ( in_array( $item->ID, $_used_ids, true ) ) { return ''; } $_used_ids[] = $item->ID; return $id; } /** * Remove the `menu-item-has-children` class from bottom level menu items. * * This runs on the {@see 'nav_menu_css_class'} filter. The $args and $depth * parameters were added after the filter was originally introduced in * WordPress 3.0.0 so this needs to allow for cases in which the filter is * called without them. * * @see https://core.trac.wordpress.org/ticket/56926 * * @since 6.2.0 * * @param string[] $classes Array of the CSS classes that are applied to the menu item's `<li>` element. * @param WP_Post $menu_item The current menu item object. * @param stdClass|false $args An object of wp_nav_menu() arguments. Default false ($args unspecified when filter is called). * @param int|false $depth Depth of menu item. Default false ($depth unspecified when filter is called). * @return string[] Modified nav menu classes. */ function wp_nav_menu_remove_menu_item_has_children_class( $classes, $menu_item, $args = false, $depth = false ) { /* * Account for the filter being called without the $args or $depth parameters. * * This occurs when a theme uses a custom walker calling the `nav_menu_css_class` * filter using the legacy formats prior to the introduction of the $args and * $depth parameters. * * As both of these parameters are required for this function to determine * both the current and maximum depth of the menu tree, the function does not * attempt to remove the `menu-item-has-children` class if these parameters * are not set. */ if ( false === $depth || false === $args ) { return $classes; } // Max-depth is 1-based. $max_depth = isset( $args->depth ) ? (int) $args->depth : 0; // Depth is 0-based so needs to be increased by one. $depth = $depth + 1; // Complete menu tree is displayed. if ( 0 === $max_depth ) { return $classes; } /* * Remove the `menu-item-has-children` class from bottom level menu items. * -1 is used to display all menu items in one level so the class should * be removed from all menu items. */ if ( -1 === $max_depth || $depth >= $max_depth ) { $classes = array_diff( $classes, array( 'menu-item-has-children' ) ); } return $classes; }
