@sociallane/elements 1.0.0

package/widgets/cta-notify/data/view.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * Data Preparation: CTA Notify
+ *
+ * Transforms raw Elementor settings into clean, template-ready data.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for CTA Notify widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID for accessibility
+ * @return array Template-ready data
+ */
+function prepare_cta_notify_view( array $settings, string $widget_id ): array {
+	$show_headline    = ( $settings['show_headline'] ?? 'yes' ) === 'yes';
+	$show_description = ( $settings['show_description'] ?? 'yes' ) === 'yes';
+
+	$headline     = $show_headline ? esc_html( $settings['headline'] ?? '' ) : '';
+	$description  = $show_description ? esc_html( $settings['description'] ?? '' ) : '';
+	$headline_tag = in_array( $settings['headline_tag'] ?? 'h2', [ 'h1', 'h2', 'h3' ], true )
+		? $settings['headline_tag']
+		: 'h2';
+
+	$form_shortcode = trim( $settings['form_shortcode'] ?? '' );
+
+	$animation = sociallane_animation_view_data( $settings );
+
+	// Card: Tailwind-only dark card with purple glow (before: gradient)
+	$classes = [
+		'section'     => 'bg-neutral-100 dark:bg-neutral-950',
+		'card'        => 'relative overflow-hidden rounded-xl p-8 md:p-10 lg:p-12 text-center bg-neutral-700 border border-neutral-700 before:content-[""] before:absolute before:inset-x-0 before:bottom-0 before:h-3/4 before:bg-gradient-to-t before:from-neutral-500/25 before:to-transparent before:pointer-events-none',
+		'card_inner'  => 'relative z-10',
+		'headline'    => 'text-white',
+		'description'=> 'text-neutral-400',
+	];
+
+	return [
+		'show_headline'    => $show_headline,
+		'show_description' => $show_description,
+		'headline'         => $headline,
+		'headline_tag'     => $headline_tag,
+		'description'      => $description,
+		'form_shortcode'   => $form_shortcode,
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+	];
+}

package/widgets/cta-notify/templates/wrapper.php

