| 1 |
<?php |
| 2 |
namespace ABlocks\Blocks\Breadcrumb; |
| 3 |
|
| 4 |
if ( ! defined( 'ABSPATH' ) ) { |
| 5 |
exit; |
| 6 |
} |
| 7 |
|
| 8 |
use ABlocks\Classes\BlockBaseAbstract; |
| 9 |
use ABlocks\Classes\CssGeneratorV2; |
| 10 |
use ABlocks\Helper; |
| 11 |
use ABlocks\Controls\Color; |
| 12 |
use ABlocks\Controls\Typography; |
| 13 |
use ABlocks\Controls\Alignment; |
| 14 |
use ABlocks\Controls\Dimensions; |
| 15 |
|
| 16 |
class Block extends BlockBaseAbstract { |
| 17 |
protected $block_name = 'breadcrumb'; |
| 18 |
|
| 19 |
public function build_css( $attributes ) { |
| 20 |
$css_generator = new CssGeneratorV2( $attributes, $this->block_name ); |
| 21 |
|
| 22 |
$css_generator->add_class_styles( |
| 23 |
'{{WRAPPER}} .ablocks-breadcrumbs', |
| 24 |
$this->get_wrapper_css( $attributes ), |
| 25 |
$this->get_wrapper_css( $attributes, 'Tablet' ), |
| 26 |
$this->get_wrapper_css( $attributes, 'Mobile' ), |
| 27 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_wrapper_css( $attributes, $device ); } ) |
| 28 |
); |
| 29 |
|
| 30 |
// Normal link color |
| 31 |
$css_generator->add_class_styles( |
| 32 |
'{{WRAPPER}} div.ablocks-breadcrumbs span a', |
| 33 |
$this->get_breadcrumb_normal_title_css( $attributes ), |
| 34 |
$this->get_breadcrumb_normal_title_css( $attributes, 'Tablet' ), |
| 35 |
$this->get_breadcrumb_normal_title_css( $attributes, 'Mobile' ), |
| 36 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_breadcrumb_normal_title_css( $attributes, $device ); } ) |
| 37 |
); |
| 38 |
|
| 39 |
// Hover link color |
| 40 |
$css_generator->add_class_styles( |
| 41 |
'{{WRAPPER}} div.ablocks-breadcrumbs span a:hover', |
| 42 |
$this->get_breadcrumb_hover_title_css( $attributes ), |
| 43 |
$this->get_breadcrumb_hover_title_css( $attributes, 'Tablet' ), |
| 44 |
$this->get_breadcrumb_hover_title_css( $attributes, 'Mobile' ), |
| 45 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_breadcrumb_hover_title_css( $attributes, $device ); } ) |
| 46 |
); |
| 47 |
|
| 48 |
// Title (typography + color + direction) |
| 49 |
$css_generator->add_class_styles( |
| 50 |
'{{WRAPPER}} .ablocks-breadcrumbs__item', |
| 51 |
$this->get_breadcrumb_title_css( $attributes ), |
| 52 |
$this->get_breadcrumb_title_css( $attributes, 'Tablet' ), |
| 53 |
$this->get_breadcrumb_title_css( $attributes, 'Mobile' ), |
| 54 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_breadcrumb_title_css( $attributes, $device ); } ) |
| 55 |
); |
| 56 |
|
| 57 |
// Separator (color + font-size) |
| 58 |
$css_generator->add_class_styles( |
| 59 |
'{{WRAPPER}} .ablocks-breadcrumbs__separator', |
| 60 |
$this->get_breadcrumb_separator_css( $attributes ), |
| 61 |
$this->get_breadcrumb_separator_css( $attributes, 'Tablet' ), |
| 62 |
$this->get_breadcrumb_separator_css( $attributes, 'Mobile' ), |
| 63 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_breadcrumb_separator_css( $attributes, $device ); } ) |
| 64 |
); |
| 65 |
$css_generator->add_class_styles( |
| 66 |
'{{WRAPPER}} .ablocks-breadcrumbs___before-image , {{WRAPPER}} .ablocks-breadcrumbs__before-text', |
| 67 |
$this->get_breadcrumb_before_text_image_css( $attributes ), |
| 68 |
$this->get_breadcrumb_before_text_image_css( $attributes, 'Tablet' ), |
| 69 |
$this->get_breadcrumb_before_text_image_css( $attributes, 'Mobile' ), |
| 70 |
$css_generator->custom_device_map( function ( $device ) use ( $attributes ) { return $this->get_breadcrumb_before_text_image_css( $attributes, $device ); } ) |
| 71 |
); |
| 72 |
|
| 73 |
return $css_generator->generate_css(); |
| 74 |
|
| 75 |
} |
| 76 |
|
| 77 |
|
| 78 |
public function get_wrapper_css( $attributes, $device = '' ) { |
| 79 |
$css = []; |
| 80 |
|
| 81 |
if ( ! empty( $attributes['breadcrumbSpaceBetween'] ) ) { |
| 82 |
$css['gap'] = $attributes['breadcrumbSpaceBetween'] . 'px'; |
| 83 |
} |
| 84 |
|
| 85 |
if ( isset( $attributes['positionBreadcrumb'][ 'value' . $device ] ) ) { |
| 86 |
$css['justify-content'] = $attributes['positionBreadcrumb'][ 'value' . $device ]; |
| 87 |
} |
| 88 |
return array_merge( |
| 89 |
$css, |
| 90 |
); |
| 91 |
|
| 92 |
} |
| 93 |
|
| 94 |
public function get_breadcrumb_title_css( $attributes, $device = '' ) { |
| 95 |
$css = []; |
| 96 |
|
| 97 |
if ( ! empty( $attributes['breadcrumbTitlecolor'] ) ) { |
| 98 |
$css['color'] = Color::get_css( $attributes['breadcrumbTitlecolor'] ); |
| 99 |
} |
| 100 |
|
| 101 |
$dir = isset( $attributes['taxonomyTitleDirection'] ) ? $attributes['taxonomyTitleDirection'] : null; |
| 102 |
$dirCss = ! is_null( $dir ) ? get_alignment_css( $dir, 'justify-content', $device ) : []; |
| 103 |
if ( ! empty( $attributes['breadcrumbItemBackground'] ) ) { |
| 104 |
$css['background-color'] = Color::get_css( $attributes['breadcrumbItemBackground'] ); |
| 105 |
} |
| 106 |
$typographyValueGlobal = ! empty( $attributes['breadcrumbTitleTypographyGlobal'] ) ? $attributes['breadcrumbTitleTypographyGlobal'] : ''; |
| 107 |
return array_merge( |
| 108 |
$css, (array) $dirCss, |
| 109 |
Typography::get_css( $attributes['breadcrumbTitleTypography'] ?? [], '', $device, $typographyValueGlobal ), |
| 110 |
Dimensions::get_css( $attributes['breadcrumbItemPadding'] ?? [], 'padding', $device ), |
| 111 |
Dimensions::get_css( $attributes['BreadcrumbBorderRadius'] ?? [], 'border-radius', $device ), |
| 112 |
); |
| 113 |
} |
| 114 |
|
| 115 |
public function get_breadcrumb_normal_title_css( $attributes, $device = '' ) { |
| 116 |
$css = []; |
| 117 |
|
| 118 |
if ( ! empty( $attributes['breadcrumbLinkcolor'] ) ) { |
| 119 |
$css['color'] = Color::get_css( $attributes['breadcrumbLinkcolor'] ); |
| 120 |
} |
| 121 |
|
| 122 |
return $css; |
| 123 |
} |
| 124 |
|
| 125 |
public function get_breadcrumb_hover_title_css( $attributes, $device = '' ) { |
| 126 |
$css = []; |
| 127 |
|
| 128 |
if ( ! empty( $attributes['breadcrumbHoverLinkcolor'] ) ) { |
| 129 |
$css['color'] = Color::get_css( $attributes['breadcrumbHoverLinkcolor'] ); |
| 130 |
} |
| 131 |
|
| 132 |
return $css; |
| 133 |
} |
| 134 |
|
| 135 |
public function get_breadcrumb_separator_css( $attributes, $device = '' ) { |
| 136 |
$css = []; |
| 137 |
|
| 138 |
if ( ! empty( $attributes['breadcrumbseparatorcolor'] ) ) { |
| 139 |
$css['color'] = Color::get_css( $attributes['breadcrumbseparatorcolor'] ); |
| 140 |
} |
| 141 |
|
| 142 |
if ( ! empty( $attributes['breadcrumbseparsize'] ) ) { |
| 143 |
// IMPORTANT: CSS property is kebab-case |
| 144 |
$css['font-size'] = $attributes['breadcrumbseparsize'] . 'px'; |
| 145 |
} |
| 146 |
|
| 147 |
return $css; |
| 148 |
} |
| 149 |
public function get_breadcrumb_before_text_image_css( $attributes, $device = '' ) { |
| 150 |
$css = []; |
| 151 |
|
| 152 |
if ( ! empty( $attributes['beforeBreadcrumbBackgroundcolor'] ) ) { |
| 153 |
$css['background-color'] = Color::get_css( $attributes['beforeBreadcrumbBackgroundcolor'] ); |
| 154 |
} |
| 155 |
|
| 156 |
return array_merge( |
| 157 |
$css, |
| 158 |
Dimensions::get_css( $attributes['beforeBreadcrumbPaddingcolor'] ?? [], 'padding', $device ), |
| 159 |
Dimensions::get_css( $attributes['beforeBreadcrumbBorderRadius'] ?? [], 'border-radius', $device ), |
| 160 |
); |
| 161 |
} |
| 162 |
|
| 163 |
|
| 164 |
public function render( $attributes = [] ) { |
| 165 |
$breadcrumb_normalize = $this->normalize( $attributes ); |
| 166 |
$breadcrumb_items = $this->build_items( $breadcrumb_normalize ); |
| 167 |
if ( empty( $breadcrumb_items ) ) { |
| 168 |
return; |
| 169 |
} |
| 170 |
$breadcrumb_items = $this->limit_items( $breadcrumb_items, (int) $breadcrumb_normalize['max'] ); |
| 171 |
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped |
| 172 |
echo $this->render_html_breadcrumbs( $breadcrumb_items, $breadcrumb_normalize ); |
| 173 |
} |
| 174 |
|
| 175 |
/** |
| 176 |
* Defaults |
| 177 |
*/ |
| 178 |
private function normalize( $attributes ) { |
| 179 |
$separator = isset( $attributes['SeparatorChange'] ) && $attributes['SeparatorChange'] !== '' |
| 180 |
? (string) $attributes['SeparatorChange'] |
| 181 |
: '>'; |
| 182 |
|
| 183 |
$home_text = ( isset( $attributes['homeBreadcrumbs'] ) && $attributes['homeBreadcrumbs'] !== '' ) |
| 184 |
? (string) $attributes['homeBreadcrumbs'] |
| 185 |
: __( 'Home', 'ablocks' ); |
| 186 |
|
| 187 |
$beforeBreadcrumbImage = ( isset( $attributes['beforeBreadcrumbImage'] ) && $attributes['beforeBreadcrumbImage'] !== '' ) |
| 188 |
? (string) $attributes['beforeBreadcrumbImage'] |
| 189 |
: ''; // __( '', 'ablocks' ); |
| 190 |
|
| 191 |
$beforeBreadcrumbText = ( isset( $attributes['beforeBreadcrumbText'] ) && $attributes['beforeBreadcrumbText'] !== '' ) |
| 192 |
? (string) $attributes['beforeBreadcrumbText'] |
| 193 |
: __( 'Before Text', 'ablocks' ); |
| 194 |
|
| 195 |
$beforeBreadcrumbTextImage = ( isset( $attributes['beforeBreadcrumbTextImage'] ) && $attributes['beforeBreadcrumbTextImage'] !== '' ) |
| 196 |
? (string) $attributes['beforeBreadcrumbTextImage'] |
| 197 |
: ''; // __( '', 'ablocks' ); |
| 198 |
|
| 199 |
$beforeTextImage = ( isset( $attributes['beforeTextImage'] ) && $attributes['beforeTextImage'] !== '' ) |
| 200 |
? (string) $attributes['beforeTextImage'] |
| 201 |
: ''; // __( '', 'ablocks' ); |
| 202 |
|
| 203 |
$beforeSeparator = ( isset( $attributes['beforeSeparator'] ) && $attributes['beforeSeparator'] !== '' ) |
| 204 |
? (string) $attributes['beforeSeparator'] |
| 205 |
: ''; // __( '', 'ablocks' ); |
| 206 |
|
| 207 |
$enable_faq_schema = false; |
| 208 |
if ( isset( $attributes['enableFaqSchema'] ) ) { |
| 209 |
$parsed_enable_faq_schema = filter_var( $attributes['enableFaqSchema'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE ); |
| 210 |
$enable_faq_schema = ( null === $parsed_enable_faq_schema ) ? false : $parsed_enable_faq_schema; |
| 211 |
} |
| 212 |
|
| 213 |
return wp_parse_args( (array) $attributes, [ |
| 214 |
'separator' => $separator, |
| 215 |
'home_text' => $home_text, |
| 216 |
'before_breadcrumb_image' => $beforeBreadcrumbImage, |
| 217 |
'before_breadcrumb_text' => $beforeBreadcrumbText, |
| 218 |
'before_breadcrumb_text_image' => $beforeBreadcrumbTextImage, |
| 219 |
'before_text_image' => $beforeTextImage, |
| 220 |
'before_separator' => $beforeSeparator, |
| 221 |
'enableFaqSchema' => $enable_faq_schema, |
| 222 |
'include_current' => true, |
| 223 |
'tax' => '', |
| 224 |
'max' => 0, |
| 225 |
] ); |
| 226 |
} |
| 227 |
|
| 228 |
/** |
| 229 |
* Detect editor (post/site editor, AJAX, REST block render) |
| 230 |
*/ |
| 231 |
private function in_editor() : bool { |
| 232 |
// More precise REST check: block renderer routes |
| 233 |
if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) { |
| 234 |
// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized |
| 235 |
$uri = $_SERVER['REQUEST_URI'] ?? ''; |
| 236 |
if ( strpos( $uri, '/wp/v2/block-renderer' ) !== false |
| 237 |
|| strpos( $uri, '/wp-block-editor/v1/block-renderer' ) !== false ) { |
| 238 |
return true; |
| 239 |
} |
| 240 |
} |
| 241 |
|
| 242 |
if ( is_admin() ) { |
| 243 |
if ( function_exists( 'get_current_screen' ) ) { |
| 244 |
$scr = get_current_screen(); |
| 245 |
if ( $scr ) { |
| 246 |
if ( ! empty( $scr->is_block_editor ) ) { |
| 247 |
return true; |
| 248 |
} |
| 249 |
if ( isset( $scr->base ) && $scr->base === 'site-editor' ) { |
| 250 |
return true; |
| 251 |
} |
| 252 |
} |
| 253 |
} |
| 254 |
if ( function_exists( 'wp_doing_ajax' ) && wp_doing_ajax() ) { |
| 255 |
return true; |
| 256 |
} |
| 257 |
} |
| 258 |
return false; |
| 259 |
} |
| 260 |
|
| 261 |
/** |
| 262 |
* Build breadcrumb items (editor-aware) |
| 263 |
* Each: ['label' => string, 'url' => string|false] |
| 264 |
*/ |
| 265 |
private function build_items( array $breadcrumb_normalize ) { |
| 266 |
if ( $this->in_editor() ) { |
| 267 |
return $this->build_items_editor( $breadcrumb_normalize ); |
| 268 |
} |
| 269 |
$breadcrumb_items = []; |
| 270 |
|
| 271 |
// Front page |
| 272 |
if ( is_front_page() ) { |
| 273 |
$this->add_item( $breadcrumb_items, $breadcrumb_normalize['home_text'] ); |
| 274 |
return $breadcrumb_items; |
| 275 |
} |
| 276 |
|
| 277 |
// Home |
| 278 |
$this->add_item( $breadcrumb_items, $breadcrumb_normalize['home_text'], home_url( '/' ) ); |
| 279 |
|
| 280 |
// Posts page (static front) |
| 281 |
if ( is_home() && ! is_front_page() ) { |
| 282 |
$pid = (int) get_option( 'page_for_posts' ); |
| 283 |
$this->add_item( $breadcrumb_items, $pid ? get_the_title( $pid ) : __( 'Blog', 'ablocks' ) ); |
| 284 |
return $breadcrumb_items; |
| 285 |
} |
| 286 |
|
| 287 |
// Singular |
| 288 |
if ( is_singular() ) { |
| 289 |
global $post; |
| 290 |
|
| 291 |
if ( ! $post ) { |
| 292 |
if ( ! empty( $breadcrumb_normalize['include_current'] ) ) { |
| 293 |
$this->add_item( $breadcrumb_items, $this->current_title_safe() ); |
| 294 |
} |
| 295 |
return $breadcrumb_items; |
| 296 |
} |
| 297 |
|
| 298 |
$breadcrumb_pt = get_post_type( $post ); |
| 299 |
$breadcrumb_pto = $breadcrumb_pt ? get_post_type_object( $breadcrumb_pt ) : null; |
| 300 |
|
| 301 |
// WooCommerce: prepend Shop for product |
| 302 |
$is_wc_product = ( 'product' === $breadcrumb_pt ) && function_exists( 'wc_get_page_id' ) && is_singular( 'product' ); |
| 303 |
if ( $is_wc_product ) { |
| 304 |
$shop_id = wc_get_page_id( 'shop' ); |
| 305 |
if ( $shop_id && 'publish' === get_post_status( $shop_id ) ) { |
| 306 |
$this->add_item( $breadcrumb_items, get_the_title( $shop_id ), get_permalink( $shop_id ) ); |
| 307 |
} |
| 308 |
} |
| 309 |
|
| 310 |
// Post type label/archive (avoid for product since Shop already added) |
| 311 |
if ( ! $is_wc_product ) { |
| 312 |
$this->add_post_type_item( $breadcrumb_items, $breadcrumb_pt, $breadcrumb_pto, [ 'post', 'page' ] ); |
| 313 |
} |
| 314 |
|
| 315 |
// Hierarchical (page / hierarchical CPT) |
| 316 |
if ( is_page() || ( $breadcrumb_pto && is_post_type_hierarchical( $breadcrumb_pt ) ) ) { |
| 317 |
$this->add_post_ancestors( $breadcrumb_items, $post ); |
| 318 |
|
| 319 |
// Also include taxonomy trail (categories/tags) on single pages if available. |
| 320 |
$this->append_taxonomy_trail( $breadcrumb_items, $post->ID, $breadcrumb_pt, $breadcrumb_normalize['tax'] ); |
| 321 |
} else { |
| 322 |
// Non-hierarchical: taxonomy trail (if any). |
| 323 |
$this->append_taxonomy_trail( $breadcrumb_items, $post->ID, $breadcrumb_pt, $breadcrumb_normalize['tax'] ); |
| 324 |
}//end if |
| 325 |
|
| 326 |
if ( ! empty( $breadcrumb_normalize['include_current'] ) ) { |
| 327 |
$this->add_item( $breadcrumb_items, $this->current_title_safe( $post ) ); |
| 328 |
} |
| 329 |
return $breadcrumb_items; |
| 330 |
}//end if |
| 331 |
|
| 332 |
// Tax archives |
| 333 |
if ( is_category() || is_tag() || is_tax() ) { |
| 334 |
$term = get_queried_object(); |
| 335 |
return ( $term && ! is_wp_error( $term ) ) |
| 336 |
? $this->build_taxonomy_archive_items( $breadcrumb_items, $term ) |
| 337 |
: $breadcrumb_items; |
| 338 |
}//end if |
| 339 |
|
| 340 |
// Post type archive |
| 341 |
if ( is_post_type_archive() ) { |
| 342 |
$breadcrumb_pt = get_query_var( 'post_type' ); |
| 343 |
if ( is_array( $breadcrumb_pt ) ) { |
| 344 |
$breadcrumb_pt = reset( $breadcrumb_pt ); } |
| 345 |
$po = $breadcrumb_pt ? get_post_type_object( $breadcrumb_pt ) : null; |
| 346 |
if ( $po ) { |
| 347 |
$this->add_item( $breadcrumb_items, $po->labels->name ); |
| 348 |
return $breadcrumb_items; |
| 349 |
} |
| 350 |
} |
| 351 |
|
| 352 |
// Author |
| 353 |
if ( is_author() ) { |
| 354 |
$breadcrumb_u = get_queried_object(); |
| 355 |
if ( $breadcrumb_u ) { |
| 356 |
$this->add_item( $breadcrumb_items, sprintf( __( 'Author: %s', 'ablocks' ), $breadcrumb_u->display_name ) ); |
| 357 |
return $breadcrumb_items; |
| 358 |
} |
| 359 |
} |
| 360 |
|
| 361 |
// Date |
| 362 |
if ( is_year() || is_month() || is_day() ) { |
| 363 |
$this->add_item( $breadcrumb_items, get_the_date( is_year() ? 'Y' : ( is_month() ? 'F Y' : 'F j, Y' ) ) ); |
| 364 |
return $breadcrumb_items; |
| 365 |
} |
| 366 |
|
| 367 |
// Search |
| 368 |
if ( is_search() ) { |
| 369 |
$this->add_item( $breadcrumb_items, sprintf( __( 'Search: %s', 'ablocks' ), get_search_query() ) ); |
| 370 |
return $breadcrumb_items; |
| 371 |
} |
| 372 |
|
| 373 |
// 404 |
| 374 |
if ( is_404() ) { |
| 375 |
$this->add_item( $breadcrumb_items, __( '404 Not Found', 'ablocks' ) ); |
| 376 |
return $breadcrumb_items; |
| 377 |
} |
| 378 |
|
| 379 |
return $breadcrumb_items; |
| 380 |
} |
| 381 |
|
| 382 |
/** |
| 383 |
* Editor builder (mirrors frontend; robust current title) |
| 384 |
*/ |
| 385 |
private function build_items_editor( array $breadcrumb_normalize ) : array { |
| 386 |
$breadcrumb_items = []; |
| 387 |
$home_label = (string) $breadcrumb_normalize['home_text']; // attributes → fallback "Home" |
| 388 |
$this->add_item( $breadcrumb_items, $home_label, home_url( '/' ) ); |
| 389 |
|
| 390 |
global $post; |
| 391 |
if ( $post instanceof \WP_Post ) { |
| 392 |
$breadcrumb_pt = get_post_type( $post ); |
| 393 |
$breadcrumb_pto = $breadcrumb_pt ? get_post_type_object( $breadcrumb_pt ) : null; |
| 394 |
|
| 395 |
if ( is_post_type_hierarchical( $breadcrumb_pt ) ) { |
| 396 |
$this->add_post_ancestors( $breadcrumb_items, $post ); |
| 397 |
|
| 398 |
// Also include taxonomy trail (categories/tags) on single pages if available. |
| 399 |
$this->append_taxonomy_trail( $breadcrumb_items, $post->ID, $breadcrumb_pt, $breadcrumb_normalize['tax'] ); |
| 400 |
} else { |
| 401 |
$this->add_post_type_item( $breadcrumb_items, $breadcrumb_pt, $breadcrumb_pto, [ 'post', 'page' ] ); |
| 402 |
$this->append_taxonomy_trail( $breadcrumb_items, $post->ID, $breadcrumb_pt, $breadcrumb_normalize['tax'] ); |
| 403 |
}//end if |
| 404 |
|
| 405 |
if ( ! empty( $breadcrumb_normalize['include_current'] ) ) { |
| 406 |
$this->add_item( $breadcrumb_items, $this->current_title_safe( $post ) ); |
| 407 |
} |
| 408 |
return $breadcrumb_items; |
| 409 |
}//end if |
| 410 |
|
| 411 |
// No $post in editor (e.g., site editor template) → sample trail |
| 412 |
$this->add_item( $breadcrumb_items, __( 'Template', 'ablocks' ), home_url( '/Template/' ) ); |
| 413 |
if ( ! empty( $breadcrumb_normalize['include_current'] ) ) { |
| 414 |
$this->add_item( $breadcrumb_items, __( 'Currents Page', 'ablocks' ) ); |
| 415 |
} |
| 416 |
return $breadcrumb_items; |
| 417 |
} |
| 418 |
|
| 419 |
/** |
| 420 |
* Safe current title (fallbacks when get_the_title() empty in editor) |
| 421 |
*/ |
| 422 |
private function current_title_safe( $p = null ) : string { |
| 423 |
if ( $p instanceof \WP_Post ) { |
| 424 |
$breadcrumb_t = get_the_title( $p ); |
| 425 |
if ( $breadcrumb_t === '' ) { |
| 426 |
$breadcrumb_t = $p->post_title; |
| 427 |
} |
| 428 |
if ( $breadcrumb_t === '' ) { |
| 429 |
$breadcrumb_t = __( '(no title)', 'ablocks' ); |
| 430 |
} |
| 431 |
return $breadcrumb_t; |
| 432 |
} |
| 433 |
$breadcrumb_t = single_post_title( '', false ); |
| 434 |
if ( $breadcrumb_t === '' ) { |
| 435 |
$breadcrumb_t = __( '(no title)', 'ablocks' ); |
| 436 |
} |
| 437 |
return $breadcrumb_t; |
| 438 |
} |
| 439 |
|
| 440 |
/** |
| 441 |
* Add a breadcrumb item. |
| 442 |
*/ |
| 443 |
private function add_item( array &$breadcrumb_items, $label, $url = false ) : void { |
| 444 |
$breadcrumb_items[] = [ |
| 445 |
'label' => (string) $label, |
| 446 |
'url' => $url |
| 447 |
]; |
| 448 |
} |
| 449 |
|
| 450 |
/** |
| 451 |
* Add a term breadcrumb item (linked). |
| 452 |
*/ |
| 453 |
private function add_term_item( array &$breadcrumb_items, $term ) : void { |
| 454 |
if ( ! $term || is_wp_error( $term ) ) { |
| 455 |
return; |
| 456 |
} |
| 457 |
$link = get_term_link( $term ); |
| 458 |
$this->add_item( $breadcrumb_items, $term->name, is_wp_error( $link ) ? false : $link ); |
| 459 |
} |
| 460 |
|
| 461 |
/** |
| 462 |
* Add post ancestors (linked). |
| 463 |
*/ |
| 464 |
private function add_post_ancestors( array &$breadcrumb_items, $post ) : void { |
| 465 |
foreach ( array_reverse( get_post_ancestors( $post ) ) as $aid ) { |
| 466 |
if ( (int) $aid === (int) get_option( 'page_on_front' ) ) { |
| 467 |
continue; |
| 468 |
} |
| 469 |
$this->add_item( $breadcrumb_items, get_the_title( $aid ), get_permalink( $aid ) ); |
| 470 |
} |
| 471 |
} |
| 472 |
|
| 473 |
/** |
| 474 |
* Add a post type item. |
| 475 |
*/ |
| 476 |
private function add_post_type_item( array &$breadcrumb_items, $post_type, $post_type_obj = null, array $skip_types = [] ) : bool { |
| 477 |
if ( $post_type && in_array( $post_type, $skip_types, true ) ) { |
| 478 |
return false; |
| 479 |
} |
| 480 |
$breadcrumb_pto = $post_type_obj ?: ( $post_type ? get_post_type_object( $post_type ) : null ); |
| 481 |
if ( ! $breadcrumb_pto ) { |
| 482 |
return false; |
| 483 |
} |
| 484 |
$url = ! empty( $breadcrumb_pto->has_archive ) ? get_post_type_archive_link( $post_type ) : false; |
| 485 |
$this->add_item( $breadcrumb_items, $breadcrumb_pto->labels->name, $url ); |
| 486 |
return true; |
| 487 |
} |
| 488 |
|
| 489 |
/** |
| 490 |
* Add term ancestors (linked). |
| 491 |
*/ |
| 492 |
private function add_term_ancestors( array &$breadcrumb_items, $term ) : void { |
| 493 |
foreach ( array_reverse( get_ancestors( $term->term_id, $term->taxonomy, 'taxonomy' ) ) as $id ) { |
| 494 |
$this->add_term_item( $breadcrumb_items, get_term( $id, $term->taxonomy ) ); |
| 495 |
} |
| 496 |
} |
| 497 |
|
| 498 |
/** |
| 499 |
* Append taxonomy trail (category + tag when available) to breadcrumb items. |
| 500 |
* Returns true if any taxonomy items were appended. |
| 501 |
*/ |
| 502 |
private function append_taxonomy_trail( array &$breadcrumb_items, int $post_id, string $post_type, string $preferred_tax = '' ) : bool { |
| 503 |
$breadcrumb_tax = $this->preferred_tax( $post_type, $preferred_tax ); |
| 504 |
if ( ! $breadcrumb_tax ) { |
| 505 |
return false; |
| 506 |
} |
| 507 |
|
| 508 |
$secondary = ( $preferred_tax === '' ) ? $this->secondary_tax( $post_type, $breadcrumb_tax ) : ''; |
| 509 |
$taxes = array_filter( array_unique( [ $breadcrumb_tax, $secondary ] ) ); |
| 510 |
$seen_terms = []; |
| 511 |
foreach ( $taxes as $taxonomy ) { |
| 512 |
$primary = $this->primary_term( $post_id, $taxonomy ); |
| 513 |
if ( ! $primary ) { |
| 514 |
continue; |
| 515 |
} |
| 516 |
|
| 517 |
foreach ( array_reverse( get_ancestors( $primary->term_id, $primary->taxonomy, 'taxonomy' ) ) as $id ) { |
| 518 |
$breadcrumb_t = get_term( $id, $primary->taxonomy ); |
| 519 |
$key = $breadcrumb_t ? $breadcrumb_t->taxonomy . ':' . $breadcrumb_t->term_id : ''; |
| 520 |
if ( ! $breadcrumb_t || is_wp_error( $breadcrumb_t ) || isset( $seen_terms[ $key ] ) ) { |
| 521 |
continue; |
| 522 |
} |
| 523 |
$seen_terms[ $key ] = true; |
| 524 |
$this->add_term_item( $breadcrumb_items, $breadcrumb_t ); |
| 525 |
} |
| 526 |
$key = $primary->taxonomy . ':' . $primary->term_id; |
| 527 |
if ( ! isset( $seen_terms[ $key ] ) ) { |
| 528 |
$seen_terms[ $key ] = true; |
| 529 |
$this->add_term_item( $breadcrumb_items, $primary ); |
| 530 |
} |
| 531 |
}//end foreach |
| 532 |
return ! empty( $seen_terms ); |
| 533 |
} |
| 534 |
|
| 535 |
/** |
| 536 |
* Preferred taxonomy |
| 537 |
*/ |
| 538 |
private function preferred_tax( $post_type, $preferred = '' ) { |
| 539 |
if ( $preferred && taxonomy_exists( $preferred ) ) { |
| 540 |
return $preferred; |
| 541 |
} |
| 542 |
$taxes = get_object_taxonomies( $post_type, 'objects' ); |
| 543 |
foreach ( $taxes as $breadcrumb_t ) { |
| 544 |
if ( $breadcrumb_t->public && $breadcrumb_t->hierarchical ) { |
| 545 |
return $breadcrumb_t->name; |
| 546 |
} |
| 547 |
} |
| 548 |
foreach ( $taxes as $breadcrumb_t ) { |
| 549 |
if ( $breadcrumb_t->public ) { |
| 550 |
return $breadcrumb_t->name; |
| 551 |
} |
| 552 |
} |
| 553 |
return false; |
| 554 |
} |
| 555 |
|
| 556 |
/** |
| 557 |
* Secondary taxonomy (first public non-hierarchical) when primary is hierarchical. |
| 558 |
*/ |
| 559 |
private function secondary_tax( $post_type, $primary_tax = '' ) { |
| 560 |
$primary = $primary_tax ? get_taxonomy( $primary_tax ) : null; |
| 561 |
if ( $primary && empty( $primary->hierarchical ) ) { |
| 562 |
return false; |
| 563 |
} |
| 564 |
|
| 565 |
foreach ( get_object_taxonomies( $post_type, 'objects' ) as $breadcrumb_t ) { |
| 566 |
if ( $breadcrumb_t->public && ! $breadcrumb_t->hierarchical && $breadcrumb_t->name !== $primary_tax ) { |
| 567 |
return $breadcrumb_t->name; |
| 568 |
} |
| 569 |
} |
| 570 |
return false; |
| 571 |
} |
| 572 |
|
| 573 |
/** |
| 574 |
* Get a representative post type for a taxonomy. |
| 575 |
*/ |
| 576 |
private function taxonomy_post_type( $taxonomy ) { |
| 577 |
$tax = $taxonomy ? get_taxonomy( $taxonomy ) : null; |
| 578 |
if ( ! $tax || empty( $tax->object_type ) ) { |
| 579 |
return false; |
| 580 |
} |
| 581 |
$object_types = (array) $tax->object_type; |
| 582 |
if ( in_array( 'listing', $object_types, true ) ) { |
| 583 |
return 'listing'; |
| 584 |
} |
| 585 |
return reset( $object_types ); |
| 586 |
} |
| 587 |
|
| 588 |
/** |
| 589 |
* Build taxonomy archive items: Post Type > Term ancestors > Term (linked). |
| 590 |
*/ |
| 591 |
private function build_taxonomy_archive_items( array $breadcrumb_items, $term ) : array { |
| 592 |
$breadcrumb_pt = $this->taxonomy_post_type( $term->taxonomy ); |
| 593 |
$breadcrumb_pto = $breadcrumb_pt ? get_post_type_object( $breadcrumb_pt ) : null; |
| 594 |
$this->add_post_type_item( $breadcrumb_items, $breadcrumb_pt, $breadcrumb_pto ); |
| 595 |
|
| 596 |
$this->add_term_ancestors( $breadcrumb_items, $term ); |
| 597 |
$this->add_term_item( $breadcrumb_items, $term ); |
| 598 |
|
| 599 |
return $breadcrumb_items; |
| 600 |
} |
| 601 |
|
| 602 |
/** |
| 603 |
* Primary term (Yoast) or first term |
| 604 |
*/ |
| 605 |
private function primary_term( $post_id, $taxonomy ) { |
| 606 |
if ( class_exists( 'WPSEO_Primary_Term' ) ) { |
| 607 |
$yoast = new \WPSEO_Primary_Term( $taxonomy, $post_id ); |
| 608 |
$id = (int) $yoast->get_primary_term(); |
| 609 |
if ( $id ) { |
| 610 |
$breadcrumb_t = get_term( $id, $taxonomy ); |
| 611 |
if ( $breadcrumb_t && ! is_wp_error( $breadcrumb_t ) ) { |
| 612 |
return $breadcrumb_t; |
| 613 |
} |
| 614 |
} |
| 615 |
} |
| 616 |
$terms = get_the_terms( $post_id, $taxonomy ); |
| 617 |
return ( $terms && ! is_wp_error( $terms ) ) ? array_shift( $terms ) : null; |
| 618 |
} |
| 619 |
|
| 620 |
/** |
| 621 |
* Tail limit |
| 622 |
*/ |
| 623 |
private function limit_items( array $breadcrumb_items, int $max ) { |
| 624 |
if ( $max > 0 && count( $breadcrumb_items ) > $max ) { |
| 625 |
return array_slice( $breadcrumb_items, - $max ); |
| 626 |
} |
| 627 |
return $breadcrumb_items; |
| 628 |
} |
| 629 |
|
| 630 |
/** |
| 631 |
* Best-effort current request URL for schema item fallback. |
| 632 |
*/ |
| 633 |
private function current_request_url() : string { |
| 634 |
if ( ! empty( $_SERVER['REQUEST_URI'] ) ) { |
| 635 |
$request_uri = wp_unslash( $_SERVER['REQUEST_URI'] ); |
| 636 |
$request_uri = esc_url_raw( $request_uri ); |
| 637 |
|
| 638 |
return home_url( $request_uri ); |
| 639 |
} |
| 640 |
|
| 641 |
$permalink = get_permalink(); |
| 642 |
if ( ! empty( $permalink ) ) { |
| 643 |
return $permalink; |
| 644 |
} |
| 645 |
|
| 646 |
return home_url( '/' ); |
| 647 |
} |
| 648 |
|
| 649 |
/** |
| 650 |
* Breadcrumbs-style HTML (matches Breadcrumbs classes; includes microdata) |
| 651 |
*/ |
| 652 |
private function render_html_breadcrumbs( array $breadcrumb_items, array $breadcrumb_normalize ) { |
| 653 |
$enable_schema = ! empty( $breadcrumb_normalize['enableFaqSchema'] ); |
| 654 |
ob_start(); |
| 655 |
?> |
| 656 |
<div aria-label="<?php esc_attr_e( 'breadcrumb', 'ablocks' ); ?>" |
| 657 |
class="ablocks-breadcrumbs" |
| 658 |
role="navigation" |
| 659 |
<?php if ( $enable_schema ) : ?> |
| 660 |
itemscope |
| 661 |
itemtype="https://schema.org/BreadcrumbList" |
| 662 |
<?php endif; ?>> |
| 663 |
|
| 664 |
<?php |
| 665 |
|
| 666 |
if ( $breadcrumb_normalize['beforeTextImage'] == 'true' ) : ?> |
| 667 |
<?php if ( $breadcrumb_normalize['beforeBreadcrumbTextImage'] == 'text' ) : ?> |
| 668 |
<span class="ablocks-breadcrumbs__before-text ablocks-breadcrumbs__item"> |
| 669 |
<?php echo esc_html( $breadcrumb_normalize['beforeBreadcrumbText'] ); ?> |
| 670 |
</span> |
| 671 |
<?php if ( $breadcrumb_normalize['beforeSeparator'] == 'true' ) : ?> |
| 672 |
<span class="ablocks-breadcrumbs__separator"><?php echo esc_html( $breadcrumb_normalize['separator'] ); ?></span> |
| 673 |
<?php endif; ?> |
| 674 |
<?php elseif ( $breadcrumb_normalize['beforeBreadcrumbTextImage'] == 'image' ) : ?> |
| 675 |
<span class="ablocks-breadcrumbs___before-image"><img src="<?php echo esc_url( $breadcrumb_normalize['before_breadcrumb_image'] ); ?>" alt=""> |
| 676 |
</span> |
| 677 |
<?php if ( $breadcrumb_normalize['beforeSeparator'] == 'true' ) : ?> |
| 678 |
<span class="ablocks-breadcrumbs__separator"><?php echo esc_html( $breadcrumb_normalize['separator'] ); ?></span> |
| 679 |
<?php endif; ?> |
| 680 |
<?php endif; ?> |
| 681 |
<?php endif; ?> |
| 682 |
|
| 683 |
<?php foreach ( $breadcrumb_items as $i => $breadcrumb_it ) : ?> |
| 684 |
<span class="ablocks-breadcrumbs__item" |
| 685 |
<?php if ( $enable_schema ) : ?> |
| 686 |
itemprop="itemListElement" |
| 687 |
itemscope |
| 688 |
itemtype="https://schema.org/ListItem" |
| 689 |
<?php endif; ?>> |
| 690 |
|
| 691 |
<?php if ( ! empty( $breadcrumb_it['url'] ) ) : ?> |
| 692 |
<a <?php if ( $enable_schema ) : ?>itemprop="item"<?php endif; ?> href="<?php echo esc_url( $breadcrumb_it['url'] ); ?>"> |
| 693 |
<span <?php if ( $enable_schema ) : ?>itemprop="name"<?php endif; ?>><?php echo esc_html( $breadcrumb_it['label'] ); ?></span> |
| 694 |
</a> |
| 695 |
<?php else : ?> |
| 696 |
<span class="ablocks-breadcrumbs__item-current" <?php if ( $enable_schema ) : ?>itemprop="name"<?php endif; ?>><?php echo esc_html( $breadcrumb_it['label'] ); ?></span> |
| 697 |
<?php $current_item_url = $this->current_request_url(); ?> |
| 698 |
<?php if ( $enable_schema && ! empty( $current_item_url ) ) : ?> |
| 699 |
<meta itemprop="item" content="<?php echo esc_url( $current_item_url ); ?>" /> |
| 700 |
<?php endif; ?> |
| 701 |
<?php endif; ?> |
| 702 |
<?php if ( $enable_schema ) : ?> |
| 703 |
<meta itemprop="position" content="<?php echo (int) ( $i + 1 ); ?>" /> |
| 704 |
<?php endif; ?> |
| 705 |
</span> |
| 706 |
<?php if ( $i < count( $breadcrumb_items ) - 1 ) : ?> |
| 707 |
<span class="ablocks-breadcrumbs__separator"><?php echo esc_html( $breadcrumb_normalize['separator'] ); ?></span> |
| 708 |
<?php endif; ?> |
| 709 |
<?php endforeach; ?> |
| 710 |
</div> |
| 711 |
<?php |
| 712 |
return trim( ob_get_clean() ); |
| 713 |
} |
| 714 |
|
| 715 |
|
| 716 |
/** |
| 717 |
* Block → PHP SSR entry (use in render_callback) |
| 718 |
*/ |
| 719 |
public function render_block_content( $attributes, $content = '', $block_instance = null ) { |
| 720 |
$breadcrumb_normalize = $this->normalize( $attributes ); |
| 721 |
|
| 722 |
// --- Ensure correct $post in editor/preview (REST) --- |
| 723 |
$restore_post = null; |
| 724 |
|
| 725 |
if ( $block_instance && ! empty( $block_instance->context['postId'] ) ) { |
| 726 |
$maybe = get_post( (int) $block_instance->context['postId'] ); |
| 727 |
|
| 728 |
if ( $maybe instanceof \WP_Post ) { |
| 729 |
global $post; |
| 730 |
$restore_post = $post ?? null; |
| 731 |
$post = $maybe; |
| 732 |
setup_postdata( $post ); |
| 733 |
} |
| 734 |
} |
| 735 |
|
| 736 |
$breadcrumb_items = $this->build_items( $breadcrumb_normalize ); |
| 737 |
|
| 738 |
if ( $restore_post !== null ) { |
| 739 |
wp_reset_postdata(); |
| 740 |
global $post; |
| 741 |
$post = $restore_post; |
| 742 |
} |
| 743 |
|
| 744 |
if ( empty( $breadcrumb_items ) ) { |
| 745 |
return ''; |
| 746 |
} |
| 747 |
$breadcrumb_items = $this->limit_items( $breadcrumb_items, (int) $breadcrumb_normalize['max'] ); |
| 748 |
|
| 749 |
return $this->render_html_breadcrumbs( $breadcrumb_items, $breadcrumb_normalize ); |
| 750 |
} |
| 751 |
|
| 752 |
|
| 753 |
} |
| 754 |
|
