Update guest panel resource to support nullable slug and fix logout route handling

Author: scott grayson

README.md

@@ -65,17 +65,17 @@ public function panel(Panel $panel): Panel
     return $panel
         // ...
         ->plugins([
-            FilamentHelpFrontendPlugin::make()
-                ->slug('app/help'), // Optional: customize the URL slug
-            //...
+            FilamentHelpFrontendPlugin::make(),
+            // Default slug is 'help-articles', so articles will be at {panel-path}/help-articles
+            // Customize with ->slug('custom-slug') if needed
         ]);
 }
 ```
 
 **Configuration Options:**
-- **Plugin method**: `->slug('custom-slug')` - Set the URL slug when registering the plugin (defaults to `'help'` if not specified)
+- **Plugin method**: `->slug('custom-slug')` - Set the URL slug when registering the plugin (defaults to `'help-articles'` if not specified)
 
-**Location**: App panel (defaults to `/help`, configurable via `->slug()`)  
+**Location**: App panel (defaults to `{panel-path}/help-articles`, configurable via `->slug()`)  
 **Access**: Authenticated users only  
 **Features**: Read-only access to public help articles
 
@@ -114,8 +114,8 @@ public function panel(Panel $panel): Panel
 Help articles are available in three different locations depending on your setup:
 
 1. **Admin Panel** (`/admin/help-articles`): For editing and managing help articles
-2. **App Panel** (configurable, default `/help`): For authenticated users to view public help articles
-3. **Guest Panel** (configurable, default uses panel path): For public/guest users to view public help articles
+2. **App Panel** (configurable, default `{panel-path}/help-articles`): For authenticated users to view public help articles
+3. **Guest Panel** (configurable, default `{panel-path}/help`): For public/guest users to view public help articles
 
 The frontend and guest panel URLs can be customized using the plugin's `->slug()` method when registering the plugin (see plugin documentation above).
 

config/filament-help.php

@@ -27,3 +27,4 @@
 </x-filament-panels::page>
 
 
+

resources/views/pages/list-help.blade.php

@@ -28,8 +28,8 @@ public function getId(): string
 
     public function register(Panel $panel): void
     {
-        // Set the slug on the resource - use provided slug or default to 'help'
-        $defaultSlug = 'help';
+        // Set the slug on the resource - use provided slug or default to 'help-articles'
+        $defaultSlug = 'help-articles';
         $slug = $this->slug ?? $defaultSlug;
 
         if (empty($slug)) {

resources/views/pages/view-help.blade.php

@@ -32,8 +32,10 @@ public function register(Panel $panel): void
         $defaultSlug = 'help';
         $slug = $this->slug ?? $defaultSlug;
 
-        if (empty($slug)) {
-            throw new \InvalidArgumentException('Slug cannot be empty. Please provide a non-empty slug when registering the plugin.');
+        // Allow empty slug only if explicitly passed (to use panel path directly)
+        // But default must always be non-empty
+        if ($slug === $defaultSlug && empty($slug)) {
+            throw new \InvalidArgumentException('Default slug cannot be empty. Please provide a non-empty slug when registering the plugin.');
         }
 
         \Tapp\FilamentHelp\Resources\Guest\HelpArticleResource::setSlug($slug);

resources/views/resources/guest/help-article-resource/pages/view-help-article.blade.php

@@ -13,7 +13,6 @@ public function configurePackage(Package $package): void
         $package
             ->name('filament-help')
             ->hasViews()
-            ->hasConfigFile('filament-help')
             ->hasMigrations([
                 'create_help_articles_table',
                 'add_is_hidden_to_help_articles_table',
@@ -24,17 +23,4 @@ public function configurePackage(Package $package): void
                     ->askToRunMigrations();
             });
     }
-
-    public function boot(): void
-    {
-        parent::boot();
-
-        $this->publishes([
-            __DIR__.'/../../resources/views' => resource_path('views/vendor/filament-help'),
-        ], 'filament-help-views');
-
-        $this->publishes([
-            __DIR__.'/../resources/css/help.css' => public_path('vendor/filament-help/help.css'),
-        ], 'filament-help-assets');
-    }
 }

src/FilamentHelpFrontendPlugin.php

@@ -27,7 +27,7 @@ public static function shouldRegisterNavigation(): bool
 
     protected static ?string $modelLabel = 'Help Article';
 
-    protected static string $slug = 'help';
+    protected static ?string $slug = 'help-articles';
 
     public static function setSlug(string $slug): void
     {

src/FilamentHelpGuestPlugin.php

@@ -27,14 +27,11 @@ public static function shouldRegisterNavigation(): bool
 
     protected static ?string $modelLabel = 'Help Article';
 
-    protected static string $slug = 'help';
+    protected static ?string $slug = 'help';
 
     public static function setSlug(string $slug): void
     {
-        if (empty($slug)) {
-            throw new \InvalidArgumentException('Slug cannot be empty.');
-        }
-
+        // Allow empty string to use panel path directly (when explicitly set)
         static::$slug = $slug;
     }