Add guest help article index and show pages with pagination improvements

.github/workflows/phpstan.yml

@@ -1,20 +1,23 @@
 name: PHPStan
 
 on:
-  push:
+  pull_request:
     paths:
       - '**.php'
       - 'phpstan.neon.dist'
       - '.github/workflows/phpstan.yml'
-  pull_request:
+  push:
+    branches:
+      - main
     paths:
       - '**.php'
       - 'phpstan.neon.dist'
       - '.github/workflows/phpstan.yml'
+  workflow_dispatch:
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: false
 
 jobs:
   phpstan:

.github/workflows/pint.yml

@@ -8,6 +8,7 @@ on:
       - 'pint.json'
     branches-ignore:
       - 'dependabot/npm_and_yarn/*'
+  workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}

.github/workflows/test.yml

@@ -1,24 +1,27 @@
 name: Test
 
 on:
-  push:
+  pull_request:
     paths:
       - '**.php'
       - '.github/workflows/test.yml'
       - 'phpunit.xml.dist'
       - 'composer.json'
       - 'composer.lock'
-  pull_request:
+  push:
+    branches:
+      - main
     paths:
       - '**.php'
       - '.github/workflows/test.yml'
       - 'phpunit.xml.dist'
       - 'composer.json'
       - 'composer.lock'
+  workflow_dispatch:
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: false
 
 jobs:
   test:
@@ -33,27 +36,28 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php-version }}
           extensions: bcmath, ctype, fileinfo, json, mbstring, openssl, pdo, tokenizer, xml
           coverage: none
-
       - name: Get composer cache directory
         id: composer-cache
         run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
-
       - name: Setup composer cache
         uses: actions/cache@v3
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: ${{ runner.os }}-composer-
-
       - name: Install composer dependencies
-        run: composer install --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
-
+        run: |
+          composer install --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+      - name: Clear Pest cache
+        run: rm -rf vendor/pestphp/pest/.temp/test-results || true
+      - name: Ensure test directories exist
+        run: |
+          mkdir -p tests/Feature tests/Unit
       - name: Run tests
-        run: composer test
+        run: composer test

.gitignore

@@ -2,7 +2,7 @@
 .pest/
 
 # Composer
-/vendor/
+/vendor
 
 # IDE
 .vscode/
@@ -25,3 +25,6 @@ storage/framework/views/
 
 # Testing
 .phpunit.result.cache
+
+composer.lock
+package-lock.json

README.md

@@ -5,7 +5,7 @@
 ![GitHub Code Style Action Status](https://github.com/TappNetwork/filament-help/actions/workflows/fix-php-code-style-issues.yml/badge.svg)
 [![Total Downloads](https://img.shields.io/packagist/dt/tapp/filament-help.svg?style=flat-square)](https://packagist.org/packages/tapp/filament-help)
 
-This plugin adds help article management to Filament with both admin and frontend capabilities.
+This plugin adds help article management to Filament with admin, frontend, and guest panel capabilities.
 
 ## Version Compatibility
 
@@ -28,38 +28,11 @@ php artisan vendor:publish --tag="filament-help-migrations"
 php artisan migrate
 ```
 
-You can publish the config file with:
-
-```bash
-php artisan vendor:publish --tag="filament-help-config"
-```
-
-This is the contents of the published config file:
-
-```php
-return [
-    'navigation' => [
-        'admin' => [
-            'register' => true,
-            'sort' => 1,
-            'icon' => 'heroicon-o-question-mark-circle',
-            'group' => 'Help',
-        ],
-        'frontend' => [
-            'register' => true,
-            'sort' => 1,
-            'icon' => 'heroicon-o-question-mark-circle',
-            'label' => 'Help',
-        ],
-    ],
-];
-```
-
 ## Using the Plugins
 
-### Admin Plugin
+### Admin Plugin (for editing help articles)
 
-Add this plugin to a panel on `plugins()` method. 
+Add this plugin to your admin panel for full CRUD operations. 
 E.g. in `app/Providers/Filament/AdminPanelProvider.php`:
 
 ```php
@@ -76,9 +49,13 @@ public function panel(Panel $panel): Panel
 }
 ```
 
-### Frontend Plugin
+**Location**: Admin panel (typically `/admin/help-articles`)  
+**Access**: Authenticated admin users only  
+**Features**: Create, edit, delete, and manage all help articles
 
-Add this plugin to a panel for frontend access:
+### Frontend Plugin (for authenticated users)
+
+Add this plugin to your authenticated user panel for read-only access:
 
 ```php
 use Tapp\FilamentHelp\FilamentHelpFrontendPlugin;
@@ -89,18 +66,67 @@ public function panel(Panel $panel): Panel
         // ...
         ->plugins([
             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-articles'` if not specified)
+
+**Location**: App panel (defaults to `{panel-path}/help-articles`, configurable via `->slug()`)  
+**Access**: Authenticated users only  
+**Features**: Read-only access to public help articles
+
+### Guest Plugin (for public access)
+
+Add this plugin to a guest panel (without authentication) for public access:
+
+```php
+use Tapp\FilamentHelp\FilamentHelpGuestPlugin;
+
+public function panel(Panel $panel): Panel
+{
+    return $panel
+        ->id('guest')
+        ->path('') // Panel path (empty = root, or set to your desired base path)
+        // ... other panel configuration
+        // Note: Do NOT add authMiddleware() for guest access
+        ->plugins([
+            FilamentHelpGuestPlugin::make(),
+            // Default slug is 'help', so articles will be at /help (or {panel-path}/help)
+            // 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)
+- **Slug requirement**: Slug must be a non-empty string
+
+**Location**: Guest panel (defaults to `{panel-path}/help`, configurable via `->slug()`)  
+**Access**: Public (no authentication required)  
+**Features**: Read-only access to public help articles for guests
+
+## Help Article Locations
+
+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 `{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).
+
 ## Features
 
 - **Admin Panel**: Full CRUD operations for help articles
-- **Frontend**: Read-only access to public help articles
+- **Frontend/Guest**: Read-only access to public help articles
 - **Rich Content**: HTML content support with iframe embedding
-- **Public/Private**: Control article visibility
-- **Search & Filter**: Find articles by name and filter by public status
+- **Public/Private**: Control article visibility with `is_public` flag
+- **Hidden/Draft**: Hide articles from public view with `is_hidden` flag (useful for drafts or archived articles)
+- **Search & Filter**: Find articles by name and filter by public/hidden status
 
 ## Testing