Mediální obsah

Tento dokument popisuje technické požadavky na mediální materiály poskytované prostřednictvím XML feedu. Kvalitní média jsou nezbytná pro viditelnost akce a zapojení uživatelů.

1. Základní mediální pole (povinná a nepovinná)

Pro zajištění optimálního zobrazení musí váš feed obsahovat konkrétní URL adresy pro vizuální identitu akce.

Element	Povinné	Popis
preview_url	Ano	URL hlavního obrázku (obálka/náhled).
banner_url	Ne	URL banneru pro stránku s detaily akce.
attachment_url	Ne	URL ke stažitelnému souboru (např. PDF program/menu). Pokud je potřeba více souborů, sloučte je prosím do jednoho ZIP archivu.

Poznámka: Všechny URL adresy musí být přímé, statické a pouze přes HTTPS.

2. Prvky galerie (`<gallery>`)

Blok galerie umožňuje připojit k akci další vizuální obsah. Každá položka musí mít uveden svůj typ.

Element	Typ	Povinné	Popis
type	Atribut	Ano	Jeden z: image, video nebo embed.
url	Řetězec	Ano	Veřejný přímý odkaz (pouze HTTPS).
title	Řetězec	Ne	SEO alt-text nebo název souboru ke stažení.
caption	Řetězec	Ne	Viditelné poděkování/zdroj nebo popis (např. „Foto: Karlsbad Archive").

Příklad implementace v XML:

<gallery>
  <item type="image">
    <url>https://example.com/photo1.jpg</url>
    <title>Event Highlight</title>
  </item>
  <item type="video">
    <url>https://www.youtube.com/watch?v=dQw4w9WgXcQ</url>
    <title>Official Teaser</title>
  </item>
  <item type="embed">
    <url>https://my.matterport.com/show/?m=example</url>
    <title>360 Virtual Tour</title>
  </item>
</gallery>

3. Obecná omezení

Formáty obrázků: JPEG, PNG, WebP (preferováno).
Velikost souboru: Max. 10 MB na obrázek nebo dokument.
Doporučená velikost: do 2400 px na delší straně — větší obrázek stejně uložíme zmenšený; tiskové plakáty (např. 7000 × 10 000 px) neposílejte.
Dokumenty: Pro attachment_url je silně preferován formát PDF.
Video a embedy: Použijte typ video pro přímé videoplatformy (YouTube, Vimeo) a embed pro interaktivní obsah (Matterport, Spotify).

4. Požadavky na CDN a hosting

Pro zajištění stabilní synchronizace musí váš mediální hosting splňovat následující kritéria:

Přímá dostupnost: URL adresy musí vést přímo k souboru, nikoli na vstupní stránku.
Žádná ochrana proti hotlinkingu: Váš server musí umožnit našemu crawleru (KamNaZapade/1.0 (+https://kamnazapade.cz)) stahovat materiály.
Pouze HTTPS: Nezabezpečené odkazy http budou odmítnuty.
Trvalé odkazy (permalinky): URL adresy médií by měly zůstat statické. Pokud URL změníte, systém ji znovu načte jako zcela nové médium.

5. Automatické zpracování

Při načítání vašich médií náš systém provádí:

Zmenšení: obrázek, jehož delší strana přesahuje 2400 px nebo soubor 1 MB, uložíme zmenšený tak, aby se vešel do 2400 × 2400 px, ve formátu WebP (nikdy nezvětšujeme; průhlednost zůstane, metadata a barevný profil se odstraní, orientace podle EXIF se použije). Menší obrázky, SVG a animované GIF/WebP/PNG ukládáme beze změny. Váš soubor ani jeho adresa se nemění. Pro náhledy, mobil i desktop pak web generuje menší velikosti z uložené verze.
Cachování: Materiály jsou ukládány do cache na našem CDN pro zlepšení výkonu.