index of
/
home
/
thefkyzp
/
public_html
/
wp-content
/
themes
/
oceanwp
/
inc
/
File: /home/thefkyzp/public_html/wp-content/themes/oceanwp/inc/breadcrumbs.php
<?php /** * Breadcrumb Trail - A breadcrumb menu script for WordPress. * * Breadcrumb Trail is a script for showing a breadcrumb trail for any type of page. It tries to * anticipate any type of structure and display the best possible trail that matches your site's * permalink structure. While not perfect, it attempts to fill in the gaps left by many other * breadcrumb scripts. * * This program is free software; you can redistribute it and/or modify it under the terms of the GNU * General Public License as published by the Free Software Foundation; either version 2 of the License, * or (at your option) any later version. * * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * * @package BreadcrumbTrail * @version 1.0.0 * @author Justin Tadlock <justin@justintadlock.com> * @copyright Copyright (c) 2008 - 2015, Justin Tadlock * @link https://themehybrid.com/plugins/breadcrumb-trail * @license https://www.gnu.org/licenses/old-licenses/gpl-2.0.html */ /** * Support for external plugin breadcrumbs. * * @param Array $options Breadcrumb Data. * * @return Array Breadcrumb Data. */ function oceanwp_breadcrumbs_sources( $options ) { $is_enable = is_callable( 'WPSEO_Options::get' ) ? WPSEO_Options::get( 'breadcrumbs-enable' ) : false; $wpseo_data = get_option( 'wpseo_internallinks' ) ? get_option( 'wpseo_internallinks' ) : $is_enable; if ( ! is_array( $wpseo_data ) ) { unset( $wpseo_data ); $wpseo_data = array( 'breadcrumbs-enable' => $is_enable, ); } if ( function_exists( 'yoast_breadcrumb' ) && true === $wpseo_data['breadcrumbs-enable'] ) { $options['yoast-seo'] = 'Yoast SEO Breadcrumbs'; } if ( function_exists( 'seopress_display_breadcrumbs' ) ) { $options['seopress'] = 'SEOPress'; } if ( function_exists( 'rank_math_the_breadcrumbs' ) && RankMath\Helper::get_settings( 'general.breadcrumbs' ) ) { $options['rank-math'] = 'Rank Math'; } return $options; } add_filter( 'oceanwp_breadcrumbs_source_list', 'oceanwp_breadcrumbs_sources' ); /** * Shows a breadcrumb for all types of pages. This is a wrapper function for the Breadcrumb_Trail class, * which should be used in theme templates. * * @since 0.1.0 * @access public * @param array $args Arguments to pass to Breadcrumb_Trail. * @return void */ function oceanwp_breadcrumb_trail( $args = array() ) { // Return if breadcrumbs are disabled. if ( ! oceanwp_has_breadcrumbs() || is_front_page() ) { return; } $breadcrumb_source = get_theme_mod( 'ocean_breadcrumbs_source' ); $is_enable = is_callable( 'WPSEO_Options::get' ) ? WPSEO_Options::get( 'breadcrumbs-enable' ) : false; $wpseo_data = get_option( 'wpseo_internallinks' ) ? get_option( 'wpseo_internallinks' ) : $is_enable; if ( ! is_array( $wpseo_data ) ) { unset( $wpseo_data ); $wpseo_data = array( 'breadcrumbs-enable' => $is_enable, ); } // Yoast breadcrumbs. if ( function_exists( 'yoast_breadcrumb' ) && true === $wpseo_data['breadcrumbs-enable'] && $breadcrumb_source && 'yoast-seo' === $breadcrumb_source ) { $classes = 'site-breadcrumbs clr'; if ( $breadcrumbs_position = get_theme_mod( 'ocean_breadcrumbs_position' ) ) { $classes .= ' position-' . $breadcrumbs_position; } return yoast_breadcrumb( '<nav class="' . $classes . '">', '</nav>' ); } // SEOPress breadcrumbs. if ( function_exists( 'seopress_display_breadcrumbs' ) && $breadcrumb_source && 'seopress' === $breadcrumb_source ) { return seopress_display_breadcrumbs(); } // Rank Math breadcrumbs. if ( function_exists( 'rank_math_the_breadcrumbs' ) && RankMath\Helper::get_settings( 'general.breadcrumbs' ) && $breadcrumb_source && 'rank-math' === $breadcrumb_source ) { return rank_math_the_breadcrumbs(); } $schema = get_theme_mod( 'ocean_breadcrumb_schema', true ); $defaults = array( 'schema' => $schema, ); $args = apply_filters( 'oceanwp_breadcrumb_trail_args', $defaults ); $breadcrumb = apply_filters( 'oceanwp_breadcrumb_trail_object', null, $args ); if ( ! is_object( $breadcrumb ) ) { $breadcrumb = new OceanWP_Breadcrumb_Trail( $args ); } return $breadcrumb->trail(); } /** * Add container to SEOPRess breadcrumbs. * * @since 1.5.21 */ function sp_breadcrumbs_before() { $classes = 'site-breadcrumbs clr'; if ( $breadcrumbs_position = get_theme_mod( 'ocean_breadcrumbs_position' ) ) { $classes .= ' position-' . $breadcrumbs_position; } echo '<div class="' . esc_attr( $classes ) . '">'; } add_action( 'seopress_breadcrumbs_before_html', 'sp_breadcrumbs_before' ); /** * Div closed */ function sp_breadcrumbs_after() { echo '</div>'; } add_action( 'seopress_breadcrumbs_after_html', 'sp_breadcrumbs_after' ); /** * Add container to Rank Math breadcrumbs. * * @since 1.6.5 */ function rm_breadcrumbs( $args ) { $classes = 'site-breadcrumbs clr'; if ( $breadcrumbs_position = get_theme_mod( 'ocean_breadcrumbs_position' ) ) { $classes .= ' position-' . $breadcrumbs_position; } $args['wrap_before'] = '<div class="' . $classes . '">'; $args['wrap_after'] = '</div>'; return $args; } add_action( 'rank_math/frontend/breadcrumb/args', 'rm_breadcrumbs' ); /** * Add container to WooCommerce breadcrumbs. * * @since 3.4.5 */ function owp_woo_breadcrumbs( $args ) { $classes = 'site-breadcrumbs woocommerce-breadcrumbs clr'; if ( $breadcrumbs_position = get_theme_mod( 'ocean_breadcrumbs_position' ) ) { $classes .= ' position-' . $breadcrumbs_position; } $separator = apply_filters( 'oceanwp_breadcrumb_separator', get_theme_mod( 'ocean_breadcrumb_separator', '>' ) ); $separator = '<span class="breadcrumb-sep">' . $separator . '</span>'; $args['wrap_before'] = '<div class="' . $classes . '">'; $args['wrap_after'] = '</div>'; $args['delimiter'] = $separator; return $args; } add_filter( 'woocommerce_breadcrumb_defaults', 'owp_woo_breadcrumbs' ); /** * Creates a breadcrumbs menu for the site based on the current page that's being viewed by the user. * * @since 0.6.0 * @access public */ class OceanWP_Breadcrumb_Trail { /** * Array of items belonging to the current breadcrumb trail. * * @since 0.1.0 * @access public * @var array */ public $items = array(); /** * Arguments used to build the breadcrumb trail. * * @since 0.1.0 * @access public * @var array */ public $args = array(); /** * Array of text labels. * * @since 1.0.0 * @access public * @var array */ public $labels = array(); /** * Array of post types (key) and taxonomies (value) to use for single post views. * * @since 1.0.0 * @access public * @var array */ public $post_taxonomy = array(); /* ====== Magic Methods ====== */ /** * Magic method to use in case someone tries to output the layout object as a string. * We'll just return the trail HTML. * * @since 1.0.0 * @access public * @return string */ public function __toString() { return $this->trail(); } /** * Sets up the breadcrumb trail properties. Calls the `OceanWP_Breadcrumb_Trail::add_items()` method * to creat the array of breadcrumb items. * * @since 0.6.0 * @access public * @param array $args { * @type string $container Container HTML element. nav|div * @type string $before String to output before breadcrumb menu. * @type string $after String to output after breadcrumb menu. * @type bool $show_on_front Whether to show when `is_front_page()`. * @type bool $network Whether to link to the network main site (multisite only). * @type bool $show_title Whether to show the title (last item) in the trail. * @type array $labels Text labels. @see OceanWP_Breadcrumb_Trail::set_labels() * @type array $post_taxonomy Taxonomies to use for post types. @see OceanWP_Breadcrumb_Trail::set_post_taxonomy() * @type bool $echo Whether to print or return the breadcrumbs. * } * @return void */ public function __construct( $args = array() ) { $defaults = array( 'container' => 'nav', 'before' => '', 'after' => '', 'show_on_front' => false, 'network' => false, 'show_title' => true, 'labels' => array(), 'post_taxonomy' => array(), 'echo' => true, 'schema' => true, ); // Parse the arguments with the deaults. $this->args = apply_filters( 'oceanwp_breadcrumb_trail_args', wp_parse_args( $args, $defaults ) ); // Set the labels and post taxonomy properties. $this->set_labels(); $this->set_post_taxonomy(); // Let's find some items to add to the trail! $this->add_items(); } /* ====== Public Methods ====== */ /** * Return the Schema attributes for breadcrumb. * * @since 3.4.5 * @access protected * @return string */ protected function breadcrumb_schema( $schema_for ) { $item_count = count( $this->items ); if ( 2 > $item_count || false === $this->args['schema'] ) { return; } $breadcrumb_schema = apply_filters( 'oceanwp_theme_strings', array( 'breadcrumbList' => 'itemscope itemtype="http://schema.org/BreadcrumbList"', 'itempropName' => 'itemprop="name"', 'itempropThing' => 'itemtype="https://schema.org/Thing"', 'ItempropList' => 'itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"', ) ); $schema_item = isset( $breadcrumb_schema[ $schema_for ] ) ? $breadcrumb_schema[ $schema_for ] : ''; return $schema_item; } /** * Formats the HTML output for the breadcrumb trail. * * @since 0.6.0 * @access public * @return string */ public function get_trail() { // Set up variables that we'll need. $breadcrumb = ''; $separator = apply_filters( 'oceanwp_breadcrumb_separator', get_theme_mod( 'ocean_breadcrumb_separator', '>' ) ); $separator = '<span class="breadcrumb-sep">' . $separator . '</span>'; $item_count = count( $this->items ); $item_position = 0; $meta = ''; $p_class = ''; // Connect the breadcrumb trail if there are items in the trail. if ( 0 < $item_count ) { // Open the unordered list. $breadcrumb .= sprintf( '<ol class="trail-items" %s>', $this->breadcrumb_schema( 'breadcrumbList' ) ); if ( $this->args['schema'] ) { // Add the number of items and item list order schema. $breadcrumb .= sprintf( '<meta name="numberOfItems" content="%d" />', absint( $item_count ) ); $breadcrumb .= '<meta name="itemListOrder" content="Ascending" />'; } // Loop through the items and add them to the list. foreach ( $this->items as $item ) { // Iterate the item position. ++$item_position; // Check if the item is linked. preg_match( '/(<a.*?>)(.*?)(<\/a>)/i', $item, $matches ); // Wrap the item text with appropriate itemprop. $item = ! empty( $matches ) ? sprintf( '%s<span %s>%s</span>%s', $matches[1], $this->breadcrumb_schema( 'itempropName' ), $matches[2], $matches[3] ) : sprintf( '<span>%s</span>', $item ); // Wrap the item with its itemprop. $item = ( ! empty( $matches ) && $this->args['schema'] ) ? preg_replace( '/(<a.*?)([\'"])>/i', '$1$2 itemprop=$2item$2>', $item ) : sprintf( '<a span href="#">%s</span></a>', $item ); // Add list item classes. $item_class = 'trail-item'; if ( 1 === $item_position && 1 < $item_count ) { $item_class .= ' trail-begin'; } elseif ( $item_count === $item_position ) { $item_class .= ' trail-end'; } // Create list item attributes. $attributes = 'class="' . $item_class . '" ' . $this->breadcrumb_schema( 'ItempropList' ) . ''; if ( $this->args['schema'] ) { // Position meta. $meta = sprintf( '<meta itemprop="position" content="%s" />', absint( $item_position ) ); } // Separator. if ( $item_count === $item_position ) { $sep = ''; $item = sprintf( '<span itemprop="name">%s</span>', $this->items[$item_count - 1] ); } else { $sep = $separator; } // Build the list item. $breadcrumb .= sprintf( '<li %s>%s%s%s</li>', $attributes, $item, $sep, $meta ); } // Close the unordered list. $breadcrumb .= '</ol>'; // Postion class. if ( '' !== get_theme_mod( 'ocean_breadcrumbs_position' ) ) { $p_class = ' position-' . get_theme_mod( 'ocean_breadcrumbs_position' ); } // Wrap the breadcrumb trail. $breadcrumb = sprintf( '<%1$s role="navigation" aria-label="%2$s" class="site-breadcrumbs clr' . $p_class . '">%3$s%4$s%5$s</%1$s>', tag_escape( $this->args['container'] ), esc_attr( $this->labels['aria_label'] ), $this->args['before'], $breadcrumb, $this->args['after'] ); } // Allow developers to filter the breadcrumb trail HTML. $breadcrumb = apply_filters( 'breadcrumb_trail', $breadcrumb, $this->args ); return $breadcrumb; } /** * Echo the breadcrumb trail. * * @since 0.6.0 * @access public * @return string */ public function trail() { echo $this->get_trail(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } /* ====== Protected Methods ====== */ /** * Sets the labels property. Parses the inputted labels array with the defaults. * * @since 1.0.0 * @access protected * @return void */ protected function set_labels() { $defaults = array( 'aria_label' => esc_attr_x( 'Breadcrumbs', 'breadcrumbs aria label', 'oceanwp' ), 'home' => get_theme_mod( 'ocean_breadcrumb_translation_home', esc_html__( 'Home', 'oceanwp' ) ), 'error_404' => get_theme_mod( 'ocean_breadcrumb_translation_error', esc_html__( '404 Not Found', 'oceanwp' ) ), 'archives' => esc_html__( 'Archives', 'oceanwp' ), // Translators: %s is the search query. The HTML entities are opening and closing curly quotes. 'search' => get_theme_mod( 'ocean_breadcrumb_translation_search', esc_html__( 'Search results for', 'oceanwp' ) ), // Translators: %s is the page number. 'paged' => esc_html__( 'Page %s', 'oceanwp' ), // Translators: Minute archive title. %s is the minute time format. 'archive_minute' => esc_html__( 'Minute %s', 'oceanwp' ), // Translators: Weekly archive title. %s is the week date format. 'archive_week' => esc_html__( 'Week %s', 'oceanwp' ), // "%s" is replaced with the translated date/time format. 'archive_minute_hour' => '%s', 'archive_hour' => '%s', 'archive_day' => '%s', 'archive_month' => '%s', 'archive_year' => '%s', ); $this->labels = apply_filters( 'breadcrumb_trail_labels', wp_parse_args( $this->args['labels'], $defaults ) ); } /** * Sets the `$post_taxonomy` property. This is an array of post types (key) and taxonomies (value). * The taxonomy's terms are shown on the singular post view if set. * * @since 1.0.0 * @access protected * @return void */ protected function set_post_taxonomy() { $defaults = array(); // If post permalink is set to `%postname%`, use the `category` taxonomy. if ( '%postname%' === trim( get_option( 'permalink_structure' ), '/' ) ) { $defaults['post'] = 'category'; } $this->post_taxonomy = apply_filters( 'oceanwp_breadcrumb_trail_post_taxonomy', wp_parse_args( $this->args['post_taxonomy'], $defaults ) ); } /** * Runs through the various WordPress conditional tags to check the current page being viewed. Once * a condition is met, a specific method is launched to add items to the `$items` array. * * @since 1.0.0 * @access protected * @return void */ protected function add_items() { // If viewing the front page. if ( is_front_page() ) { $this->add_front_page_items(); } // If not viewing the front page. else { // Add the network and site home links. $this->add_network_home_link(); $this->add_site_home_link(); // If viewing the blog page. if ( is_home() ) { $this->add_home_items(); } // If viewing a single post. elseif ( is_singular() ) { $this->add_singular_items(); } // If viewing an archive page. elseif ( is_archive() ) { if ( is_post_type_archive() ) { $this->add_post_type_archive_items(); } elseif ( is_category() || is_tag() || is_tax() ) { $this->add_term_archive_items(); } elseif ( is_author() ) { $this->add_user_archive_items(); } elseif ( get_query_var( 'minute' ) && get_query_var( 'hour' ) ) { $this->add_minute_hour_archive_items(); } elseif ( get_query_var( 'minute' ) ) { $this->add_minute_archive_items(); } elseif ( get_query_var( 'hour' ) ) { $this->add_hour_archive_items(); } elseif ( is_day() ) { $this->add_day_archive_items(); } elseif ( get_query_var( 'w' ) ) { $this->add_week_archive_items(); } elseif ( is_month() ) { $this->add_month_archive_items(); } elseif ( is_year() ) { $this->add_year_archive_items(); } else { $this->add_default_archive_items(); } } // If viewing a search results page. elseif ( is_search() ) { $this->add_search_items(); } // If viewing the 404 page. elseif ( is_404() ) { $this->add_404_items(); } } // Add paged items if they exist. $this->add_paged_items(); // Allow developers to overwrite the items for the breadcrumb trail. $this->items = array_unique( apply_filters( 'oceanwp_breadcrumb_trail_items', $this->items, $this->args ) ); } /** * Gets front items based on $wp_rewrite->front. * * @since 1.0.0 * @access protected * @return void */ protected function add_rewrite_front_items() { global $wp_rewrite; if ( $wp_rewrite->front ) $this->add_path_parents( $wp_rewrite->front ); } /** * Adds the page/paged number to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_paged_items() { // If viewing a paged singular post. if ( is_singular() && 1 < get_query_var( 'page' ) && true === $this->args['show_title'] ) { $this->items[] = sprintf( $this->labels['paged'], number_format_i18n( absint( get_query_var( 'page' ) ) ) ); } // If viewing a singular post with paged comments. elseif ( is_singular() && get_option( 'page_comments' ) && 1 < get_query_var( 'cpage' ) ) { $this->items[] = sprintf( $this->labels['paged_comments'], number_format_i18n( absint( get_query_var( 'cpage' ) ) ) ); } // If viewing a paged archive-type page. elseif ( is_paged() && true === $this->args['show_title'] ) { $this->items[] = sprintf( $this->labels['paged'], number_format_i18n( absint( get_query_var( 'paged' ) ) ) ); } } /** * Adds the network (all sites) home page link to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_network_home_link() { // Home item $setting = get_theme_mod( 'ocean_breadcrumb_home_item', 'icon' ); // Icon $icon_class = ''; if ( 'text' == $setting ) { $icon_class = ' has-text'; } $icon = ''; if ( is_customize_preview() || 'icon' == $setting ) { $icon = oceanwp_icon( 'home', false ); } if ( is_customize_preview() && 'text' == $setting ) { $icon = oceanwp_icon( 'home', false, 'icon-home has-text' ); } // Text. $text_class = ''; if ( 'icon' == $setting ) { $text_class = ' has-icon'; } $text = '<span class="breadcrumb-home'. $text_class .'">'. $this->labels['home'] .'</span>'; if ( is_multisite() && ! is_main_site() && true === $this->args['network'] ) { $this->items[] = sprintf( '<a href="%s" rel="home" aria-label="' .$this->labels['home']. '">%s</a>', esc_url( network_home_url() ), $icon, $text ); } } /** * Adds the current site's home page link to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_site_home_link() { // Home item $setting = get_theme_mod( 'ocean_breadcrumb_home_item', 'icon' ); // Icon $icon_class = ''; if ( 'text' == $setting ) { $icon_class = ' has-text'; } $icon = ''; if ( is_customize_preview() || 'icon' == $setting ) { $icon = oceanwp_icon( 'home', false ); } if ( is_customize_preview() && 'text' == $setting ) { $icon = oceanwp_icon( 'home', false, 'icon-home has-text' ); } // Text $text_class = ''; if ( 'icon' == $setting ) { $text_class = ' has-icon'; } $text = '<span class="breadcrumb-home'. $text_class .'">'. $this->labels['home'] .'</span>'; // Vars $network = is_multisite() && ! is_main_site() && true === $this->args['network']; $label = $network ? get_bloginfo( 'name' ) : $text; $rel = $network ? '' : ' rel="home"'; $this->items[] = sprintf( '<a href="%s"%s aria-label="' . $this->labels['home'] . '">%s%s</a>', esc_url( home_url() ), $rel, $icon, $label ); } /** * Adds items for the front page to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_front_page_items() { // Only show front items if the 'show_on_front' argument is set to 'true'. if ( true === $this->args['show_on_front'] || is_paged() || ( is_singular() && 1 < get_query_var( 'page' ) ) ) { // Add network home link. $this->add_network_home_link(); // If on a paged view, add the site home link. if ( is_paged() ) { $this->add_site_home_link(); } // If on the main front page, add the network home title. elseif ( true === $this->args['show_title'] ) { $this->items[] = is_multisite() && true === $this->args['network'] ? get_bloginfo( 'name' ) : $this->labels['home']; } } } /** * Adds blog page items to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_home_items() { $post_id = get_option( 'page_for_posts' ); $title = get_the_title( $post_id ); if ( true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $post_id ) ), $title ); } elseif ( $title && true === $this->args['show_title'] ) { $this->items[] = $title; } } /** * Add crumbs for a term. * * @since 3.4.5 * @access protected * @param int $term_id Term ID. * @param string $taxonomy Taxonomy. */ protected 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->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_term_link( $ancestor ) ), $ancestor->name ); } } } /** * Adds singular post items to the items array. * * @since 1.0.0 * @access protected * @return void */ protected function add_singular_items() { // Get the queried post. $post = get_queried_object(); $post_id = get_queried_object_id(); // Post type taxonomy $posts_tax = get_theme_mod( 'ocean_breadcrumb_posts_taxonomy', 'category' ); $products_tax = get_theme_mod( 'ocean_breadcrumb_products_taxonomy', 'shop' ); $portfolio_tax = get_theme_mod( 'ocean_breadcrumb_portfolio_taxonomy', 'ocean_portfolio_category' ); if ( 'product' != $post->post_type ) { // If the post has a parent, follow the parent trail. if ( 0 < $post->post_parent ) { $this->add_post_parents( $post->post_parent ); } // If the post doesn't have a parent, get its hierarchy based off the post type. else { $this->add_post_hierarchy( $post_id ); } } // If the post type is 'post'. if ( 'post' === $post->post_type && 'none' != $posts_tax ) { if ( 'blog' == $posts_tax && ( 'posts' !== get_option( 'show_on_front' ) && 0 < $post_id ) ) { $page_id = get_option( 'page_for_posts'); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $page_id ) ), get_the_title( $page_id ) ); } else { $this->add_post_terms( $post_id, $posts_tax ); } } // If the post type is 'product'. else if ( 'product' === $post->post_type && 'none' != $products_tax ) { $cat = current( get_the_category( $post ) ); if ( 'shop' == $products_tax ) { $shop_id = wc_get_page_id( 'shop' ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $shop_id ) ), get_the_title( $shop_id ) ); } else if ( 'product_cat' === $products_tax || 'product_tag' === $products_tax ) { $terms = wc_get_product_terms( $post_id, $products_tax, 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, $products_tax ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_term_link( $main_term ) ), $main_term->name ); } } else { $this->add_post_terms( $post_id, $products_tax ); } } // If the post type is 'ocean_portfolio'. else if ( class_exists( 'Ocean_Portfolio' ) && 'ocean_portfolio' === $post->post_type && 'none' != $portfolio_tax ) { $portfolio_id = get_theme_mod( 'op_portfolio_page' ); if ( 'portfolio' == $portfolio_tax && ! empty( $portfolio_id ) ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $portfolio_id ) ), get_the_title( $portfolio_id ) ); } else { $this->add_post_terms( $post_id, $portfolio_tax ); } } // Other posts types else { if ( ! empty( $this->post_taxonomy[ $post->post_type ] ) ) { $this->add_post_terms( $post_id, $this->post_taxonomy[ $post->post_type ] ); } } // End with the post title. if ( true == get_theme_mod( 'ocean_breadcrumb_show_title', true ) && $post_title = single_post_title( '', false ) ) { if ( 1 < get_query_var( 'page' ) || is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $post_id ) ), $post_title ); } if ( function_exists('is_wc_endpoint_url') && is_wc_endpoint_url() ){ $endpoint = WC()->query->get_current_endpoint(); $endpoint_title = WC()->query->get_endpoint_title( $endpoint ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( wc_get_endpoint_url( $endpoint ) ), $endpoint_title ); } } } /** * Adds the items to the trail items array for taxonomy term archives. * * @since 1.0.0 * @access protected * @global object $wp_rewrite * @return void */ protected function add_term_archive_items() { global $wp_rewrite; // Get some taxonomy and term variables. $term = get_queried_object(); $taxonomy = get_taxonomy( $term->taxonomy ); $done_post_type = false; // If there are rewrite rules for the taxonomy. if ( false !== $taxonomy->rewrite ) { // If 'with_front' is true, dd $wp_rewrite->front to the trail. if ( $taxonomy->rewrite['with_front'] && $wp_rewrite->front ) $this->add_rewrite_front_items(); // Get parent pages by path if they exist. $this->add_path_parents( $taxonomy->rewrite['slug'] ); // Add post type archive if its 'has_archive' matches the taxonomy rewrite 'slug'. if ( $taxonomy->rewrite['slug'] ) { $slug = trim( $taxonomy->rewrite['slug'], '/' ); // Deals with the situation if the slug has a '/' between multiple // strings. For example, "movies/genres" where "movies" is the post // type archive. $matches = explode( '/', $slug ); // 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. $slug = $match; // Get public post types that match the rewrite slug. $post_types = $this->get_post_types_by_slug( $match ); if ( ! empty( $post_types ) ) { $post_type_object = $post_types[0]; // Add support for a non-standard label of 'archive_title' (special use case). $label = ! empty( $post_type_object->labels->archive_title ) ? $post_type_object->labels->archive_title : $post_type_object->labels->name; // Core filter hook. $label = apply_filters( 'post_type_archive_title', $label, $post_type_object->name ); // Add the post type archive link to the trail. $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_post_type_archive_link( $post_type_object->name ) ), $label ); $done_post_type = true; // Break out of the loop. break; } } } } } // If there's a single post type for the taxonomy, use it. if ( false === $done_post_type && 1 === count( $taxonomy->object_type ) && post_type_exists( $taxonomy->object_type[0] ) ) { // If the post type is 'post'. if ( 'post' === $taxonomy->object_type[0] ) { $post_id = get_option( 'page_for_posts' ); if ( 'posts' !== get_option( 'show_on_front' ) && 0 < $post_id ) $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $post_id ) ), get_the_title( $post_id ) ); // If the post type is not 'post'. } else { $post_type_object = get_post_type_object( $taxonomy->object_type[0] ); $label = ! empty( $post_type_object->labels->archive_title ) ? $post_type_object->labels->archive_title : $post_type_object->labels->name; // Core filter hook. $label = apply_filters( 'post_type_archive_title', $label, $post_type_object->name ); $url = apply_filters( 'post_type_archive_url', get_post_type_archive_link( $post_type_object->name ) ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( $url ), $label ); } } // If the taxonomy is hierarchical, list its parent terms. if ( is_taxonomy_hierarchical( $term->taxonomy ) && $term->parent ) { $this->add_term_parents( $term->parent, $term->taxonomy ); } // Add the term name to the trail end. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_term_link( $term, $term->taxonomy ) ), single_term_title( '', false ) ); } } /** * Adds the items to the trail items array for post type archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_post_type_archive_items() { // Get the post type object. $post_type_object = get_post_type_object( get_query_var( 'post_type' ) ); if ( false !== $post_type_object->rewrite ) { // If 'with_front' is true, add $wp_rewrite->front to the trail. if ( $post_type_object->rewrite['with_front'] ) { $this->add_rewrite_front_items(); } // If there's a rewrite slug, check for parents. if ( ! empty( $post_type_object->rewrite['slug'] ) ) { $this->add_path_parents( $post_type_object->rewrite['slug'] ); } } // Add the post type [plural] name to the trail end. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_post_type_archive_link( $post_type_object->name ) ), post_type_archive_title( '', false ) ); } } /** * Adds the items to the trail items array for user (author) archives. * * @since 1.0.0 * @access protected * @global object $wp_rewrite * @return void */ protected function add_user_archive_items() { global $wp_rewrite; // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Get the user ID. $user_id = get_query_var( 'author' ); // If $author_base exists, check for parent pages. if ( ! empty( $wp_rewrite->author_base ) && ! is_post_type_archive() ) { $this->add_path_parents( $wp_rewrite->author_base ); } // Add the author's display name to the trail end. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_author_posts_url( $user_id ) ), get_the_author_meta( 'display_name', $user_id ) ); } } /** * Adds the items to the trail items array for minute + hour archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_minute_hour_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Add the minute + hour item. if ( true === $this->args['show_title'] ) { $this->items[] = sprintf( $this->labels['archive_minute_hour'], get_the_time( esc_html_x( 'g:i a', 'minute and hour archives time format', 'oceanwp' ) ) ); } } /** * Adds the items to the trail items array for minute archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_minute_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Add the minute item. if ( true === $this->args['show_title'] ) { $this->items[] = sprintf( $this->labels['archive_minute'], get_the_time( esc_html_x( 'i', 'minute archives time format', 'oceanwp' ) ) ); } } /** * Adds the items to the trail items array for hour archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_hour_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Add the hour item. if ( true === $this->args['show_title'] ) { $this->items[] = sprintf( $this->labels['archive_hour'], get_the_time( esc_html_x( 'g a', 'hour archives time format', 'oceanwp' ) ) ); } } /** * Adds the items to the trail items array for day archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_day_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Get year, month, and day. $year = sprintf( $this->labels['archive_year'], get_the_time( esc_html_x( 'Y', 'yearly archives date format', 'oceanwp' ) ) ); $month = sprintf( $this->labels['archive_month'], get_the_time( esc_html_x( 'F', 'monthly archives date format', 'oceanwp' ) ) ); $day = sprintf( $this->labels['archive_day'], get_the_time( esc_html_x( 'j', 'daily archives date format', 'oceanwp' ) ) ); // Add the year and month items. $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_year_link( get_the_time( 'Y' ) ) ), $year ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_month_link( get_the_time( 'Y' ), get_the_time( 'm' ) ) ), $month ); // Add the day item. $archive_year = get_the_time( 'Y' ); $archive_month = get_the_time( 'm' ); $archive_day = get_the_time( 'd' ); if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_day_link( $archive_year, $archive_month, $archive_day ) ), $day ); } } /** * Adds the items to the trail items array for week archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_week_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Get the year and week. $year = sprintf( $this->labels['archive_year'], get_the_time( esc_html_x( 'Y', 'yearly archives date format', 'oceanwp' ) ) ); $week = sprintf( $this->labels['archive_week'], get_the_time( esc_html_x( 'W', 'weekly archives date format', 'oceanwp' ) ) ); // Add the year item. $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_year_link( get_the_time( 'Y' ) ) ), $year ); // Add the week item. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = esc_url( get_archives_link( add_query_arg( array( 'm' => get_the_time( 'Y' ), 'w' => get_the_time( 'W' ) ), home_url() ), $week, false ) ); } } /** * Adds the items to the trail items array for month archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_month_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Get the year and month. $year = sprintf( $this->labels['archive_year'], get_the_time( esc_html_x( 'Y', 'yearly archives date format', 'oceanwp' ) ) ); $month = sprintf( $this->labels['archive_month'], get_the_time( esc_html_x( 'F', 'monthly archives date format', 'oceanwp' ) ) ); // Add the year item. $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_year_link( get_the_time( 'Y' ) ) ), $year ); // Add the month item. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_month_link( get_the_time( 'Y' ), get_the_time( 'm' ) ) ), $month ); } } /** * Adds the items to the trail items array for year archives. * * @since 1.0.0 * @access protected * @return void */ protected function add_year_archive_items() { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Get the year. $year = sprintf( $this->labels['archive_year'], get_the_time( esc_html_x( 'Y', 'yearly archives date format', 'oceanwp' ) ) ); // Add the year item. if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_year_link( get_the_time( 'Y' ) ) ), $year ); } } /** * Adds the items to the trail items array for archives that don't have a more specific method * defined in this class. * * @since 1.0.0 * @access protected * @return void */ protected function add_default_archive_items() { // If this is a date-/time-based archive, add $wp_rewrite->front to the trail. if ( is_date() || is_time() ) { $this->add_rewrite_front_items(); } if ( true === $this->args['show_title'] ) { $this->items[] = $this->labels['archives']; } } /** * Adds the items to the trail items array for search results. * * @since 1.0.0 * @access protected * @return void */ protected function add_search_items() { if ( is_paged() || true === $this->args['show_title'] ) { $this->items[] = sprintf( '<a href="%s">%s%s</a>', esc_url( get_search_link() ), '<span class="breadcrumb-search">'. $this->labels['search'] .'</span>', ' “'. get_search_query() .'”' ); } } /** * Adds the items to the trail items array for 404 pages. * * @since 1.0.0 * @access protected * @return void */ protected function add_404_items() { if ( true === $this->args['show_title'] ) { $this->items[] = '<span class="breadcrumb-error">'. $this->labels['error_404'] .'</span>'; } } /** * Adds a specific post's parents to the items array. * * @since 1.0.0 * @access protected * @param int $post_id * @return void */ protected function add_post_parents( $post_id ) { $parents = array(); while ( $post_id ) { // Get the post by ID. $post = get_post( $post_id ); // If we hit a page that's set as the front page, bail. if ( 'page' == $post->post_type && 'page' == get_option( 'show_on_front' ) && $post_id == get_option( 'page_on_front' ) ) { break; } // Add the formatted post link to the array of parents. $parents[] = sprintf( '<a href="%s">%s</a>', esc_url( get_permalink( $post_id ) ), get_the_title( $post_id ) ); // If there's no longer a post parent, break out of the loop. if ( 0 >= $post->post_parent ) { break; } // Change the post ID to the parent post to continue looping. $post_id = $post->post_parent; } // Get the post hierarchy based off the final parent post. $this->add_post_hierarchy( $post_id ); // Display terms for specific post type taxonomy if requested. if ( ! empty( $this->post_taxonomy[ $post->post_type ] ) ) { $this->add_post_terms( $post_id, $this->post_taxonomy[ $post->post_type ] ); } // Merge the parent items into the items array. $this->items = array_merge( $this->items, array_reverse( $parents ) ); } /** * Adds a specific post's hierarchy to the items array. The hierarchy is determined by post type's * rewrite arguments and whether it has an archive page. * * @since 1.0.0 * @access protected * @param int $post_id * @return void */ protected function add_post_hierarchy( $post_id ) { // Get the post type. $post_type = get_post_type( $post_id ); $post_type_object = get_post_type_object( $post_type ); // If this is the 'post' post type, get the rewrite front items and map the rewrite tags. if ( 'post' === $post_type ) { // Add $wp_rewrite->front to the trail. $this->add_rewrite_front_items(); // Map the rewrite tags. $this->map_rewrite_tags( $post_id, get_option( 'permalink_structure' ) ); } // If the post type has rewrite rules. elseif ( false !== $post_type_object->rewrite ) { // If 'with_front' is true, add $wp_rewrite->front to the trail. if ( $post_type_object->rewrite['with_front'] ) { $this->add_rewrite_front_items(); } // If there's a path, check for parents. if ( ! empty( $post_type_object->rewrite['slug'] ) ) { $this->add_path_parents( $post_type_object->rewrite['slug'] ); } } // If there's an archive page, add it to the trail. if ( $post_type_object->has_archive ) { // Add support for a non-standard label of 'archive_title' (special use case). $label = !empty( $post_type_object->labels->archive_title ) ? $post_type_object->labels->archive_title : $post_type_object->labels->name; // Core filter hook. $label = apply_filters( 'post_type_archive_title', $label, $post_type_object->name ); $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_post_type_archive_link( $post_type ) ), $label ); } // Map the rewrite tags if there's a `%` in the slug. if ( 'post' !== $post_type && ! empty( $post_type_object->rewrite['slug'] ) && false !== strpos( $post_type_object->rewrite['slug'], '%' ) ) { $this->map_rewrite_tags( $post_id, $post_type_object->rewrite['slug'] ); } } /** * Gets post types by slug. This is needed because the get_post_types() function doesn't exactly * match the 'has_archive' argument when it's set as a string instead of a boolean. * * @since 0.6.0 * @access protected * @param int $slug The post type archive slug to search for. * @return void */ protected function get_post_types_by_slug( $slug ) { $return = array(); $post_types = get_post_types( array(), 'objects' ); foreach ( $post_types as $type ) { if ( $slug === $type->has_archive || ( true === $type->has_archive && $slug === $type->rewrite['slug'] ) ) { $return[] = $type; } } return $return; } /** * Adds a post's terms from a specific taxonomy to the items array. * * @since 1.0.0 * @access protected * @param int $post_id The ID of the post to get the terms for. * @param string $taxonomy The taxonomy to get the terms from. * @return void */ protected function add_post_terms( $post_id, $taxonomy ) { // Get the post type. $post_type = get_post_type( $post_id ); // Get the post categories. $terms = get_the_terms( $post_id, $taxonomy ); // Check that categories were returned. if ( $terms && ! is_wp_error( $terms ) ) { // Sort the terms by ID and get the first category. if ( function_exists( 'wp_list_sort' ) ) { $terms = wp_list_sort( $terms, 'term_id' ); } else { usort( $terms, '_usort_terms_by_ID' ); } $term = get_term( $terms[0], $taxonomy ); // If the category has a parent, add the hierarchy to the trail. if ( 0 < $term->parent ) { $this->add_term_parents( $term->parent, $taxonomy ); } // Add the category archive link to the trail. $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_term_link( $term, $taxonomy ) ), $term->name ); } } /** * Get parent posts by path. Currently, this method only supports getting parents of the 'page' * post type. 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. * * @since 1.0.0 * @access protected * @param string $path The path (slug) to search for posts by. * @return void */ function add_path_parents( $path ) { // Trim '/' off $path in case we just got a simple '/' instead of a real path. $path = trim( $path, '/' ); // If there's no path, return. if ( empty( $path ) ) return; // Get parent post by the path. $post = get_page_by_path( $path ); if ( !empty( $post ) ) { $this->add_post_parents( $post->ID ); } elseif ( is_null( $post ) ) { // 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 ); $post = get_page_by_path( trim( $path, '/' ) ); // If a parent post is found, set the $post_id and break out of the loop. if ( !empty( $post ) && 0 < $post->ID ) { $this->add_post_parents( $post->ID ); break; } } } } } } /** * 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 1.0.0 * @param int $term_id ID of the term to get the parents of. * @param string $taxonomy Name of the taxonomy for the given term. * @return void */ function add_term_parents( $term_id, $taxonomy ) { // Set up some default arrays. $parents = array(); // While there is a parent ID, add the parent term link to the $parents array. while ( $term_id ) { // Get the parent term. $term = get_term( $term_id, $taxonomy ); // Add the formatted term link to the array of parent terms. $parents[] = sprintf( '<a href="%s">%s</a>', esc_url( get_term_link( $term, $taxonomy ) ), $term->name ); // Set the parent term's parent as the parent ID. $term_id = $term->parent; } // If we have parent terms, reverse the array to put them in the proper order for the trail. if ( ! empty( $parents ) ) $this->items = array_merge( $this->items, array_reverse( $parents ) ); } /** * 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.6.0 * @access protected * @param int $post_id ID of the post whose parents we want. * @param string $path Path of a potential parent page. * @param array $args Mixed arguments for the menu. * @return array */ protected function map_rewrite_tags( $post_id, $path ) { $post = get_post( $post_id ); // 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 ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_year_link( get_the_time( 'Y', $post_id ) ) ), sprintf( $this->labels['archive_year'], get_the_time( esc_html_x( 'Y', 'yearly archives date format', 'oceanwp' ) ) ) ); } // If using the %monthnum% tag, add a link to the monthly archive. elseif ( '%monthnum%' == $tag ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_month_link( get_the_time( 'Y', $post_id ), get_the_time( 'm', $post_id ) ) ), sprintf( $this->labels['archive_month'], get_the_time( esc_html_x( 'F', 'monthly archives date format', 'oceanwp' ) ) ) ); } // If using the %day% tag, add a link to the daily archive. elseif ( '%day%' == $tag ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_day_link( get_the_time( 'Y', $post_id ), get_the_time( 'm', $post_id ), get_the_time( 'd', $post_id ) ) ), sprintf( $this->labels['archive_day'], get_the_time( esc_html_x( 'j', 'daily archives date format', 'oceanwp' ) ) ) ); } // If using the %author% tag, add a link to the post author archive. elseif ( '%author%' == $tag ) { $this->items[] = sprintf( '<a href="%s">%s</a>', esc_url( get_author_posts_url( $post->post_author ) ), 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 ( taxonomy_exists( trim( $tag, '%' ) ) ) { // Force override terms in this post type. $this->post_taxonomy[ $post->post_type ] = false; // Add the post categories. $this->add_post_terms( $post_id, trim( $tag, '%' ) ); } } } } }