Adds theme helper, prepares for themes system

app/helpers/theme.php

@@ -0,0 +1,209 @@
+<?php
+
+/**
+ * Theme Helper
+ *
+ * Handles theme management and template/asset loading for the application.
+ * Supports multiple themes with fallback to default theme when needed.
+ * The default theme uses app/templates and public_html/static as fallbacks/
+ */
+
+namespace App\Helpers;
+
+use Exception;
+
+class Theme
+{
+    /**
+     * @var array Theme configuration
+     */
+    private static $config;
+
+    /**
+     * @var string Current theme name
+     */
+    private static $currentTheme;
+
+    /**
+     * Initialize the theme system
+     */
+    public static function init()
+    {
+        self::$config = require __DIR__ . '/../config/theme.php';
+        self::$currentTheme = self::getCurrentThemeName();
+    }
+
+    /**
+     * Get the current theme name
+     *
+     * @return string
+     */
+    public static function getCurrentThemeName()
+    {
+        // Check if already determined
+        if (self::$currentTheme !== null) {
+            return self::$currentTheme;
+        }
+
+        // Get from session if available
+        if (Session::isValidSession() && ($theme = Session::get('user_theme'))) {
+            if (self::themeExists($theme)) {
+                self::$currentTheme = $theme;
+                return $theme;
+            }
+        }
+
+        // Default to 'default' theme which uses app/templates
+        self::$currentTheme = 'default';
+        return 'default';
+    }
+
+    /**
+     * Set the current theme for the session
+     *
+     * @param string $themeName
+     * @return bool
+     */
+    public static function setCurrentTheme(string $themeName): bool
+    {
+        if (!self::themeExists($themeName)) {
+            return false;
+        }
+
+        if (Session::isValidSession()) {
+            Session::set('user_theme', $themeName);
+        }
+
+        self::$currentTheme = $themeName;
+        return true;
+    }
+
+    /**
+     * Check if a theme exists
+     *
+     * @param string $themeName
+     * @return bool
+     */
+    public static function themeExists(string $themeName): bool
+    {
+        $themePath = self::getThemePath($themeName);
+        return is_dir($themePath) && file_exists("$themePath/config.php");
+    }
+
+    /**
+     * Get the path to a theme
+     *
+     * @param string|null $themeName
+     * @return string
+     */
+    public static function getThemePath(?string $themeName = null): string
+    {
+        $themeName = $themeName ?? self::getCurrentThemeName();
+        $config = self::getConfig();
+        return rtrim($config['paths']['themes'], '/') . "/$themeName";
+    }
+
+    /**
+     * Get the URL for a theme asset
+     *
+     * @param string $path
+     * @param bool $includeVersion
+     * @return string
+     */
+    public static function asset($path, $includeVersion = false)
+    {
+        $themeName = self::getCurrentThemeName();
+        $config = self::getConfig();
+        $baseUrl = rtrim($GLOBALS['app_root'] ?? '', '/');
+
+        // For non-default themes, use theme assets
+        if ($themeName !== 'default') {
+            $assetPath = "/themes/{$themeName}/assets/" . ltrim($path, '/');
+
+            // Add version query string for cache busting
+            if ($includeVersion) {
+                $version = self::getThemeVersion($themeName);
+                $assetPath .= (strpos($assetPath, '?') !== false ? '&' : '?') . 'v=' . $version;
+            }
+        } else {
+            // For default theme, use public_html directly
+            $assetPath = '/' . ltrim($path, '/');
+        }
+
+        return $baseUrl . $assetPath;
+    }
+
+    /**
+     * Include a theme template
+     *
+     * @param string $template
+     * @param array $data
+     * @return void
+     */
+    public static function include($template, $data = [])
+    {
+        $themeName = self::getCurrentThemeName();
+        $config = self::getConfig();
+
+        // For non-default themes, look in the theme directory
+        if ($themeName !== 'default') {
+            $themePath = $config['paths']['themes'] . '/' . $themeName . '/views/' . $template . '.php';
+            if (file_exists($themePath)) {
+                extract($data);
+                include $themePath;
+                return;
+            }
+
+            // Fallback to default theme if template not found in custom theme
+            $legacyPath = $config['paths']['templates'] . '/' . $template . '.php';
+            if (file_exists($legacyPath)) {
+                extract($data);
+                include $legacyPath;
+                return;
+            }
+        } else {
+            // Default theme uses app/templates
+            $legacyPath = $config['paths']['templates'] . '/' . $template . '.php';
+            if (file_exists($legacyPath)) {
+                extract($data);
+                include $legacyPath;
+                return;
+            }
+        }
+
+        // Log error if template not found
+        error_log("Template not found: {$template} in theme: {$themeName}");
+    }
+
+    /**
+     * Get all available themes
+     *
+     * @return array
+     */
+    public static function getAvailableThemes(): array
+    {
+        $themes = [];
+        $themesDir = self::$config['path'] ?? (__DIR__ . '/../../themes');
+
+        if (!is_dir($themesDir)) {
+            return [];
+        }
+
+        foreach (scandir($themesDir) as $item) {
+            if ($item === '.' || $item === '..' || !is_dir("$themesDir/$item")) {
+                continue;
+            }
+
+            $configFile = "$themesDir/$item/config.php";
+            if (file_exists($configFile)) {
+                $config = include $configFile;
+                $themes[$item] = $config['name'] ?? ucfirst($item);
+            }
+        }
+
+        return $themes;
+    }
+}
+
+// Initialize the theme system
+Theme::init();