implode( ' ', $classes ) ];
if ( $anchor ) {
$wrapper_args['id'] = sanitize_html_class( $anchor );
}
$wrapper_attributes = get_block_wrapper_attributes( $wrapper_args );
$data_attrs = HTML_Helpers::build_data_attrs( $attributes );
// Lazy background marker.
$background = $attributes['background'] ?? [];
$is_lazy_bg = ! empty( $background['lazyLoad'] ) && 'image' === ( $background['type'] ?? 'none' ) && '' !== ( $background['image']['url'] ?? '' );
$lazy_marker = $is_lazy_bg ? ' data-flexa-lazy-bg' : '';
/**
* Render the wrapper around already-built inner HTML.
*
* @param string $inner_html Escaped inner markup.
* @return void
*/
$print_wrapper = static function ( $inner_html ) use ( $html_tag, $wrapper_attributes, $data_attrs, $lazy_marker ) {
printf(
'<%1$s %2$s%3$s%4$s>%5$s',
esc_html( $html_tag ),
$wrapper_attributes, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built via get_block_wrapper_attributes.
$data_attrs, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- keys sanitized, values escaped in helper.
$lazy_marker, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static literal.
$inner_html // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- names esc_html'd, urls esc_url'd, icons svg_kses'd below.
);
};
// --- Bail cleanly when the taxonomy is gone / invalid. ---
if ( '' === $tax || ! taxonomy_exists( $tax ) ) {
$print_wrapper( '' . esc_html__( 'No terms found.', 'flexa-block' ) . '
' );
return;
}
// --- Query the terms. ---
$query_args = [
'taxonomy' => $tax,
'orderby' => $order_by,
'order' => $order,
'hide_empty' => ! $show_empty,
];
if ( $limit > 0 ) {
$query_args['number'] = $limit;
}
$terms = get_terms( $query_args );
if ( is_wp_error( $terms ) || empty( $terms ) ) {
$print_wrapper( '' . esc_html__( 'No terms found.', 'flexa-block' ) . '
' );
return;
}
$terms = array_values( $terms );
// --- Resolve the (constant) prefix / suffix affixes once. ---
$affix_allowed = [ 'strong' => [], 'em' => [], 'b' => [], 'i' => [], 'br' => [], 'span' => [] ];
/**
* Build one affix's inner HTML (icon glyph or minimal-kses'd text), or ''.
*
* @param string $type 'none' | 'icon' | 'text'.
* @param mixed $icon IconValue.
* @param string $text Text value.
* @param string $cls Element class.
* @param array $allowed Allowed tags for text.
* @return string
*/
$build_affix = static function ( $type, $icon, $text, $cls, $allowed ) {
if ( 'icon' === $type ) {
$svg = HTML_Helpers::icon_html( $icon );
return '' !== $svg ? '' . $svg . '' : '';
}
if ( 'text' === $type && '' !== trim( (string) $text ) ) {
return '' . wp_kses( (string) $text, $allowed ) . '';
}
return '';
};
$prefix_html = $build_affix( $attributes['prefixType'] ?? 'none', $attributes['prefixIcon'] ?? [], $attributes['prefixText'] ?? '', 'flexa-taxonomy__prefix', $affix_allowed );
$suffix_html = $build_affix( $attributes['suffixType'] ?? 'none', $attributes['suffixIcon'] ?? [], $attributes['suffixText'] ?? '', 'flexa-taxonomy__suffix', $affix_allowed );
/**
* The clickable body of one term: the linked prefix + name + count + suffix.
*
* @param WP_Term $term Term object.
* @return string
*/
$build_link = static function ( $term ) use ( $prefix_html, $suffix_html, $show_count ) {
$link_raw = get_term_link( $term );
$href = is_wp_error( $link_raw ) ? '' : esc_url( $link_raw );
$name = '' . esc_html( $term->name ) . '';
$count = $show_count ? '(' . (int) $term->count . ')' : '';
$inner = $prefix_html . $name . $count . $suffix_html;
if ( '' !== $href ) {
return '' . $inner . '';
}
return '' . $inner . '';
};
// --- Dropdown: a native