| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372 |
- <?php
- /**
- * WC_Breadcrumb class.
- *
- * @package WooCommerce/Classes
- * @version 2.3.0
- */
- defined( 'ABSPATH' ) || exit;
- /**
- * Breadcrumb class.
- */
- class WC_Breadcrumb {
- /**
- * Breadcrumb trail.
- *
- * @var array
- */
- private $crumbs = array();
- /**
- * Add a crumb so we don't get lost.
- *
- * @param string $name Name.
- * @param string $link Link.
- */
- public function add_crumb( $name, $link = '' ) {
- $this->crumbs[] = array(
- strip_tags( $name ),
- $link,
- );
- }
- /**
- * Reset crumbs.
- */
- public function reset() {
- $this->crumbs = array();
- }
- /**
- * Get the breadcrumb.
- *
- * @return array
- */
- public function get_breadcrumb() {
- return apply_filters( 'woocommerce_get_breadcrumb', $this->crumbs, $this );
- }
- /**
- * Generate breadcrumb trail.
- *
- * @return array of breadcrumbs
- */
- public function generate() {
- $conditionals = array(
- 'is_home',
- 'is_404',
- 'is_attachment',
- 'is_single',
- 'is_product_category',
- 'is_product_tag',
- 'is_shop',
- 'is_page',
- 'is_post_type_archive',
- 'is_category',
- 'is_tag',
- 'is_author',
- 'is_date',
- 'is_tax',
- );
- if ( ( ! is_front_page() && ! ( is_post_type_archive() && intval( get_option( 'page_on_front' ) ) === wc_get_page_id( 'shop' ) ) ) || is_paged() ) {
- foreach ( $conditionals as $conditional ) {
- if ( call_user_func( $conditional ) ) {
- call_user_func( array( $this, 'add_crumbs_' . substr( $conditional, 3 ) ) );
- break;
- }
- }
- $this->search_trail();
- $this->paged_trail();
- return $this->get_breadcrumb();
- }
- return array();
- }
- /**
- * Prepend the shop page to shop breadcrumbs.
- */
- private function prepend_shop_page() {
- $permalinks = wc_get_permalink_structure();
- $shop_page_id = wc_get_page_id( 'shop' );
- $shop_page = get_post( $shop_page_id );
- // If permalinks contain the shop page in the URI prepend the breadcrumb with shop.
- if ( $shop_page_id && $shop_page && isset( $permalinks['product_base'] ) && strstr( $permalinks['product_base'], '/' . $shop_page->post_name ) && intval( get_option( 'page_on_front' ) ) !== $shop_page_id ) {
- $this->add_crumb( get_the_title( $shop_page ), get_permalink( $shop_page ) );
- }
- }
- /**
- * Is home trail..
- */
- private function add_crumbs_home() {
- $this->add_crumb( single_post_title( '', false ) );
- }
- /**
- * 404 trail.
- */
- private function add_crumbs_404() {
- $this->add_crumb( __( 'Error 404', 'woocommerce' ) );
- }
- /**
- * Attachment trail.
- */
- private function add_crumbs_attachment() {
- global $post;
- $this->add_crumbs_single( $post->post_parent, get_permalink( $post->post_parent ) );
- $this->add_crumb( get_the_title(), get_permalink() );
- }
- /**
- * Single post trail.
- *
- * @param int $post_id Post ID.
- * @param string $permalink Post permalink.
- */
- private function add_crumbs_single( $post_id = 0, $permalink = '' ) {
- if ( ! $post_id ) {
- global $post;
- } else {
- $post = get_post( $post_id ); // WPCS: override ok.
- }
- if ( 'product' === get_post_type( $post ) ) {
- $this->prepend_shop_page();
- $terms = wc_get_product_terms(
- $post->ID, 'product_cat', apply_filters(
- 'woocommerce_breadcrumb_product_terms_args', array(
- 'orderby' => 'parent',
- 'order' => 'DESC',
- )
- )
- );
- if ( $terms ) {
- $main_term = apply_filters( 'woocommerce_breadcrumb_main_term', $terms[0], $terms );
- $this->term_ancestors( $main_term->term_id, 'product_cat' );
- $this->add_crumb( $main_term->name, get_term_link( $main_term ) );
- }
- } elseif ( 'post' !== get_post_type( $post ) ) {
- $post_type = get_post_type_object( get_post_type( $post ) );
- if ( ! empty( $post_type->has_archive ) ) {
- $this->add_crumb( $post_type->labels->singular_name, get_post_type_archive_link( get_post_type( $post ) ) );
- }
- } else {
- $cat = current( get_the_category( $post ) );
- if ( $cat ) {
- $this->term_ancestors( $cat->term_id, 'category' );
- $this->add_crumb( $cat->name, get_term_link( $cat ) );
- }
- }
- $this->add_crumb( get_the_title( $post ), $permalink );
- }
- /**
- * Page trail.
- */
- private function add_crumbs_page() {
- global $post;
- if ( $post->post_parent ) {
- $parent_crumbs = array();
- $parent_id = $post->post_parent;
- while ( $parent_id ) {
- $page = get_post( $parent_id );
- $parent_id = $page->post_parent;
- $parent_crumbs[] = array( get_the_title( $page->ID ), get_permalink( $page->ID ) );
- }
- $parent_crumbs = array_reverse( $parent_crumbs );
- foreach ( $parent_crumbs as $crumb ) {
- $this->add_crumb( $crumb[0], $crumb[1] );
- }
- }
- $this->add_crumb( get_the_title(), get_permalink() );
- $this->endpoint_trail();
- }
- /**
- * Product category trail.
- */
- private function add_crumbs_product_category() {
- $current_term = $GLOBALS['wp_query']->get_queried_object();
- $this->prepend_shop_page();
- $this->term_ancestors( $current_term->term_id, 'product_cat' );
- $this->add_crumb( $current_term->name );
- }
- /**
- * Product tag trail.
- */
- private function add_crumbs_product_tag() {
- $current_term = $GLOBALS['wp_query']->get_queried_object();
- $this->prepend_shop_page();
- /* translators: %s: product tag */
- $this->add_crumb( sprintf( __( 'Products tagged “%s”', 'woocommerce' ), $current_term->name ) );
- }
- /**
- * Shop breadcrumb.
- */
- private function add_crumbs_shop() {
- if ( intval( get_option( 'page_on_front' ) ) === wc_get_page_id( 'shop' ) ) {
- return;
- }
- $_name = wc_get_page_id( 'shop' ) ? get_the_title( wc_get_page_id( 'shop' ) ) : '';
- if ( ! $_name ) {
- $product_post_type = get_post_type_object( 'product' );
- $_name = $product_post_type->labels->singular_name;
- }
- $this->add_crumb( $_name, get_post_type_archive_link( 'product' ) );
- }
- /**
- * Post type archive trail.
- */
- private function add_crumbs_post_type_archive() {
- $post_type = get_post_type_object( get_post_type() );
- if ( $post_type ) {
- $this->add_crumb( $post_type->labels->singular_name, get_post_type_archive_link( get_post_type() ) );
- }
- }
- /**
- * Category trail.
- */
- private function add_crumbs_category() {
- $this_category = get_category( $GLOBALS['wp_query']->get_queried_object() );
- if ( 0 !== intval( $this_category->parent ) ) {
- $this->term_ancestors( $this_category->term_id, 'category' );
- }
- $this->add_crumb( single_cat_title( '', false ), get_category_link( $this_category->term_id ) );
- }
- /**
- * Tag trail.
- */
- private function add_crumbs_tag() {
- $queried_object = $GLOBALS['wp_query']->get_queried_object();
- /* translators: %s: tag name */
- $this->add_crumb( sprintf( __( 'Posts tagged “%s”', 'woocommerce' ), single_tag_title( '', false ) ), get_tag_link( $queried_object->term_id ) );
- }
- /**
- * Add crumbs for date based archives.
- */
- private function add_crumbs_date() {
- if ( is_year() || is_month() || is_day() ) {
- $this->add_crumb( get_the_time( 'Y' ), get_year_link( get_the_time( 'Y' ) ) );
- }
- if ( is_month() || is_day() ) {
- $this->add_crumb( get_the_time( 'F' ), get_month_link( get_the_time( 'Y' ), get_the_time( 'm' ) ) );
- }
- if ( is_day() ) {
- $this->add_crumb( get_the_time( 'd' ) );
- }
- }
- /**
- * Add crumbs for taxonomies
- */
- private function add_crumbs_tax() {
- $this_term = $GLOBALS['wp_query']->get_queried_object();
- $taxonomy = get_taxonomy( $this_term->taxonomy );
- $this->add_crumb( $taxonomy->labels->name );
- if ( 0 !== intval( $this_term->parent ) ) {
- $this->term_ancestors( $this_term->term_id, $this_term->taxonomy );
- }
- $this->add_crumb( single_term_title( '', false ), get_term_link( $this_term->term_id, $this_term->taxonomy ) );
- }
- /**
- * Add a breadcrumb for author archives.
- */
- private function add_crumbs_author() {
- global $author;
- $userdata = get_userdata( $author );
- /* translators: %s: author name */
- $this->add_crumb( sprintf( __( 'Author: %s', 'woocommerce' ), $userdata->display_name ) );
- }
- /**
- * Add crumbs for a term.
- *
- * @param int $term_id Term ID.
- * @param string $taxonomy Taxonomy.
- */
- private function term_ancestors( $term_id, $taxonomy ) {
- $ancestors = get_ancestors( $term_id, $taxonomy );
- $ancestors = array_reverse( $ancestors );
- foreach ( $ancestors as $ancestor ) {
- $ancestor = get_term( $ancestor, $taxonomy );
- if ( ! is_wp_error( $ancestor ) && $ancestor ) {
- $this->add_crumb( $ancestor->name, get_term_link( $ancestor ) );
- }
- }
- }
- /**
- * Endpoints.
- */
- private function endpoint_trail() {
- $endpoint = is_wc_endpoint_url() ? WC()->query->get_current_endpoint() : '';
- $endpoint_title = $endpoint ? WC()->query->get_endpoint_title( $endpoint ) : '';
- if ( $endpoint_title ) {
- $this->add_crumb( $endpoint_title );
- }
- }
- /**
- * Add a breadcrumb for search results.
- */
- private function search_trail() {
- if ( is_search() ) {
- /* translators: %s: search term */
- $this->add_crumb( sprintf( __( 'Search results for “%s”', 'woocommerce' ), get_search_query() ), remove_query_arg( 'paged' ) );
- }
- }
- /**
- * Add a breadcrumb for pagination.
- */
- private function paged_trail() {
- if ( get_query_var( 'paged' ) ) {
- /* translators: %d: page number */
- $this->add_crumb( sprintf( __( 'Page %d', 'woocommerce' ), get_query_var( 'paged' ) ) );
- }
- }
- }
|