feat:[LAR-34] Add filament tags crud in cpanel with feature test (#203)

Author: cybersoldattech

.gitignore

@@ -4,7 +4,6 @@
 npm-debug.log
 yarn-error.log
 yarn.lock
-
 /vendor
 composer.phar
 

app/Filament/Resources/TagResource.php

@@ -0,0 +1,92 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources;
+
+use App\Filament\Resources\TagResource\Pages;
+use App\Models\Tag;
+use Filament\Forms;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Form;
+use Filament\Resources\Resource;
+use Filament\Support\Enums\MaxWidth;
+use Filament\Tables;
+use Filament\Tables\Table;
+use Illuminate\Support\Str;
+
+final class TagResource extends Resource
+{
+    protected static ?string $model = Tag::class;
+
+    protected static ?string $navigationIcon = 'heroicon-o-tag';
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->schema([
+                Forms\Components\TextInput::make('name')
+                    ->live(onBlur: true)
+                    ->required()
+                    ->unique()
+                    ->validationMessages([
+                        'unique' => 'Cette valeur existe déjà',
+                    ])
+                    ->afterStateUpdated(function (string $operation, $state, Forms\Set $set): void {
+                        $set('slug', Str::slug($state));
+                    })
+                    ->columnSpanFull(),
+                Forms\Components\TextInput::make('slug')
+                    ->readOnly()
+                    ->required()
+                    ->helperText(__('Cette valeur est générée dynamiquement en fonction du Name.'))
+                    ->columnSpanFull(),
+                Select::make('concerns')
+                    ->multiple()
+                    ->options([
+                        'post' => 'Post',
+                        'tutorial' => 'Tutoriel',
+                        'discussion' => 'Discussion',
+                    ])
+                    ->required()
+                    ->columnSpanFull(),
+                Forms\Components\Textarea::make('description')
+                    ->columnSpanFull(),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                Tables\Columns\TextColumn::make('name')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make('slug')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make(name: 'concerns'),
+            ])
+            ->filters([
+                //
+            ])
+            ->actions([
+                \Filament\Tables\Actions\ActionGroup::make([
+                    Tables\Actions\DeleteAction::make(),
+                    Tables\Actions\EditAction::make()
+                        ->slideOver()
+                        ->modalWidth(MaxWidth::Large),
+                ]),
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListTags::route('/'),
+        ];
+    }
+}

app/Filament/Resources/TagResource/Pages/ListTags.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\TagResource\Pages;
+
+use App\Filament\Resources\TagResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ListRecords;
+use Filament\Support\Enums\MaxWidth;
+
+final class ListTags extends ListRecords
+{
+    protected static string $resource = TagResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\CreateAction::make()
+                ->slideOver()
+                ->modalWidth(MaxWidth::Large),
+        ];
+    }
+}

tests/Feature/Filament/TagTest.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Filament\Resources\TagResource;
+use App\Filament\Resources\TagResource\Pages\ListTags;
+use App\Models\Tag;
+use Filament\Actions\CreateAction;
+use Filament\Actions\EditAction;
+use Illuminate\Database\Eloquent\Factories\Sequence;
+use Livewire\Livewire;
+
+beforeEach(function (): void {
+    $this->user = $this->login();
+    $this->tags = Tag::factory()
+        ->count(10)
+        ->state(new Sequence(
+            ['concerns' => ['post', 'tutorial']],
+            ['concerns' => ['post']],
+        ))
+        ->create();
+});
+
+describe(TagResource::class, function (): void {
+    it('page can display table with records', function (): void {
+        Livewire::test(ListTags::class)
+            ->assertCanSeeTableRecords($this->tags);
+    });
+
+    it('can validate input is value is null or empty', function (): void {
+        $name = fake()->name();
+
+        Livewire::test(ListTags::class)
+            ->callAction(CreateAction::class, data: [
+                'name' => null,
+                'concerns' => [],
+                'description' => 'Description du tag '.$name,
+            ])
+            ->assertHasActionErrors(['name' => 'required', 'concerns' => 'required']);
+    });
+
+    it('Admin can create tag', function (): void {
+        $name = fake()->name();
+
+        Livewire::test(ListTags::class)
+            ->callAction(CreateAction::class, data: [
+                'name' => $name,
+                'concerns' => ['post', 'tutorial'],
+                'description' => 'Description du tag '.$name,
+            ])
+            ->assertHasNoActionErrors()
+            ->assertStatus(200);
+    });
+
+    it('Admin can edit tag', function (): void {
+        $tag = Tag::factory()->create();
+
+        Livewire::test(ListTags::class)
+            ->callTableAction(EditAction::class, $tag, data: [
+                'name' => 'Edited tag',
+            ])
+            ->assertHasNoTableActionErrors();
+
+        $tag->refresh();
+
+        expect($tag->name)
+            ->toBe('Edited tag');
+    });
+
+})->group('tags');