feat: add configuration options to global block resource

Author: mishatch

README.md

@@ -590,14 +590,20 @@ You can configure the plugin directly when registering it:
 ->plugins([
     \Redberry\PageBuilderPlugin\GlobalBlocksPlugin::make()
         ->enableGlobalBlocks(true) // Enable/disable the Global Blocks resource
-        ->resource(\App\Filament\Resources\CustomGlobalBlocksResource::class), // Use custom resource
+        ->resource(\App\Filament\Resources\CustomGlobalBlocksResource::class) // Use custom resource
+        ->navigationGroup('Content Management') // Customize navigation group
+        ->navigationSort(10) // Set navigation sort order
+        ->navigationIcon('heroicon-o-document-text'), // Set navigation icon (use empty string '' to remove icon)
     // ... other plugins
 ])
 ```
 
 **Configuration options:**
 - `enableGlobalBlocks(bool)`: Enable or disable the Global Blocks resource (default: `true`)
 - `resource(string)`: Specify a custom resource class that extends the package's resource
+- `navigationGroup(string)`: Set the navigation group for the Global Blocks resource (default: `'Content Management'`)
+- `navigationSort(int)`: Set the navigation sort order for the Global Blocks resource
+- `navigationIcon(string)`: Set the navigation icon for the Global Blocks resource (use empty string `''` to remove the icon)
 
 This approach allows you to:
 - **Enable Global Blocks on specific panels only** - Perfect for multi-panel applications

resources/views/forms/page-builder.blade.php

@@ -24,6 +24,12 @@
                         $editAction = $getAction($getEditActionName());
                         $editAction = $editAction(['item' => $item, 'index' => $loop->index]);
                         $editActionIsVisible = $editAction->isVisible();
+
+                        $blockType = $item['block_type'] ?? null;
+                        $isGlobalBlock = $blockType &&
+                                        class_exists($blockType) &&
+                                        method_exists($blockType, 'isGlobalBlock') &&
+                                        $blockType::isGlobalBlock();
                     @endphp
                     <li x-sortable-item="{{ $item['id'] }}"
                         class="fi-fo-repeater-item divide-y divide-gray-100 rounded-xl bg-white shadow-sm ring-1 ring-gray-950/5 dark:divide-white/10 dark:bg-white/5 dark:ring-white/10">
@@ -34,12 +40,18 @@ class="fi-fo-repeater-item divide-y divide-gray-100 rounded-xl bg-white shadow-s
                             <div class="flex justify-between w-full items-center">
                                 {{ $getBlockLabel($item['block_type'], $item, $loop->index) }}
                                 <div class="flex gap-x-4 items-center">
+                                    @if ($editActionIsVisible)
+                                        @if ($isGlobalBlock)
+                                            <div class="px-3 py-2">
+                                                <x-heroicon-o-globe-alt class="h-5 w-5 text-white"/>
+                                            </div>
+                                        @else
+                                            {{ $renderEditActionButton($item['id'], $loop->index) }}
+                                        @endif
+                                    @endif
                                     @if ($deleteActionIsVisible)
                                         {{ $renderDeleteActionButton($item['id'], $loop->index) }}
                                     @endif
-                                    @if ($editActionIsVisible)
-                                        {{ $renderEditActionButton($item['id'], $loop->index) }}
-                                    @endif
                                 </div>
                             </div>
                         </div>

src/GlobalBlocksPlugin.php

@@ -12,6 +12,12 @@ class GlobalBlocksPlugin implements Plugin
 
     protected string $globalResourceClass = GlobalBlockConfigResource::class;
 
+    protected ?string $navigationGroup = null;
+
+    protected ?int $navigationSort = null;
+
+    protected ?string $navigationIcon = null;
+
     public static function make(): static
     {
         return app(static::class);
@@ -31,6 +37,27 @@ public function resource(string $resourceClass): static
         return $this;
     }
 
+    public function navigationGroup(string $group): static
+    {
+        $this->navigationGroup = $group;
+
+        return $this;
+    }
+
+    public function navigationSort(int $sort): static
+    {
+        $this->navigationSort = $sort;
+
+        return $this;
+    }
+
+    public function navigationIcon(string $icon): static
+    {
+        $this->navigationIcon = $icon;
+
+        return $this;
+    }
+
     public function getId(): string
     {
         return 'page-builder-global-blocks';
@@ -46,6 +73,18 @@ public function register(Panel $panel): void
             return;
         }
 
+        if ($this->navigationGroup !== null) {
+            $this->globalResourceClass::navigationGroup($this->navigationGroup);
+        }
+
+        if ($this->navigationSort !== null) {
+            $this->globalResourceClass::navigationSort($this->navigationSort);
+        }
+
+        if ($this->navigationIcon !== null) {
+            $this->globalResourceClass::navigationIcon($this->navigationIcon);
+        }
+
         $panel->resources([
             $this->globalResourceClass,
         ]);

src/Resources/GlobalBlockConfigResource.php

@@ -20,6 +20,8 @@ class GlobalBlockConfigResource extends Resource
 
     protected static ?string $navigationGroup = 'Content Management';
 
+    protected static ?int $navigationSort = null;
+
     protected static ?string $navigationLabel = 'Global Blocks';
 
     protected static ?string $modelLabel = 'Global Block';

tests/GlobalBlocksPluginTest.php

@@ -76,3 +76,57 @@
 
     expect($panel->getResources())->toBeEmpty();
 });
+
+it('can configure navigation group', function () {
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationGroup('Custom Group');
+
+    expect($plugin)->toBeInstanceOf(GlobalBlocksPlugin::class);
+});
+
+it('can configure navigation sort', function () {
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationSort(15);
+
+    expect($plugin)->toBeInstanceOf(GlobalBlocksPlugin::class);
+});
+
+it('can configure navigation icon', function () {
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationIcon('heroicon-o-document-text');
+
+    expect($plugin)->toBeInstanceOf(GlobalBlocksPlugin::class);
+});
+
+it('can remove navigation icon with empty string', function () {
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationIcon('');
+
+    expect($plugin)->toBeInstanceOf(GlobalBlocksPlugin::class);
+});
+
+it('applies navigation customizations to resource', function () {
+    $panel = Panel::make();
+
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationGroup('Custom Group')
+        ->navigationSort(25)
+        ->navigationIcon('heroicon-o-cog');
+
+    $plugin->register($panel);
+
+    expect(GlobalBlockConfigResource::getNavigationGroup())->toBe('Custom Group');
+    expect(GlobalBlockConfigResource::getNavigationSort())->toBe(25);
+    expect(GlobalBlockConfigResource::getNavigationIcon())->toBe('heroicon-o-cog');
+});
+
+it('applies empty icon to resource', function () {
+    $panel = Panel::make();
+
+    $plugin = GlobalBlocksPlugin::make()
+        ->navigationIcon('');
+
+    $plugin->register($panel);
+
+    expect(GlobalBlockConfigResource::getNavigationIcon())->toBe('');
+});