'/', 'before' => '', 'after' => false, 'front_page' => true, 'show_home' => __( 'Home', $textdomain ), 'echo' => true ); /* Allow singular post views to have a taxonomy's terms prefixing the trail. */ if ( is_singular() ) $defaults["singular_{$wp_query->post->post_type}_taxonomy"] = false; /* Apply filters to the arguments. */ $args = apply_filters( 'breadcrumb_trail_args', $args ); /* Parse the arguments and extract them for easy variable naming. */ $args = wp_parse_args( $args, $defaults ); /* Get the trail items. */ $trail = breadcrumb_trail_get_items( $args ); /* Connect the breadcrumb trail if there are items in the trail. */ if ( !empty( $trail ) && is_array( $trail ) ) { /* Open the breadcrumb trail containers. */ $breadcrumb = ''; } /* Allow developers to filter the breadcrumb trail HTML. */ $breadcrumb = apply_filters( 'breadcrumb_trail', $breadcrumb ); /* Output the breadcrumb. */ if ( $args['echo'] ) echo $breadcrumb; else return $breadcrumb; } /** * Gets the items for the breadcrumb trail. This is the heart of the script. It checks the current page * being viewed and decided based on the information provided by WordPress what items should be * added to the breadcrumb trail. * * @since 0.4.0 * @todo Build in caching based on the queried object ID. * @param array $args Mixed arguments for the menu. * @return array List of items to be shown in the trail. */ function breadcrumb_trail_get_items( $args = array() ) { global $wp_query, $wp_rewrite; /* Get the textdomain. */ $textdomain = breadcrumb_trail_textdomain(); /* Set up an empty trail array and empty path. */ $trail = array(); $path = ''; /* If $show_home is set and we're not on the front page of the site, link to the home page. */ if ( !is_front_page() && $args['show_home'] ) $trail[] = '' . $args['show_home'] . ''; /* If viewing the front page of the site. */ if ( is_front_page() ) { if ( $args['show_home'] && $args['front_page'] ) $trail['trail_end'] = "{$args['show_home']}"; } /* If viewing the "home"/posts page. */ elseif ( is_home() ) { $home_page = get_page( $wp_query->get_queried_object_id() ); $trail = array_merge( $trail, breadcrumb_trail_get_parents( $home_page->post_parent, '' ) ); $trail['trail_end'] = get_the_title( $home_page->ID ); } /* If viewing a singular post (page, attachment, etc.). */ elseif ( is_singular() ) { /* Get singular post variables needed. */ $post = $wp_query->get_queried_object(); $post_id = absint( $wp_query->get_queried_object_id() ); $post_type = $post->post_type; $parent = absint( $post->post_parent ); /* Get the post type object. */ $post_type_object = get_post_type_object( $post_type ); /* If viewing a singular 'post'. */ if ( 'post' == $post_type ) { /* If $front has been set, add it to the $path. */ $path .= trailingslashit( $wp_rewrite->front ); /* If there's a path, check for parents. */ if ( !empty( $path ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* Map the permalink structure tags to actual links. */ $trail = array_merge( $trail, breadcrumb_trail_map_rewrite_tags( $post_id, get_option( 'permalink_structure' ) ) ); } /* If viewing a singular 'attachment'. */ elseif ( 'attachment' == $post_type ) { /* If $front has been set, add it to the $path. */ $path .= trailingslashit( $wp_rewrite->front ); /* If there's a path, check for parents. */ if ( !empty( $path ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* Map the post (parent) permalink structure tags to actual links. */ $trail = array_merge( $trail, breadcrumb_trail_map_rewrite_tags( $post->post_parent, get_option( 'permalink_structure' ) ) ); } /* If a custom post type, check if there are any pages in its hierarchy based on the slug. */ elseif ( 'page' !== $post_type ) { /* If $front has been set, add it to the $path. */ if ( $post_type_object->rewrite['with_front'] && $wp_rewrite->front ) $path .= trailingslashit( $wp_rewrite->front ); /* If there's a slug, add it to the $path. */ if ( !empty( $post_type_object->rewrite['slug'] ) ) $path .= $post_type_object->rewrite['slug']; /* If there's a path, check for parents. */ if ( !empty( $path ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* If there's an archive page, add it to the trail. */ if ( !empty( $post_type_object->rewrite['archive'] ) && function_exists( 'get_post_type_archive_link' ) ) $trail[] = '' . $post_type_object->labels->name . ''; } /* If the post type path returns nothing and there is a parent, get its parents. */ if ( ( empty( $path ) && 0 !== $parent ) || ( 'attachment' == $post_type ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( $parent, '' ) ); /* Or, if the post type is hierarchical and there's a parent, get its parents. */ elseif ( 0 !== $parent && is_post_type_hierarchical( $post_type ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( $parent, '' ) ); /* Display terms for specific post type taxonomy if requested. */ if ( !empty( $args["singular_{$post_type}_taxonomy"] ) && $terms = get_the_term_list( $post_id, $args["singular_{$post_type}_taxonomy"], '', ', ', '' ) ) $trail[] = $terms; /* End with the post title. */ $post_title = get_the_title(); if ( !empty( $post_title ) ) $trail['trail_end'] = $post_title; } /* If we're viewing any type of archive. */ elseif ( is_archive() ) { /* If viewing a taxonomy term archive. */ if ( is_tax() || is_category() || is_tag() ) { /* Get some taxonomy and term variables. */ $term = $wp_query->get_queried_object(); $taxonomy = get_taxonomy( $term->taxonomy ); /* Get the path to the term archive. Use this to determine if a page is present with it. */ if ( is_category() ) $path = get_option( 'category_base' ); elseif ( is_tag() ) $path = get_option( 'tag_base' ); else { if ( $taxonomy->rewrite['with_front'] && $wp_rewrite->front ) $path = trailingslashit( $wp_rewrite->front ); $path .= $taxonomy->rewrite['slug']; } /* Get parent pages by path if they exist. */ if ( $path ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* If the taxonomy is hierarchical, list its parent terms. */ if ( is_taxonomy_hierarchical( $term->taxonomy ) && $term->parent ) $trail = array_merge( $trail, breadcrumb_trail_get_term_parents( $term->parent, $term->taxonomy ) ); /* Add the term name to the trail end. */ if ( function_exists( 'single_term_title' ) ) $trail['trail_end'] = single_term_title( '', false ); else $trail['trail_end'] = $term->name; } /* If viewing a post type archive. */ elseif ( function_exists( 'is_post_type_archive' ) && is_post_type_archive() ) { /* Get the post type object. */ $post_type_object = get_post_type_object( get_query_var( 'post_type' ) ); /* If $front has been set, add it to the $path. */ if ( $post_type_object->rewrite['with_front'] && $wp_rewrite->front ) $path .= trailingslashit( $wp_rewrite->front ); /* If there's a slug, add it to the $path. */ if ( !empty( $post_type_object->rewrite['archive'] ) ) $path .= $post_type_object->rewrite['archive']; /* If there's a path, check for parents. */ if ( !empty( $path ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* Add the post type [plural] name to the trail end. */ $trail['trail_end'] = $post_type_object->labels->name; } /* If viewing an author archive. */ elseif ( is_author() ) { /* If $front has been set, add it to $path. */ if ( !empty( $wp_rewrite->front ) ) $path .= trailingslashit( $wp_rewrite->front ); /* If an $author_base exists, add it to $path. */ if ( !empty( $wp_rewrite->author_base ) ) $path .= $wp_rewrite->author_base; /* If $path exists, check for parent pages. */ if ( !empty( $path ) ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $path ) ); /* Add the author's display name to the trail end. */ $trail['trail_end'] = get_the_author_meta( 'display_name', get_query_var( 'author' ) ); } /* If viewing a time-based archive. */ elseif ( is_time() ) { if ( get_query_var( 'minute' ) && get_query_var( 'hour' ) ) $trail['trail_end'] = get_the_time( __( 'g:i a', $textdomain ) ); elseif ( get_query_var( 'minute' ) ) $trail['trail_end'] = sprintf( __( 'Minute %1$s', $textdomain ), get_the_time( __( 'i', $textdomain ) ) ); elseif ( get_query_var( 'hour' ) ) $trail['trail_end'] = get_the_time( __( 'g a', $textdomain ) ); } /* If viewing a date-based archive. */ elseif ( is_date() ) { /* If $front has been set, check for parent pages. */ if ( $wp_rewrite->front ) $trail = array_merge( $trail, breadcrumb_trail_get_parents( '', $wp_rewrite->front ) ); if ( is_day() ) { $trail[] = '' . get_the_time( __( 'Y', $textdomain ) ) . ''; $trail[] = '' . get_the_time( __( 'F', $textdomain ) ) . ''; $trail['trail_end'] = get_the_time( __( 'd', $textdomain ) ); } elseif ( get_query_var( 'w' ) ) { $trail[] = '' . get_the_time( __( 'Y', $textdomain ) ) . ''; $trail['trail_end'] = sprintf( __( 'Week %1$s', $textdomain ), get_the_time( esc_attr__( 'W', $textdomain ) ) ); } elseif ( is_month() ) { $trail[] = '' . get_the_time( __( 'Y', $textdomain ) ) . ''; $trail['trail_end'] = get_the_time( __( 'F', $textdomain ) ); } elseif ( is_year() ) { $trail['trail_end'] = get_the_time( __( 'Y', $textdomain ) ); } } } /* If viewing search results. */ elseif ( is_search() ) $trail['trail_end'] = sprintf( __( 'Search results for "%1$s"', $textdomain ), esc_attr( get_search_query() ) ); /* If viewing a 404 error page. */ elseif ( is_404() ) $trail['trail_end'] = __( '404 Not Found', $textdomain ); /* Allow devs to step in and filter the $trail array. */ return apply_filters( 'breadcrumb_trail_items', $trail ); } /** * Turns %tag% from permalink structures into usable links for the breadcrumb trail. This feels kind of * hackish for now because we're checking for specific %tag% examples and only doing it for the 'post' * post type. In the future, maybe it'll handle a wider variety of possibilities, especially for custom post * types. * * @since 0.4.0 * @param int $post_id ID of the post whose parents we want. * @param string $path Path of a potential parent page. * @return array $trail Array of links to the post breadcrumb. */ function breadcrumb_trail_map_rewrite_tags( $post_id = '', $path = '' ) { /* Set up an empty $trail array. */ $trail = array(); /* Make sure there's a $path and $post_id before continuing. */ if ( empty( $path ) || empty( $post_id ) ) return $trail; /* Get the post based on the post ID. */ $post = get_post( $post_id ); /* If no post is returned, an error is returned, or the post does not have a 'post' post type, return. */ if ( empty( $post ) || is_wp_error( $post ) || 'post' !== $post->post_type ) return $trail; /* Get the textdomain. */ $textdomain = breadcrumb_trail_textdomain(); /* Trim '/' from both sides of the $path. */ $path = trim( $path, '/' ); /* Split the $path into an array of strings. */ $matches = explode( '/', $path ); /* If matches are found for the path. */ if ( is_array( $matches ) ) { /* Loop through each of the matches, adding each to the $trail array. */ foreach ( $matches as $match ) { /* Trim any '/' from the $match. */ $tag = trim( $match, '/' ); /* If using the %year% tag, add a link to the yearly archive. */ if ( '%year%' == $tag ) $trail[] = '' . get_the_time( __( 'Y', $textdomain ), $post_id ) . ''; /* If using the %monthnum% tag, add a link to the monthly archive. */ elseif ( '%monthnum%' == $tag ) $trail[] = '' . get_the_time( __( 'F', $textdomain ), $post_id ) . ''; /* If using the %day% tag, add a link to the daily archive. */ elseif ( '%day%' == $tag ) $trail[] = '' . get_the_time( __( 'd', $textdomain ), $post_id ) . ''; /* If using the %author% tag, add a link to the post author archive. */ elseif ( '%author%' == $tag ) $trail[] = '' . get_the_author_meta( 'display_name', $post->post_author ) . ''; /* If using the %category% tag, add a link to the first category archive to match permalinks. */ elseif ( '%category%' == $tag ) { /* Get the post categories. */ $terms = get_the_category( $post_id ); /* Check that categories were returned. */ if ( $terms ) { /* Sort the terms by ID and get the first category. */ usort( $terms, '_usort_terms_by_ID' ); $term = get_term( $terms[0], 'category' ); /* If the category has a parent, add the hierarchy to the trail. */ if ( 0 !== $term->parent ) $trail = array_merge( $trail, breadcrumb_trail_get_term_parents( $term->parent, 'category' ) ); /* Add the category archive link to the trail. */ $trail[] = '' . $term->name . ''; } } } } /* Return the $trail array. */ return $trail; } /** * Gets parent pages of any post type or taxonomy by the ID or Path. The goal of this function is to create * a clear path back to home given what would normally be a "ghost" directory. If any page matches the given * path, it'll be added. But, it's also just a way to check for a hierarchy with hierarchical post types. * * @since 0.3.0 * @param int $post_id ID of the post whose parents we want. * @param string $path Path of a potential parent page. * @return array $trail Array of parent page links. */ function breadcrumb_trail_get_parents( $post_id = '', $path = '' ) { /* Set up an empty trail array. */ $trail = array(); /* If neither a post ID nor path set, return an empty array. */ if ( empty( $post_id ) && empty( $path ) ) return $trail; /* If the post ID is empty, use the path to get the ID. */ if ( empty( $post_id ) ) { /* Get parent post by the path. */ $parent_page = get_page_by_path( $path ); /* If a parent post is found, set the $post_id variable to it. */ if ( !empty( $parent_page ) ) $post_id = $parent_page->ID; } /* If a post ID and path is set, search for a post by the given path. */ if ( $post_id == 0 && !empty( $path ) ) { /* Separate post names into separate paths by '/'. */ $path = trim( $path, '/' ); preg_match_all( "/\/.*?\z/", $path, $matches ); /* If matches are found for the path. */ if ( isset( $matches ) ) { /* Reverse the array of matches to search for posts in the proper order. */ $matches = array_reverse( $matches ); /* Loop through each of the path matches. */ foreach ( $matches as $match ) { /* If a match is found. */ if ( isset( $match[0] ) ) { /* Get the parent post by the given path. */ $path = str_replace( $match[0], '', $path ); $parent_page = get_page_by_path( trim( $path, '/' ) ); /* If a parent post is found, set the $post_id and break out of the loop. */ if ( !empty( $parent_page ) && $parent_page->ID > 0 ) { $post_id = $parent_page->ID; break; } } } } } /* While there's a post ID, add the post link to the $parents array. */ while ( $post_id ) { /* Get the post by ID. */ $page = get_page( $post_id ); /* Add the formatted post link to the array of parents. */ $parents[] = '' . get_the_title( $post_id ) . ''; /* Set the parent post's parent to the post ID. */ $post_id = $page->post_parent; } /* If we have parent posts, reverse the array to put them in the proper order for the trail. */ if ( isset( $parents ) ) $trail = array_reverse( $parents ); /* Return the trail of parent posts. */ return $trail; } /** * Searches for term parents of hierarchical taxonomies. This function is similar to the WordPress * function get_category_parents() but handles any type of taxonomy. * * @since 0.3.0 * @param int $parent_id The ID of the first parent. * @param object|string $taxonomy The taxonomy of the term whose parents we want. * @return array $trail Array of links to parent terms. */ function breadcrumb_trail_get_term_parents( $parent_id = '', $taxonomy = '' ) { /* Set up some default arrays. */ $trail = array(); $parents = array(); /* If no term parent ID or taxonomy is given, return an empty array. */ if ( empty( $parent_id ) || empty( $taxonomy ) ) return $trail; /* While there is a parent ID, add the parent term link to the $parents array. */ while ( $parent_id ) { /* Get the parent term. */ $parent = get_term( $parent_id, $taxonomy ); /* Add the formatted term link to the array of parent terms. */ $parents[] = '' . $parent->name . ''; /* Set the parent term's parent as the parent ID. */ $parent_id = $parent->parent; } /* If we have parent terms, reverse the array to put them in the proper order for the trail. */ if ( !empty( $parents ) ) $trail = array_reverse( $parents ); /* Return the trail of parent terms. */ return $trail; } /** * Returns the textdomain used by the script and allows it to be filtered by plugins/themes. * * @since 0.4.0 * @returns string The textdomain for the script. */ function breadcrumb_trail_textdomain() { return apply_filters( 'breadcrumb_trail_textdomain', 'breadcrumb-trail' ); } ?>