Update HelpArticle model

Author: andreia

README.md

@@ -31,6 +31,14 @@ This is the contents of the published config file:
 
 ```php
 return [
+    /*
+    | Help Article Model
+    |
+    | If you extend the HelpArticle model, specify your extended model here.
+    | This ensures Filament resources use your extended model.
+    */
+    'model' => env('FILAMENT_HELP_MODEL', \Tapp\FilamentHelp\Models\HelpArticle::class),
+
     'tenancy' => [
         // Enable or disable tenancy features globally
         'enabled' => env('FILAMENT_HELP_TENANCY_ENABLED', false),
@@ -225,21 +233,76 @@ Or use environment variables in your `.env` file:
 
 ```env
 FILAMENT_HELP_TENANCY_ENABLED=true
+FILAMENT_HELP_TENANCY_MODEL=App\Models\Team
 FILAMENT_HELP_TENANCY_COLUMN=team_id
+FILAMENT_HELP_TENANCY_RELATIONSHIP=team
 FILAMENT_HELP_TENANCY_SCOPE_ADMIN=true
 FILAMENT_HELP_TENANCY_SCOPE_FRONTEND=true
 FILAMENT_HELP_TENANCY_SCOPE_GUEST=false
 ```
 
-2. **Run migrations**:
+2. **Add the tenant relationship to your HelpArticle model**:
+
+Since the package needs to support various tenant models (Team, Organization, etc.), you need to define the relationship in your application.
+
+Extend the `HelpArticle` model in your application:
+
+```php
+// app/Models/HelpArticle.php
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Tapp\FilamentHelp\Models\HelpArticle as BaseHelpArticle;
+
+class HelpArticle extends BaseHelpArticle
+{
+    /**
+     * Get the team that owns the help article.
+     */
+    public function team(): BelongsTo
+    {
+        return $this->belongsTo(\App\Models\Team::class);
+    }
+}
+```
+
+Or if you use a different tenant model:
+
+```php
+public function organization(): BelongsTo
+{
+    return $this->belongsTo(\App\Models\Organization::class);
+}
+```
+
+**Important**: Make sure the relationship name matches the `relationship` config value you set (e.g., `'team'` or `'organization'`).
+
+Then, update your config to use your extended model:
+
+```php
+// config/filament-help.php
+return [
+    'model' => \App\Models\HelpArticle::class,
+    
+    'tenancy' => [
+        'enabled' => true,
+        'model' => \App\Models\Team::class,
+        'column' => 'team_id',
+        'relationship' => 'team',
+        // ...
+    ],
+];
+```
+
+3. **Run migrations**:
 
 When tenancy is enabled, the migration will automatically add the tenant column to the `help_articles` table:
 
 ```bash
 php artisan migrate
 ```
 
-3. **Configure your Filament panel with tenancy**:
+4. **Configure your Filament panel with tenancy**:
 
 ```php
 // In your AdminPanelProvider.php (or wherever you configure your Filament panel)

config/filament-help.php

