) or a library/builtin
// glyph (inline, sanitised). Skip until one is chosen — mirrors the
// generator's renderable rule so :nth-child tint positions stay in sync.
$icon_cfg = is_array( $item['icon'] ?? null ) ? $item['icon'] : [];
$source = (string) ( $icon_cfg['source'] ?? 'none' );
$markup = (string) ( $icon_cfg['markup'] ?? '' );
$icon_url = (string) ( $icon_cfg['url'] ?? '' );
if ( 'upload' === $source && '' !== $icon_url ) {
$icon_svg = ' . ')
';
} elseif ( 'none' !== $source && '' !== $markup ) {
$icon_svg = HTML_Helpers::svg_kses( $markup );
if ( '' === $icon_svg ) {
continue;
}
} else {
continue;
}
$label = '' !== (string) ( $icon_cfg['name'] ?? '' ) ? (string) $icon_cfg['name'] : __( 'Social link', 'flexa-block' );
$type_class = 'flexa-social-icon__item--custom-icon';
$tinted = true;
} else {
if ( ! isset( $social_catalog[ $platform ] ) ) {
continue;
}
$entry = $social_catalog[ $platform ];
$tinted = 'custom' === ( $item['colorMode'] ?? 'official' );
$icon_svg = $tinted
? ''
: $entry['brand'];
$label = $entry['label'];
$type_class = 'flexa-social-icon__item--' . sanitize_html_class( $platform );
}
$item_classes = 'flexa-social-icon__item ' . $type_class;
if ( $tinted ) {
$item_classes .= ' flexa-social-icon__item--custom';
}
$inner = '' . $icon_svg . '';
$link = is_array( $item['link'] ?? null ) ? $item['link'] : [];
$url = (string) ( $link['url'] ?? '' );
if ( '' !== $url ) {
$item_attrs = 'class="' . esc_attr( $item_classes ) . '" href="' . esc_url( $url ) . '" aria-label="' . esc_attr( $label ) . '"';
if ( '_blank' === ( $link['target'] ?? '' ) ) {
$rel = trim( (string) ( $link['rel'] ?? '' ) );
if ( '' === $rel ) {
$rel = 'noopener noreferrer';
}
$rel = trim( (string) preg_replace( '/[^a-z0-9 _-]/i', '', $rel ) );
$item_attrs .= ' target="_blank" rel="' . esc_attr( $rel ) . '"';
}
$items_html .= '' . $inner . '';
} else {
$items_html .= '' . $inner . '';
}
}
if ( '' === $items_html ) {
return;
}
// Wrapper classes + attributes.
$classes = [ 'flexa-social-icon' ];
if ( '' !== $block_id ) {
$classes[] = 'flexa-social-icon-' . sanitize_html_class( $block_id );
}
$hover_effect = (string) ( $attributes['hoverEffect'] ?? '' );
if ( in_array( $hover_effect, [ 'grow', 'shrink', 'lift', 'rotate' ], true ) ) {
$classes[] = 'flexa-social-icon--hover-' . $hover_effect;
}
$classes = HTML_Helpers::build_wrapper_classes( $classes, $attributes );
$wrapper_args = [ 'class' => 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 );
printf(
'<%1$s %2$s%3$s>%4$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.
$items_html // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static SVG literals; urls/labels/classes escaped above.
);