@sociallane/elements 1.0.0

package/packages/widgets/hero-collage/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@sociallane/widget-hero-collage",
+  "version": "1.0.0",
+  "private": true,
+  "description": "SocialLane Elements widget: hero-collage",
+  "peerDependencies": {
+    "@sociallane/core": "^1.0.0"
+  },
+  "scripts": {
+    "build": "echo \"No widget-specific build\""
+  }
+}

package/packages/widgets/hero-collage/templates/wrapper.php

@@ -0,0 +1,102 @@
+<?php
+/**
+ * Template: Hero Collage Wrapper
+ *
+ * AVAILABLE DATA ($view):
+ * - show_headline, show_description, show_cta_primary, show_cta_secondary
+ * - headline, headline_tag, description
+ * - cta_primary, cta_secondary (button data)
+ * - content_order, media_order, collage (5 items with src, alt, placement)
+ * - classes, widget_id
+ *
+ * @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 );
+
+$elements_path = SOCIALLANE_ELEMENTS_PATH . 'elements';
+$hero_id       = 'hero-collage-' . $view['widget_id'];
+$has_collage   = ! empty( array_filter( array_column( $view['collage'] ?? [], 'src' ) ) );
+?>
+
+<?php // ========== HERO COLLAGE START ========== ?>
+
+<section
+	class="<?php echo esc_attr( $view['classes']['section'] ); ?> relative py-16 md:py-24 lg:py-32 overflow-hidden"
+	<?php if ( $view['show_headline'] && $view['headline'] !== '' ) : ?>aria-labelledby="<?php echo esc_attr( $hero_id ); ?>"<?php endif; ?>
+>
+	<div class="container relative z-10 mx-auto px-4 sm:px-6 lg:px-8">
+		<div class="grid grid-cols-1 lg:grid-cols-2 gap-10 lg:gap-16 items-center">
+			<?php
+		$header = [
+			'use_wrapper'       => false,
+			'show_headline'     => $view['show_headline'] && $view['headline'] !== '',
+			'headline'          => $view['headline'] ?? '',
+			'headline_tag'      => $view['headline_tag'] ?? 'h1',
+			'headline_class'    => $view['classes']['headline'] ?? '',
+			'headline_extras'   => 'text-3xl sm:text-4xl md:text-5xl lg:text-6xl font-bold font-heading leading-tight',
+			'headline_id'       => $hero_id,
+			'headline_attrs'    => $headline_attrs,
+			'show_description'  => $view['show_description'] && $view['description'] !== '',
+			'description'       => $view['description'] ?? '',
+			'description_class' => $view['classes']['description'] ?? '',
+			'description_extras'=> 'mt-6 text-lg md:text-xl leading-relaxed',
+		];
+		// ----- Content column ----- ?>
+			<div class="<?php echo esc_attr( $view['content_order'] ); ?>">
+				<?php include $elements_path . '/section-header/templates/render.php'; ?>
+
+				<?php
+				$cta_group = [
+					'show_primary'    => $view['show_cta_primary'] && $view['cta_primary'],
+					'primary'         => $view['cta_primary'] ?? null,
+					'show_secondary'  => $view['show_cta_secondary'] && $view['cta_secondary'],
+					'secondary'       => $view['cta_secondary'] ?? null,
+					'class'           => 'mt-8 flex flex-col sm:flex-row items-start sm:items-center gap-4',
+					'primary_extras'  => 'focus:ring-offset-white dark:focus:ring-offset-neutral-900',
+					'secondary_extras'=> 'focus:ring-offset-white dark:focus:ring-offset-neutral-900',
+					'elements_path'   => $elements_path,
+				];
+				include $elements_path . '/cta-group/templates/render.php';
+				?>
+			</div>
+
+			<?php // ----- Collage column ----- ?>
+			<?php if ( $has_collage ) : ?>
+				<div class="<?php echo esc_attr( $view['media_order'] ); ?>">
+					<div class="grid grid-cols-3 grid-rows-3 gap-3 md:gap-4 aspect-square max-w-lg mx-auto lg:max-w-none">
+						<?php foreach ( $view['collage'] as $item ) : ?>
+							<div class="<?php echo esc_attr( $item['placement'] ); ?> min-h-0 rounded-xl overflow-hidden bg-neutral-200 dark:bg-neutral-800">
+								<?php if ( $item['src'] !== '' ) : ?>
+									<img
+										src="<?php echo esc_url( $item['src'] ); ?>"
+										alt="<?php echo esc_attr( $item['alt'] ); ?>"
+										<?php if ( ! empty( $item['srcset'] ) ) : ?>srcset="<?php echo esc_attr( $item['srcset'] ); ?>"<?php endif; ?>
+										<?php if ( ! empty( $item['sizes'] ) ) : ?>sizes="<?php echo esc_attr( $item['sizes'] ); ?>"<?php endif; ?>
+										<?php if ( ! empty( $item['width'] ) ) : ?>width="<?php echo esc_attr( $item['width'] ); ?>"<?php endif; ?>
+										<?php if ( ! empty( $item['height'] ) ) : ?>height="<?php echo esc_attr( $item['height'] ); ?>"<?php endif; ?>
+										loading="<?php echo esc_attr( $item['loading'] ); ?>"
+										decoding="async"
+										class="w-full h-full object-cover"
+									/>
+								<?php endif; ?>
+							</div>
+						<?php endforeach; ?>
+					</div>
+				</div>
+			<?php endif; ?>
+		</div>
+	</div>
+</section>
+
+<?php // ========== HERO COLLAGE END ========== ?>

package/packages/widgets/hero-overlay/data/view.php

@@ -0,0 +1,117 @@
+<?php
+/**
+ * Data Preparation: Hero Overlay
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Hero Overlay widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID
+ * @return array Template-ready data
+ */
+function prepare_hero_overlay_view( array $settings, string $widget_id ): array {
+	$raw_slides = $settings['slides'] ?? [];
+	$slides     = sociallane_process_repeater( $raw_slides, function ( $slide, $index ) {
+		$image = sociallane_prepare_image_data(
+			isset( $slide['image'] ) && is_array( $slide['image'] ) ? $slide['image'] : [],
+			[
+				'alt'        => $slide['image_alt'] ?? '',
+				'sizes'      => '100vw',
+				'loading'    => $index === 0 ? 'eager' : 'lazy',
+				'image_size' => 'full',
+			]
+		);
+
+		$cta = null;
+		if ( ! empty( trim( $slide['cta_text'] ?? '' ) ) && function_exists( 'sociallane_prepare_button_data' ) ) {
+			$cta = sociallane_prepare_button_data(
+				$slide['cta_text'] ?? '',
+				$slide['cta_url'] ?? [],
+				[ 'preset' => $slide['cta_style'] ?? 'primary' ]
+			);
+		}
+
+		$headline_tag = sociallane_validate_option( $slide['headline_tag'] ?? 'h1', [ 'h1', 'h2', 'h3' ], 'h1' );
+
+		return [
+			'image'        => $image,
+			'eyebrow'      => esc_html( $slide['eyebrow'] ?? '' ),
+			'headline'     => esc_html( $slide['headline'] ?? '' ),
+			'headline_tag' => $headline_tag,
+			'cta'          => $cta,
+		];
+	} );
+
+	// Ensure at least one slide for backward compatibility
+	if ( empty( $slides ) ) {
+		$slides[] = [
+			'image'        => sociallane_prepare_image_data( [ 'url' => '' ], [ 'alt' => '', 'sizes' => '100vw', 'loading' => 'eager', 'image_size' => 'full' ] ),
+			'eyebrow'      => '',
+			'headline'     => '',
+			'headline_tag' => 'h1',
+			'cta'          => null,
+		];
+	}
+
+	$layout = sociallane_validate_option( $settings['layout'] ?? 'slider', [ 'single', 'slider' ], 'slider' );
+	$is_slider = $layout === 'slider' && count( $slides ) > 1;
+	$min_height = $settings['min_height'] ?? '70vh';
+	$show_nav   = $is_slider && sociallane_show_field( $settings, 'show_nav_arrows' );
+	$autoplay    = $is_slider && sociallane_show_field( $settings, 'autoplay' );
+	$autoplay_delay = (int) ( $settings['autoplay_delay'] ?? 5 );
+	if ( $autoplay_delay < 2 ) {
+		$autoplay_delay = 2;
+	}
+
+	// When single layout, only use first slide for display (template will render one slide)
+	$display_slides = $layout === 'single' ? array_slice( $slides, 0, 1 ) : $slides;
+
+	// Anchor button: right-aligned in blur bar, links to #section-id (optional)
+	$show_anchor = sociallane_show_field( $settings, 'show_anchor_button', 'no' );
+	$anchor_text = $show_anchor ? trim( $settings['anchor_text'] ?? '' ) : '';
+	$anchor_href = '#';
+	if ( $show_anchor && ! empty( trim( $settings['anchor_url']['url'] ?? '' ) ) ) {
+		$raw = trim( $settings['anchor_url']['url'] );
+		if ( strpos( $raw, '#' ) === 0 ) {
+			$anchor_href = $raw !== '#' ? $raw : '#';
+		} else {
+			$parsed = wp_parse_url( $raw );
+			$anchor_href = ( isset( $parsed['fragment'] ) && $parsed['fragment'] !== '' ) ? '#' . $parsed['fragment'] : '#' . $raw;
+		}
+	}
+	$anchor_button = ( $show_anchor && $anchor_text !== '' )
+		? [ 'text' => esc_html( $anchor_text ), 'url' => esc_attr( $anchor_href ) ]
+		: null;
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true ] );
+
+	$classes = [
+		'eyebrow'    => 'text-primary dark:text-primary-light',
+		'headline'   => 'text-white dark:text-white',
+		'overlay'    => 'bg-neutral-900/60 dark:bg-neutral-950/70',
+		'bar_bg'     => 'bg-neutral-900/50 dark:bg-neutral-950/60 border-t border-white/5 backdrop-blur-xl',
+		'cta_bar'    => 'inline-flex items-center justify-center gap-2 rounded-full px-6 py-3.5 text-base font-semibold text-white bg-emerald-500 hover:bg-emerald-600 focus:outline-none focus:ring-2 focus:ring-emerald-400 focus:ring-offset-2 focus:ring-offset-neutral-900 dark:focus:ring-offset-neutral-950 transition-colors no-underline',
+		'anchor_btn' => 'inline-flex items-center justify-center gap-2 rounded-full px-6 py-3.5 text-base font-semibold text-white bg-transparent border-2 border-white/90 hover:bg-white/10 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-neutral-900 dark:focus:ring-offset-neutral-950 transition-colors no-underline shrink-0',
+		'nav_btn'    => 'text-white hover:text-white/90 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-neutral-900 dark:focus:ring-offset-neutral-950 rounded-full p-2 transition-colors',
+	];
+
+	return [
+		'slides'          => $display_slides,
+		'is_slider'       => $is_slider,
+		'show_nav_arrows' => $show_nav,
+		'autoplay'        => $autoplay,
+		'autoplay_delay'  => $autoplay_delay,
+		'anchor_button'   => $anchor_button,
+		'min_height'     => $min_height,
+		'classes'        => $classes,
+		'widget_id'      => $widget_id,
+		'animation'      => $animation,
+	];
+}

