`) — NOT produced here; lives in FAQGeneratorService. * - Backend storage format — produced by renderFlat() / renderAccordion(). * - Frontend serialization — kept in sync via matching CSS class names. */ class FAQTemplateRenderer { /** * Return default settings used when none are provided. * * @return array */ public static function getDefaultSettings(): array { return [ 'container_class_name' => '', ]; } /** * Render FAQ list as a native HTML accordion using
/. * * @param array> $faqs List of ['question' => ..., 'answer' => ...] pairs. * @param array $settings Optional display settings; supports 'container_class_name'. * * @return string Sanitized accordion HTML. */ public static function renderAccordion(array $faqs, array $settings = []): string { $settings = array_merge(static::getDefaultSettings(), $settings); $container_class = 'aipt-faq-accordion'; $custom_class = isset($settings['container_class_name']) ? trim((string) $settings['container_class_name']) : ''; if ($custom_class !== '') { $container_class .= ' ' . $custom_class; } $items = []; foreach ($faqs as $faq) { if (!is_array($faq)) { continue; } $question = isset($faq['question']) ? trim((string) $faq['question']) : ''; $answer = isset($faq['answer']) ? trim((string) $faq['answer']) : ''; if ($question === '' || $answer === '') { continue; } $items[] = sprintf( '
' . "\n" . ' %s' . "\n" . '
%s
' . "\n" . '
', esc_html($question), wp_kses_post($answer) ); } if (empty($items)) { return ''; } return sprintf( '
' . "\n%s\n" . '
', esc_attr($container_class), implode("\n", $items) ); } /** * Render FAQ list in the flat (non-accordion) format. * * @param array> $faqs List of ['question' => ..., 'answer' => ...] pairs. * @param string $format 'html' or 'text'. * @param array $settings Optional display settings for Q/A labels. * * @return string Rendered FAQ content. */ public static function renderFlat( array $faqs, string $format, array $settings = [] ): string { $lines = []; $labels_enabled = isset( $settings['qa_labels_enabled'] ) ? (bool) $settings['qa_labels_enabled'] : true; $q_label = isset( $settings['question_label'] ) ? trim( (string) $settings['question_label'] ) : 'Q'; $a_label = isset( $settings['answer_label'] ) ? trim( (string) $settings['answer_label'] ) : 'A'; foreach ( $faqs as $faq ) { if ( ! is_array( $faq ) ) { continue; } $question = isset( $faq['question'] ) ? trim( (string) $faq['question'] ) : ''; $answer = isset( $faq['answer'] ) ? trim( (string) $faq['answer'] ) : ''; if ( '' === $question || '' === $answer ) { continue; } if ( $format === 'html' ) { if ( $labels_enabled && $q_label !== '' ) { $q_prefix = '' . esc_html( $q_label ) . ': '; } else { $q_prefix = ''; } if ( $labels_enabled && $a_label !== '' ) { $a_prefix = '' . esc_html( $a_label ) . ': '; } else { $a_prefix = ''; } $lines[] = sprintf( '

%s%s

%s%s
', $q_prefix, esc_html( $question ), $a_prefix, wp_kses_post( $answer ) ); continue; } $q_text_prefix = ( $labels_enabled && $q_label !== '' ) ? $q_label . ': ' : ''; $lines[] = $q_text_prefix . $question; $a_text_prefix = ( $labels_enabled && $a_label !== '' ) ? $a_label . ': ' : ''; $lines[] = $a_text_prefix . $answer; $lines[] = ''; } if ( $format === 'html' && ! empty( $lines ) ) { return '
' . "\n" . implode( "\n", $lines ) . "\n" . '
'; } return trim( implode( "\n", $lines ) ); } /** * Delegate to accordion or flat renderer based on caller intent. * * This is the primary entry-point for FAQGeneratorController. * * @param array> $faqs List of FAQ pairs. * @param string $format 'html' or 'text'. * @param bool $accordion_enabled Whether to use the accordion template. * @param array $settings Optional display settings passed to renderAccordion(). * * @return string Rendered FAQ content. */ public static function renderForStorage( array $faqs, string $format, bool $accordion_enabled = false, array $settings = [] ): string { if ( $accordion_enabled && $format === 'html' ) { return static::renderAccordion( $faqs, $settings ); } return static::renderFlat( $faqs, $format, $settings ); } }