@sociallane/elements 1.0.0

package/widgets/form-contact/templates/partials/testimonial.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * Template Partial: Contact Form Testimonial
+ *
+ * Brand icon + name, quote, author avatar + name + role.
+ * Uses $view from parent wrapper.
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $view ) ) {
+	return;
+}
+
+$classes = $view['classes'] ?? [];
+?>
+
+<?php // ----- Testimonial start ----- ?>
+
+<aside class="flex flex-col gap-6 md:gap-8" aria-label="<?php esc_attr_e( 'Testimonial', 'sociallane-elements' ); ?>">
+	<?php if ( ! empty( $view['brand_icon']['src'] ) || ! empty( $view['brand_name'] ) ) : ?>
+		<div class="flex items-center gap-3">
+			<?php if ( ! empty( $view['brand_icon']['src'] ) ) : ?>
+				<img
+					src="<?php echo esc_url( $view['brand_icon']['src'] ); ?>"
+					alt="<?php echo esc_attr( $view['brand_icon']['alt'] ); ?>"
+					<?php if ( ! empty( $view['brand_icon']['width'] ) ) : ?>width="<?php echo esc_attr( $view['brand_icon']['width'] ); ?>"<?php endif; ?>
+					<?php if ( ! empty( $view['brand_icon']['height'] ) ) : ?>height="<?php echo esc_attr( $view['brand_icon']['height'] ); ?>"<?php endif; ?>
+					loading="lazy"
+					decoding="async"
+					class="h-8 w-auto object-contain shrink-0"
+				/>
+			<?php endif; ?>
+			<?php if ( ! empty( $view['brand_name'] ) ) : ?>
+				<span class="<?php echo esc_attr( $classes['brand_name'] ?? '' ); ?> text-lg font-semibold font-heading">
+					<?php echo $view['brand_name']; ?>
+				</span>
+			<?php endif; ?>
+		</div>
+	<?php endif; ?>
+
+	<?php if ( ! empty( $view['quote'] ) ) : ?>
+		<blockquote class="<?php echo esc_attr( $classes['quote'] ?? '' ); ?> text-lg md:text-xl leading-relaxed">
+			&quot;<?php echo $view['quote']; ?>&quot;
+		</blockquote>
+	<?php endif; ?>
+
+	<?php if ( ! empty( $view['author_avatar']['src'] ) || ! empty( $view['author_name'] ) || ! empty( $view['author_role'] ) ) : ?>
+		<footer class="flex items-center gap-4">
+			<?php if ( ! empty( $view['author_avatar']['src'] ) ) : ?>
+				<img
+					src="<?php echo esc_url( $view['author_avatar']['src'] ); ?>"
+					alt="<?php echo esc_attr( $view['author_avatar']['alt'] ?? '' ); ?>"
+					<?php if ( ! empty( $view['author_avatar']['srcset'] ) ) : ?>srcset="<?php echo esc_attr( $view['author_avatar']['srcset'] ); ?>"<?php endif; ?>
+					<?php if ( ! empty( $view['author_avatar']['sizes'] ) ) : ?>sizes="<?php echo esc_attr( $view['author_avatar']['sizes'] ); ?>"<?php endif; ?>
+					<?php if ( ! empty( $view['author_avatar']['width'] ) ) : ?>width="<?php echo esc_attr( $view['author_avatar']['width'] ); ?>"<?php endif; ?>
+					<?php if ( ! empty( $view['author_avatar']['height'] ) ) : ?>height="<?php echo esc_attr( $view['author_avatar']['height'] ); ?>"<?php endif; ?>
+					loading="lazy"
+					decoding="async"
+					class="size-12 md:size-14 rounded-full object-cover shrink-0"
+				/>
+			<?php endif; ?>
+			<div class="min-w-0">
+				<?php if ( ! empty( $view['author_name'] ) ) : ?>
+					<p class="<?php echo esc_attr( $classes['author_name'] ?? '' ); ?> font-semibold text-base">
+						<?php echo $view['author_name']; ?>
+					</p>
+				<?php endif; ?>
+				<?php if ( ! empty( $view['author_role'] ) ) : ?>
+					<p class="<?php echo esc_attr( $classes['author_role'] ?? '' ); ?> text-sm mt-0.5">
+						<?php echo $view['author_role']; ?>
+					</p>
+				<?php endif; ?>
+			</div>
+		</footer>
+	<?php endif; ?>
+</aside>
+
+<?php // ----- Testimonial end ----- ?>

