@sociallane/elements 1.0.0

package/includes/class-disable-reset-css.php

@@ -0,0 +1,78 @@
+<?php
+/**
+ * Disable reset and global CSS from WordPress core, Elementor, and Hello theme.
+ *
+ * Ensures no global reset/normalize or block/theme styles are loaded,
+ * so your own base styles (e.g. Tailwind) control the document.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+// Prevent direct access
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Class Disable_Reset_Css
+ */
+class Disable_Reset_Css {
+
+	/**
+	 * Hook into WordPress and Elementor/Hello.
+	 */
+	public static function init(): void {
+		// Hello theme: prevent enqueue of reset.css (handle: hello-elementor).
+		add_filter( 'hello_elementor_enqueue_style', '__return_false' );
+		// Hello theme: prevent enqueue of theme.css (handle: hello-elementor-theme-style).
+		add_filter( 'hello_elementor_enqueue_theme_style', '__return_false' );
+
+		// After styles are enqueued, remove Elementor and Hello reset/base styles.
+		add_action( 'wp_enqueue_scripts', [ __CLASS__, 'dequeue_reset_styles' ], 999 );
+
+		// Elementor re-enqueues frontend CSS in wp_footer when page has Elementor content; dequeue again.
+		add_action( 'elementor/frontend/after_enqueue_styles', [ __CLASS__, 'dequeue_reset_styles' ], 999 );
+
+		// Strip elementor-frontend.min.css from output if it ever gets enqueued (safety net).
+		add_filter( 'style_loader_tag', [ __CLASS__, 'strip_elementor_frontend_style' ], 10, 4 );
+	}
+
+	/**
+	 * Remove elementor-frontend stylesheet link from output.
+	 *
+	 * @param string $html   The link tag for the enqueued style.
+	 * @param string $handle The style's registered handle.
+	 * @param string $href   The stylesheet's source URL.
+	 * @param string $media  The stylesheet's media attribute.
+	 * @return string Empty string for elementor-frontend, else unchanged.
+	 */
+	public static function strip_elementor_frontend_style( string $html, string $handle, string $href, string $media ): string {
+		if ( $handle === 'elementor-frontend' ) {
+			return '';
+		}
+		return $html;
+	}
+
+	/**
+	 * Dequeue WordPress core, Elementor, and Hello theme front-end styles.
+	 */
+	public static function dequeue_reset_styles(): void {
+		// WordPress core: block library and theme/global styles.
+		wp_dequeue_style( 'wp-block-library' );
+		wp_dequeue_style( 'wp-block-library-theme' );
+		wp_dequeue_style( 'global-styles' );
+		wp_dequeue_style( 'classic-theme-styles' );
+
+		// Hello theme: reset.css (full normalize) and theme.css (base styles).
+		wp_dequeue_style( 'hello-elementor' );
+		wp_dequeue_style( 'hello-elementor-theme-style' );
+
+		// Elementor: frontend base (includes reset-like rules for .elementor).
+		wp_dequeue_style( 'elementor-frontend' );
+
+		// Elementor: global/kit CSS when registered (e.g. by Pro or kit).
+		wp_dequeue_style( 'elementor-global' );
+	}
+}

package/includes/class-gravity-forms-styles.php

@@ -0,0 +1,78 @@
+<?php
+/**
+ * Disable Gravity Forms front-end styles so Tailwind Forms + .sl-newsletter-form apply.
+ *
+ * Uses gform_disable_css filter (prevents GF from enqueueing) plus dequeue fallback
+ * for any styles that load via theme layer or late enqueue.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+// Prevent direct access
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Class Gravity_Forms_Styles
+ */
+class Gravity_Forms_Styles {
+
+	/**
+	 * GF style handles to dequeue (legacy + theme layer)
+	 *
+	 * @var string[]
+	 */
+	private static array $handles = [
+		'gforms_reset_css',
+		'gforms_formsmain_css',
+		'gforms_ready_class_css',
+		'gforms_browsers_css',
+		'gforms_rtl_css',
+		'gform_basic',
+		'gform_theme',
+		'gform_theme_components',
+		'gravity_forms_theme_reset',
+		'gravity_forms_theme_foundation',
+		'gravity_forms_theme_framework',
+		'gravity_forms_orbital_theme',
+	];
+
+	/**
+	 * Initialize
+	 */
+	public static function init(): void {
+		// Primary: prevent GF from enqueueing form CSS on frontend.
+		add_filter( 'gform_disable_css', [ __CLASS__, 'disable_css_on_frontend' ] );
+
+		// Fallback: dequeue in case GF loads styles via theme layer or late enqueue.
+		add_action( 'wp_enqueue_scripts', [ __CLASS__, 'dequeue_styles' ], 999 );
+		add_action( 'wp_footer', [ __CLASS__, 'dequeue_styles' ], 1 );
+		add_action( 'elementor/frontend/after_enqueue_styles', [ __CLASS__, 'dequeue_styles' ], 999 );
+	}
+
+	/**
+	 * Disable GF CSS on frontend (admin keeps GF styles for form editor, etc.).
+	 *
+	 * @param bool $disabled Current value
+	 * @return bool
+	 */
+	public static function disable_css_on_frontend( $disabled ): bool {
+		if ( is_admin() ) {
+			return $disabled;
+		}
+		return true;
+	}
+
+	/**
+	 * Dequeue all GF form styles (safety net).
+	 */
+	public static function dequeue_styles(): void {
+		foreach ( self::$handles as $handle ) {
+			wp_dequeue_style( $handle );
+			wp_deregister_style( $handle );
+		}
+	}
+}

