Config Publication Options

Author: jasperf

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.1] - 2025-10-16
+
+### Fixed
+
+- **Config Loading Issue** - Fixed template configuration not loading in production environments
+  - Added fallback config loading directly from package config file
+  - Resolves "No templates found" error when running `wp acorn sage-native-block:create`
+  - Templates now load correctly even if Laravel config() helper fails
+  - Improved resilience for production WordPress/Acorn environments
+
 ## [2.0.0] - 2025-10-14
 
 ### Changed - BREAKING CHANGES
@@ -207,7 +217,8 @@ Templates automatically appear in the category selection menu on next run.
 - Configuration documentation
 - Feature overview and examples
 
-[Unreleased]: https://github.com/imagewize/sage-native-block/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/imagewize/sage-native-block/compare/v2.0.1...HEAD
+[2.0.1]: https://github.com/imagewize/sage-native-block/compare/v2.0.0...v2.0.1
 [2.0.0]: https://github.com/imagewize/sage-native-block/compare/v1.1.0...v2.0.0
 [1.1.0]: https://github.com/imagewize/sage-native-block/compare/v1.0.2...v1.1.0
 [1.0.2]: https://github.com/imagewize/sage-native-block/compare/v1.0.1...v1.0.2

README.md

@@ -23,18 +23,24 @@ You can install this package with Composer from your Sage 11+ theme root directo
 composer require imagewize/sage-native-block --dev
 ```
 
-**NB** You can drop `--dev` but then it will be included in your production build.
+**That's it!** The package is ready to use. No additional setup required.
 
+You can drop `--dev` but then it will be included in your production build.
 
-## Configuration
+## Configuration (Optional)
 
-You can publish the config file with:
+The package works out of the box with default settings. However, you can optionally publish the config file to customize template settings:
 
 ```shell
 wp acorn vendor:publish --provider="Imagewize\SageNativeBlockPackage\Providers\SageNativeBlockServiceProvider"
 ```
 
-**NB**: This is recommended to customize template settings. The package includes default configuration with 5 block templates and typography/spacing presets.
+**When to publish:**
+- You want to customize typography or spacing presets
+- You want to add your own template definitions to the config
+- You're experiencing config loading issues in your environment (rare)
+
+**Note:** Since v2.0.1, the package automatically falls back to loading config directly if it's not published, making this step truly optional.
 
 ## Usage
 
@@ -221,7 +227,15 @@ resources/js/blocks/testimonial/
 
 ### Typography and Spacing Presets
 
-After publishing the config file (`wp acorn vendor:publish`), you can customize typography and spacing presets in `config/sage-native-block.php` to match your theme's design system.
+**Optional:** If you want to customize global typography and spacing presets used by package templates, publish the config file:
+
+```bash
+wp acorn vendor:publish --provider="Imagewize\SageNativeBlockPackage\Providers\SageNativeBlockServiceProvider"
+```
+
+Then edit `config/sage-native-block.php` to match your theme's design system.
+
+**Note:** This only affects package templates (basic, generic, nynaeve). Your custom templates in `block-templates/` are unaffected and use whatever styles you define in them.
 
 ### Creating Custom Templates
 

src/Console/SageNativeBlockCommand.php

@@ -158,7 +158,8 @@ public function handle(RootsFilesystem $rootsFiles): int
         }
 
         // Get template display name
-        $templateConfig = config('sage-native-block.templates')[$template] ?? [];
+        $allTemplates = array_merge($this->getTemplatesConfig(), $this->getThemeTemplates());
+        $templateConfig = $allTemplates[$template] ?? [];
         $templateName = $templateConfig['name'] ?? $template;
 
         // Extract the base name for directory structure
@@ -541,6 +542,47 @@ protected function updateJsFile(RootsFilesystem $rootsFiles): ?bool
         }
     }
 
+    /**
+     * Get templates configuration with fallback to package config file.
+     * This ensures templates are available even if config() helper fails.
+     */
+    protected function getTemplatesConfig(): array
+    {
+        $templates = config('sage-native-block.templates', null);
+
+        // If config is not loaded (returns null or empty), load directly from package
+        if ($templates === null || empty($templates)) {
+            $configPath = dirname(__DIR__, 2) . '/config/sage-native-block.php';
+
+            if (file_exists($configPath)) {
+                $config = require $configPath;
+                $templates = $config['templates'] ?? [];
+            }
+        }
+
+        return $templates ?: [];
+    }
+
+    /**
+     * Get default template with fallback to package config file.
+     */
+    protected function getDefaultTemplate(): string
+    {
+        $default = config('sage-native-block.default_template', null);
+
+        // If config is not loaded, load directly from package
+        if ($default === null) {
+            $configPath = dirname(__DIR__, 2) . '/config/sage-native-block.php';
+
+            if (file_exists($configPath)) {
+                $config = require $configPath;
+                $default = $config['default_template'] ?? 'basic';
+            }
+        }
+
+        return $default ?: 'basic';
+    }
+
     /**
      * Get available template categories dynamically.
      * Returns categories from config templates plus auto-detected theme templates.
@@ -558,7 +600,7 @@ protected function getAvailableCategories(): array
         $categoryNames = [];
 
         // Get categories from config (for package-provided themes like Nynaeve)
-        $templates = config('sage-native-block.templates', []);
+        $templates = $this->getTemplatesConfig();
         foreach ($templates as $template) {
             if (isset($template['category']) &&
                 !in_array($template['category'], ['basic', 'generic'])) {
@@ -693,7 +735,7 @@ protected function promptForTemplateCategory(): string
     protected function promptForTemplate(?string $category = null): string
     {
         // Get package templates from config
-        $packageTemplates = config('sage-native-block.templates', []);
+        $packageTemplates = $this->getTemplatesConfig();
 
         // Get theme templates
         $themeTemplates = $this->getThemeTemplates();
@@ -703,7 +745,7 @@ protected function promptForTemplate(?string $category = null): string
 
         if (empty($allTemplates)) {
             $this->warn('No templates found. Using default.');
-            return config('sage-native-block.default_template', 'basic');
+            return $this->getDefaultTemplate();
         }
 
         // Filter templates by category if provided
@@ -715,7 +757,7 @@ protected function promptForTemplate(?string $category = null): string
 
         if (empty($allTemplates)) {
             $this->warn("No templates found for category '{$category}'. Using default.");
-            return config('sage-native-block.default_template', 'basic');
+            return $this->getDefaultTemplate();
         }
 
         // For 'basic' category, just return the basic template directly
@@ -731,7 +773,7 @@ protected function promptForTemplate(?string $category = null): string
             $keys[] = $key;
         }
 
-        $defaultIndex = array_search(config('sage-native-block.default_template', 'basic'), $keys);
+        $defaultIndex = array_search($this->getDefaultTemplate(), $keys);
         if ($defaultIndex === false) {
             $defaultIndex = 0;
         }
@@ -750,7 +792,7 @@ protected function promptForTemplate(?string $category = null): string
     protected function isValidTemplate(string $template): bool
     {
         // Check package templates
-        $packageTemplates = config('sage-native-block.templates', []);
+        $packageTemplates = $this->getTemplatesConfig();
         if (isset($packageTemplates[$template])) {
             return true;
         }
@@ -777,7 +819,7 @@ protected function getStubPath(string $template): string
         }
 
         // Fall back to package templates
-        $packageTemplates = config('sage-native-block.templates', []);
+        $packageTemplates = $this->getTemplatesConfig();
         if (isset($packageTemplates[$template])) {
             return $packageTemplates[$template]['stub_path'] ?? 'block';
         }