compat
9 months ago
content-options
2 months ago
custom-post-types
1 month ago
featured-content
1 year ago
responsive-videos
1 year ago
social-menu
2 months ago
class-featured-content.php
2 months ago
class-main.php
4 weeks ago
class-social-links.php
9 months ago
content-options.php
9 months ago
custom-content-types.php
8 months ago
jetpack-color.php
2 years ago
responsive-videos.php
2 years ago
shared-functions.php
2 years ago
site-breadcrumbs.php
9 months ago
social-menu.php
9 months ago
site-breadcrumbs.php
94 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Theme Tools: Site Breadcrumbs. |
| 4 | * |
| 5 | * Quickly add breadcrumbs to the single view of a hierarchical post type or a hierarchical taxonomy. |
| 6 | * |
| 7 | * @package automattic/jetpack-classic-theme-helper |
| 8 | */ |
| 9 | |
| 10 | if ( ! defined( 'ABSPATH' ) ) { |
| 11 | exit( 0 ); |
| 12 | } |
| 13 | |
| 14 | $host = new Automattic\Jetpack\Status\Host(); |
| 15 | if ( ! function_exists( 'jetpack_breadcrumbs' ) && ! $host->is_wpcom_simple() ) { |
| 16 | /** |
| 17 | * Echos a set of breadcrumbs. |
| 18 | * |
| 19 | * Themes can call this function where the breadcrumbs should be outputted. |
| 20 | */ |
| 21 | function jetpack_breadcrumbs() { |
| 22 | $taxonomy = is_category() ? 'category' : get_query_var( 'taxonomy' ); |
| 23 | $is_taxonomy_hierarchical = is_taxonomy_hierarchical( $taxonomy ); |
| 24 | |
| 25 | $post_type = is_page() ? 'page' : get_query_var( 'post_type' ); |
| 26 | $is_post_type_hierarchical = is_post_type_hierarchical( $post_type ); |
| 27 | |
| 28 | if ( ! ( $is_post_type_hierarchical || $is_taxonomy_hierarchical ) || is_front_page() ) { |
| 29 | return; |
| 30 | } |
| 31 | |
| 32 | $breadcrumb = ''; |
| 33 | $position = 1; |
| 34 | |
| 35 | if ( $is_post_type_hierarchical ) { |
| 36 | $post_id = get_queried_object_id(); |
| 37 | $ancestors = array_reverse( get_post_ancestors( $post_id ) ); |
| 38 | if ( $ancestors ) { |
| 39 | foreach ( $ancestors as $ancestor ) { |
| 40 | $breadcrumb .= '<span itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><meta itemprop="position" content="' . esc_attr( (string) $position ) . '"><a href="' . esc_url( get_permalink( $ancestor ) ) . '" itemprop="item"><span itemprop="name">' . esc_html( get_the_title( $ancestor ) ) . '</span></a></span>'; |
| 41 | ++$position; |
| 42 | } |
| 43 | } |
| 44 | $breadcrumb .= '<span class="current-page" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><meta itemprop="position" content="' . esc_attr( (string) $position ) . '"><span itemprop="name">' . esc_html( get_the_title( $post_id ) ) . '</span></span>'; |
| 45 | } elseif ( $is_taxonomy_hierarchical ) { |
| 46 | $current = get_term( get_queried_object_id(), $taxonomy ); |
| 47 | |
| 48 | if ( is_wp_error( $current ) ) { |
| 49 | return; |
| 50 | } |
| 51 | |
| 52 | if ( $current->parent ) { |
| 53 | $breadcrumb = jetpack_get_term_parents( $current->parent, $taxonomy ); |
| 54 | } |
| 55 | |
| 56 | $breadcrumb .= '<span class="current-category" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><meta property="position" content="' . esc_attr( (string) $position ) . '"><span itemprop="name">' . esc_html( $current->name ) . '</span></span>'; |
| 57 | } |
| 58 | |
| 59 | $home = '<span itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"><meta itemprop="position" content="' . esc_attr( (string) $position ) . '"><meta itemprop="position" content="0"><a href="' . esc_url( home_url( '/' ) ) . '" class="home-link" itemprop="item" rel="home"><span itemprop="name">' . esc_html__( 'Home', 'jetpack-classic-theme-helper' ) . '</span></a></span>'; |
| 60 | |
| 61 | echo '<nav class="entry-breadcrumbs" itemscope itemtype="https://schema.org/BreadcrumbList">' . $home . $breadcrumb . '</nav>'; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 62 | } |
| 63 | } |
| 64 | |
| 65 | if ( ! function_exists( 'jetpack_get_term_parents' ) ) { |
| 66 | /** |
| 67 | * Return the parents for a given taxonomy term ID. |
| 68 | * |
| 69 | * @param int $term Taxonomy term whose parents will be returned. |
| 70 | * @param string $taxonomy Taxonomy name that the term belongs to. |
| 71 | * @param array $visited Terms already added to prevent duplicates. |
| 72 | * |
| 73 | * @return string|WP_Error A list of links to the term parents|WP_Error. |
| 74 | */ |
| 75 | function jetpack_get_term_parents( $term, $taxonomy, $visited = array() ) { |
| 76 | $parent = get_term( $term, $taxonomy ); |
| 77 | |
| 78 | if ( is_wp_error( $parent ) ) { |
| 79 | return $parent; |
| 80 | } |
| 81 | |
| 82 | $chain = ''; |
| 83 | |
| 84 | if ( $parent->parent && ( $parent->parent !== $parent->term_id ) && ! in_array( $parent->parent, $visited, true ) ) { |
| 85 | $visited[] = $parent->parent; |
| 86 | $chain .= jetpack_get_term_parents( $parent->parent, $taxonomy, $visited ); |
| 87 | } |
| 88 | |
| 89 | $chain .= '<a href="' . esc_url( get_category_link( $parent->term_id ) ) . '">' . $parent->name . '</a>'; |
| 90 | |
| 91 | return $chain; |
| 92 | } |
| 93 | } |
| 94 |