120 lines
3.1 KiB
PHP
120 lines
3.1 KiB
PHP
<?php
|
|
/**
|
|
* Term Data source for Block Bindings.
|
|
*
|
|
* @since 6.9.0
|
|
* @package WordPress
|
|
* @subpackage Block Bindings
|
|
*/
|
|
|
|
/**
|
|
* Gets value for Term Data source.
|
|
*
|
|
* @since 6.9.0
|
|
* @access private
|
|
*
|
|
* @param array $source_args Array containing source arguments used to look up the override value.
|
|
* Example: array( "field" => "name" ).
|
|
* @param WP_Block $block_instance The block instance.
|
|
* @return mixed The value computed for the source.
|
|
*/
|
|
function _block_bindings_term_data_get_value( array $source_args, $block_instance ) {
|
|
if ( empty( $source_args['field'] ) ) {
|
|
return null;
|
|
}
|
|
|
|
/*
|
|
* BACKWARDS COMPATIBILITY: Hardcoded exception for navigation blocks.
|
|
* Required for WordPress 6.9+ navigation blocks. DO NOT REMOVE.
|
|
*/
|
|
$block_name = $block_instance->name ?? '';
|
|
$is_navigation_block = in_array(
|
|
$block_name,
|
|
array( 'core/navigation-link', 'core/navigation-submenu' ),
|
|
true
|
|
);
|
|
|
|
if ( $is_navigation_block ) {
|
|
// Navigation blocks: read from block attributes.
|
|
$term_id = $block_instance->attributes['id'] ?? null;
|
|
$type = $block_instance->attributes['type'] ?? '';
|
|
// Map UI shorthand to taxonomy slug when using attributes.
|
|
$taxonomy = ( 'tag' === $type ) ? 'post_tag' : $type;
|
|
} else {
|
|
// All other blocks: use context
|
|
$term_id = $block_instance->context['termId'] ?? null;
|
|
$taxonomy = $block_instance->context['taxonomy'] ?? '';
|
|
}
|
|
|
|
// If we don't have required identifiers, bail early.
|
|
if ( empty( $term_id ) || empty( $taxonomy ) ) {
|
|
return null;
|
|
}
|
|
|
|
// Get the term data.
|
|
$term = get_term( $term_id, $taxonomy );
|
|
if ( is_wp_error( $term ) || ! $term ) {
|
|
return null;
|
|
}
|
|
|
|
// Check if taxonomy exists and is publicly queryable.
|
|
$taxonomy_object = get_taxonomy( $taxonomy );
|
|
if ( ! $taxonomy_object || ! $taxonomy_object->publicly_queryable ) {
|
|
if ( ! current_user_can( 'read' ) ) {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
switch ( $source_args['field'] ) {
|
|
case 'id':
|
|
return esc_html( (string) $term_id );
|
|
|
|
case 'name':
|
|
return esc_html( $term->name );
|
|
|
|
case 'link':
|
|
// Only taxonomy entities are supported by Term Data.
|
|
$term_link = get_term_link( $term );
|
|
return is_wp_error( $term_link ) ? null : esc_url( $term_link );
|
|
|
|
case 'slug':
|
|
return esc_html( $term->slug );
|
|
|
|
case 'description':
|
|
return wp_kses_post( $term->description );
|
|
|
|
case 'parent':
|
|
return esc_html( (string) $term->parent );
|
|
|
|
case 'count':
|
|
return esc_html( (string) $term->count );
|
|
|
|
default:
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Registers Term Data source in the block bindings registry.
|
|
*
|
|
* @since 6.9.0
|
|
* @access private
|
|
*/
|
|
function _register_block_bindings_term_data_source() {
|
|
if ( get_block_bindings_source( 'core/term-data' ) ) {
|
|
// The source is already registered.
|
|
return;
|
|
}
|
|
|
|
register_block_bindings_source(
|
|
'core/term-data',
|
|
array(
|
|
'label' => _x( 'Term Data', 'block bindings source' ),
|
|
'get_value_callback' => '_block_bindings_term_data_get_value',
|
|
'uses_context' => array( 'termId', 'taxonomy' ),
|
|
)
|
|
);
|
|
}
|
|
|
|
add_action( 'init', '_register_block_bindings_term_data_source' );
|