feat: Add EPG map bypass options to channels and EPG Maps

Resolves #416

Author: sparkison

app/Filament/Resources/Channels/ChannelResource.php

@@ -41,6 +41,7 @@
 use Filament\Schemas\Components\Utilities\Set;
 use Filament\Schemas\Schema;
 use Filament\Support\Enums\Width;
+use Filament\Tables\Columns\IconColumn;
 use Filament\Tables\Columns\ImageColumn;
 use Filament\Tables\Columns\SelectColumn;
 use Filament\Tables\Columns\TextColumn;
@@ -278,6 +279,10 @@ public static function getTableColumns($showGroup = true, $showPlaylist = true):
                     }
                 })
                 ->sortable(),
+            IconColumn::make('epg_map_enabled')
+                ->label('Mapping Enabled')
+                ->sortable()
+                ->boolean(),
             TextColumn::make('epgChannel.name')
                 ->label('EPG Channel')
                 ->toggleable()
@@ -783,6 +788,47 @@ public static function getTableBulkActions($addToCustom = true): array
                     ->modalIcon('heroicon-o-arrow-uturn-left')
                     ->modalDescription('Reset Find & Replace results back to playlist defaults for the selected channels. This will remove any custom values set in the selected column.')
                     ->modalSubmitActionLabel('Reset now'),
+                BulkAction::make('enable-epg-mapping')
+                    ->label('Enable EPG mapping')
+                    ->action(function (Collection $records, array $data): void {
+                        $records->each(fn ($channel) => $channel->update([
+                            'epg_map_enabled' => true,
+                        ]));
+                    })->after(function () {
+                        Notification::make()
+                            ->success()
+                            ->title('EPG map re-enabled for selected channels')
+                            ->body('The EPG map has been re-enabled for the selected channels.')
+                            ->send();
+                    })
+                    ->hidden(fn () => ! $addToCustom)
+                    ->deselectRecordsAfterCompletion()
+                    ->requiresConfirmation()
+                    ->icon('heroicon-o-calendar')
+                    ->modalIcon('heroicon-o-calendar')
+                    ->modalDescription('Allow mapping EPG to selected channels when running EPG mapping jobs.')
+                    ->modalSubmitActionLabel('Enable now'),
+                BulkAction::make('disable-epg-mapping')
+                    ->label('Disabled EPG mapping')
+                    ->color('warning')
+                    ->action(function (Collection $records, array $data): void {
+                        $records->each(fn ($channel) => $channel->update([
+                            'epg_map_enabled' => false,
+                        ]));
+                    })->after(function () {
+                        Notification::make()
+                            ->success()
+                            ->title('EPG map disabled for selected channels')
+                            ->body('The EPG map has been disabled for the selected channels.')
+                            ->send();
+                    })
+                    ->hidden(fn () => ! $addToCustom)
+                    ->deselectRecordsAfterCompletion()
+                    ->requiresConfirmation()
+                    ->icon('heroicon-o-calendar')
+                    ->modalIcon('heroicon-o-calendar')
+                    ->modalDescription('Don\'t map EPG to selected channels when running EPG mapping jobs.')
+                    ->modalSubmitActionLabel('Disable now'),
                 BulkAction::make('enable')
                     ->label('Enable selected')
                     ->action(function (Collection $records): void {

app/Filament/Resources/EpgMaps/EpgMapResource.php

@@ -269,6 +269,13 @@ public static function getForm(
                 ->columns(2)
                 ->columnSpanFull()
                 ->schema([
+                    Toggle::make('settings.skip_missing')
+                        ->label('Skip channels without EPG ID')
+                        ->columnSpanFull()
+                        ->inline(true)
+                        ->live()
+                        ->default(false)
+                        ->helperText('When enabled, channels that do not have "epg_channel_id" or "tvg-id" will be skipped during the mapping process. Disable this to attempt to match all channels, even those without an EPG ID.'),
                     Toggle::make('settings.use_regex')
                         ->label('Use regex for filtering')
                         ->columnSpanFull()

app/Jobs/MapPlaylistChannelsToEpg.php

@@ -109,7 +109,10 @@ public function handle(): void
                     ->whereNotNull('epg_channel_id')
                     ->count();
                 $channels = Channel::whereIn('id', $this->channels)
-                    ->where('is_vod', false)
+                    ->where([
+                        ['is_vod', false],
+                        ['epg_map_enabled', true],
+                    ])
                     ->when(! $this->force, function ($query) {
                         $query->where('epg_channel_id', null);
                     });
@@ -120,7 +123,10 @@ public function handle(): void
                     ->whereNotNull('epg_channel_id')
                     ->count();
                 $channels = $playlist->channels()
-                    ->where('is_vod', false)
+                    ->where([
+                        ['is_vod', false],
+                        ['epg_map_enabled', true],
+                    ])
                     ->when(! $this->force, function ($query) {
                         $query->where('epg_channel_id', null);
                     });

app/Models/Channel.php

@@ -46,6 +46,7 @@ class Channel extends Model
         'movie_data' => 'array',
         'sync_settings' => 'array',
         'last_metadata_fetch' => 'datetime',
+        'epg_map_enabled' => 'boolean',
         'logo_type' => ChannelLogoType::class,
     ];
 

app/Models/EpgMap.php

@@ -27,6 +27,7 @@ class EpgMap extends Model
         'mapped_count' => 'integer',
         'settings' => 'array',
         'channels' => 'array',
+        'skip_missing_epg_id' => 'boolean',
         'status' => Status::class,
     ];
 

database/migrations/2026_01_26_085249_add_epg_map_bypass_to_channels.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('channels', function (Blueprint $table) {
+            $table->boolean('epg_map_enabled')->default(true)->after('epg_channel_id');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('channels', function (Blueprint $table) {
+            $table->dropColumn('epg_map_enabled');
+        });
+    }
+};