Skip to content

A self-hosted media server and file management system

feat: generate open graph previews in place on the folder images page

aminnausin12ded306a7f6
diff --git a/app/Services/PreviewGeneratorService.php b/app/Services/PreviewGeneratorService.php
index 8d0750ab..328f0bf8 100644
--- a/app/Services/PreviewGeneratorService.php
+++ b/app/Services/PreviewGeneratorService.php
@@ -41,6 +41,7 @@ class PreviewGeneratorService {
public function handle(Request $request, bool $generateRawPreview): Response {
$outputTemplate = $generateRawPreview ? 'og-media-preview' : 'og-preview';
$defaultData = $this->defaultData($request);
+ $imageOnly = $request->query('preview') === '3';
try {
$categorySlug = $request->route('dir');
@@ -57,6 +58,10 @@ class PreviewGeneratorService {
$viewData = $this->preparePreviewData($this->buildFolderPreviewData($category, $folder, $request), $folder->series, $generateRawPreview);
}
+ if ($imageOnly) {
+ return redirect()->to($viewData['thumbnail_url']);
+ }
+
return response()->view($outputTemplate, $viewData);
} catch (\Throwable $e) {
Log::warning('Error generating link preview', [
@@ -64,6 +69,10 @@ class PreviewGeneratorService {
'trace' => $e->getTraceAsString(),
]);
+ if ($imageOnly) {
+ return redirect()->to($this->defaultPoster);
+ }
+
return response()->view('og-preview', $defaultData);
}
}
diff --git a/resources/js/components/folders/FolderImages.vue b/resources/js/components/folders/FolderImages.vue
index 7a33128a..0ce933e5 100644
--- a/resources/js/components/folders/FolderImages.vue
+++ b/resources/js/components/folders/FolderImages.vue
@@ -1,16 +1,17 @@
<script setup lang="ts" generic="T extends ImageType">
-import type { FolderResource, ImageType, SeriesResource } from '@/contracts/media';
+import type { FolderResource, ImageResource, ImageType, SeriesResource } from '@/contracts/media';
import type { ComputedRef } from 'vue';
import { ButtonBase, ButtonText } from '@/components/cedar-ui/button';
import { computed, inject, ref } from 'vue';
+import { usePreviewGenerator } from '@/service/editor/usePreviewGenerator';
import { toPlural } from '@/service/util.ts';
import { cn } from '@aminnausin/cedar-ui';
+import ProiconsArrowSync from '~icons/proicons/arrow-sync';
import ProIconsPhotoOff from '@/components/icons/ProIconsPhotoOff.vue';
import ImageCard from '@/components/cards/data/ImageCard.vue';
import FolderTab from '@/components/folders/FolderTab.vue';
-import IconShare from '@/components/icons/IconShare.vue';
const primaryIds = inject<ComputedRef<Record<T, number>>>('primaryImageIds');
const isAudio = inject<ComputedRef<boolean>>('isAudio');
@@ -25,6 +26,22 @@ const filteredType = ref<ImageType>(activeFilters.value[0]);
const filteredPrimaryId = computed(() => primaryIds?.value?.[filteredType.value as T]);
const isShowingReplaced = ref(false);
+
+const { generate, isGenerating } = usePreviewGenerator();
+
+const generatePreview = async () => {
+ if (!folder?.value || !data?.value.images) return;
+
+ const path = await generate(`/${folder.value.category_id}/${folder.value.id}`);
+ if (!path) return;
+
+ const images = data.value.images;
+ const index = images.findIndex((i) => i.type === 'preview' && !i.replaced_at);
+ const image: ImageResource = { id: images[index]?.id ?? -1, source: 'generated', type: 'preview', path };
+
+ if (index === -1) images.push(image);
+ else images.splice(index, 1, image);
+};
</script>
<template>
<FolderTab class="flex-1">
@@ -95,10 +112,10 @@ const isShowingReplaced = ref(false);
variant="transparent"
type="button"
class="text-foreground-2 hover:text-foreground-0 xs:max-h-none xs:px-1 max-h-6 gap-1.5 p-0 text-xs transition-colors"
- :to="`/${folder.category_id}/${folder.id}?preview=1`"
- :target="'_blank'"
+ @click="generatePreview"
+ :disabled="isGenerating"
>
- <IconShare class="size-3.5" /> {{ filteredImages.length === 0 ? 'Generate' : 'Regenerate' }} preview in new tab
+ <ProiconsArrowSync :class="['size-3.5', { 'animate-spin': isGenerating }]" /> {{ filteredImages.length === 0 ? 'Generate' : 'Regenerate' }} preview
</ButtonBase>
</div>
</div>
diff --git a/resources/js/service/editor/usePreviewGenerator.ts b/resources/js/service/editor/usePreviewGenerator.ts
new file mode 100644
index 00000000..621af9f1
--- /dev/null
+++ b/resources/js/service/editor/usePreviewGenerator.ts
@@ -0,0 +1,46 @@
+import { toast } from '@aminnausin/cedar-ui';
+import { ref } from 'vue';
+
+const requestPreview = async (url: string): Promise<string> => {
+ const target = new URL(url, globalThis.location.origin);
+ target.searchParams.set('preview', '3');
+
+ const res = await fetch(target, { cache: 'no-store' });
+ if (!res.ok) throw new Error(`Preview generation failed (${res.status})`);
+
+ const finalUrl = new URL(res.url);
+ if (!/\/preview\.(webp|png|jpe?g)$/i.test(finalUrl.pathname)) {
+ throw new Error('Preview generation failed (fell back to default image)');
+ }
+
+ return finalUrl.pathname;
+};
+
+export function usePreviewGenerator() {
+ const isGenerating = ref(false);
+
+ const generate = async (url: string): Promise<string | null> => {
+ if (isGenerating.value) return null;
+
+ isGenerating.value = true;
+ try {
+ const path = (await toast.promise(requestPreview(url), {
+ loading: 'Generating Preview',
+ loadingDescription: 'Creating a new preview image',
+ success: 'Preview Generated!',
+ successDescription: 'The preview image has been updated',
+ error: 'Failed to generate preview',
+ errorDescription: (err) => (err as Error).message,
+ })) as string;
+
+ return `${path}?v=${Date.now()}`;
+ } catch (e) {
+ console.error(e);
+ return null;
+ } finally {
+ isGenerating.value = false;
+ }
+ };
+
+ return { generate, isGenerating };
+}