feat(hub): add support for content warnings

app/Community/Controllers/UserSettingsController.php

@@ -21,9 +21,11 @@
 use App\Data\UserData;
 use App\Data\UserPermissionsData;
 use App\Enums\Permissions;
+use App\Enums\UserPreference;
 use App\Http\Controller;
 use App\Models\User;
 use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Inertia\Inertia;
 use Inertia\Response as InertiaResponse;
@@ -124,6 +126,21 @@ public function updateLocale(UpdateLocaleRequest $request): JsonResponse
         return response()->json(['success' => true]);
     }
 
+    // TODO migrate to $user->preferences blob
+    public function enableSuppressMatureContentWarning(Request $request): JsonResponse
+    {
+        /** @var User $user */
+        $user = $request->user();
+
+        $currentPreferences = (int) $user->getAttribute('websitePrefs');
+        $newPreferences = $currentPreferences | (1 << UserPreference::Site_SuppressMatureContentWarning);
+
+        $user->websitePrefs = $newPreferences;
+        $user->save();
+
+        return response()->json(['success' => true]);
+    }
+
     // TODO migrate to $user->preferences blob
     public function updatePreferences(UpdateWebsitePrefsRequest $request): JsonResponse
     {

app/Community/RouteServiceProvider.php

@@ -339,6 +339,9 @@ protected function mapWebRoutes(): void
                     'middleware' => ['auth'],
                     'prefix' => 'internal-api/settings',
                 ], function () {
+                    Route::patch('/preferences/content-warning', [UserSettingsController::class, 'enableSuppressMatureContentWarning'])
+                        ->name('api.settings.preferences.suppress-mature-content-warning');
+
                     Route::put('profile', [UserSettingsController::class, 'updateProfile'])->name('api.settings.profile.update');
                     Route::put('locale', [UserSettingsController::class, 'updateLocale'])->name('api.settings.locale.update');
                     Route::put('preferences', [UserSettingsController::class, 'updatePreferences'])->name('api.settings.preferences.update');

app/Data/UserData.php

@@ -42,7 +42,10 @@ public function __construct(
         public Lazy|string|null $visibleRole = null,
         public Lazy|int|null $websitePrefs = null,
 
-        #[TypeScriptType(['prefersAbsoluteDates' => 'boolean'])]
+        #[TypeScriptType([
+            'shouldAlwaysBypassContentWarnings' => 'boolean',
+            'prefersAbsoluteDates' => 'boolean',
+        ])]
         public Lazy|array|null $preferences = [],
         #[LiteralTypeScriptType('App.Models.UserRole[]')]
         public Lazy|array|null $roles = [],
@@ -82,6 +85,7 @@ public static function fromUser(User $user): self
             motto: Lazy::create(fn () => $user->Motto),
             preferences: Lazy::create(
                 fn () => [
+                    'shouldAlwaysBypassContentWarnings' => $user->should_always_bypass_content_warnings,
                     'prefersAbsoluteDates' => $user->prefers_absolute_dates,
                 ]
             ),

app/Filament/Resources/HubResource.php

@@ -10,6 +10,7 @@
 use App\Filament\Resources\HubResource\RelationManagers\GamesRelationManager;
 use App\Filament\Resources\HubResource\RelationManagers\ParentHubsRelationManager;
 use App\Models\GameSet;
+use App\Models\User;
 use App\Platform\Enums\GameSetType;
 use App\Support\Rules\NoEmoji;
 use Filament\Forms;
