@sociallane/elements 1.0.0

package/packages/widgets/social-proof-trust/social-proof-trust.php

@@ -0,0 +1,367 @@
+<?php
+/**
+ * Widget: Social Proof
+ *
+ * A section with a headline, description, and a list of trust-building statistics.
+ * Each stat has an icon, bold number, and descriptive text.
+ * Optional right-side image (e.g. 3D character) for visual balance.
+ *
+ * @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;
+}
+
+/**
+ * Social Proof Widget
+ */
+class Social_Proof_Trust extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'social-proof-trust';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'Social Proof (Trust)', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-counter';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-content' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'social proof', 'stats', 'trust', 'statistics', 'numbers' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_content_section();
+		$this->register_stats_section();
+		$this->register_media_section();
+		$this->register_style_icon_section();
+		$this->register_animation_controls( true, true );
+	}
+
+	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_eyebrow',
+			[
+				'label'   => esc_html__( 'Show eyebrow', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'eyebrow',
+			[
+				'label'       => esc_html__( 'Eyebrow', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Trusted Worldwide', 'sociallane-elements' ),
+				'placeholder' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+			]
+		);
+
+		$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' ),
+				'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->add_control(
+			'link_1_text',
+			[
+				'label'       => esc_html__( 'Link 1 text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Explore Legality Guide', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'link_1_url',
+			[
+				'label'     => esc_html__( 'Link 1 URL', 'sociallane-elements' ),
+				'type'      => Controls_Manager::URL,
+			]
+		);
+
+		$this->add_control(
+			'link_2_text',
+			[
+				'label'       => esc_html__( 'Link 2 text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Visit the Trust Center', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'link_2_url',
+			[
+				'label'     => esc_html__( 'Link 2 URL', 'sociallane-elements' ),
+				'type'      => Controls_Manager::URL,
+			]
+		);
+
+		$this->add_control(
+			'link_1_style',
+			[
+				'label'     => esc_html__( 'Link 1 style', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SELECT,
+				'default'   => 'primary',
+				'options'   => function_exists( 'sociallane_get_button_preset_options' ) ? sociallane_get_button_preset_options() : [
+					'primary'   => esc_html__( 'Primary', 'sociallane-elements' ),
+					'secondary' => esc_html__( 'Secondary', 'sociallane-elements' ),
+					'ghost'     => esc_html__( 'Ghost', 'sociallane-elements' ),
+					'outline'   => esc_html__( 'Outline', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->add_control(
+			'link_2_style',
+			[
+				'label'     => esc_html__( 'Link 2 style', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SELECT,
+				'default'   => 'secondary',
+				'options'   => function_exists( 'sociallane_get_button_preset_options' ) ? sociallane_get_button_preset_options() : [
+					'primary'   => esc_html__( 'Primary', 'sociallane-elements' ),
+					'secondary' => esc_html__( 'Secondary', 'sociallane-elements' ),
+					'ghost'     => esc_html__( 'Ghost', 'sociallane-elements' ),
+					'outline'   => esc_html__( 'Outline', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->add_control(
+			'buttons_layout',
+			[
+				'label'     => esc_html__( 'Buttons layout', 'sociallane-elements' ),
+				'type'      => Controls_Manager::SELECT,
+				'default'   => 'row',
+				'options'   => [
+					'row'    => esc_html__( 'Row', 'sociallane-elements' ),
+					'column' => esc_html__( 'Column', 'sociallane-elements' ),
+				],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_stats_section(): void {
+		$this->start_controls_section(
+			'section_stats',
+			[
+				'label' => esc_html__( 'Stats', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$repeater = new Repeater();
+
+		$repeater->add_control(
+			'icon',
+			[
+				'label'   => esc_html__( 'Icon', 'sociallane-elements' ),
+				'type'    => Controls_Manager::ICONS,
+				'default' => [
+					'value'   => 'eicon-lock-user',
+					'library' => 'elementor',
+				],
+			]
+		);
+
+		$repeater->add_control(
+			'stat',
+			[
+				'label'       => esc_html__( 'Stat', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Lorem', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$repeater->add_control(
+			'description',
+			[
+				'label'   => esc_html__( 'Description', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXT,
+				'default' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'stats',
+			[
+				'label'       => esc_html__( 'Stats', 'sociallane-elements' ),
+				'type'        => Controls_Manager::REPEATER,
+				'fields'      => $repeater->get_controls(),
+				'default'     => [
+					[
+						'stat'        => esc_html__( 'Lorem', 'sociallane-elements' ),
+						'description' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+						'icon'        => [ 'value' => 'eicon-lock-user', 'library' => 'elementor' ],
+					],
+					[
+						'stat'        => esc_html__( 'Lorem', 'sociallane-elements' ),
+						'description' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+						'icon'        => [ 'value' => 'eicon-user-circle-o', 'library' => 'elementor' ],
+					],
+					[
+						'stat'        => esc_html__( 'Lorem', 'sociallane-elements' ),
+						'description' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+						'icon'        => [ 'value' => 'eicon-editor-list-ol', 'library' => 'elementor' ],
+					],
+					[
+						'stat'        => esc_html__( 'Lorem', 'sociallane-elements' ),
+						'description' => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+						'icon'        => [ 'value' => 'eicon-global', 'library' => 'elementor' ],
+					],
+				],
+				'title_field' => '{{{ stat }}}',
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_media_section(): void {
+		$this->start_controls_section(
+			'section_media',
+			[
+				'label' => esc_html__( 'Media', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_image',
+			[
+				'label'   => esc_html__( 'Show Image', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => '',
+			]
+		);
+
+		$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_style_icon_section(): void {
+		$this->start_controls_section(
+			'section_style_icon',
+			[
+				'label' => esc_html__( 'Stat icons', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_STYLE,
+			]
+		);
+
+		$this->add_control(
+			'icon_color',
+			[
+				'label'     => esc_html__( 'Icon color', 'sociallane-elements' ),
+				'type'      => Controls_Manager::COLOR,
+				'selectors' => [
+					'{{WRAPPER}} .social-proof-stat-icon' => 'color: {{VALUE}};',
+					'{{WRAPPER}} .social-proof-stat-icon .e-icon' => 'color: {{VALUE}};',
+					'{{WRAPPER}} .social-proof-stat-icon svg' => 'fill: {{VALUE}}; stroke: {{VALUE}};',
+				],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_social_proof_trust_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/packages/widgets/social-proof-trust/templates/partials/layout-trust.php

@@ -0,0 +1,73 @@
+<?php
+/**
+ * Partial: Social Proof – Trust layout
+ *
+ * Two columns: left = eyebrow, headline, description, primary + secondary buttons;
+ * right = 2×2 grid of stat cards.
+ * Expects $view with layout, eyebrow, headline, description, links, buttons_layout, stats, classes, widget_id.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $view ) || ( $view['layout'] ?? '' ) !== 'trust' ) {
+	return;
+}
+
+$section_id  = 'social-proof-' . $view['widget_id'];
+$has_heading = ( $view['show_eyebrow'] && $view['eyebrow'] !== '' ) || ( $view['show_headline'] && $view['headline'] !== '' ) || ( $view['show_description'] && $view['description'] !== '' );
+$has_links   = ! empty( $view['links'] );
+$has_stats   = ! empty( $view['stats'] );
+$elements_path = SOCIALLANE_ELEMENTS_PATH . 'elements';
+$cls = $view['classes'];
+?>
+<div class="grid grid-cols-1 lg:grid-cols-2 gap-10 lg:gap-16 items-center">
+	<?php // ----- Left: eyebrow, headline, description, links ----- ?>
+	<div class="lg:max-w-xl">
+		<header class="<?php echo $has_heading ? '' : 'sr-only'; ?>" id="<?php echo esc_attr( $section_id ); ?>">
+			<?php if ( $view['show_eyebrow'] && $view['eyebrow'] !== '' ) : ?>
+				<p class="<?php echo esc_attr( $cls['eyebrow'] ?? '' ); ?> text-sm text-blue-chill-200 font-normal uppercase tracking-wider mb-3">
+					<?php echo $view['eyebrow']; ?>
+				</p>
+			<?php endif; ?>
+
+			<?php if ( $view['show_headline'] && $view['headline'] !== '' ) : ?>
+				<<?php echo $view['headline_tag']; ?>
+					class="<?php echo esc_attr( $cls['headline'] ?? '' ); ?> text-3xl sm:text-4xl md:text-5xl font-bold font-heading"
+					<?php echo ! empty( $headline_attrs ) ? ' ' . $headline_attrs : ''; ?>
+				>
+					<?php echo $view['headline']; ?>
+				</<?php echo $view['headline_tag']; ?>>
+			<?php endif; ?>
+
+			<?php if ( $view['show_description'] && $view['description'] !== '' ) : ?>
+				<p class="<?php echo esc_attr( $cls['description'] ?? '' ); ?> mt-4 text-lg md:text-xl text-blue-chill-200 leading-relaxed">
+					<?php echo $view['description']; ?>
+				</p>
+			<?php endif; ?>
+		</header>
+
+		<?php if ( $has_links ) : ?>
+			<?php
+			$buttons_dir = ( $view['buttons_layout'] ?? 'row' ) === 'column' ? 'flex-col' : 'flex-row flex-wrap';
+			?>
+			<div class="mt-8 flex <?php echo esc_attr( $buttons_dir ); ?> gap-4">
+				<?php foreach ( $view['links'] as $button ) : ?>
+					<?php include $elements_path . '/button/templates/render.php'; ?>
+				<?php endforeach; ?>
+			</div>
+		<?php endif; ?>
+	</div>
+
+	<?php // ----- Right: 2×2 stats grid ----- ?>
+	<?php if ( $has_stats ) : ?>
+		<div class="grid grid-cols-1 sm:grid-cols-2 gap-6 md:gap-8"<?php echo ! empty( $stagger_attrs ) ? ' ' . $stagger_attrs : ''; ?>>
+			<?php foreach ( $view['stats'] as $stat ) : ?>
+				<?php include __DIR__ . '/stat-card.php'; ?>
+			<?php endforeach; ?>
+		</div>
+	<?php endif; ?>
+</div>

package/packages/widgets/social-proof-trust/templates/partials/stat-card.php

@@ -0,0 +1,32 @@
+<?php
+/**
+ * Partial: Social Proof – stat card (for trust layout 2×2 grid)
+ *
+ * Expects $stat (icon, stat, description) and $view['classes'] (stat_value, stat_desc, icon).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $stat ) ) {
+	return;
+}
+
+$classes = $view['classes'] ?? [];
+?>
+<div class="flex flex-col gap-3">
+	<?php if ( ! empty( $stat['icon']['value'] ) ) : ?>
+		<div class="social-proof-stat-icon <?php echo esc_attr( $classes['icon'] ?? 'text-blue-chill-600' ); ?> shrink-0 [&_.e-icon]:w-8 [&_.e-icon]:h-8 [&_svg]:fill-current" aria-hidden="true">
+			<?php \Elementor\Icons_Manager::render_icon( $stat['icon'], [ 'aria-hidden' => 'true', 'class' => 'w-8 h-8' ] ); ?>
+		</div>
+	<?php endif; ?>
+	<?php if ( ! empty( $stat['stat'] ) ) : ?>
+		<span class="<?php echo esc_attr( $classes['stat_value'] ?? '' ); ?> font-bold text-lg md:text-2xl"><?php echo $stat['stat']; ?></span>
+	<?php endif; ?>
+	<?php if ( ! empty( $stat['description'] ) ) : ?>
+		<span class="<?php echo esc_attr( $classes['stat_desc'] ?? '' ); ?> text-sm md:text-base"><?php echo $stat['description']; ?></span>
+	<?php endif; ?>
+</div>

package/packages/widgets/social-proof-trust/templates/partials/stat-item.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Partial: Social Proof – single stat item
+ *
+ * Expects $stat (icon, stat, description) and $view['classes'] (stat_value, stat_desc, icon).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $stat ) ) {
+	return;
+}
+
+$classes = $view['classes'] ?? [];
+?>
+<li class="flex gap-4">
+	<?php if ( ! empty( $stat['icon']['value'] ) ) : ?>
+		<div class="social-proof-stat-icon <?php echo esc_attr( $classes['icon'] ?? 'text-primary' ); ?> shrink-0 [&_.e-icon]:w-6 [&_.e-icon]:h-6 mt-0.5 [&_svg]:fill-current" aria-hidden="true">
+			<?php \Elementor\Icons_Manager::render_icon( $stat['icon'], [ 'aria-hidden' => 'true', 'class' => 'w-6 h-6' ] ); ?>
+		</div>
+	<?php endif; ?>
+
+	<div>
+		<?php if ( ! empty( $stat['stat'] ) ) : ?>
+			<span class="<?php echo esc_attr( $classes['stat_value'] ?? '' ); ?> font-bold text-lg md:text-xl"><?php echo $stat['stat']; ?></span><?php echo ! empty( $stat['description'] ) ? ' ' : ''; ?>
+		<?php endif; ?>
+		<?php if ( ! empty( $stat['description'] ) ) : ?>
+			<span class="<?php echo esc_attr( $classes['stat_desc'] ?? '' ); ?> text-base md:text-lg"><?php echo $stat['description']; ?></span>
+		<?php endif; ?>
+	</div>
+</li>

package/packages/widgets/social-proof-trust/templates/wrapper.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * Template: Social Proof Wrapper
+ *
+ * AVAILABLE DATA ($view):
+ * - layout ('default' | 'trust')
+ * - show_headline, show_description, show_image, show_eyebrow (trust)
+ * - headline, headline_tag, description, eyebrow
+ * - links (trust: button data), stats, image
+ * - 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 );
+$section_id = 'social-proof-' . $view['widget_id'];
+$has_heading = ( $view['show_headline'] && ! empty( $view['headline'] ) ) || ( $view['show_description'] && ! empty( $view['description'] ) )
+	|| ( $view['show_eyebrow'] && ! empty( $view['eyebrow'] ) );
+$has_stats   = ! empty( $view['stats'] );
+$has_image   = $view['show_image'] && ! empty( $view['image']['src'] );
+
+$elements_path = SOCIALLANE_ELEMENTS_PATH . 'elements';
+?>
+
+<?php // ========== SOCIAL PROOF 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">
+		<?php $stagger_attrs = sociallane_stagger_attrs( $anim ); ?>
+		<?php include __DIR__ . '/partials/layout-trust.php'; ?>
+	</div>
+</section>
+
+<?php // ========== SOCIAL PROOF END ========== ?>

package/packages/widgets/testimonial-quote/data/view.php

@@ -0,0 +1,57 @@
+<?php
+/**
+ * Data Preparation: Testimonial Quote
+ *
+ * Builds template-ready $view: quote, author (icon + name), layout,
+ * optional pattern, and theme classes (light + dark).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Testimonial Quote widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID
+ * @return array Template-ready data
+ */
+function prepare_testimonial_quote_view( array $settings, string $widget_id ): array {
+	$fields       = sociallane_extract_fields( $settings, [
+		'quote'      => [ 'show_key' => 'show_quote', 'sanitize' => 'wp_kses_post' ],
+		'author_name' => [ 'show_key' => 'show_author' ],
+	] );
+	$author_icon  = ( $fields['show_author_name'] ?? false ) ? ( $settings['author_icon'] ?? null ) : null;
+	$show_pattern = ( $settings['show_pattern'] ?? 'yes' ) === 'yes';
+	$content_width = sociallane_validate_option( $settings['content_width'] ?? 'medium', [ 'narrow', 'medium', 'wide', 'full' ], 'medium' );
+	$width_classes = [
+		'narrow' => 'max-w-2xl',
+		'medium' => 'max-w-3xl',
+		'wide'   => 'max-w-4xl',
+		'full'   => 'max-w-full',
+	];
+	$content_width_class = $width_classes[ $content_width ] ?? $width_classes['medium'];
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true ] );
+	$classes = [
+		'section'    => 'bg-neutral-100 dark:bg-neutral-800',
+		'quote'      => 'text-neutral-900 dark:text-white',
+		'author_name'=> 'text-neutral-900 dark:text-white',
+		'pattern'    => 'sl-bg-pattern-intro',
+	];
+	if ( ! $show_pattern ) {
+		$classes['pattern'] = '';
+	}
+
+	return array_merge( $fields, [
+		'show_author'        => $fields['show_author_name'] ?? false,
+		'author_icon'        => $author_icon,
+		'content_width_class'=> $content_width_class,
+		'classes'             => $classes,
+		'widget_id'           => $widget_id,
+		'animation'           => $animation,
+	] );
+}

package/packages/widgets/testimonial-quote/package.json

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