question that
* toggles its answer region) plus the data attributes view.js needs, and — when
* enabled — a FAQPage JSON-LD block for rich results. The question/answer text
* inherits the theme's typography unless the user overrode it.
*
* @package Flexa\Block
*
* @var array $attributes Block attributes.
* @var string $content Save content (unused — dynamic block).
* @var WP_Block $block Block instance.
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
// phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound -- $attributes provided by WP block API.
use Flexa\Block\HTML_Helpers;
$block_id = $attributes['blockId'] ?? '';
$anchor = $attributes['anchor'] ?? '';
$html_tag = HTML_Helpers::get_html_tag( $attributes );
$items = $attributes['items'] ?? [];
if ( ! is_array( $items ) || empty( $items ) ) {
return;
}
$icon_pos = 'left' === ( $attributes['iconPosition'] ?? 'right' ) ? 'left' : 'right';
$show_icon = false !== ( $attributes['showIcon'] ?? true );
$icon_style = in_array( $attributes['iconStyle'] ?? 'plus', [ 'plus', 'chevron', 'arrow' ], true ) ? $attributes['iconStyle'] : 'plus';
$expand_first = ! empty( $attributes['expandFirst'] );
$close_others = false !== ( $attributes['closeOthers'] ?? true );
$allow_toggle = false !== ( $attributes['allowToggle'] ?? true );
$enable_schema = ! empty( $attributes['enableSchema'] );
// Inline formatting allowed inside the question text.
$question_allowed = [
'strong' => [],
'em' => [],
'b' => [],
'i' => [],
'br' => [],
'span' => [],
];
// Tags Google accepts inside a FAQ rich result's answer text — the question
// name must stay plain text, but the answer keeps this markup for SEO.
$schema_answer_allowed = [
'h1' => [],
'h2' => [],
'h3' => [],
'h4' => [],
'h5' => [],
'h6' => [],
'br' => [],
'ol' => [],
'ul' => [],
'li' => [],
'a' => [ 'href' => true ],
'p' => [],
'div' => [],
'b' => [],
'strong' => [],
'i' => [],
'em' => [],
];
/**
* Build the open/close icon markup for the chosen style. All markup is static
* (no user input) so it is safe to echo directly.
*/
$icon_html = '';
if ( $show_icon ) {
if ( 'chevron' === $icon_style ) {
$icon_html = '';
} elseif ( 'arrow' === $icon_style ) {
$icon_html = '';
} else {
$icon_html = '';
}
}
// Build the list items.
$id_base = '' !== $block_id ? sanitize_html_class( $block_id ) : 'faq';
$items_html = '';
$schema_qa = [];
foreach ( array_values( $items ) as $index => $item ) {
$question = wp_kses( (string) ( $item['question'] ?? '' ), $question_allowed );
$answer = wp_kses_post( (string) ( $item['answer'] ?? '' ) );
if ( '' === trim( wp_strip_all_tags( $question ) ) && '' === trim( wp_strip_all_tags( $answer ) ) ) {
continue;
}
$is_open = 0 === $index && $expand_first;
$answer_id = 'flexa-faq-' . $id_base . '-a' . $index;
$question_id = 'flexa-faq-' . $id_base . '-q' . $index;
$open_attr = $is_open ? ' data-open' : '';
$expanded = $is_open ? 'true' : 'false';
$text_html = '' . $question . '';
$inner_q = $show_icon && 'left' === $icon_pos ? $icon_html . $text_html : $text_html . $icon_html;
$items_html .= '';
$items_html .= '
';
$items_html .= '
';
$items_html .= '
';
$items_html .= '
%7$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.
$faq_attrs, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static literals only.
$lazy_marker, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static literal.
$schema_html, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_json_encode output, script tag static.
$items_html // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- question wp_kses'd, answer wp_kses_post'd, ids esc_attr'd above.
);