@@ -0,0 +1,69 @@
+<?php
+/**
+ * Template: CTA Notify Wrapper
+ *
+ * Centered dark card with purple glow, headline, description, and inline form.
+ *
+ * AVAILABLE DATA ($view):
+ * - show_headline, show_description
+ * - headline, headline_tag, description, form_shortcode
+ * - classes, widget_id
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $view ) ) {
+	return;
+}
+
+$anim          = $view['animation'] ?? [];
+$section_attrs = sociallane_section_animation_attrs( $anim );
+$section_id  = 'cta-notify-' . $view['widget_id'];
+$has_heading = ( $view['show_headline'] && ! empty( $view['headline'] ) ) || ( $view['show_description'] && ! empty( $view['description'] ) );
+$has_form    = ! empty( $view['form_shortcode'] );
+?>
+
+<?php // ========== CTA NOTIFY START ========== ?>
+
+<section
+	class="<?php echo esc_attr( $view['classes']['section'] ); ?> py-16 md:py-20 lg:py-24"
+	<?php echo $section_attrs ? ' ' . $section_attrs : ''; ?>
+	<?php if ( $has_heading ) : ?>aria-labelledby="<?php echo esc_attr( $section_id ); ?>"<?php endif; ?>
+>
+	<div class="container mx-auto px-4 sm:px-6 lg:px-8">
+		<div class="max-w-4xl mx-auto">
+			<div class="<?php echo esc_attr( $view['classes']['card'] ); ?>">
+				<div class="<?php echo esc_attr( $view['classes']['card_inner'] ); ?>">
+				<?php if ( $has_heading ) : ?>
+					<header class="mb-6 md:mb-8" id="<?php echo esc_attr( $section_id ); ?>">
+						<?php if ( $view['show_headline'] && ! empty( $view['headline'] ) ) : ?>
+							<<?php echo $view['headline_tag']; ?>
+								class="<?php echo esc_attr( $view['classes']['headline'] ); ?> text-2xl sm:text-3xl md:text-4xl font-bold font-heading leading-tight"
+							>
+								<?php echo $view['headline']; ?>
+							</<?php echo $view['headline_tag']; ?>>
+						<?php endif; ?>
+						<?php if ( $view['show_description'] && ! empty( $view['description'] ) ) : ?>
+							<p class="<?php echo esc_attr( $view['classes']['description'] ); ?> mt-4 text-base md:text-lg leading-relaxed">
+								<?php echo $view['description']; ?>
+							</p>
+						<?php endif; ?>
+					</header>
+				<?php endif; ?>
+
+				<?php if ( $has_form ) : ?>
+					<div class="sl-cta-notify-form mt-8">
+						<?php echo do_shortcode( $view['form_shortcode'] ); ?>
+					</div>
+				<?php endif; ?>
+				</div>
+			</div>
+		</div>
+	</div>
+</section>
+
+<?php // ========== CTA NOTIFY END ========== ?>

package/widgets/cta-split/cta-split.php

@@ -0,0 +1,246 @@
+<?php
+/**
+ * Widget: CTA Split
+ *
+ * Two-column section: left = dark slate panel (headline, description, phone | email);
+ * right = full-height image. No overlay on image. Teal contact icons and text.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+use Elementor\Widget_Base;
+use Elementor\Controls_Manager;
+use SocialLane\Elements\Traits\Animation_Controls;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * CTA Split Widget
+ */
+class Cta_Split extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'cta-split';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'CTA Split', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-call-to-action';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-forms' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'cta', 'split', 'contact', 'phone', 'email', 'call to action' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_content_section();
+		$this->register_contact_section();
+		$this->register_image_section();
+		$this->register_layout_section();
+		$this->register_animation_controls( true, false );
+	}
+
+	private function register_content_section(): void {
+		$this->start_controls_section(
+			'section_content',
+			[
+				'label' => esc_html__( 'Content', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_headline',
+			[
+				'label'   => esc_html__( 'Show Headline', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'headline',
+			[
+				'label'       => esc_html__( 'Headline', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+				'placeholder' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$this->add_control(
+			'headline_tag',
+			[
+				'label'   => esc_html__( 'Headline Tag', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'h2',
+				'options' => [
+					'h1' => 'H1',
+					'h2' => 'H2',
+					'h3' => 'H3',
+				],
+			]
+		);
+
+		$this->add_control(
+			'show_description',
+			[
+				'label'   => esc_html__( 'Show Description', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'description',
+			[
+				'label'   => esc_html__( 'Description', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXTAREA,
+				'default' => esc_html__( 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.', 'sociallane-elements' ),
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_contact_section(): void {
+		$this->start_controls_section(
+			'section_contact',
+			[
+				'label' => esc_html__( 'Contact', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_phone',
+			[
+				'label'   => esc_html__( 'Show Phone', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'phone',
+			[
+				'label'       => esc_html__( 'Phone Number', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => '+31 (0)70 413 1100',
+				'label_block' => true,
+			]
+		);
+
+		$this->add_control(
+			'phone_url',
+			[
+				'label'       => esc_html__( 'Phone Link (optional)', 'sociallane-elements' ),
+				'type'        => Controls_Manager::URL,
+				'description' => esc_html__( 'Leave empty to use tel: from number', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'show_email',
+			[
+				'label'   => esc_html__( 'Show Email', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'email',
+			[
+				'label'       => esc_html__( 'Email Address', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => 'info@example.com',
+				'label_block' => true,
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_image_section(): void {
+		$this->start_controls_section(
+			'section_image',
+			[
+				'label' => esc_html__( 'Image', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'image',
+			[
+				'label'   => esc_html__( 'Image', 'sociallane-elements' ),
+				'type'    => Controls_Manager::MEDIA,
+				'default' => [ 'url' => \Elementor\Utils::get_placeholder_image_src() ],
+			]
+		);
+
+		$this->add_control(
+			'image_alt',
+			[
+				'label'       => esc_html__( 'Image Alt Text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'description' => esc_html__( 'Required for accessibility', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_layout_section(): void {
+		$this->start_controls_section(
+			'section_layout',
+			[
+				'label' => esc_html__( 'Layout', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'min_height',
+			[
+				'label'   => esc_html__( 'Minimum Section Height', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => '60vh',
+				'options' => [
+					'40vh'  => esc_html__( '40vh', 'sociallane-elements' ),
+					'50vh'  => esc_html__( '50vh', 'sociallane-elements' ),
+					'60vh'  => esc_html__( '60vh', 'sociallane-elements' ),
+					'70vh'  => esc_html__( '70vh', 'sociallane-elements' ),
+					'80vh'  => esc_html__( '80vh', 'sociallane-elements' ),
+					'90vh'  => esc_html__( '90vh', 'sociallane-elements' ),
+					'100vh' => esc_html__( '100vh', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_cta_split_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/widgets/cta-split/data/view.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * Data Preparation: CTA Split
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for CTA Split widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID
+ * @return array Template-ready data
+ */
+function prepare_cta_split_view( array $settings, string $widget_id ): array {
+	$show_headline    = sociallane_show_field( $settings, 'show_headline' );
+	$show_description = sociallane_show_field( $settings, 'show_description' );
+	$show_phone       = sociallane_show_field( $settings, 'show_phone' );
+	$show_email       = sociallane_show_field( $settings, 'show_email' );
+
+	$headline     = sociallane_sanitize_text( $show_headline, $settings, 'headline' );
+	$description  = sociallane_sanitize_text( $show_description, $settings, 'description' );
+	$headline_tag = sociallane_validate_heading_tag( $settings, 'headline_tag', 'h2' );
+
+	$image = sociallane_prepare_image_data(
+		$settings['image'] ?? [],
+		[
+			'alt'        => $settings['image_alt'] ?? '',
+			'sizes'      => '(min-width: 1024px) 50vw, 100vw',
+			'loading'    => 'lazy',
+			'image_size' => 'large',
+		]
+	);
+
+	$phone_raw = $show_phone ? trim( $settings['phone'] ?? '' ) : '';
+	$phone_url = $settings['phone_url']['url'] ?? '';
+	if ( $phone_raw && ! $phone_url ) {
+		$phone_url = 'tel:' . preg_replace( '/\s+/', '', $phone_raw );
+	}
+	$phone = $phone_raw ? [
+		'label' => esc_html( $phone_raw ),
+		'url'   => esc_url( $phone_url ?: 'tel:' . preg_replace( '/\s+/', '', $phone_raw ) ),
+	] : null;
+
+	$email_raw = $show_email ? trim( $settings['email'] ?? '' ) : '';
+	$email     = $email_raw ? [
+		'label' => esc_html( $email_raw ),
+		'url'   => 'mailto:' . sanitize_email( $email_raw ),
+	] : null;
+
+	$min_height = $settings['min_height'] ?? '60vh';
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true ] );
+
+	// Dark slate left panel (#2E3E4C), white headline, lighter grey description, teal contact (#34D399)
+	$classes = [
+		'panel'       => 'bg-blue-chill-900 dark:bg-blue-chill-950',
+		'headline'    => 'text-white dark:text-white',
+		'description' => 'text-white/90 dark:text-neutral-200',
+		'contact'     => 'text-emerald-400 dark:text-emerald-400',
+		'icon'        => 'text-emerald-400 dark:text-emerald-400 shrink-0',
+		'separator'   => 'text-white/50 dark:text-neutral-400',
+		'focus_ring'  => 'focus:ring-emerald-400 focus:ring-offset-2 focus:ring-offset-blue-chill-900 dark:focus:ring-offset-blue-chill-950',
+	];
+
+	return [
+		'show_headline'    => $show_headline,
+		'show_description' => $show_description,
+		'show_phone'       => $show_phone,
+		'show_email'       => $show_email,
+		'headline'         => $headline,
+		'headline_tag'     => $headline_tag,
+		'description'      => $description,
+		'image'            => $image,
+		'phone'            => $phone,
+		'email'            => $email,
+		'min_height'       => $min_height,
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+	];
+}

package/widgets/cta-split/templates/wrapper.php

@@ -0,0 +1,113 @@
+<?php
+/**
+ * Template: CTA Split Wrapper
+ *
+ * Two columns: left = dark panel (headline, description, phone | email);
+ * right = full-height image. No overlay. Teal contact.
+ *
+ * AVAILABLE DATA ($view): show_headline, show_description, show_phone, show_email,
+ * headline, headline_tag, description, image, phone, email, min_height,
+ * classes, widget_id, animation
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $view ) ) {
+	return;
+}
+
+$anim           = $view['animation'] ?? [];
+$section_attrs  = sociallane_section_animation_attrs( $anim );
+$headline_attrs = sociallane_headline_animation_attrs( $anim );
+$section_id     = 'cta-split-' . $view['widget_id'];
+$elements_path  = SOCIALLANE_ELEMENTS_PATH . 'elements';
+
+$has_headline    = $view['show_headline'] && $view['headline'] !== '';
+$has_description = $view['show_description'] && $view['description'] !== '';
+$has_contact     = ! empty( $view['phone'] ) || ! empty( $view['email'] );
+$has_heading     = $has_headline || $has_description;
+$has_image       = ! empty( $view['image']['src'] );
+?>
+
+<?php // ========== CTA SPLIT START ========== ?>
+
+<section
+	class="cta-split flex flex-col justify-center items-center lg:flex-row min-h-0 overflow-hidden max-lg:h-auto!"
+	style="min-height: <?php echo esc_attr( $view['min_height'] ); ?>; height: <?php echo esc_attr( $view['min_height'] ); ?>;"
+	<?php echo $section_attrs ? ' ' . $section_attrs : ''; ?>
+	<?php if ( $has_heading ) : ?>aria-labelledby="<?php echo esc_attr( $section_id ); ?>"<?php endif; ?>
+>
+	<?php /* Left: dark panel – content */ ?>
+	<div class="flex flex-col justify-center <?php echo esc_attr( $view['classes']['panel'] ); ?> py-14 px-6 sm:py-16 sm:px-8 lg:py-20 lg:px-12 xl:px-16 order-1">
+		<div class="max-w-xl w-full">
+			<header class="mb-0" id="<?php echo esc_attr( $section_id ); ?>">
+				<?php if ( $has_headline ) : ?>
+					<<?php echo $view['headline_tag']; ?>
+						class="<?php echo esc_attr( $view['classes']['headline'] ); ?> text-2xl sm:text-3xl md:text-4xl lg:text-5xl font-bold font-heading leading-tight"
+						<?php echo $headline_attrs ? ' ' . $headline_attrs : ''; ?>
+					>
+						<?php echo $view['headline']; ?>
+					</<?php echo $view['headline_tag']; ?>>
+				<?php endif; ?>
+				<?php if ( $has_description ) : ?>
+					<p class="<?php echo esc_attr( $view['classes']['description'] ); ?> mt-6 md:mt-8 text-base md:text-lg leading-relaxed">
+						<?php echo $view['description']; ?>
+					</p>
+				<?php endif; ?>
+			</header>
+
+			<?php /* Contact: phone | email – left-aligned, teal icon + text */ ?>
+			<?php if ( $has_contact ) : ?>
+				<div class="flex flex-wrap items-center gap-x-4 gap-y-2 mt-8 md:mt-10 text-base md:text-lg">
+					<?php if ( ! empty( $view['phone'] ) ) : ?>
+						<a
+							href="<?php echo esc_url( $view['phone']['url'] ); ?>"
+							class="<?php echo esc_attr( $view['classes']['contact'] ); ?> inline-flex items-center gap-2 hover:opacity-90 focus:outline-none focus:ring-2 <?php echo esc_attr( $view['classes']['focus_ring'] ); ?> rounded transition-opacity"
+							aria-label="<?php echo esc_attr( sprintf( /* translators: phone number */ __( 'Call %s', 'sociallane-elements' ), $view['phone']['label'] ) ); ?>"
+						>
+							<svg class="w-5 h-5 <?php echo esc_attr( $view['classes']['icon'] ); ?>" fill="currentColor" viewBox="0 0 20 20" aria-hidden="true">
+								<path d="M2 3a1 1 0 011-1h2.153a1 1 0 01.986.836l.74 4.435a1 1 0 01-.54 1.06l-1.548.773a11.037 11.037 0 006.105 6.105l.774-1.548a1 1 0 011.059-.54l4.435.74a1 1 0 01.836.986V17a1 1 0 01-1 1h-2C7.82 18 2 12.18 2 5V3z"/>
+							</svg>
+							<span><?php echo $view['phone']['label']; ?></span>
+						</a>
+					<?php endif; ?>
+
+					<?php if ( ! empty( $view['phone'] ) && ! empty( $view['email'] ) ) : ?>
+						<span class="<?php echo esc_attr( $view['classes']['separator'] ); ?> hidden sm:inline" aria-hidden="true">|</span>
+					<?php endif; ?>
+
+					<?php if ( ! empty( $view['email'] ) ) : ?>
+						<a
+							href="<?php echo esc_url( $view['email']['url'] ); ?>"
+							class="<?php echo esc_attr( $view['classes']['contact'] ); ?> inline-flex items-center gap-2 hover:opacity-90 focus:outline-none focus:ring-2 <?php echo esc_attr( $view['classes']['focus_ring'] ); ?> rounded transition-opacity"
+							aria-label="<?php echo esc_attr( sprintf( /* translators: email address */ __( 'Email %s', 'sociallane-elements' ), $view['email']['label'] ) ); ?>"
+						>
+							<svg class="w-5 h-5 <?php echo esc_attr( $view['classes']['icon'] ); ?>" fill="currentColor" viewBox="0 0 20 20" aria-hidden="true">
+								<path d="M2.003 5.884L10 9.882l7.997-3.998A2 2 0 0016 4H4a2 2 0 00-1.997 1.884z"/>
+								<path d="M18 8.118l-8 4-8-4V14a2 2 0 002 2h12a2 2 0 002-2V8.118z"/>
+							</svg>
+							<span><?php echo $view['email']['label']; ?></span>
+						</a>
+					<?php endif; ?>
+				</div>
+			<?php endif; ?>
+		</div>
+	</div>
+
+	<?php /* Right: image – full height, object-cover */ ?>
+	<?php if ( $has_image ) : ?>
+		<div class="relative min-h-[280px] sm:min-h-[360px] lg:min-h-0 lg:h-full order-2 bg-neutral-200 dark:bg-neutral-800">
+			<?php
+			$image          = $view['image'];
+			$image['class'] = 'w-full h-full object-cover';
+			include $elements_path . '/image/templates/render.php';
+			?>
+		</div>
+	<?php endif; ?>
+</section>
+
+<?php // ========== CTA SPLIT END ========== ?>

package/widgets/faq/data/view.php

@@ -0,0 +1,105 @@
+<?php
+/**
+ * Data Preparation: FAQ
+ *
+ * Transforms raw Elementor settings into clean, template-ready data.
+ * All sanitization and defaults happen here.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for FAQ widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID for accessibility
+ * @return array Template-ready data
+ */
+function prepare_faq_view( array $settings, string $widget_id ): array {
+	$show_title       = ( $settings['show_title'] ?? 'yes' ) === 'yes';
+	$show_description = ( $settings['show_description'] ?? 'yes' ) === 'yes';
+
+	$title       = $show_title ? esc_html( $settings['title'] ?? '' ) : '';
+	$description = $show_description ? wp_kses_post( $settings['description'] ?? '' ) : '';
+	$title_tag   = in_array( $settings['title_tag'] ?? 'h2', [ 'h1', 'h2', 'h3' ], true )
+		? $settings['title_tag']
+		: 'h2';
+
+	// Build FAQ items with sanitized question/answer; assign IDs for aria-controls
+	$raw_items = $settings['faq_items'] ?? [];
+	$items     = [];
+	$first_open = ( $settings['first_open'] ?? 'yes' ) === 'yes';
+
+	foreach ( $raw_items as $index => $row ) {
+		$q = isset( $row['question'] ) ? trim( (string) $row['question'] ) : '';
+		$a = isset( $row['answer'] ) ? (string) $row['answer'] : '';
+		if ( $q === '' && $a === '' ) {
+			continue;
+		}
+		$btn_label = isset( $row['button_label'] ) ? trim( (string) $row['button_label'] ) : '';
+		$btn_url   = isset( $row['button_url'] ) && is_array( $row['button_url'] ) ? $row['button_url'] : [];
+		$button    = ( $btn_label !== '' && function_exists( 'sociallane_prepare_button_data' ) )
+			? sociallane_prepare_button_data( $btn_label, $btn_url, [ 'preset' => 'primary' ] )
+			: null;
+		$item_id   = 'faq-' . $widget_id . '-' . $index;
+		$is_first_displayed = ( count( $items ) === 0 );
+		$items[]   = [
+			'id'       => $item_id,
+			'question' => esc_html( $q ),
+			'answer'   => wp_kses_post( $a ),
+			'open'     => $first_open && $is_first_displayed,
+			'button'   => $button,
+		];
+	}
+
+	// Layout: stacked | split | centered
+	$layout = in_array( $settings['layout'] ?? 'stacked', [ 'stacked', 'split', 'centered' ], true )
+		? $settings['layout']
+		: 'stacked';
+	$content_position = ( $settings['content_position'] ?? 'left' ) === 'right' ? 'right' : 'left';
+	$header_order = ( $layout === 'split' && $content_position === 'right' ) ? 'lg:order-2' : 'lg:order-1';
+	$accordion_order = ( $layout === 'split' && $content_position === 'right' ) ? 'lg:order-1' : 'lg:order-2';
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true, 'stagger' => true ] );
+
+	// Light/dark mode classes (all color/theme here — templates only echo these)
+	$classes = [
+		'section'      => 'bg-neutral-100 dark:bg-zinc-900',
+		'title'        => 'text-zinc-900 dark:text-neutral-200',
+		'description'  => 'text-zinc-900 dark:text-neutral-200',
+		'item_border'  => 'border-neutral-200 dark:border-blue-chill-100/0',
+		'item_bg'      => 'bg-transparent',
+		'question'     => 'text-zinc-900 dark:text-neutral-200',
+		'answer'       => 'text-zinc-900 dark:text-neutral-200',
+		'summary_focus'=> 'focus:ring-primary focus:ring-offset-2 focus:ring-offset-white dark:focus:ring-offset-neutral-900',
+		'chevron'      => 'bg-blue-chill-300 dark:bg-neutral-800 text-neutral-600 dark:text-blue-chill-300',
+	];
+
+	// Schema for FAQPage (for SEO JSON-LD)
+	$schema_items = array_map( function ( $item ) {
+		return [
+			'question' => $item['question'],
+			'answer'   => wp_strip_all_tags( $item['answer'] ),
+		];
+	}, $items );
+
+	return [
+		'show_title'       => $show_title,
+		'show_description'=> $show_description,
+		'title'            => $title,
+		'title_tag'        => $title_tag,
+		'description'      => $description,
+		'items'            => $items,
+		'layout'           => $layout,
+		'header_order'     => $header_order,
+		'accordion_order'  => $accordion_order,
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+		'schema_items'     => $schema_items,
+	];
+}