@@ -20,6 +21,7 @@
 use Filament\Tables;
 use Filament\Tables\Table;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Facades\Auth;
 
 class HubResource extends Resource
 {
@@ -57,6 +59,11 @@ public static function infolist(Infolist $infolist): Infolist
                         Infolists\Components\TextEntry::make('title')
                             ->label('Title'),
 
+                        Infolists\Components\TextEntry::make('has_content_warning')
+                            ->label('Has Content Warning')
+                            ->formatStateUsing(fn (bool $state): string => $state ? 'Yes' : 'No')
+                            ->color(fn (bool $state): string => $state ? 'danger' : ''),
+
                         BreadcrumbPreview::make('breadcrumbs')
                             ->label('Breadcrumb Preview')
                             ->columnSpanFull(),
@@ -74,6 +81,9 @@ public static function infolist(Infolist $infolist): Infolist
 
     public static function form(Form $form): Form
     {
+        /** @var User $user */
+        $user = Auth::user();
+
         return $form
             ->schema([
                 Forms\Components\Section::make('Primary Details')
@@ -85,6 +95,12 @@ public static function form(Form $form): Form
                             ->minLength(2)
                             ->maxLength(80)
                             ->rules([new NoEmoji()]),
+
+                        Forms\Components\Toggle::make('has_content_warning')
+                            ->label('Has Content Warning')
+                            ->helperText('CAUTION: If this is enabled, players will get a warning when opening any game in the hub!')
+                            ->default(false)
+                            ->visible(fn ($record) => $user->can('toggleHasContentWarning', $record)),
                     ]),
 
                 Forms\Components\Section::make('Internal Notes')

app/Models/Game.php

@@ -323,6 +323,11 @@ public function getCanonicalUrlAttribute(): string
         return route('game.show', [$this, $this->getSlugAttribute()]);
     }
 
+    public function getHasContentWarningAttribute(): bool
+    {
+        return $this->gameSets()->where('has_content_warning', true)->exists();
+    }
+
     public function getLastUpdatedAttribute(): Carbon
     {
         return $this->last_achievement_update ?? $this->Updated;

app/Models/GameSet.php

@@ -36,13 +36,15 @@ class GameSet extends BaseModel
         'game_id',
         'internal_notes',
         'image_asset_path',
+        'has_content_warning',
         'title',
         'type',
         'updated_at',
         'user_id',
     ];
 
     protected $casts = [
+        'has_content_warning' => 'boolean',
         'type' => GameSetType::class,
     ];
 
@@ -148,9 +150,10 @@ public function getActivitylogOptions(): LogOptions
     {
         return LogOptions::defaults()
             ->logOnly([
-                'title',
-                'internal_notes',
+                'has_content_warning',
                 'image_asset_path',
+                'internal_notes',
+                'title',
             ])
             ->logOnlyDirty()
             ->dontSubmitEmptyLogs();

app/Models/User.php

@@ -428,6 +428,11 @@ public function getPermissionsAttribute(): int
         return $this->attributes['Permissions'];
     }
 
+    public function getShouldAlwaysBypassContentWarningsAttribute(): bool
+    {
+        return BitSet($this->getAttribute('websitePrefs'), UserPreference::Site_SuppressMatureContentWarning);
+    }
+
     public function getPrefersAbsoluteDatesAttribute(): bool
     {
         return BitSet($this->getAttribute('websitePrefs'), UserPreference::Forum_ShowAbsoluteDates);

app/Platform/Actions/BuildGameSetRelatedHubsAction.php

@@ -25,6 +25,7 @@ public function execute(GameSet $gameSet): array
                 'title',
                 'image_asset_path',
                 'type',
+                'has_content_warning',
                 'updated_at',
             ])
             ->withCount([

app/Platform/Actions/BuildHubBreadcrumbsAction.php

@@ -7,6 +7,7 @@
 use App\Models\GameSet;
 use App\Platform\Data\GameSetData;
 use App\Platform\Enums\GameSetType;
+use Carbon\Carbon;
 use Illuminate\Support\Facades\Cache;
 
 /**
@@ -163,7 +164,8 @@ public function execute(GameSet $gameSet): array
                 badgeUrl: media_asset($data['image_asset_path']),
                 gameCount: 0,
                 linkCount: 0,
-                updatedAt: new \Carbon\Carbon($data['updated_at']),
+                updatedAt: new Carbon($data['updated_at']),
+                hasContentWarning: false, // doesn't matter, this is just a breadcrumb
             ),
             $cachedData ?? [],
         );

app/Platform/Controllers/HubController.php

@@ -93,7 +93,7 @@ public function show(GameListRequest $request, ?GameSet $gameSet): InertiaRespon
         $can = UserPermissionsData::fromUser($user)->include('develop', 'manageGameSets');
 
         $props = new HubPagePropsData(
-            hub: GameSetData::from($gameSet)->include('title', 'badgeUrl', 'updatedAt'),
+            hub: GameSetData::from($gameSet)->include('title', 'badgeUrl', 'updatedAt', 'hasContentWarning'),
             relatedHubs: (new BuildGameSetRelatedHubsAction())->execute($gameSet),
             breadcrumbs: (new BuildHubBreadcrumbsAction())->execute($gameSet),
             paginatedGameListEntries: $paginatedData,

app/Platform/Data/GameSetData.php

@@ -8,6 +8,7 @@
 use App\Platform\Enums\GameSetType;
 use Carbon\Carbon;
 use Spatie\LaravelData\Data;
+use Spatie\LaravelData\Lazy;
 use Spatie\TypeScriptTransformer\Attributes\TypeScript;
 
 #[TypeScript('GameSet')]
@@ -21,6 +22,7 @@ public function __construct(
         public int $gameCount,
         public int $linkCount,
         public Carbon $updatedAt,
+        public Lazy|bool $hasContentWarning,
     ) {
     }
 
@@ -37,6 +39,7 @@ public static function fromGameSetWithCounts(GameSet $gameSet): self
             gameCount: $gameSet->games_count ?? 0,
             linkCount: $gameSet->link_count ?? 0,
             updatedAt: $gameSet->updated_at,
+            hasContentWarning: Lazy::create(fn () => $gameSet->has_content_warning),
         );
     }
 }

app/Policies/GameSetPolicy.php

@@ -67,4 +67,12 @@ public function forceDelete(User $user, GameSet $gameSet): bool
     {
         return false;
     }
+
+    public function toggleHasContentWarning(User $user, GameSet $gameSet): bool
+    {
+        return $user->hasAnyRole([
+            Role::ADMINISTRATOR,
+            Role::DEVELOPER_STAFF,
+        ]);
+    }
 }

database/migrations/2024_12_18_000000_update_game_sets_tables.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class() extends Migration {
+    public function up(): void
+    {
+        Schema::table('game_sets', function (Blueprint $table) {
+            $table->boolean('has_content_warning')->default(false)->after('definition');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('game_sets', function (Blueprint $table) {
+            $table->dropColumn('has_content_warning');
+        });
+    }
+};

lang/en_US.json

@@ -502,7 +502,6 @@
     "Go to previous news page": "Go to previous news page",
     "Go to next news page": "Go to next news page",
     "Swipe to view more": "Swipe to view more",
-    "All {{systemName}} Games": "All {{systemName}} Games",
     "rowGroupAriaLabel_one": "{{systemName}} group with {{val, number}} game",
     "rowGroupAriaLabel_other": "{{systemName}} group with {{val, number}} games",
     "Games are now grouped by system": "Games are now grouped by system",
@@ -512,5 +511,9 @@
     "Getting Started": "Getting Started",
     "Moderation Comments - {{user}}": "Moderation Comments - {{user}}",
     "Moderation Comments": "Moderation Comments",
+    "Content Warning": "Content Warning",
+    "This page may contain content that is not appropriate for all ages.": "This page may contain content that is not appropriate for all ages.",
+    "Are you sure you want to view this page?": "Are you sure you want to view this page?",
+    "Yes, and don't ask again": "Yes, and don't ask again",
     "Columns": "Columns"
 }

package.json

@@ -23,6 +23,7 @@
         "@floating-ui/dom": "^1.5.1",
         "@hookform/resolvers": "^3.9.0",
         "@inertiajs/core": "^1.2.0",
+        "@radix-ui/react-alert-dialog": "^1.1.4",
         "@radix-ui/react-checkbox": "^1.1.1",
         "@radix-ui/react-dialog": "^1.1.2",
         "@radix-ui/react-dropdown-menu": "^2.1.1",