@sociallane/elements 1.0.0

package/includes/class-widget-manager.php

@@ -0,0 +1,605 @@
+<?php
+/**
+ * Widget Manager
+ *
+ * Manages which widgets are enabled/disabled via wp_options.
+ * Used by both the onboarding wizard and admin settings page.
+ *
+ * @package SocialLane\Elements
+ * @since   1.1.0
+ */
+
+namespace SocialLane\Elements;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+class Widget_Manager {
+
+	const OPTION_KEY = 'sociallane_enabled_widgets';
+
+	/**
+	 * Get currently enabled widget slugs.
+	 * Returns default list if no option is set (fresh install).
+	 * Merges in any new registry widgets with default => true so they appear after plugin updates.
+	 *
+	 * @return array<string>
+	 */
+	public function get_enabled_widgets(): array {
+		$enabled = get_option( self::OPTION_KEY, null );
+
+		if ( $enabled === null ) {
+			$enabled = $this->get_default_widgets();
+		} else {
+			$enabled = is_array( $enabled ) ? $enabled : [];
+			// Merge in new default widgets not yet in the saved list (e.g. after adding a widget).
+			$default_slugs = $this->get_default_widgets();
+			$enabled = array_values( array_unique( array_merge( $enabled, $default_slugs ) ) );
+		}
+
+		return apply_filters( 'sociallane_elements_enabled_widgets', $enabled );
+	}
+
+	/**
+	 * Save enabled widget slugs.
+	 *
+	 * @param array<string> $slugs Widget slugs to enable.
+	 */
+	public function set_enabled_widgets( array $slugs ): void {
+		$valid = array_intersect( $slugs, array_keys( self::get_widget_registry() ) );
+		$valid = apply_filters( 'sociallane_elements_widgets_to_save', array_values( $valid ) );
+		update_option( self::OPTION_KEY, $valid, true );
+	}
+
+	/**
+	 * Check if a specific widget is enabled.
+	 *
+	 * @param string $slug Widget slug.
+	 * @return bool
+	 */
+	public function is_widget_enabled( string $slug ): bool {
+		return in_array( $slug, $this->get_enabled_widgets(), true );
+	}
+
+	/**
+	 * Get slugs enabled by default (all widgets when no option set).
+	 *
+	 * @return array<string>
+	 */
+	public function get_default_widgets(): array {
+		return array_keys( array_filter(
+			self::get_widget_registry(),
+			function ( $w ) {
+				return $w['default'] ?? true;
+			}
+		) );
+	}
+
+	/**
+	 * Get widget registry: slug => [ name, description, category, preview, default ].
+	 *
+	 * @return array<string, array{name: string, description: string, category: string, preview: string, default: bool}>
+	 */
+	public static function get_widget_registry(): array {
+		$registry = [
+			'hero-announcement'    => [
+				'name'        => 'Hero Announcement',
+				'description' => 'Hero with announcement banner and CTA',
+				'category'    => 'heroes',
+				'preview'     => 'hero-announcement.webp',
+				'default'     => true,
+			],
+			'hero-centered-image' => [
+				'name'        => 'Hero Centered Image',
+				'description' => 'Centered hero with large image below',
+				'category'    => 'heroes',
+				'preview'     => 'hero-centered-image.webp',
+				'default'     => true,
+			],
+			'hero-collage'         => [
+				'name'        => 'Hero Collage',
+				'description' => 'Hero with multi-image collage layout',
+				'category'    => 'heroes',
+				'preview'     => 'hero-collage.webp',
+				'default'     => true,
+			],
+			'hero-saas-centered'   => [
+				'name'        => 'Hero SaaS (Centered)',
+				'description' => 'SaaS-style hero with centered content',
+				'category'    => 'heroes',
+				'preview'     => 'hero-saas.webp',
+				'default'     => true,
+			],
+			'hero-saas-split'      => [
+				'name'        => 'Hero SaaS (Split)',
+				'description' => 'SaaS-style hero with content and image side-by-side',
+				'category'    => 'heroes',
+				'preview'     => 'hero-saas.webp',
+				'default'     => true,
+			],
+			'hero-saas-stacked'    => [
+				'name'        => 'Hero SaaS (Stacked)',
+				'description' => 'SaaS-style hero with image above content',
+				'category'    => 'heroes',
+				'preview'     => 'hero-saas.webp',
+				'default'     => true,
+			],
+			'hero-split'           => [
+				'name'        => 'Hero Split',
+				'description' => 'Side-by-side hero with content and media',
+				'category'    => 'heroes',
+				'preview'     => 'hero-split.webp',
+				'default'     => true,
+			],
+			'hero-stacked-image'   => [
+				'name'        => 'Hero Stacked Image',
+				'description' => 'Stacked layout hero with full-width image',
+				'category'    => 'heroes',
+				'preview'     => 'hero-stacked-image.webp',
+				'default'     => true,
+			],
+			'hero-overlay-slider'   => [
+				'name'        => 'Hero Overlay (Slider)',
+				'description' => 'Hero with background slides, dark overlay, nav arrows, and CTA',
+				'category'    => 'heroes',
+				'preview'     => 'hero-overlay.webp',
+				'default'     => true,
+			],
+			'hero-overlay-single'   => [
+				'name'        => 'Hero Overlay (Single)',
+				'description' => 'Single-slide hero with background image and left-aligned CTA',
+				'category'    => 'heroes',
+				'preview'     => 'hero-overlay.webp',
+				'default'     => true,
+			],
+			'page-hero-left'        => [
+				'name'        => 'Page Hero (Left)',
+				'description' => 'Minimal text-only page hero, left-aligned',
+				'category'    => 'heroes',
+				'preview'     => 'simple-page-hero.webp',
+				'default'     => true,
+			],
+			'page-hero-center'      => [
+				'name'        => 'Page Hero (Center)',
+				'description' => 'Minimal text-only page hero, center-aligned',
+				'category'    => 'heroes',
+				'preview'     => 'simple-page-hero.webp',
+				'default'     => true,
+			],
+			'content-block'        => [
+				'name'        => 'Content Block',
+				'description' => 'Flexible content section with text and media',
+				'category'    => 'content',
+				'preview'     => 'content-block.webp',
+				'default'     => true,
+			],
+			'intro-pattern'        => [
+				'name'        => 'Intro Pattern',
+				'description' => 'Intro section with decorative pattern',
+				'category'    => 'content',
+				'preview'     => 'intro-pattern.webp',
+				'default'     => true,
+			],
+			'intro-text'           => [
+				'name'        => 'Intro Text',
+				'description' => 'Simple text introduction section',
+				'category'    => 'content',
+				'preview'     => 'intro-text.webp',
+				'default'     => true,
+			],
+			'faq-stacked'           => [
+				'name'        => 'FAQ (Stacked)',
+				'description' => 'Accordion-style FAQ with schema markup',
+				'category'    => 'content',
+				'preview'     => 'faq.webp',
+				'default'     => true,
+			],
+			'faq-split'             => [
+				'name'        => 'FAQ (Split)',
+				'description' => 'FAQ with header and accordion in split columns',
+				'category'    => 'content',
+				'preview'     => 'faq.webp',
+				'default'     => true,
+			],
+			'faq-centered'          => [
+				'name'        => 'FAQ (Centered)',
+				'description' => 'Centered FAQ accordion with schema markup',
+				'category'    => 'content',
+				'preview'     => 'faq.webp',
+				'default'     => true,
+			],
+			'testimonial-quote'    => [
+				'name'        => 'Testimonial Quote',
+				'description' => 'Single testimonial with quote and avatar',
+				'category'    => 'content',
+				'preview'     => 'testimonial-quote.webp',
+				'default'     => true,
+			],
+			'section-stats'        => [
+				'name'        => 'Section Stats',
+				'description' => 'Statistics counter section',
+				'category'    => 'content',
+				'preview'     => 'section-stats.webp',
+				'default'     => true,
+			],
+			'services'             => [
+				'name'        => 'Services',
+				'description' => 'Services showcase with icons and descriptions',
+				'category'    => 'content',
+				'preview'     => 'services.webp',
+				'default'     => true,
+			],
+			'feature-list-cta'     => [
+				'name'        => 'Feature List CTA',
+				'description' => 'Feature list with call-to-action',
+				'category'    => 'content',
+				'preview'     => 'feature-list-cta.webp',
+				'default'     => true,
+			],
+			'feature-list'         => [
+				'name'        => 'Feature List',
+				'description' => 'Heading with checklist of items and teal checkmarks',
+				'category'    => 'content',
+				'preview'     => 'feature-list.webp',
+				'default'     => true,
+			],
+			'bento-grid-4'         => [
+				'name'        => 'Bento Grid (4 cells)',
+				'description' => 'Bento-style 4-cell asymmetric grid layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-grid.webp',
+				'default'     => true,
+			],
+			'bento-grid-5'         => [
+				'name'        => 'Bento Grid (Two Row)',
+				'description' => 'Bento-style two-row grid layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-grid.webp',
+				'default'     => true,
+			],
+			'bento-grid-6'         => [
+				'name'        => 'Bento Grid (Two Column Second Row)',
+				'description' => 'Bento-style two-column second row grid layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-grid.webp',
+				'default'     => true,
+			],
+			'bento-portfolio-4'    => [
+				'name'        => 'Bento Portfolio (4 cells)',
+				'description' => 'Portfolio showcase in 4-cell bento layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-portfolio.webp',
+				'default'     => true,
+			],
+			'bento-portfolio-5'    => [
+				'name'        => 'Bento Portfolio (Two Row)',
+				'description' => 'Portfolio showcase in two-row bento layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-portfolio.webp',
+				'default'     => true,
+			],
+			'bento-portfolio-6'    => [
+				'name'        => 'Bento Portfolio (Two Column)',
+				'description' => 'Portfolio showcase in two-column second row bento layout',
+				'category'    => 'cards',
+				'preview'     => 'bento-portfolio.webp',
+				'default'     => true,
+			],
+			'card-hover-reveal'    => [
+				'name'        => 'Card Hover Reveal',
+				'description' => 'Image card with backdrop-blur bar that fades up on hover',
+				'category'    => 'cards',
+				'preview'     => 'card-hover-reveal.webp',
+				'default'     => true,
+			],
+			'feature-grid'         => [
+				'name'        => 'Feature Grid',
+				'description' => 'Grid of feature cards with icons',
+				'category'    => 'cards',
+				'preview'     => 'feature-grid.webp',
+				'default'     => true,
+			],
+			'feature-grid-centered' => [
+				'name'        => 'Feature Grid (Centered 2x2)',
+				'description' => 'Centered 2x2 grid of feature cards with icons',
+				'category'    => 'cards',
+				'preview'     => 'feature-grid.webp',
+				'default'     => true,
+			],
+			'grid-case-studies'    => [
+				'name'        => 'Grid Case Studies',
+				'description' => 'Case study cards in grid layout',
+				'category'    => 'cards',
+				'preview'     => 'grid-case-studies.webp',
+				'default'     => true,
+			],
+			'grid-components'      => [
+				'name'        => 'Grid Components',
+				'description' => 'Component showcase grid',
+				'category'    => 'cards',
+				'preview'     => 'grid-components.webp',
+				'default'     => true,
+			],
+			'posts-grid'           => [
+				'name'        => 'Posts Grid',
+				'description' => 'Blog post cards in responsive grid',
+				'category'    => 'cards',
+				'preview'     => 'grid-posts.webp',
+				'default'     => true,
+			],
+			'posts-grid-overlay'   => [
+				'name'        => 'Posts Grid (Overlay)',
+				'description' => 'Blog post cards with image overlay',
+				'category'    => 'cards',
+				'preview'     => 'grid-posts.webp',
+				'default'     => true,
+			],
+			'blog-grid'            => [
+				'name'        => 'Blog Grid',
+				'description' => 'Article cards with category overlay, date, excerpt, and CTA',
+				'category'    => 'cards',
+				'preview'     => 'grid-posts.webp',
+				'default'     => true,
+			],
+			'grid-team'            => [
+				'name'        => 'Grid Team',
+				'description' => 'Team member cards with photos and roles',
+				'category'    => 'cards',
+				'preview'     => 'grid-team.webp',
+				'default'     => true,
+			],
+			'testimonials-grid'    => [
+				'name'        => 'Testimonials Grid',
+				'description' => 'Testimonial cards in responsive grid',
+				'category'    => 'cards',
+				'preview'     => 'grid-testimonials.webp',
+				'default'     => true,
+			],
+			'testimonials-masonry' => [
+				'name'        => 'Testimonials (Masonry)',
+				'description' => 'Testimonial cards in masonry layout',
+				'category'    => 'cards',
+				'preview'     => 'grid-testimonials.webp',
+				'default'     => true,
+			],
+			'testimonials-bento'   => [
+				'name'        => 'Testimonials (Bento)',
+				'description' => 'Testimonial cards in bento layout',
+				'category'    => 'cards',
+				'preview'     => 'grid-testimonials.webp',
+				'default'     => true,
+			],
+			'pricing-table'        => [
+				'name'        => 'Pricing Table',
+				'description' => 'Pricing plans comparison table',
+				'category'    => 'cards',
+				'preview'     => 'pricing-table.webp',
+				'default'     => true,
+			],
+			'newsletter-card'      => [
+				'name'        => 'Newsletter (Card)',
+				'description' => 'Newsletter signup in two-column card layout',
+				'category'    => 'forms',
+				'preview'     => 'newsletter.webp',
+				'default'     => true,
+			],
+			'newsletter-section'   => [
+				'name'        => 'Newsletter (Section)',
+				'description' => 'Newsletter signup in centered section layout',
+				'category'    => 'forms',
+				'preview'     => 'newsletter.webp',
+				'default'     => true,
+			],
+			'form-contact'         => [
+				'name'        => 'Form Contact',
+				'description' => 'Contact form section with Gravity Forms',
+				'category'    => 'forms',
+				'preview'     => 'form-contact.webp',
+				'default'     => true,
+			],
+			'cta-notify'           => [
+				'name'        => 'CTA Notify',
+				'description' => 'Notification-style call to action',
+				'category'    => 'forms',
+				'preview'     => 'cta-notify.webp',
+				'default'     => true,
+			],
+			'cta-banner'           => [
+				'name'        => 'CTA Banner',
+				'description' => 'Full-width banner with background image and lower CTA block (headline, description, phone/email)',
+				'category'    => 'forms',
+				'preview'     => 'cta-notify.webp',
+				'default'     => true,
+			],
+			'cta-split'            => [
+				'name'        => 'CTA Split',
+				'description' => 'Split section: dark panel (headline, description, phone | email) + full-height image',
+				'category'    => 'forms',
+				'preview'     => 'cta-split.webp',
+				'default'     => true,
+			],
+			'nav-default'          => [
+				'name'        => 'Navigation (Default)',
+				'description' => 'Site header with mega menu and theme toggle',
+				'category'    => 'navigation',
+				'preview'     => 'nav.webp',
+				'default'     => true,
+			],
+			'nav-centered'         => [
+				'name'        => 'Navigation (Centered)',
+				'description' => 'Centered navigation with mega menu and theme toggle',
+				'category'    => 'navigation',
+				'preview'     => 'nav.webp',
+				'default'     => true,
+			],
+			'nav-minimal'          => [
+				'name'        => 'Navigation (Minimal)',
+				'description' => 'Minimal navigation with mega menu and theme toggle',
+				'category'    => 'navigation',
+				'preview'     => 'nav.webp',
+				'default'     => true,
+			],
+			'nav-compact'          => [
+				'name'        => 'Navigation (Compact)',
+				'description' => 'Compact navigation with mega menu and theme toggle',
+				'category'    => 'navigation',
+				'preview'     => 'nav.webp',
+				'default'     => true,
+			],
+			'nav-floating'         => [
+				'name'        => 'Navigation (Floating)',
+				'description' => 'Floating pill-style navigation with mega menu and theme toggle',
+				'category'    => 'navigation',
+				'preview'     => 'nav.webp',
+				'default'     => true,
+			],
+			'footer'               => [
+				'name'        => 'Footer',
+				'description' => 'Multi-column site footer',
+				'category'    => 'footers',
+				'preview'     => 'footer.webp',
+				'default'     => true,
+			],
+			'footer-links-contact' => [
+				'name'        => 'Footer Links & Contact',
+				'description' => 'Dark footer with logo, link columns from menu, contact column, and bottom bar',
+				'category'    => 'footers',
+				'preview'     => 'footer.webp',
+				'default'     => true,
+			],
+			'footer-brand'         => [
+				'name'        => 'Footer Brand',
+				'description' => 'Minimal brand-focused footer',
+				'category'    => 'footers',
+				'preview'     => 'footer-brand.webp',
+				'default'     => true,
+			],
+			'client-logos'         => [
+				'name'        => 'Client Logos',
+				'description' => 'Scrolling client/partner logo bar',
+				'category'    => 'logos',
+				'preview'     => 'client-logos.webp',
+				'default'     => true,
+			],
+			'logo-grid-centered'   => [
+				'name'        => 'Logo Grid (Centered)',
+				'description' => 'Centered grid of partner/client logos',
+				'category'    => 'logos',
+				'preview'     => 'logo-grid.webp',
+				'default'     => true,
+			],
+			'logo-grid-row'        => [
+				'name'        => 'Logo Grid (Row)',
+				'description' => 'Single row of logos, carousel if more than 6',
+				'category'    => 'logos',
+				'preview'     => 'logo-grid.webp',
+				'default'     => true,
+			],
+			'logo-grid-split'      => [
+				'name'        => 'Logo Grid (Split)',
+				'description' => 'Text left, logo grid right',
+				'category'    => 'logos',
+				'preview'     => 'logo-grid.webp',
+				'default'     => true,
+			],
+			'social-proof'         => [
+				'name'        => 'Social Proof',
+				'description' => 'Social proof section with headline, description, stats, optional image',
+				'category'    => 'logos',
+				'preview'     => 'social-proof.webp',
+				'default'     => true,
+			],
+			'social-proof-trust'   => [
+				'name'        => 'Social Proof (Trust)',
+				'description' => 'Trust layout: text and links left, 2×2 stats right',
+				'category'    => 'logos',
+				'preview'     => 'social-proof.webp',
+				'default'     => true,
+			],
+			'outreach-dashboard'   => [
+				'name'        => 'Outreach Dashboard',
+				'description' => 'Outreach metrics dashboard widget',
+				'category'    => 'dashboards',
+				'preview'     => 'outreach-dashboard.webp',
+				'default'     => true,
+			],
+			'pipeline-dashboard'   => [
+				'name'        => 'Pipeline Dashboard',
+				'description' => 'Sales pipeline dashboard widget',
+				'category'    => 'dashboards',
+				'preview'     => 'pipeline-dashboard.webp',
+				'default'     => true,
+			],
+			'sales-dashboard'      => [
+				'name'        => 'Sales Dashboard',
+				'description' => 'Sales analytics dashboard widget',
+				'category'    => 'dashboards',
+				'preview'     => 'sales-dashboard.webp',
+				'default'     => true,
+			],
+		];
+
+		return apply_filters( 'sociallane_elements_widget_registry', $registry );
+	}
+
+	/**
+	 * Get category definitions for the browser tabs.
+	 *
+	 * @return array<string, string>
+	 */
+	public static function get_categories(): array {
+		$categories = [
+			'heroes'     => esc_html__( 'Heroes', 'sociallane-elements' ),
+			'content'    => esc_html__( 'Content', 'sociallane-elements' ),
+			'cards'      => esc_html__( 'Cards & Grids', 'sociallane-elements' ),
+			'forms'      => esc_html__( 'Forms & CTAs', 'sociallane-elements' ),
+			'navigation' => esc_html__( 'Navigation', 'sociallane-elements' ),
+			'footers'    => esc_html__( 'Footers', 'sociallane-elements' ),
+			'logos'      => esc_html__( 'Logos & Social Proof', 'sociallane-elements' ),
+			'dashboards' => esc_html__( 'Dashboards', 'sociallane-elements' ),
+		];
+
+		return apply_filters( 'sociallane_elements_widget_categories', $categories );
+	}
+
+	/**
+	 * Get preview image/SVG URL for a widget (for onboarding and settings browser).
+	 * Tries: 1) WebP in assets/previews/, 2) SVG in assets/svgs/widgets/{slug}.svg, 3) category fallback SVG.
+	 *
+	 * @param string $slug   Widget slug.
+	 * @param array  $widget Widget registry entry (must have 'category').
+	 * @return string URL or empty string.
+	 */
+	public static function get_widget_preview_url( string $slug, array $widget ): string {
+		$path = trailingslashit( SOCIALLANE_ELEMENTS_PATH );
+		$url  = trailingslashit( SOCIALLANE_ELEMENTS_URL );
+
+		$preview_file = $widget['preview'] ?? '';
+		if ( $preview_file && file_exists( $path . 'assets/previews/' . $preview_file ) ) {
+			return $url . 'assets/previews/' . $preview_file;
+		}
+
+		if ( file_exists( $path . 'assets/svgs/widgets/' . $slug . '.svg' ) ) {
+			return $url . 'assets/svgs/widgets/' . $slug . '.svg';
+		}
+
+		$category_fallbacks = [
+			'heroes'     => 'hero',
+			'content'    => 'content-block',
+			'cards'      => 'bento-grid-4',
+			'forms'      => 'newsletter-card',
+			'navigation' => 'navigation',
+			'footers'    => 'footer',
+			'logos'      => 'logo-grid-centered',
+			'dashboards' => 'posts-grid',
+		];
+		$category = $widget['category'] ?? '';
+		$fallback_slug = $category_fallbacks[ $category ] ?? '';
+		if ( $fallback_slug && file_exists( $path . 'assets/svgs/widgets/' . $fallback_slug . '.svg' ) ) {
+			return $url . 'assets/svgs/widgets/' . $fallback_slug . '.svg';
+		}
+
+		return '';
+	}
+}