• File: term-template.php
  • Full Path: /home/u505525515/domains/medineeestates.com/public_html/wp-includes/blocks/term-template.php
  • Date Modified: 05/25/2026 6:29 AM
  • File size: 4.41 KB
  • MIME-type: text/x-php
  • Charset: utf-8
<?php
/**
 * Server-side rendering of the `core/term-template` block.
 *
 * @package WordPress
 */

/**
 * Renders the `core/term-template` block on the server.
 *
 * @since 6.9.0
 *
 * @param array    $attributes Block attributes.
 * @param string   $content    Block default content.
 * @param WP_Block $block      Block instance.
 *
 * @return string Returns the output of the term template.
 */
function render_block_core_term_template( $attributes, $content, $block ) {
    if ( ! isset( $block->context ) || empty( $block->context['termQuery'] ) ) {
        return '';
    }

    $query = $block->context['termQuery'];

    $query_args = array(
        'number'     => $query['perPage'],
        'order'      => $query['order'],
        'orderby'    => $query['orderBy'],
        'hide_empty' => $query['hideEmpty'],
    );

    $inherit_query = isset( $query['inherit'] )
        && $query['inherit']
        && ( is_tax() || is_category() || is_tag() );

    if ( $inherit_query ) {
        // Get the current term and taxonomy from the queried object.
        $queried_object = get_queried_object();

        // For hierarchical taxonomies, show children of the current term.
        // For non-hierarchical taxonomies, show all terms (don't set parent).
        if ( is_taxonomy_hierarchical( $queried_object->taxonomy ) ) {
            // If showNested is true, use child_of to include nested terms.
            // Otherwise, use parent to show only direct children.
            if ( ! empty( $query['showNested'] ) ) {
                $query_args['child_of'] = $queried_object->term_id;
            } else {
                $query_args['parent'] = $queried_object->term_id;
            }
        }
        $query_args['taxonomy'] = $queried_object->taxonomy;
    } else {
        // If not inheriting set `taxonomy` from the block attribute.
        $query_args['taxonomy'] = $query['taxonomy'];

        // If we are including specific terms we ignore `showNested` argument.
        if ( ! empty( $query['include'] ) ) {
            $query_args['include'] = array_unique( array_map( 'intval', $query['include'] ) );
            $query_args['orderby'] = 'include';
            $query_args['order']   = 'asc';
        } elseif ( is_taxonomy_hierarchical( $query['taxonomy'] ) && empty( $query['showNested'] ) ) {
            // We set parent only when inheriting from the taxonomy archive context or not
            // showing nested terms, otherwise nested terms are not displayed.
            $query_args['parent'] = 0;
        }
    }

    $terms_query = new WP_Term_Query( $query_args );
    $terms       = $terms_query->get_terms();

    if ( ! $terms || is_wp_error( $terms ) ) {
        return '';
    }

    $content = '';
    foreach ( $terms as $term ) {
        // Get an instance of the current Term Template block.
        $block_instance = $block->parsed_block;

        // Set the block name to one that does not correspond to an existing registered block.
        // This ensures that for the inner instances of the Term Template block, we do not render any block supports.
        $block_instance['blockName'] = 'core/null';

        $term_id  = $term->term_id;
        $taxonomy = $term->taxonomy;

        $filter_block_context = static function ( $context ) use ( $term_id, $taxonomy ) {
            $context['termId']   = $term_id;
            $context['taxonomy'] = $taxonomy;
            return $context;
        };

        // Use an early priority to so that other 'render_block_context' filters have access to the values.
        add_filter( 'render_block_context', $filter_block_context, 1 );

        // Render the inner blocks of the Term Template block with `dynamic` set to `false` to prevent calling
        // `render_callback` and ensure that no wrapper markup is included.
        $block_content = ( new WP_Block( $block_instance ) )->render( array( 'dynamic' => false ) );

        remove_filter( 'render_block_context', $filter_block_context, 1 );

        // Wrap the render inner blocks in a `li` element with the appropriate term classes.
        $term_classes = "wp-block-term term-{$term->term_id} {$term->taxonomy} taxonomy-{$term->taxonomy}";

        $content .= '<li class="' . esc_attr( $term_classes ) . '">' . $block_content . '</li>';
    }

    $classnames = '';

    if ( isset( $attributes['style']['elements']['link']['color']['text'] ) ) {
        $classnames .= 'has-link-color';
    }

    $wrapper_attributes = get_block_wrapper_attributes( array( 'class' => trim( $classnames ) ) );

    return sprintf(
        '<ul %s>%s</ul>',
        $wrapper_attributes,
        $content
    );
}

/**
 * Registers the `core/term-template` block on the server.
 *
 * @since 6.9.0
 */
function register_block_core_term_template() {
    register_block_type_from_metadata(
        __DIR__ . '/term-template',
        array(
            'render_callback' => 'render_block_core_term_template',
        )
    );
}
add_action( 'init', 'register_block_core_term_template' );