<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Term Data source for Block Bindings.

[2] Fix | Delete

*

[3] Fix | Delete

* @since 6.9.0

[4] Fix | Delete

* @package WordPress

[5] Fix | Delete

* @subpackage Block Bindings

[6] Fix | Delete

*/

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* Gets value for Term Data source.

[10] Fix | Delete

*

[11] Fix | Delete

* @since 6.9.0

[12] Fix | Delete

* @access private

[13] Fix | Delete

*

[14] Fix | Delete

* @param array $source_args Array containing source arguments used to look up the override value.

[15] Fix | Delete

* Example: array( "field" => "name" ).

[16] Fix | Delete

* @param WP_Block $block_instance The block instance.

[17] Fix | Delete

* @return mixed The value computed for the source.

[18] Fix | Delete

*/

[19] Fix | Delete

function _block_bindings_term_data_get_value( array $source_args, $block_instance ) {

[20] Fix | Delete

if ( empty( $source_args['field'] ) ) {

[21] Fix | Delete

return null;

[22] Fix | Delete

}

[23] Fix | Delete

[24] Fix | Delete

/*

[25] Fix | Delete

* BACKWARDS COMPATIBILITY: Hardcoded exception for navigation blocks.

[26] Fix | Delete

* Required for WordPress 6.9+ navigation blocks. DO NOT REMOVE.

[27] Fix | Delete

*/

[28] Fix | Delete

$block_name = $block_instance->name ?? '';

[29] Fix | Delete

$is_navigation_block = in_array(

[30] Fix | Delete

$block_name,

[31] Fix | Delete

array( 'core/navigation-link', 'core/navigation-submenu' ),

[32] Fix | Delete

true

[33] Fix | Delete

);

[34] Fix | Delete

[35] Fix | Delete

if ( $is_navigation_block ) {

[36] Fix | Delete

// Navigation blocks: read from block attributes.

[37] Fix | Delete

$term_id = $block_instance->attributes['id'] ?? null;

[38] Fix | Delete

$type = $block_instance->attributes['type'] ?? '';

[39] Fix | Delete

// Map UI shorthand to taxonomy slug when using attributes.

[40] Fix | Delete

$taxonomy = ( 'tag' === $type ) ? 'post_tag' : $type;

[41] Fix | Delete

} else {

[42] Fix | Delete

// All other blocks: use context

[43] Fix | Delete

$term_id = $block_instance->context['termId'] ?? null;

[44] Fix | Delete

$taxonomy = $block_instance->context['taxonomy'] ?? '';

[45] Fix | Delete

}

[46] Fix | Delete

[47] Fix | Delete

// If we don't have required identifiers, bail early.

[48] Fix | Delete

if ( empty( $term_id ) || empty( $taxonomy ) ) {

[49] Fix | Delete

return null;

[50] Fix | Delete

}

[51] Fix | Delete

[52] Fix | Delete

// Get the term data.

[53] Fix | Delete

$term = get_term( $term_id, $taxonomy );

[54] Fix | Delete

if ( is_wp_error( $term ) || ! $term ) {

[55] Fix | Delete

return null;

[56] Fix | Delete

}

[57] Fix | Delete

[58] Fix | Delete

// Check if taxonomy exists and is publicly queryable.

[59] Fix | Delete

$taxonomy_object = get_taxonomy( $taxonomy );

[60] Fix | Delete

if ( ! $taxonomy_object || ! $taxonomy_object->publicly_queryable ) {

[61] Fix | Delete

if ( ! current_user_can( 'read' ) ) {

[62] Fix | Delete

return null;

[63] Fix | Delete

}

[64] Fix | Delete

}

[65] Fix | Delete

[66] Fix | Delete

switch ( $source_args['field'] ) {

[67] Fix | Delete

case 'id':

[68] Fix | Delete

return esc_html( (string) $term_id );

[69] Fix | Delete

[70] Fix | Delete

case 'name':

[71] Fix | Delete

return esc_html( $term->name );

[72] Fix | Delete

[73] Fix | Delete

case 'link':

[74] Fix | Delete

// Only taxonomy entities are supported by Term Data.

[75] Fix | Delete

$term_link = get_term_link( $term );

[76] Fix | Delete

return is_wp_error( $term_link ) ? null : esc_url( $term_link );

[77] Fix | Delete

[78] Fix | Delete

case 'slug':

[79] Fix | Delete

return esc_html( $term->slug );

[80] Fix | Delete

[81] Fix | Delete

case 'description':

[82] Fix | Delete

return wp_kses_post( $term->description );

[83] Fix | Delete

[84] Fix | Delete

case 'parent':

[85] Fix | Delete

return esc_html( (string) $term->parent );

[86] Fix | Delete

[87] Fix | Delete

case 'count':

[88] Fix | Delete

return esc_html( (string) $term->count );

[89] Fix | Delete

[90] Fix | Delete

default:

[91] Fix | Delete

return null;

[92] Fix | Delete

}

[93] Fix | Delete

}

[94] Fix | Delete

[95] Fix | Delete

/**

[96] Fix | Delete

* Registers Term Data source in the block bindings registry.

[97] Fix | Delete

*

[98] Fix | Delete

* @since 6.9.0

[99] Fix | Delete

* @access private

[100] Fix | Delete

*/

[101] Fix | Delete

function _register_block_bindings_term_data_source() {

[102] Fix | Delete

if ( get_block_bindings_source( 'core/term-data' ) ) {

[103] Fix | Delete

// The source is already registered.

[104] Fix | Delete

return;

[105] Fix | Delete

}

[106] Fix | Delete

[107] Fix | Delete

register_block_bindings_source(

[108] Fix | Delete

'core/term-data',

[109] Fix | Delete

array(

[110] Fix | Delete

'label' => _x( 'Term Data', 'block bindings source' ),

[111] Fix | Delete

'get_value_callback' => '_block_bindings_term_data_get_value',

[112] Fix | Delete

'uses_context' => array( 'termId', 'taxonomy' ),

[113] Fix | Delete

)

[114] Fix | Delete

);

[115] Fix | Delete

}

[116] Fix | Delete

[117] Fix | Delete

add_action( 'init', '_register_block_bindings_term_data_source' );

[118] Fix | Delete

[119] Fix | Delete