@sociallane/elements 1.0.0

package/packages/widgets/newsletter/templates/wrapper.php

@@ -0,0 +1,137 @@
+<?php
+/**
+ * Template: Newsletter Wrapper
+ *
+ * AVAILABLE DATA ($view):
+ * - layout ('card' | 'section')
+ * - show_headline, show_description, show_privacy
+ * - headline, headline_tag, description
+ * - form_shortcode
+ * - privacy_text, privacy_link_text, privacy_href, privacy_attrs
+ * - 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  = 'newsletter-' . $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'] ) );
+$is_card     = ( $view['layout'] ?? 'card' ) === 'card';
+$form_class  = 'sl-newsletter-form' . ( $is_card ? ' sl-newsletter-form--card' : '' );
+?>
+
+<?php // ========== NEWSLETTER 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 ( $is_card ) : ?>
+			<?php // ----- Card layout: two columns, rounded card ----- ?>
+			<div class="<?php echo esc_attr( $view['classes']['card'] ); ?> p-8 md:p-10 lg:p-12 max-w-5xl mx-auto">
+				<div class="grid grid-cols-1 lg:grid-cols-2 gap-8 lg:gap-12 items-center">
+					<?php if ( $has_heading ) : ?>
+						<header class="text-left" 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; ?>
+
+					<div class="<?php echo $has_heading ? '' : 'lg:col-span-2'; ?>">
+						<?php if ( $has_form ) : ?>
+							<div class="<?php echo esc_attr( $form_class ); ?> mb-4">
+								<?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 text-left">
+								<?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>
+				</div>
+			</div>
+		<?php else : ?>
+			<?php // ----- Section layout: centered single column ----- ?>
+			<div class="max-w-2xl mx-auto text-center">
+				<?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-lg md:text-xl leading-relaxed">
+								<?php echo $view['description']; ?>
+							</p>
+						<?php endif; ?>
+					</header>
+				<?php endif; ?>
+
+				<?php if ( $has_form ) : ?>
+					<div class="<?php echo esc_attr( $form_class ); ?> mb-6 md:mb-8">
+						<?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">
+						<?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 focus:outline-none"
+							>
+								<?php echo $view['privacy_link_text']; ?>
+							</a>
+						<?php endif; ?>
+					</p>
+				<?php endif; ?>
+			</div>
+		<?php endif; ?>
+	</div>
+</section>
+
+<?php // ========== NEWSLETTER END ========== ?>

package/packages/widgets/newsletter-card/data/view.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * Data Preparation: Newsletter (Card)
+ *
+ * Transforms raw Elementor settings into clean, template-ready data.
+ * Fixed card layout (two columns).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Newsletter (Card) widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID for accessibility
+ * @return array Template-ready data
+ */
+function prepare_newsletter_card_view( array $settings, string $widget_id ): array {
+	$fields            = sociallane_extract_fields( $settings, [
+		'headline'    => [],
+		'description' => [ 'show_key' => 'show_description' ],
+		'privacy_text' => [ 'show_key' => 'show_privacy' ],
+	] );
+	$headline_tag      = sociallane_validate_heading_tag( $settings );
+	$form_shortcode    = trim( $settings['form_shortcode'] ?? '' );
+	$privacy_link_text = esc_html( $settings['privacy_link_text'] ?? '' );
+	$privacy_link      = sociallane_prepare_link_attrs( $settings['privacy_link_url'] ?? [] );
+
+	$animation = sociallane_animation_view_data( $settings );
+
+	// Light/dark: dual classes for Nav theme switcher (elementor-widget-structure, widget-utility-classes)
+	$classes = [
+		'section'      => 'bg-white dark:bg-zinc-900 ',
+		'card'         => 'bg-neutral-100 dark:bg-zinc-500/40 rounded-2xl border border-neutral-200 dark:border-blue-200/30',
+		'headline'     => 'text-zinc-900 dark:text-neutral-200',
+		'description'  => 'text-zic-900 dark:text-neutral-200',
+		'privacy'      => 'text-zinc-900 dark:text-neutral-200',
+		'privacy_link' => 'text-zinc-900 dark:text-white font-semibold underline hover:opacity-90 focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2 focus:ring-offset-neutral-100 dark:focus:ring-offset-neutral-800 rounded',
+	];
+
+	return array_merge( $fields, [
+		'headline_tag'     => $headline_tag,
+		'form_shortcode'   => $form_shortcode,
+		'privacy_link_text'=> $privacy_link_text,
+		'privacy_href'     => $privacy_link['url'],
+		'privacy_attrs'    => $privacy_link['attrs'],
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+	] );
+}

