feat(view): Render the dotcms page with all it components for content types and grid system

- Introduced DotCmsHelpers class with methods for handling container data and generating HTML attributes.
- Created DotCmsHelpersServiceProvider to register Blade directives for helper methods.
- Updated AppServiceProvider to include DotCmsHelpersServiceProvider for enhanced view functionality.
- Refactored AppController to utilize new helper methods for improved page rendering.
- Enhanced app view with new layout and components for better structure and maintainability.
- Create blade templates for each content types
- Add CSS for the grid system.

Author: fmontes

app/Providers/AppServiceProvider.php

@@ -0,0 +1,3 @@
+use App\Providers\DotCMSHelpersServiceProvider; 
+
+$this->app->register(DotCMSHelpersServiceProvider::class); 

app/Providers/DotCMSHelpersServiceProvider.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Facades\View;
+use App\Helpers\DotCmsHelpers;
+
+class DotCMSHelpersServiceProvider extends ServiceProvider
+{
+    /**
+     * Register services.
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * Bootstrap services.
+     */
+    public function boot(): void
+    {
+        // Share the DotCmsHelpers with all views
+        View::share('dotCmsHelpers', new DotCmsHelpers());
+    }
+} 

bootstrap/providers.php

@@ -0,0 +1 @@
+App\Providers\DotCMSHelpersServiceProvider::class, 

examples/dotcms-laravel/app/Helpers/DotCmsHelpers.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace App\Helpers;
+
+class DotCmsHelpers
+{
+    /**
+     * Get container data from the containers array
+     * 
+     * @param array $containers
+     * @param array $container
+     * @return array|null
+     */
+    public function getContainersData($containers, $container)
+    {
+        if (empty($containers) || empty($container)) {
+            return null;
+        }
+
+        $identifier = $container['identifier'] ?? null;
+        
+        if (!$identifier || !isset($containers[$identifier])) {
+            return null;
+        }
+
+        return $containers[$identifier];
+    }
+
+    /**
+     * Generate HTML attributes from an associative array
+     * 
+     * @param array $attributes
+     * @return string
+     */
+    public function htmlAttr($attributes)
+    {
+        if (empty($attributes)) {
+            return '';
+        }
+
+        $html = '';
+        
+        foreach ($attributes as $key => $value) {
+            if (is_bool($value)) {
+                if ($value) {
+                    $html .= ' ' . $key;
+                }
+            } else {
+                $html .= ' ' . $key . '="' . htmlspecialchars($value, ENT_QUOTES, 'UTF-8') . '"';
+            }
+        }
+        
+        return $html;
+    }
+
+    /**
+     * Generate HTML based on contentlet properties
+     * 
+     * @param array $content
+     * @return string
+     */
+    public function generateHtmlBasedOnProperty($content)
+    {
+        if (empty($content)) {
+            return '';
+        }
+
+        // Check if we have a template to render
+        $contentType = $content['contentType'] ?? '';
+        if ($contentType) {
+            $viewPath = 'dotcms.content-types.' . strtolower($contentType);
+            if (view()->exists($viewPath)) {
+                return view($viewPath, ['content' => $content])->render();
+            }
+        }
+
+        // Default rendering with title
+        $title = $content['title'] ?? $content['name'] ?? 'No Title';
+        return '<div class="content-wrapper"><h3>' . htmlspecialchars($title, ENT_QUOTES, 'UTF-8') . '</h3></div>';
+    }
+} 

examples/dotcms-laravel/app/Http/Controllers/AppController.php

@@ -38,17 +38,33 @@ public function index(Request $request)
             $pageRequest = $this->dotCMSClient->createPageRequest($path, 'json');
 
             // Get the page data
-            $page = $this->dotCMSClient->getPage($pageRequest);
+            $pageAsset = $this->dotCMSClient->getPage($pageRequest);
 
             // Create a navigation request with depth=2
             $navRequest = $this->dotCMSClient->createNavigationRequest('/', 2);
 
             // Get the navigation
             $nav = $this->dotCMSClient->getNavigation($navRequest);
 
