upload

DOCS/BANNERY_NAVOD.md

@@ -0,0 +1,265 @@
+# Bannery a reklamní plochy - Rychlý návod
+
+## Přehled
+Systém bannerů umožňuje snadnou správu reklamních ploch na webových stránkách. Bannery se automaticky zobrazují na správných místech a zároveň jsou přidány jako sponzoři do zápatí stránky.
+
+## Přednastavené pozice bannerů
+
+### 1. **Hlavní banner (Homepage - vrchol)**
+- **Rozměry:** 1200 × 200 px
+- **Umístění:** Nahoře na hlavní stránce
+- **Vhodné pro:** Hlavní partnery, velké kampaně
+- **Viditelnost:** Maximální - první věc, kterou návštěvník vidí
+
+### 2. **Střední banner (Homepage - střed)**
+- **Rozměry:** 970 × 250 px
+- **Umístění:** Mezi obsahem na hlavní stránce
+- **Vhodné pro:** Středně velké reklamy
+- **Viditelnost:** Vysoká - v průběhu scrollování
+
+### 3. **Postranní banner (Homepage - sidebar)**
+- **Rozměry:** 300 × 250 px
+- **Umístění:** Pravý postranní panel (desktop)
+- **Vhodné pro:** Menší reklamy, tlačítka
+- **Viditelnost:** Střední - sticky pozice při scrollování
+
+### 4. **Spodní banner (Homepage - zápatí)**
+- **Rozměry:** 1200 × 200 px
+- **Umístění:** Před zápatím stránky
+- **Vhodné pro:** Závěrečné CTA, doplňkové partnery
+- **Viditelnost:** Střední - na konci stránky
+
+### 5. **Banner v článcích**
+- **Rozměry:** 728 × 90 px
+- **Umístění:** Uvnitř článků
+- **Vhodné pro:** Standardní reklamní formát
+- **Viditelnost:** Vysoká - přímo v obsahu
+
+## Jak přidat nový banner
+
+### Krok 1: Příprava obrázku
+1. Připravte obrázek ve správných rozměrech
+2. Doporučené formáty: PNG nebo JPG
+3. Velikost souboru: max 500 KB
+4. Pro retina displeje použijte 2× větší rozměry
+
+**Příklad:** Pro hlavní banner (1200×200) použijte obrázek 2400×400 px
+
+### Krok 2: Přístup do administrace
+1. Přihlaste se do administrace
+2. Klikněte na **"Bannery"** v menu
+3. Stránka: `/admin/bannery`
+
+### Krok 3: Vytvoření banneru
+1. Klikněte na tlačítko **"Nový banner"**
+2. Otevře se formulář
+
+### Krok 4: Nahrání obrázku
+1. Klikněte na **"Nahrát obrázek"**
+2. Vyberte soubor z počítače
+3. Počkejte na nahrání
+
+### Krok 5: Automatická detekce
+Po nahrání systém automaticky:
+- ✅ Zjistí rozlišení obrázku
+- ✅ Vypočítá poměr stran
+- ✅ Doporučí 3 nejvhodnější pozice
+- ✅ Označí nejlepší shodu zeleně
+
+**Příklad zobrazení:**
+```
+ℹ️ Rozlišení obrázku: 1200 × 200 px
+   Poměr stran: 6.00:1
+
+✓ Doporučená umístění na základě rozlišení:
+  [Nejlepší] Hlavní banner (Homepage - vrchol) (1200×200) [Použít]
+  [#2] Spodní banner (Homepage - zápatí) (1200×200) [Použít]
+  [#3] Střední banner (Homepage - střed) (970×250) [Použít]
+```
+
+### Krok 6: Výběr pozice
+**Možnost A:** Použijte doporučení
+- Klikněte na **"Použít"** u doporučené pozice
+- Rozměry se nastaví automaticky
+
+**Možnost B:** Vyberte ručně
+- Rozbalte seznam "Umístění na webu"
+- Vyberte požadovanou pozici
+- Rozměry se nastaví automaticky
+
+### Krok 7: Vyplnění informací
+1. **Název** (povinné)
+   - Zadejte popisný název
+   - Příklad: "Hlavní partner 2025"
+
+2. **Odkaz** (volitelné)
+   - Zadejte URL pro kliknutí
+   - Příklad: `https://partner.cz`
+   - Nechte prázdné, pokud nechcete odkaz
+
+3. **Náhled**
+   - Zkontrolujte náhled banneru
+   - Ověřte, že vypadá správně
+   - Pod náhledem vidíte: "Zobrazení v pozici: [název pozice]"
+
+### Krok 8: Aktivace
+- Přepínač **"Aktivní"** je automaticky zapnutý
+- Vypněte, pokud banner ještě nechcete zobrazit
+
+### Krok 9: Uložení
+1. Klikněte na **"Uložit"**
+2. Banner se okamžitě zobrazí na webu
+3. Zároveň se přidá do sekce sponzorů v zápatí
+
+## Jak upravit existující banner
+
+1. V seznamu bannerů najděte požadovaný banner
+2. Klikněte na ikonu **tužky** (upravit)
+3. Změňte požadované údaje
+4. Pro změnu obrázku nahrajte nový soubor
+5. Klikněte na **"Uložit"**
+
+## Jak deaktivovat banner
+
+1. Najděte banner v seznamu
+2. Klikněte na **tužku** (upravit)
+3. Vypněte přepínač **"Aktivní"**
+4. Klikněte na **"Uložit"**
+
+**Tip:** Nedeaktivujte bannery mazáním - vypněte je. Zachováte tak historii.
+
+## Jak smazat banner
+
+1. Najděte banner v seznamu
+2. Klikněte na **červený koš** (smazat)
+3. Potvrďte smazání
+
+**Varování:** Smazání je trvalé a nelze ho vrátit!
+
+## Kde se bannery zobrazují
+
+### 1. Na hlavní stránce
+Podle vybrané pozice:
+- **Vrchol:** Hned po hlavičce
+- **Střed:** Mezi články a tabulkami
+- **Sidebar:** Vpravo (desktop)
+- **Zápatí:** Nad patičkou stránky
+
+### 2. V zápatí
+**Všechny aktivní bannery** se automaticky zobrazují v sekci "Naši partneři":
+- Responzivní mřížka (2-6 sloupců)
+- Bílé invertované logo na tmavém pozadí
+- Klikatelné odkazy na web partnera
+
+### 3. Na stránce Sponzoři
+- Všechny aktivní bannery se zobrazí na `/sponzori`
+- Přehledná mřížka s logy
+- Rozdělení na hlavní partnery a standardní
+
+## Doporučené postupy
+
+### ✅ Správně
+- Používejte obrázky ve správných rozměrech
+- Pojmenujte bannery popisně: "Letní turnaj 2025"
+- Testujte bannery na mobilu
+- Optimalizujte velikost souborů
+- Používejte kvalitní obrázky (min. 2× pro retina)
+- Nastavte URL pro měření návštěvnosti
+
+### ❌ Špatně
+- Nepoužívejte příliš malé obrázky (rozmazané)
+- Nepojmenujte bannery "Banner1", "test"
+- Nenahrajte obří soubory (>1MB)
+- Nepoužívejte obrázky s textem, který nelze přečíst
+- Nemažte bannery - raději je deaktivujte
+
+## Tipy pro nejlepší výsledky
+
+### Příprava obrázků
+1. **Rozlišení:** 2× větší než cílové rozměry
+   - Hlavní banner: 2400×400 px místo 1200×200
+   
+2. **Formát:**
+   - PNG: Pro loga, text, průhlednost
+   - JPG: Pro fotografie, složité obrázky
+
+3. **Optimalizace:**
+   - Použijte nástroj jako TinyPNG
+   - Cíl: <300 KB pro malé, <500 KB pro velké
+
+4. **Design:**
+   - Čitelný text i na mobilu
+   - Výrazné barvy
+   - Jasné CTA (Call To Action)
+   - Responsive design (testujte na různých zařízeních)
+
+### Sledování výkonnosti
+Přidejte UTM parametry do URL:
+```
+https://partner.cz?utm_source=banner&utm_medium=homepage&utm_campaign=leto2025
+```
+
+## Řešení problémů
+
+### Banner se nezobrazuje
+**Řešení:**
+1. ✓ Zkontrolujte, že je "Aktivní" zapnuto
+2. ✓ Obnovte stránku (Ctrl+F5)
+3. ✓ Vymažte cache prohlížeče
+4. ✓ Zkontrolujte URL obrázku
+
+### Špatné doporučení pozice
+**Příčina:** Rozměry obrázku neodpovídají žádné pozici
+
+**Řešení:**
+1. Upravte obrázek na doporučené rozměry
+2. Nebo vyberte pozici ručně (nejpodobnější)
+
+### Obrázek se nahrál, ale nezobrazil rozlišení
+**Řešení:**
+1. Zkuste nahrát znovu
+2. Zkontrolujte formát souboru (PNG/JPG)
+3. Zkuste jiný obrázek
+
+### Sponzor se nezobrazuje v zápatí
+**Řešení:**
+1. Ověřte, že je banner "Aktivní"
+2. Obnovte stránku
+3. Zkontrolujte konzoli prohlížeče (F12)
+
+## Časté dotazy
+
+**Q: Můžu mít více bannerů na stejné pozici?**
+A: Ano, ale zobrazí se všechny najednou. Pro rotaci kontaktujte administrátora.
+
+**Q: Jak dlouho trvá, než se banner zobrazí?**
+A: Okamžitě po uložení. Možná budete muset obnovit stránku (F5).
+
+**Q: Mohu změnit rozměry banneru?**
+A: Ne, rozměry jsou automaticky nastaveny podle pozice. Nahrajte obrázek ve správné velikosti.
+
+**Q: Co se stane, když nahraji obrázek s jiným rozměrem?**
+A: Systém doporučí nejlepší pozici. Banner se zobrazí podle zvolené pozice - může být roztažený nebo zmenšený.
+
+**Q: Mohu vytvořit vlastní pozici?**
+A: Ne, můžete vybrat pouze z přednastavených pozic. Pro speciální požadavky kontaktujte administrátora.
+
+**Q: Jak zjistím, kolik lidí kliklo na banner?**
+A: Použijte UTM parametry v URL a sledujte v Google Analytics.
+
+**Q: Můžu banner naplánovat na konkrétní datum?**
+A: Zatím ne. Můžete banner nahrát a aktivovat/deaktivovat ručně v požadovaný den.
+
+## Kontakt a podpora
+
+Máte problémy nebo dotazy?
+1. Nejdřív si přečtěte tento návod
+2. Zkontrolujte konzoli prohlížeče (F12)
+3. Zkuste jiný obrázek nebo formát
+4. Kontaktujte administrátora systému
+
+---
+
+**Vytvořeno:** 12. 1. 2025
+**Verze:** 1.0
+**Pro:** MyClub - Systém pro správu sportovních klubů