package/packages/widgets/newsletter-card/newsletter-card.php

@@ -0,0 +1,184 @@
+<?php
+/**
+ * Widget: Newsletter (Card)
+ *
+ * Newsletter sign-up in a two-column card layout: headline/description left,
+ * form and privacy right. Gravity Forms shortcode, Tailwind Forms styling.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+use Elementor\Widget_Base;
+use Elementor\Controls_Manager;
+use SocialLane\Elements\Traits\Animation_Controls;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Newsletter Card Widget
+ */
+class Newsletter_Card extends Widget_Base {
+
+	use Animation_Controls;
+
+	public function get_name(): string {
+		return 'newsletter-card';
+	}
+
+	public function get_title(): string {
+		return esc_html__( 'Newsletter (Card)', 'sociallane-elements' );
+	}
+
+	public function get_icon(): string {
+		return 'eicon-email-field';
+	}
+
+	public function get_categories(): array {
+		return [ 'sociallane-forms' ];
+	}
+
+	public function get_keywords(): array {
+		return [ 'newsletter', 'signup', 'card', 'gravity forms', 'form', 'email' ];
+	}
+
+	protected function register_controls(): void {
+		$this->register_content_section();
+		$this->register_privacy_section();
+		$this->register_animation_controls();
+	}
+
+	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' ),
+				'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(
+			'form_shortcode',
+			[
+				'label'       => esc_html__( 'Gravity Forms Shortcode', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXTAREA,
+				'default'     => '[gravityform id="1" title="false" description="false"]',
+				'placeholder' => '[gravityform id="1" title="false" description="false"]',
+				'description' => esc_html__( 'Enter the Gravity Forms shortcode. Example: [gravityform id="1" title="false" description="false"]', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	private function register_privacy_section(): void {
+		$this->start_controls_section(
+			'section_privacy',
+			[
+				'label' => esc_html__( 'Privacy', 'sociallane-elements' ),
+				'tab'   => Controls_Manager::TAB_CONTENT,
+			]
+		);
+
+		$this->add_control(
+			'show_privacy',
+			[
+				'label'   => esc_html__( 'Show Privacy Statement', 'sociallane-elements' ),
+				'type'    => Controls_Manager::SWITCHER,
+				'default' => 'yes',
+			]
+		);
+
+		$this->add_control(
+			'privacy_text',
+			[
+				'label'       => esc_html__( 'Privacy Text', 'sociallane-elements' ),
+				'type'        => Controls_Manager::TEXT,
+				'default'     => esc_html__( 'Lorem ipsum dolor sit amet.', 'sociallane-elements' ),
+				'description' => esc_html__( 'Text before the link, e.g. "We care about the protection of your data."', 'sociallane-elements' ),
+				'label_block' => true,
+			]
+		);
+
+		$this->add_control(
+			'privacy_link_text',
+			[
+				'label'   => esc_html__( 'Privacy Link Text', 'sociallane-elements' ),
+				'type'    => Controls_Manager::TEXT,
+				'default' => esc_html__( 'Lorem ipsum', 'sociallane-elements' ),
+			]
+		);
+
+		$this->add_control(
+			'privacy_link_url',
+			[
+				'label' => esc_html__( 'Privacy Policy URL', 'sociallane-elements' ),
+				'type'  => Controls_Manager::URL,
+			]
+		);
+
+		$this->end_controls_section();
+	}
+
+	protected function render(): void {
+		$settings = $this->get_settings_for_display();
+		require_once __DIR__ . '/data/view.php';
+		$view = prepare_newsletter_card_view( $settings, $this->get_id() );
+		include __DIR__ . '/templates/wrapper.php';
+	}
+}

package/packages/widgets/newsletter-card/package.json

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

package/packages/widgets/newsletter-card/templates/wrapper.php

@@ -0,0 +1,90 @@
+<?php
+/**
+ * Template: Newsletter (Card) Wrapper
+ *
+ * Two-column card layout: headline/description left, form and privacy right.
+ *
+ * AVAILABLE DATA ($view):
+ * - show_headline, show_description, show_privacy
+ * - headline, headline_tag, description
+ * - form_shortcode
+ * - privacy_text, privacy_link_text, privacy_href, privacy_attrs
+ * - 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 );
+$section_id    = 'newsletter-' . $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'] ) );
+$form_class    = 'sl-newsletter-form sl-newsletter-form--card';
+?>
+
+<?php // ========== NEWSLETTER (CARD) 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="<?php echo esc_attr( $view['classes']['card'] ); ?> p-8 md:p-10 lg:p-12 max-w-5xl mx-auto">
+			<div class="grid grid-cols-1 lg:grid-cols-2 gap-8 lg:gap-12 items-center">
+				<?php if ( $has_heading ) : ?>
+					<header class="text-left" 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; ?>
+
+				<div class="<?php echo $has_heading ? '' : 'lg:col-span-2'; ?>">
+					<?php if ( $has_form ) : ?>
+						<div class="<?php echo esc_attr( $form_class ); ?> mb-4">
+							<?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 text-left">
+							<?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>
+			</div>
+		</div>
+	</div>
+</section>
+
+<?php // ========== NEWSLETTER (CARD) END ========== ?>

package/packages/widgets/newsletter-section/data/view.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * Data Preparation: Newsletter (Section)
+ *
+ * Transforms raw Elementor settings into clean, template-ready data.
+ * Fixed section layout (centered single column).
+ *
+ * @package SocialLane_Elements
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Prepare view data for Newsletter (Section) widget
+ *
+ * @param array  $settings  Raw Elementor settings
+ * @param string $widget_id Unique widget ID for accessibility
+ * @return array Template-ready data
+ */
+function prepare_newsletter_section_view( array $settings, string $widget_id ): array {
+	$fields            = sociallane_extract_fields( $settings, [
+		'headline'    => [],
+		'description' => [ 'show_key' => 'show_description' ],
+		'privacy_text' => [ 'show_key' => 'show_privacy' ],
+	] );
+	$headline_tag      = sociallane_validate_heading_tag( $settings );
+	$form_shortcode    = trim( $settings['form_shortcode'] ?? '' );
+	$privacy_link_text = esc_html( $settings['privacy_link_text'] ?? '' );
+	$privacy_link      = sociallane_prepare_link_attrs( $settings['privacy_link_url'] ?? [] );
+
+	$animation = sociallane_animation_view_data( $settings );
+
+	// Light/dark: dual classes for Nav theme switcher (elementor-widget-structure, widget-utility-classes)
+	$classes = [
+		'section'      => 'bg-white dark:bg-zinc-900 ',
+		'card'         => 'bg-neutral-100 dark:bg-zinc-500/40 rounded-2xl border border-neutral-200 dark:border-blue-200/30',
+		'headline'     => 'text-zinc-900 dark:text-neutral-200',
+		'description'  => 'text-zic-900 dark:text-neutral-200',
+		'privacy'      => 'text-zinc-900 dark:text-neutral-200',
+		'privacy_link' => 'text-zinc-900 dark:text-white font-semibold underline hover:opacity-90 focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2 focus:ring-offset-neutral-100 dark:focus:ring-offset-neutral-800 rounded',
+	];
+
+	return array_merge( $fields, [
+		'headline_tag'     => $headline_tag,
+		'form_shortcode'   => $form_shortcode,
+		'privacy_link_text'=> $privacy_link_text,
+		'privacy_href'     => $privacy_link['url'],
+		'privacy_attrs'    => $privacy_link['attrs'],
+		'classes'          => $classes,
+		'widget_id'        => $widget_id,
+		'animation'        => $animation,
+	] );
+}