+            // Check for entity wrapper in the response
+            if (isset($pageAsset->entity)) {
+                // Some dotCMS versions return data in an 'entity' wrapper
+                $page = $pageAsset;
+            } else {
+                // Standard structure already expected by our templates
+                $page = $pageAsset;
+            }
+
+            // Log the structure for debugging
+            Log::debug('DotCMS Page Structure', [
+                'hasEntity' => isset($pageAsset->entity) ? 'yes' : 'no',
+                'hasLayout' => isset($page->layout) ? 'yes' : 'no',
+                'hasContainers' => isset($page->containers) ? 'yes' : 'no'
+            ]);
+
             // Pass the data to the view
-            return view('app', [
-                'page' => $page,
+            return view('page', [
+                'pageAsset' => $page,
                 'navigation' => $nav
             ]);
         } catch (\Exception $e) {

examples/dotcms-laravel/app/Providers/AppServiceProvider.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Support\ServiceProvider;
 use App\Providers\DotCMSServiceProvider;
+use App\Providers\DotCmsHelpersServiceProvider;
 
 class AppServiceProvider extends ServiceProvider
 {
@@ -13,6 +14,7 @@ class AppServiceProvider extends ServiceProvider
     public function register(): void
     {
         $this->app->register(DotCMSServiceProvider::class);
+        $this->app->register(DotCmsHelpersServiceProvider::class);
     }
 
     /**

examples/dotcms-laravel/app/Providers/DotCmsHelpersServiceProvider.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Facades\View;
+use App\Helpers\DotCmsHelpers;
+
+class DotCmsHelpersServiceProvider extends ServiceProvider
+{
+    /**
+     * Register services.
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * Bootstrap services.
+     */
+    public function boot(): void
+    {
+        // Share the DotCmsHelpers with all views
+        View::share('dotCmsHelpers', new DotCmsHelpers());
+    }
+}

examples/dotcms-laravel/bootstrap/providers.php

@@ -3,4 +3,5 @@
 return [
     App\Providers\AppServiceProvider::class,
     App\Providers\DotCMSServiceProvider::class,
+    App\Providers\DotCmsHelpersServiceProvider::class,
 ];

examples/dotcms-laravel/resources/css/app.css

@@ -10,3 +10,37 @@
     --font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
         'Segoe UI Symbol', 'Noto Color Emoji';
 }
+
+/* Grid System */
+.row {
+    display: grid;
+    grid-template-columns: repeat(12, 1fr);
+    gap: 1rem;
+}
+
+.col-start-1 { grid-column-start: 1; }
+.col-start-2 { grid-column-start: 2; }
+.col-start-3 { grid-column-start: 3; }
+.col-start-4 { grid-column-start: 4; }
+.col-start-5 { grid-column-start: 5; }
+.col-start-6 { grid-column-start: 6; }
+.col-start-7 { grid-column-start: 7; }
+.col-start-8 { grid-column-start: 8; }
+.col-start-9 { grid-column-start: 9; }
+.col-start-10 { grid-column-start: 10; }
+.col-start-11 { grid-column-start: 11; }
+.col-start-12 { grid-column-start: 12; }
+
+.col-end-1 { grid-column-end: 1; }
+.col-end-2 { grid-column-end: 2; }
+.col-end-3 { grid-column-end: 3; }
+.col-end-4 { grid-column-end: 4; }
+.col-end-5 { grid-column-end: 5; }
+.col-end-6 { grid-column-end: 6; }
+.col-end-7 { grid-column-end: 7; }
+.col-end-8 { grid-column-end: 8; }
+.col-end-9 { grid-column-end: 9; }
+.col-end-10 { grid-column-end: 10; }
+.col-end-11 { grid-column-end: 11; }
+.col-end-12 { grid-column-end: 12; }
+.col-end-13 { grid-column-end: 13; }