MyClub/DOCS/BANNERY_NAVOD.md

# 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ů