package/packages/widgets/hero-overlay/hero-overlay.php

@@ -0,0 +1,277 @@
+<?php
+/**
+ * Widget: Hero Overlay
+ *
+ * Hero with full-width background image, dark overlay, and left-aligned content
+ * (eyebrow, headline, CTA). Supports multiple slides via repeater; nav arrows in backdrop bar.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+use Elementor\Widget_Base;
+use Elementor\Controls_Manager;
+use Elementor\Repeater;
+use SocialLane\Elements\Traits\Animation_Controls;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Hero Overlay Widget
+ */
+class Hero_Overlay extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'hero-overlay';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'Hero Overlay', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-cover-image';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-heroes' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'hero', 'overlay', 'banner', 'headline', 'cta', 'slider', 'carousel' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_slides_section();
+		$this->register_slider_section();
+		$this->register_anchor_section();
+		$this->register_animation_controls( true );
+	}
+
+	private function register_slides_section(): void {
+		$this->start_controls_section(
+			'section_slides',
+			[
+				'label' => esc_html__( 'Slides', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$repeater = new Repeater();
+
+		$repeater->add_control(
+			'image',
+			[
+				'label'   => esc_html__( 'Background Image', 'sociallane-elements' ),
+				'type'    => Controls_Manager::MEDIA,
+				'default' => [ 'url' => \Elementor\Utils::get_placeholder_image_src() ],
+			]
+		);
+		$repeater->add_control(
+			'image_alt',
+			[
+				'label'       => esc_html__( 'Image Alt Text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'description' => esc_html__( 'Required for accessibility', 'sociallane-elements' ),
+			]
+		);
+		$repeater->add_control(
+			'eyebrow',
+			[
+				'label'       => esc_html__( 'Eyebrow', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+			]
+		);
+		$repeater->add_control(
+			'headline',
+			[
+				'label'       => esc_html__( 'Headline', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+			]
+		);
+		$repeater->add_control(
+			'headline_tag',
+			[
+				'label'   => esc_html__( 'Headline Tag', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'h1',
+				'options' => [ 'h1' => 'H1', 'h2' => 'H2', 'h3' => 'H3' ],
+			]
+		);
+		$repeater->add_control(
+			'cta_text',
+			[
+				'label'       => esc_html__( 'Button Text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+			]
+		);
+		$repeater->add_control(
+			'cta_url',
+			[
+				'label' => esc_html__( 'Button URL', 'sociallane-elements' ),
+				'type'  => Controls_Manager::URL,
+			]
+		);
+		$repeater->add_control(
+			'cta_style',
+			[
+				'label'   => esc_html__( 'Button Style', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'primary',
+				'options' => function_exists( 'sociallane_get_button_preset_options' ) ? sociallane_get_button_preset_options() : [ 'primary' => 'Primary', 'secondary' => 'Secondary' ],
+			]
+		);
+
+		$this->add_control(
+			'slides',
+			[
+				'label'       => esc_html__( 'Slides', 'sociallane-elements' ),
+				'type'        => Controls_Manager::REPEATER,
+				'fields'      => $repeater->get_controls(),
+				'default'     => [
+					[
+						'image'       => [ 'url' => \Elementor\Utils::get_placeholder_image_src() ],
+						'eyebrow'     => '',
+						'headline'    => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+						'headline_tag'=> 'h1',
+						'cta_text'    => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+						'cta_style'   => 'primary',
+					],
+				],
+				'title_field' => '{{{ headline }}}',
+			]
+		);
+
+		$this->add_control(
+			'min_height',
+			[
+				'label'   => esc_html__( 'Minimum Height', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => '70vh',
+				'options' => [
+					'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();
+	}
+
+	private function register_slider_section(): void {
+		$this->start_controls_section(
+			'section_slider',
+			[
+				'label' => esc_html__( 'Layout & Slider', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'layout',
+			[
+				'label'   => esc_html__( 'Layout', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => 'slider',
+				'options' => [
+					'slider' => esc_html__( 'Slider', 'sociallane-elements' ),
+					'single' => esc_html__( 'Single (no slides)', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->add_control(
+			'show_nav_arrows',
+			[
+				'label'     => esc_html__( 'Show navigation arrows', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SWITCHER,
+				'default'   => 'yes',
+				'condition' => [ 'layout' => 'slider' ],
+			]
+		);
+		$this->add_control(
+			'autoplay',
+			[
+				'label'     => esc_html__( 'Autoplay', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SWITCHER,
+				'default'   => '',
+				'condition' => [ 'layout' => 'slider' ],
+			]
+		);
+		$this->add_control(
+			'autoplay_delay',
+			[
+				'label'     => esc_html__( 'Autoplay delay (seconds)', 'sociallane-elements' ),
+				'type'      => Controls_Manager::NUMBER,
+				'default'   => 5,
+				'min'       => 2,
+				'max'       => 30,
+				'condition' => [ 'layout' => 'slider', 'autoplay' => 'yes' ],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_anchor_section(): void {
+		$this->start_controls_section(
+			'section_anchor',
+			[
+				'label' => esc_html__( 'Anchor Button', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_anchor_button',
+			[
+				'label'   => esc_html__( 'Show anchor button', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => '',
+			]
+		);
+
+		$this->add_control(
+			'anchor_text',
+			[
+				'label'       => esc_html__( 'Button text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Scroll to section', 'sociallane-elements' ),
+				'placeholder' => esc_html__( 'Scroll to section', 'sociallane-elements' ),
+				'condition'   => [ 'show_anchor_button' => 'yes' ],
+			]
+		);
+
+		$this->add_control(
+			'anchor_url',
+			[
+				'label'       => esc_html__( 'Anchor target', 'sociallane-elements' ),
+				'type'        => Controls_Manager::URL,
+				'placeholder' => '#section-id',
+				'description' => esc_html__( 'Use #section-id to scroll to a section (e.g. #contact). Add a CSS ID to the target section in Elementor.', 'sociallane-elements' ),
+				'condition'   => [ 'show_anchor_button' => 'yes' ],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_hero_overlay_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/packages/widgets/hero-overlay/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@sociallane/widget-hero-overlay",
+  "version": "1.0.0",
+  "private": true,
+  "description": "SocialLane Elements widget: hero-overlay",
+  "peerDependencies": {
+    "@sociallane/core": "^1.0.0"
+  },
+  "scripts": {
+    "build": "echo \"No widget-specific build\""
+  }
+}