package/widgets/form-contact/templates/wrapper.php

@@ -0,0 +1,98 @@
+<?php
+/**
+ * Template: Contact Form Wrapper
+ *
+ * Two columns: left = headline, description, Gravity Forms shortcode (sl-contact-form),
+ * privacy; right = optional testimonial (brand, quote, author).
+ *
+ * AVAILABLE DATA ($view):
+ * - show_headline, show_description, show_testimonial, show_privacy
+ * - headline, headline_tag, description, form_shortcode
+ * - privacy_text, privacy_link_text, privacy_href, privacy_attrs
+ * - brand_icon, brand_name, quote, author_avatar, author_name, author_role
+ * - 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  = 'form-contact-' . $view['widget_id'];
+$has_heading = ( $view['show_headline'] && ! empty( $view['headline'] ) ) || ( $view['show_description'] && ! empty( $view['description'] ) );
+$has_form    = ! empty( $view['form_shortcode'] );
+$has_privacy  = $view['show_privacy'] && ( ! empty( $view['privacy_text'] ) || ! empty( $view['privacy_link_text'] ) );
+$has_testimonial = $view['show_testimonial'] && ( ! empty( $view['quote'] ) || ! empty( $view['brand_name'] ) || ! empty( $view['author_name'] ) );
+?>
+
+<?php // ========== CONTACT FORM 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="grid grid-cols-1 lg:grid-cols-2 gap-10 lg:gap-14 xl:gap-20 items-start max-w-full mx-auto">
+			<?php // ----- Left column: headline, description, form, privacy ----- ?>
+			<div class="min-w-0">
+				<?php if ( $has_heading ) : ?>
+					<header class="mb-8 md:mb-10" 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-3xl sm:text-4xl md:text-5xl 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-contact-form mb-6">
+						<?php echo do_shortcode( $view['form_shortcode'] ); ?>
+					</div>
+				<?php endif; ?>
+
+				<?php if ( $has_privacy ) : ?>
+					<p class="<?php echo esc_attr( $view['classes']['privacy'] ); ?> text-sm md:text-base mt-4">
+						<?php if ( ! empty( $view['privacy_text'] ) ) : ?>
+							<?php echo $view['privacy_text']; ?>
+							<?php if ( ! empty( $view['privacy_link_text'] ) ) : ?> <?php endif; ?>
+						<?php endif; ?>
+						<?php if ( ! empty( $view['privacy_link_text'] ) ) : ?>
+							<a
+								href="<?php echo esc_url( $view['privacy_href'] ); ?>"
+								<?php echo $view['privacy_attrs']; ?>
+								class="<?php echo esc_attr( $view['classes']['privacy_link'] ); ?> inline-block"
+							>
+								<?php echo $view['privacy_link_text']; ?>
+							</a>
+						<?php endif; ?>
+					</p>
+				<?php endif; ?>
+			</div>
+
+			<?php // ----- Right column: testimonial ----- ?>
+			<?php if ( $has_testimonial ) : ?>
+				<div class="min-w-0">
+					<?php include __DIR__ . '/partials/testimonial.php'; ?>
+				</div>
+			<?php endif; ?>
+		</div>
+	</div>
+</section>
+
+<?php // ========== CONTACT FORM END ========== ?>

package/widgets/grid-case-studies/data/view.php

@@ -0,0 +1,88 @@
+<?php
+/**
+ * Data Preparation: Grid Case Studies
+ *
+ * Builds template-ready $view: header, cards (icon, year, label, title,
+ * description, link), layout, and theme classes (light + dark).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Grid Case Studies widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID
+ * @return array Template-ready data
+ */
+function prepare_grid_case_studies_view( array $settings, string $widget_id ): array {
+	$show_headline    = sociallane_show_field( $settings, 'show_headline' );
+	$show_description = sociallane_show_field( $settings, 'show_description' );
+	$headline         = $show_headline ? wp_kses_post( $settings['headline'] ?? '' ) : '';
+	$description      = $show_description ? wp_kses_post( $settings['description'] ?? '' ) : '';
+	$headline_tag     = sociallane_validate_heading_tag( $settings );
+
+	$columns    = in_array( $settings['columns'] ?? '3', [ '2', '3' ], true ) ? $settings['columns'] : '3';
+	$grid_class = $columns === '2'
+		? 'grid-cols-1 md:grid-cols-2'
+		: 'grid-cols-1 md:grid-cols-3';
+
+	$cards = [];
+	foreach ( $settings['cards'] ?? [] as $item ) {
+		$link_data = $item['link_url'] ?? [];
+		$href      = isset( $link_data['url'] ) && $link_data['url'] !== '' ? esc_url( $link_data['url'] ) : null;
+		$attrs     = [];
+		if ( $href !== null ) {
+			if ( ! empty( $link_data['is_external'] ) ) {
+				$attrs[] = 'target="_blank"';
+				$attrs[] = 'rel="noopener noreferrer"';
+			}
+			if ( ! empty( $link_data['nofollow'] ) ) {
+				$attrs[] = 'rel="nofollow"';
+			}
+		}
+		$show_link = ( $item['show_link'] ?? 'no' ) === 'yes';
+		$link_text = $show_link ? trim( $item['link_text'] ?? '' ) : '';
+		$cards[]   = [
+			'icon'        => $item['icon'] ?? null,
+			'year'        => esc_html( $item['year'] ?? '' ),
+			'label'       => esc_html( $item['label'] ?? '' ),
+			'title'       => esc_html( $item['title'] ?? '' ),
+			'description' => wp_kses_post( $item['card_description'] ?? '' ),
+			'show_link'   => $show_link && $link_text !== '' && $href !== null,
+			'link_text'   => esc_html( $link_text ),
+			'link_url'    => $href !== null ? $href : '',
+			'link_attrs'  => implode( ' ', $attrs ),
+		];
+	}
+
+	$animation = sociallane_animation_view_data( $settings, [ 'headline' => true, 'stagger' => true ] );
+	$classes = [
+		'section'     => 'bg-white dark:bg-neutral-900',
+		'headline'    => 'text-neutral-900 dark:text-white',
+		'description' => 'text-neutral-600 dark:text-neutral-300',
+		'card_bg'     => 'bg-white dark:bg-neutral-800 border border-neutral-200 dark:border-neutral-700 rounded-xl shadow-sm',
+		'icon_box'    => 'bg-neutral-900 dark:bg-neutral-800 text-white rounded-full shrink-0',
+		'meta'        => 'text-neutral-600 dark:text-neutral-400',
+		'title'       => 'text-neutral-900 dark:text-white',
+		'card_desc'   => 'text-neutral-600 dark:text-neutral-300',
+		'link'        => 'text-neutral-900 dark:text-white hover:underline focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2 rounded',
+	];
+
+	return [
+		'show_headline'    => $show_headline,
+		'show_description' => $show_description,
+		'headline'         => $headline,
+		'headline_tag'     => $headline_tag,
+		'description'      => $description,
+		'cards'            => $cards,
+		'grid_class'       => $grid_class,
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+	];
+}

