Medie-billeder

4. Medie-billeder

Media-modulet er centralt for alt visuelt indhold. Billeder, PDF'er, ikoner — alt uploadet og genbrugt herfra. TesseraCMS lagrer dem i Azure Blob Storage med et struktureret path-skema så de er nemme at finde tilbage til.

Hvor billeder lever

Alle uploads ender i Azure Blob Storage under en media-container. Pathen er struktureret pr. tenant og pr. record:

tenants/{tenant-slug}/{content-type}/{record-id}/{filename}

Konkret eksempel:

tenants/palle_jacobsen/Hero/hero-mpgtwdui-c13ktc/staevner-bg-1738.jpg

Det betyder:

  • Hver tenant er isoleret — palle's billeder ligger under tenants/palle_jacobsen/, nyborg under tenants/nyborg_rideklub/. De kan aldrig blandes
  • Hver record har sin egen mappe — så du nemt kan finde alle billeder der hører til en specifik side, hero, artwork osv.
  • Filnavn bevares — vi rewriter ikke til UUIDs. Hvis du uploader solnedgang.jpg, hedder den solnedgang-{timestamp}.jpg

Tre måder at uploade på

1. Fra Media-modulet (browse-flow)

  1. Klik Media på dashboardet
  2. Klik + Upload
  3. Vælg fil(er) fra din computer
  4. Tilføj alt-tekst — det er vigtigt, se nedenfor
  5. Klik Gem

Billedet ligger nu i biblioteket og kan vælges fra ethvert billed-felt.

2. Fra et billed-felt (direkte)

Når du redigerer en side og rammer et billed-felt (fx Hero-block's image):

  • Vælg fil — upload direkte fra din computer (samme upload-dialog som ovenfor)
  • URL — paste en URL manuelt (sjældent brugt)
  • Bibliotek — åbn MediaPicker-modal (anbefalet for genbrug)

3. Fra MediaPicker (genbrug)

MediaPicker-modalen (TASK-110) viser hele dit mediebibliotek som thumbnails. Du kan:

  • Filtrere efter content-type (Hero, Page, Sponsor osv.)
  • Søge på filnavn
  • Se hvilke billeder der er i brug (grøn badge) eller ubrugte (grå badge med slet-knap)
  • Klik et billede for at vælge det

Filtyper og størrelse

Tilladte filtyper

  • Billeder: JPG, PNG, WEBP, GIF, SVG
  • Dokumenter: PDF, DOCX, XLSX, PPTX
  • Andre: vi accepterer det meste — men kun billeder vises som thumbnails i picker'en

Størrelse

Max 10 MB pr. fil. Større filer afvises med en fejlbesked. Hvis du har et stort billede:

  • Komprimer med Squoosh eller TinyPNG
  • Skaler ned til den størrelse du faktisk har brug for (typisk 1920px bred er overkill for de fleste hero-billeder)

Performance-tips

  • WebP > JPG > PNG for fotos. WebP fylder ~30% mindre med samme kvalitet
  • PNG til logos og grafik med få farver
  • SVG til ikoner når muligt — skalérbart uden tab

Alt-tekst — hvorfor det matter

Når du uploader, bliver du bedt om at indtaste alt-tekst. Det er beskrivelsen af billedet og bruges af:

  • Screen readers — synshandicappede brugere hører alt-teksten oplæst
  • SEO — Google bruger alt-tekst til at forstå hvad billedet viser
  • Fallback — vises hvis billedet ikke kan loade (langsom net, broken link)

Skriv god alt-tekst

  • Beskriv hvad billedet viser — ikke at det er et billede. "Palle Jacobsen i sit atelier" — ikke "Billede af Palle"
  • Vær specifik — "Linoleumssnit i sort/hvid, kvinde der står ved et vindue" frem for "Kunstværk"
  • Hold det kort — under 100 tegn er passende
  • Skip ved dekorative billeder — hvis billedet er rent dekorativt (fx en baggrund), efterlad alt-tekst tom så screen readers springer det over

"I brug"-badges og slet-guard

I MediaPicker'en og Media-listen ser du badges pr. billede:

  • Grøn "I brug · N" — billedet er refereret fra N records (sider, heroes, FeaturedSocialPosts osv.). Du kan ikke slette det
  • Grå "Ubrugt" — billedet er ikke refereret. Du kan slette via X-knappen

Dette er en safety-net (TASK-110): hvis du sletter et brugt billede, ville siderne der refererer det vise broken images. Engine'en scanner alle content-items for URL-referencer for at finde frem til disse refs.

Hvad sker hvis du virkelig vil slette et brugt billede

  1. Find ud af hvor det bruges (klik på "I brug · N"-badgen for at se hvilke records)
  2. Fjern referencerne (åbn hver record, ændre billedet til noget andet)
  3. Når "I brug · 0" bliver til "Ubrugt", kan du slette

Praktiske tips

  • Navngiv filer på din computer FØR uploadsolnedgang-nyborg.jpg er bedre end IMG_4502.JPG. Det gør dem nemme at finde i picker'en
  • Upload én ad gangen for hero-billeder så du kan tjekke alt-teksten omhyggeligt
  • Bulk-upload OK for galleri-billeder — du kan ændre alt-tekst pr. billede bagefter
  • Brug Media-modulet til at "audit" dine billeder — hvis du ser meget "Ubrugt", er det måske tid til at rydde op