package/includes/class-onboarding.php

@@ -0,0 +1,214 @@
+<?php
+/**
+ * Onboarding Wizard
+ *
+ * Handles first-run redirect, wizard page registration, and form processing.
+ *
+ * @package SocialLane\Elements
+ * @since   1.1.0
+ */
+
+namespace SocialLane\Elements;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+class Onboarding {
+
+	const OPTION_COMPLETE   = 'sociallane_onboarding_complete';
+	const TRANSIENT_REDIRECT = '_sociallane_activation_redirect';
+
+	private Widget_Manager $widget_manager;
+
+	public function __construct( Widget_Manager $widget_manager ) {
+		$this->widget_manager = $widget_manager;
+	}
+
+	public function init(): void {
+		add_action( 'admin_menu', [ $this, 'register_page' ] );
+		add_action( 'admin_init', [ $this, 'maybe_redirect' ] );
+		add_action( 'admin_init', [ $this, 'handle_form_submit' ] );
+		add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
+	}
+
+	/**
+	 * Register hidden admin page (not in menu).
+	 */
+	public function register_page(): void {
+		add_submenu_page(
+			'',
+			'SocialLane Setup',
+			'SocialLane Setup',
+			'manage_options',
+			'sociallane-onboarding',
+			[ $this, 'render' ]
+		);
+	}
+
+	/**
+	 * Redirect to wizard on first activation.
+	 */
+	public function maybe_redirect(): void {
+		if ( ! get_transient( self::TRANSIENT_REDIRECT ) ) {
+			return;
+		}
+
+		delete_transient( self::TRANSIENT_REDIRECT );
+
+		if ( wp_doing_ajax() || is_network_admin() || isset( $_GET['activate-multi'] ) || defined( 'WP_CLI' ) ) {
+			return;
+		}
+
+		if ( get_option( self::OPTION_COMPLETE ) ) {
+			return;
+		}
+
+		wp_safe_redirect( admin_url( 'admin.php?page=sociallane-onboarding' ) );
+		exit;
+	}
+
+	/**
+	 * Handle wizard form submission.
+	 */
+	public function handle_form_submit(): void {
+		if ( ! isset( $_POST['sociallane_onboarding_nonce'] ) ) {
+			return;
+		}
+
+		if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['sociallane_onboarding_nonce'] ) ), 'sociallane_onboarding' ) ) {
+			wp_die( esc_html__( 'Security check failed.', 'sociallane-elements' ) );
+		}
+
+		if ( ! current_user_can( 'manage_options' ) ) {
+			wp_die( esc_html__( 'Insufficient permissions.', 'sociallane-elements' ) );
+		}
+
+		$step = isset( $_POST['current_step'] ) ? sanitize_text_field( wp_unslash( $_POST['current_step'] ) ) : 'requirements';
+
+		if ( $step === 'widgets' ) {
+			$widgets = isset( $_POST['widgets'] ) && is_array( $_POST['widgets'] )
+				? array_map( 'sanitize_text_field', wp_unslash( $_POST['widgets'] ) )
+				: [];
+			$this->widget_manager->set_enabled_widgets( $widgets );
+			update_option( self::OPTION_COMPLETE, true, true );
+
+			wp_safe_redirect( admin_url( 'admin.php?page=sociallane-onboarding&step=complete' ) );
+			exit;
+		}
+	}
+
+	/**
+	 * Enqueue admin assets on wizard page only.
+	 *
+	 * @param string $hook Current admin page hook.
+	 */
+	public function enqueue_assets( string $hook ): void {
+		if ( $hook !== 'admin_page_sociallane-onboarding' ) {
+			return;
+		}
+
+		$css_url = Vite_Assets::get_admin_css_url( SOCIALLANE_CORE_PATH, SOCIALLANE_CORE_URL );
+		if ( $css_url !== '' ) {
+			wp_enqueue_style(
+				'sociallane-admin',
+				$css_url,
+				[],
+				SOCIALLANE_ELEMENTS_VERSION
+			);
+		}
+
+		wp_enqueue_script(
+			'sociallane-widget-browser',
+			SOCIALLANE_ELEMENTS_URL . 'admin/js/widget-browser.js',
+			[],
+			SOCIALLANE_ELEMENTS_VERSION,
+			true
+		);
+	}
+
+	/**
+	 * Render the wizard page.
+	 */
+	public function render(): void {
+		$step = isset( $_GET['step'] ) ? sanitize_text_field( wp_unslash( $_GET['step'] ) ) : 'requirements';
+		$valid_steps = [ 'requirements', 'widgets', 'complete' ];
+		$step = in_array( $step, $valid_steps, true ) ? $step : 'requirements';
+
+		$data = match ( $step ) {
+			'requirements' => $this->get_requirements_data(),
+			'widgets'      => $this->get_widgets_data(),
+			'complete'      => $this->get_complete_data(),
+		};
+
+		$view_file = SOCIALLANE_ELEMENTS_PATH . 'admin/views/onboarding.php';
+		if ( file_exists( $view_file ) ) {
+			include $view_file;
+		} else {
+			wp_die( esc_html__( 'Onboarding view file not found.', 'sociallane-elements' ) );
+		}
+	}
+
+	/**
+	 * @return array{requirements: array<int, array{label: string, required: string, detected: string, pass: bool}>, all_pass: bool}
+	 */
+	private function get_requirements_data(): array {
+		$requirements = [
+			[
+				'label'    => __( 'PHP Version', 'sociallane-elements' ),
+				'required' => '8.0+',
+				'detected' => PHP_VERSION,
+				'pass'     => version_compare( PHP_VERSION, '8.0', '>=' ),
+			],
+			[
+				'label'    => __( 'WordPress Version', 'sociallane-elements' ),
+				'required' => '6.0+',
+				'detected' => get_bloginfo( 'version' ),
+				'pass'     => version_compare( get_bloginfo( 'version' ), '6.0', '>=' ),
+			],
+			[
+				'label'    => __( 'Elementor', 'sociallane-elements' ),
+				'required' => __( 'Active (3.18+)', 'sociallane-elements' ),
+				'detected' => defined( 'ELEMENTOR_VERSION' ) ? ELEMENTOR_VERSION : __( 'Not installed', 'sociallane-elements' ),
+				'pass'     => defined( 'ELEMENTOR_VERSION' ) && version_compare( ELEMENTOR_VERSION, '3.18', '>=' ),
+			],
+		];
+
+		$all_pass = true;
+		foreach ( $requirements as $req ) {
+			if ( empty( $req['pass'] ) ) {
+				$all_pass = false;
+				break;
+			}
+		}
+
+		return [
+			'requirements' => $requirements,
+			'all_pass'    => $all_pass,
+		];
+	}
+
+	/**
+	 * @return array{registry: array, categories: array, enabled: array}
+	 */
+	private function get_widgets_data(): array {
+		return [
+			'registry'   => Widget_Manager::get_widget_registry(),
+			'categories' => Widget_Manager::get_categories(),
+			'enabled'    => $this->widget_manager->get_enabled_widgets(),
+		];
+	}
+
+	/**
+	 * @return array{enabled_count: int, total_count: int}
+	 */
+	private function get_complete_data(): array {
+		$enabled = $this->widget_manager->get_enabled_widgets();
+		$total   = count( Widget_Manager::get_widget_registry() );
+
+		return [
+			'enabled_count' => count( $enabled ),
+			'total_count'   => $total,
+		];
+	}
+}

package/includes/class-setup-widget-catalog.php

@@ -0,0 +1,37 @@
+<?php
+/**
+ * Widget Catalog Setup — Shortcode for front-end setup guide
+ *
+ * Use shortcode [sociallane_widget_catalog_setup] on any page so users can
+ * consult the setup instructions and commands when they need to.
+ *
+ * @package SocialLane_Elements
+ */
+
+namespace SocialLane\Elements;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+class Setup_Widget_Catalog {
+
+	public static function init(): void {
+		add_shortcode( 'sociallane_widget_catalog_setup', [ __CLASS__, 'render_shortcode' ] );
+	}
+
+	/**
+	 * Shortcode callback: output the setup guide (front-end).
+	 *
+	 * @param array $atts Shortcode attributes (unused).
+	 * @return string HTML output.
+	 */
+	public static function render_shortcode( $atts ): string {
+		ob_start();
+		$view_file = SOCIALLANE_ELEMENTS_PATH . 'admin/views/setup-widget-catalog-frontend.php';
+		if ( file_exists( $view_file ) ) {
+			include $view_file;
+		}
+		return (string) ob_get_clean();
+	}
+}