@@ -2,6 +2,21 @@
 
 return [
 
+    /*
+    |--------------------------------------------------------------------------
+    | Help Article Model
+    |--------------------------------------------------------------------------
+    |
+    | If you extend the HelpArticle model in your application to add custom
+    | relationships (e.g., tenant relationships), specify your extended model here.
+    | This ensures Filament resources use your extended model instead of the base model.
+    |
+    | Example: \App\Models\HelpArticle::class
+    |
+    */
+
+    'model' => \Tapp\FilamentHelp\Models\HelpArticle::class,
+
     /*
     |--------------------------------------------------------------------------
     | Tenancy Configuration

src/Models/HelpArticle.php

@@ -2,10 +2,8 @@
 
 namespace Tapp\FilamentHelp\Models;
 
-use Filament\Models\Contracts\HasTenants;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class HelpArticle extends Model
 {
@@ -46,27 +44,38 @@ public function scopeVisible($query)
         return $query->where('is_hidden', false);
     }
 
-    /**
-     * Get the team that owns this help article.
-     */
-    public function team(): BelongsTo
-    {
-        $tenantModel = config('filament-help.tenancy.model') ?? \App\Models\Team::class;
-        $tenantColumn = config('filament-help.tenancy.column') ?? 'team_id';
-        
-        return $this->belongsTo($tenantModel, $tenantColumn);
-    }
-
     /**
      * Scope query to only include articles for a specific tenant/team.
      */
     public function scopeForTenant($query, $tenant)
     {
+        if (! config('filament-help.tenancy.enabled', false)) {
+            return $query;
+        }
+        
         $tenantColumn = config('filament-help.tenancy.column') ?? 'team_id';
 
         return $query->where($tenantColumn, $tenant->id);
     }
 
+    /**
+     * Define your tenant relationship here.
+     * 
+     * Example for Team:
+     * 
+     * public function team(): BelongsTo
+     * {
+     *     return $this->belongsTo(\App\Models\Team::class);
+     * }
+     * 
+     * Or for Organization:
+     * 
+     * public function organization(): BelongsTo
+     * {
+     *     return $this->belongsTo(\App\Models\Organization::class);
+     * }
+     */
+
     protected static function boot()
     {
         parent::boot();

src/Resources/Frontend/HelpArticleResource.php

@@ -7,14 +7,18 @@
 use Filament\Support\Enums\Alignment;
 use Filament\Tables\Columns\Layout\Stack;
 use Filament\Tables\Table;
-use Tapp\FilamentHelp\Models\HelpArticle;
 use Tapp\FilamentHelp\Resources\Frontend\Pages\ListHelpArticles;
 use Tapp\FilamentHelp\Resources\Frontend\Pages\ViewHelpArticle;
 use Tapp\FilamentHelp\Tables\Components\HelpArticleCardColumn;
 
 class HelpArticleResource extends Resource
 {
-    protected static ?string $model = HelpArticle::class;
+    protected static ?string $model = null;
+
+    public static function getModel(): string
+    {
+        return static::$model ?? config('filament-help.model', \Tapp\FilamentHelp\Models\HelpArticle::class);
+    }
 
     protected static string|\BackedEnum|null $navigationIcon = 'heroicon-o-question-mark-circle';
 

src/Resources/Guest/HelpArticleResource.php

@@ -7,14 +7,18 @@
 use Filament\Support\Enums\Alignment;
 use Filament\Tables\Columns\Layout\Stack;
 use Filament\Tables\Table;
-use Tapp\FilamentHelp\Models\HelpArticle;
 use Tapp\FilamentHelp\Resources\Guest\Pages\ListHelpArticles;
 use Tapp\FilamentHelp\Resources\Guest\Pages\ViewHelpArticle;
 use Tapp\FilamentHelp\Tables\Components\HelpArticleCardColumn;
 
 class HelpArticleResource extends Resource
 {
-    protected static ?string $model = HelpArticle::class;
+    protected static ?string $model = null;
+
+    public static function getModel(): string
+    {
+        return static::$model ?? config('filament-help.model', \Tapp\FilamentHelp\Models\HelpArticle::class);
+    }
 
     protected static string|\BackedEnum|null $navigationIcon = 'heroicon-o-question-mark-circle';
 

src/Resources/HelpArticleResource.php

@@ -12,12 +12,16 @@
 use Filament\Tables\Actions\BulkActionGroup;
 use Filament\Tables\Actions\DeleteBulkAction;
 use Illuminate\Support\Str;
-use Tapp\FilamentHelp\Models\HelpArticle;
 use Tapp\FilamentHelp\Resources\HelpArticleResource\Pages;
 
 class HelpArticleResource extends Resource
 {
-    protected static ?string $model = HelpArticle::class;
+    protected static ?string $model = null;
+
+    public static function getModel(): string
+    {
+        return static::$model ?? config('filament-help.model', \Tapp\FilamentHelp\Models\HelpArticle::class);
+    }
 
     protected static string|\BackedEnum|null $navigationIcon = 'heroicon-o-question-mark-circle';