Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
0.00%
0 / 39
0.00%
0 / 2
 CRAP
n/a
0 / 0
jetpack_breadcrumbs
0.00%
0 / 25
0.00%
0 / 1
 156
jetpack_get_term_parents
0.00%
0 / 9
0.00%
0 / 1
 30
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
10if ( ! defined( 'ABSPATH' ) ) {
11    exit( 0 );
12}
13
14$host = new Automattic\Jetpack\Status\Host();
15if ( ! 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
65if ( ! 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}