| 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 |
|
