Skip to content

A self-hosted media server and file management system

feat: working on an SSR implementation for folder previews

aminnausin034a27cb4dba
diff --git a/app/Http/Controllers/Api/V1/PreviewController.php b/app/Http/Controllers/Api/V1/PreviewController.php
new file mode 100644
index 00000000..a7897a47
--- /dev/null
+++ b/app/Http/Controllers/Api/V1/PreviewController.php
@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\FolderResource;
+use App\Models\Category;
+use App\Models\Folder;
+use Illuminate\Http\Request;
+
+class PreviewController extends Controller {
+ public function showPreview(Request $request, $dir = null) {
+ // Parse the URL path
+ $path = $request->path(); // e.g. category/folder?video=123
+ // You’ll need logic to resolve this to the right category/folder/video
+
+ $data = [
+ 'title' => 'Example Title',
+ 'description' => 'An auto-generated preview for bots.',
+ 'imageUrl' => 'https://yourcdn.com/cover.jpg',
+ 'url' => $request->fullUrl(),
+ ];
+
+ try {
+ $category = Category::where('is_private', false)->oldest('id')->first();
+
+ // If no category is found, redirect to /setup
+ if (! $category) {
+ return response()->view('og-preview', $data);
+ }
+
+ $folder = $category->default_folder_id ? Folder::find($category->default_folder_id) : $category->folders()->first();
+
+ if (! $folder) {
+ return response()->view('og-preview', $data);
+ }
+
+ $folderResource = new FolderResource($folder);
+
+ $data['title'] = "$category->name · $folderResource->name";
+ $data['description'] = $folderResource->series->description ?? $category->description ?? 'No Description';
+ $data['imageUrl'] = $folderResource->series->thumbnail_url ? $folderResource->series->thumbnail_url : asset('storage/thumbnails/default.webp');
+ $data['raw'] = $folderResource->series->thumbnail_url ? $folderResource->series->thumbnail_url : asset('storage/thumbnails/default.webp');
+
+ return response()->view('og-preview', $data);
+ } catch (\Throwable $th) {
+ return response()->view('og-preview', [
+ 'title' => 'Example Title',
+ 'description' => 'An auto-generated preview for bots.',
+ 'imageUrl' => 'https://yourcdn.com/cover.jpg',
+ 'url' => $request->fullUrl(),
+ ]);
+ }
+ }
+}
diff --git a/app/Http/Middleware/MetadataSSR.php b/app/Http/Middleware/MetadataSSR.php
new file mode 100644
index 00000000..3623893b
--- /dev/null
+++ b/app/Http/Middleware/MetadataSSR.php
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use App\Http\Controllers\Api\V1\PreviewController;
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class MetadataSSR {
+ /**
+ * Handle an incoming request.
+ *
+ * @param \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response) $next
+ */
+ public function handle(Request $request, Closure $next): Response {
+ if ($this->isSocialMediaBot($request)) {
+ return app(PreviewController::class)->showPreview($request);
+ }
+
+ return $next($request);
+ }
+
+ protected function isSocialMediaBot(Request $request): bool {
+ $userAgent = strtolower($request->header('User-Agent') ?? '');
+
+ if (preg_match('/bot|crawler|spider|facebookexternalhit|slackbot|twitterbot|discordbot|telegrambot|whatsapp|linkedinbot|mastodon|redditbot|pinterest/i', $userAgent)) {
+ return true;
+ }
+
+ $socialHeaders = [
+ 'X-Discord-Preview' => true, // Discord sends this
+ 'X-Twitter-Referer' => true, // Twitter/X
+ 'X-Facebook-External-Hit' => true, // Facebook
+ 'X-Slack-No-Retry' => true, // Slack
+ 'X-Requested-With' => 'XMLHttpRequest', // Some bots
+ ];
+
+ foreach ($socialHeaders as $header => $value) {
+ if ($request->header($header) == $value) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+}
diff --git a/resources/views/og-preview.blade.php b/resources/views/og-preview.blade.php
new file mode 100644
index 00000000..10b6d254
--- /dev/null
+++ b/resources/views/og-preview.blade.php
@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+ <meta charset="UTF-8">
+ <title>{{ $title }}</title>
+
+ <meta property="og:title" content="{{ $title }}">
+ <meta property="og:description" content="{{ $description }}">
+ <meta property="og:image" content="{{ $imageUrl }}">
+ <meta property="og:url" content="{{ $url }}">
+ <meta property="og:type" content="video.other">
+
+ <!-- <meta property="og:image" content="{{ asset('storage/thumbnails/default.webp') }}" /> -->
+ <!-- <meta property="og:image" content="https://img.anili.st/media/176301" data-vue-meta="true"> -->
+ <!-- <meta property="og:url" content="https://anilist.co/anime/176301/The-Apothecary-Diaries-Season-2/" data-vue-meta="true"> -->
+</head>
+
+<body>
+</body>
+
+</html>
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index 96485624..76796834 100755
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,11 +1,9 @@
<?php
-use App\Events\TaskEnded;
-use App\Http\Controllers\DirectoryController;
use App\Http\Controllers\MediaController;
+use App\Http\Middleware\MetadataSSR;
use App\Models\Category;
use App\Models\Folder;
-use App\Models\Task;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Gate;
use Illuminate\Support\Facades\Route;
@@ -31,12 +29,12 @@ if (env('APP_DEBUG')) {
// private
-Route::middleware('auth:sanctum')->group(function () {
- Route::get('/jobs/verifyFiles', [DirectoryController::class, 'verifyFiles']);
- Route::get('/jobs/syncFiles', [DirectoryController::class, 'syncFiles']);
- Route::get('/jobs/indexFiles', [DirectoryController::class, 'indexFiles']);
- Route::get('/jobs/cleanPaths', [DirectoryController::class, 'cleanPaths']);
-});
+// Route::middleware('auth:sanctum')->group(function () {
+// Route::get('/jobs/verifyFiles', [JobController::class, 'verifyFiles']);
+// Route::get('/jobs/syncFiles', [JobController::class, 'syncFiles']);
+// Route::get('/jobs/indexFiles', [JobController::class, 'indexFiles']);
+// Route::get('/jobs/cleanPaths', [JobController::class, 'cleanPaths']);
+// });
// public
@@ -90,7 +88,7 @@ Route::middleware('web')->group(function () {
return redirect("/{$category->name}/{$folder->name}");
});
- Route::get('/{dir?}/{folderName?}', function () {
+ Route::middleware(MetadataSSR::class)->get('/{dir?}/{folderName?}', function () {
return view('home');
})->name('root');