package/widgets/grid-case-studies/grid-case-studies.php

@@ -0,0 +1,262 @@
+<?php
+/**
+ * Widget: Grid Case Studies
+ *
+ * Section with headline, intro paragraph, and a grid of case study cards.
+ * Each card: icon in black circle, year/label metadata, title, description, optional link.
+ *
+ * @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;
+}
+
+/**
+ * Grid Case Studies Widget
+ */
+class Grid_Case_Studies extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'grid-case-studies';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'Case Studies Grid', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-gallery-grid';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-cards' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'case study', 'grid', 'cards', 'features', 'work' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_header_section();
+		$this->register_cards_section();
+		$this->register_layout_section();
+		$this->register_animation_controls( true, true );
+	}
+
+	private function register_header_section(): void {
+		$this->start_controls_section(
+			'section_header',
+			[
+				'label' => esc_html__( 'Header', '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::TEXTAREA,
+				'default'     => esc_html__( 'Harnessing technology for a brighter future', 'sociallane-elements' ),
+				'rows'        => 2,
+				'condition'   => [ 'show_headline' => 'yes' ],
+			]
+		);
+		$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' ],
+				'condition' => [ 'show_headline' => 'yes' ],
+			]
+		);
+		$this->add_control(
+			'show_description',
+			[
+				'label'   => esc_html__( 'Show intro text', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+		$this->add_control(
+			'description',
+			[
+				'label'       => esc_html__( 'Intro text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXTAREA,
+				'default'     => esc_html__( "We believe technology is the answer to the world's greatest challenges. It's also the cause, so we find ourselves in bit of a catch 22 situation.", 'sociallane-elements' ),
+				'rows'        => 3,
+				'condition'   => [ 'show_description' => 'yes' ],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_cards_section(): void {
+		$this->start_controls_section(
+			'section_cards',
+			[
+				'label' => esc_html__( 'Cards', '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-document-file',
+					'library' => 'elementor',
+				],
+			]
+		);
+		$repeater->add_control(
+			'year',
+			[
+				'label'   => esc_html__( 'Year', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXT,
+				'default' => '2023',
+			]
+		);
+		$repeater->add_control(
+			'label',
+			[
+				'label'   => esc_html__( 'Label', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXT,
+				'default' => esc_html__( 'Case study', 'sociallane-elements' ),
+			]
+		);
+		$repeater->add_control(
+			'title',
+			[
+				'label'       => esc_html__( 'Title', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Lorem ipsum dolor sit amet', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+		$repeater->add_control(
+			'card_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' ),
+			]
+		);
+		$repeater->add_control(
+			'show_link',
+			[
+				'label'   => esc_html__( 'Show link', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'no',
+			]
+		);
+		$repeater->add_control(
+			'link_text',
+			[
+				'label'       => esc_html__( 'Link text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'placeholder' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+				'condition'   => [ 'show_link' => 'yes' ],
+			]
+		);
+		$repeater->add_control(
+			'link_url',
+			[
+				'label'     => esc_html__( 'Link URL', 'sociallane-elements' ),
+				'type'      => Controls_Manager::URL,
+				'condition' => [ 'show_link' => 'yes' ],
+			]
+		);
+
+		$default_cards = [
+			[
+				'year'             => '2023',
+				'label'            => esc_html__( 'Case study', 'sociallane-elements' ),
+				'title'            => 'Skip the bank, borrow from those you trust',
+				'card_description' => 'FamilyFund is a crowdfunding platform for friends and family. Allowing users to take personal loans from their network without a traditional financial institution.',
+			],
+			[
+				'year'             => '2022',
+				'label'            => esc_html__( 'Case study', 'sociallane-elements' ),
+				'title'            => 'Get a hodl of your health',
+				'card_description' => 'Unseal is the first NFT platform where users can mint and trade NFTs of their own personal health records, allowing them to take control of their data.',
+			],
+			[
+				'year'             => '2022',
+				'label'            => esc_html__( 'Case study', 'sociallane-elements' ),
+				'title'            => 'Overcome your fears, find your match',
+				'card_description' => 'Find love in the face of fear - Phobia is a dating app that matches users based on their mutual phobias so they can be scared together.',
+			],
+		];
+		foreach ( $default_cards as $i => $row ) {
+			$default_cards[ $i ]['icon'] = [ 'value' => 'eicon-document-file', 'library' => 'elementor' ];
+		}
+
+		$this->add_control(
+			'cards',
+			[
+				'label'       => esc_html__( 'Cards', 'sociallane-elements' ),
+				'type'        => Controls_Manager::REPEATER,
+				'fields'      => $repeater->get_controls(),
+				'default'     => $default_cards,
+				'title_field' => '{{{ title }}}',
+			]
+		);
+
+		$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(
+			'columns',
+			[
+				'label'   => esc_html__( 'Columns', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SELECT,
+				'default' => '3',
+				'options' => [ '2' => '2', '3' => '3' ],
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_grid_case_studies_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/widgets/grid-case-studies/templates/partials/card.php

@@ -0,0 +1,66 @@
+<?php
+/**
+ * Partial: Grid Case Studies – single card
+ *
+ * Expects $card (icon, year, label, title, description, show_link, link_text, link_url, link_attrs)
+ * and $view['classes'].
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+if ( empty( $card ) ) {
+	return;
+}
+
+$classes = $view['classes'] ?? [];
+$has_meta = ( $card['year'] !== '' || $card['label'] !== '' );
+?>
+
+<article class="<?php echo esc_attr( $classes['card_bg'] ?? '' ); ?> p-6 md:p-8 flex flex-col text-left">
+	<?php if ( ! empty( $card['icon']['value'] ) ) : ?>
+		<div class="<?php echo esc_attr( $classes['icon_box'] ?? '' ); ?> w-12 h-12 flex items-center justify-center mb-5 [&_.e-icon]:w-6 [&_.e-icon]:h-6 [&_.e-icon]:text-white" aria-hidden="true">
+			<?php \Elementor\Icons_Manager::render_icon( $card['icon'], [ 'aria-hidden' => 'true', 'class' => 'w-6 h-6 text-white' ] ); ?>
+		</div>
+	<?php endif; ?>
+
+	<?php if ( $has_meta ) : ?>
+		<p class="<?php echo esc_attr( $classes['meta'] ?? '' ); ?> text-sm mb-2">
+			<?php
+			echo esc_html( $card['year'] );
+			if ( $card['year'] !== '' && $card['label'] !== '' ) {
+				echo ' / ';
+			}
+			echo $card['label'];
+			?>
+		</p>
+	<?php endif; ?>
+
+	<?php if ( $card['title'] !== '' ) : ?>
+		<h3 class="<?php echo esc_attr( $classes['title'] ?? '' ); ?> text-lg md:text-xl font-bold font-heading leading-tight mb-3">
+			<?php echo $card['title']; ?>
+		</h3>
+	<?php endif; ?>
+
+	<?php if ( $card['description'] !== '' ) : ?>
+		<div class="<?php echo esc_attr( $classes['card_desc'] ?? '' ); ?> text-sm md:text-base leading-relaxed mb-4">
+			<?php echo $card['description']; ?>
+		</div>
+	<?php endif; ?>
+
+	<?php if ( ! empty( $card['show_link'] ) && $card['link_text'] !== '' ) : ?>
+		<a
+			href="<?php echo esc_url( $card['link_url'] ); ?>"
+			<?php echo $card['link_attrs']; ?>
+			class="<?php echo esc_attr( $classes['link'] ?? '' ); ?> inline-flex items-center gap-1.5 text-sm font-medium mt-auto"
+		>
+			<span><?php echo $card['link_text']; ?></span>
+			<svg class="w-4 h-4 shrink-0" aria-hidden="true" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+				<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"/>
+			</svg>
+		</a>
+	<?php endif; ?>
+</article>

package/widgets/grid-case-studies/templates/wrapper.php

@@ -0,0 +1,69 @@
+<?php
+/**
+ * Template: Grid Case Studies Wrapper
+ *
+ * Header (headline + intro) and grid of case study cards.
+ * AVAILABLE DATA ($view): show_headline, show_description, headline, headline_tag,
+ * description, cards, grid_class, 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 = 'grid-case-studies-' . $view['widget_id'];
+$has_heading = ( $view['show_headline'] && $view['headline'] !== '' ) || ( $view['show_description'] && $view['description'] !== '' );
+$has_cards   = ! empty( $view['cards'] );
+$header = [
+	'headline_attrs'    => $headline_attrs,
+	'id'                => $section_id,
+	'use_wrapper'       => true,
+	'alignment'         => 'left',
+	'block_class'       => 'max-w-3xl',
+	'margin_bottom'     => 'mb-12 md:mb-16',
+	'show_headline'     => $view['show_headline'] && $view['headline'] !== '',
+	'headline'          => $view['headline'] ?? '',
+	'headline_tag'      => $view['headline_tag'] ?? 'h2',
+	'headline_class'    => $view['classes']['headline'] ?? '',
+	'headline_extras'   => 'text-3xl sm:text-4xl md:text-5xl font-bold font-heading leading-tight',
+	'show_description'  => $view['show_description'] && $view['description'] !== '',
+	'description'       => $view['description'] ?? '',
+	'description_class' => $view['classes']['description'] ?? '',
+	'description_extras'=> 'mt-4 md:mt-6 text-base md:text-lg leading-relaxed',
+];
+$elements_path = SOCIALLANE_ELEMENTS_PATH . 'elements';
+?>
+
+<?php // ========== GRID CASE STUDIES 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 if ( $has_heading ) : ?>
+			<?php include $elements_path . '/section-header/templates/render.php'; ?>
+		<?php endif; ?>
+
+		<?php if ( $has_cards ) : ?>
+			<?php $stagger_attrs = sociallane_stagger_attrs( $anim ); ?>
+			<div class="grid <?php echo esc_attr( $view['grid_class'] ); ?> gap-6 md:gap-8" <?php echo $stagger_attrs ? ' ' . $stagger_attrs : ''; ?>>
+				<?php foreach ( $view['cards'] as $card ) : ?>
+					<?php include __DIR__ . '/partials/card.php'; ?>
+				<?php endforeach; ?>
+			</div>
+		<?php endif; ?>
+	</div>
+</section>
+
+<?php // ========== GRID CASE STUDIES END ========== ?>