Speciální typy

Autoincrement

Zdroj: EspoCRM Core Účel: Automaticky rostoucí čísla Použití: Faktury, objednávky, číslování

Dostupná nastavení

Prefix

• Výchozí: Prázdné
• NASTAVENO: Text před číslem (např. "INV-")
• Dynamické: Podporuje {year}, {month} placeholdery

Suffix

• Výchozí: Prázdné
• NASTAVENO: Text za číslem (např. "/2023")
• Dynamické: Podporuje date placeholdery

Začátek číslování

• Výchozí: 1
• NASTAVENO: Vlastní startovací číslo (např. 1000)
• Reset: Možnost resetování sekvence

Padding (doplnění nul)

• Výchozí: Bez doplnění
• NASTAVENO: Počet míst s leading zeros (např. 0001)
• Formát: 001, 0001, 00001 atd.

Read only /

• Výchozí: ZAPNUTO
• ZAPNUTO: Nelze manuálně editovat
• VYPNUTO: Umožňuje ruční zadání (porušuje sekvenci)

Projev v UI

• Edit view: Zobrazeno jako disabled field s náhledem
• Detail view: Finální hodnota (prefix + číslo + suffix)
• List view: Sortovatelné podle číselné hodnoty
• Search: Vyhledávání podle celého kódu
• Generování: Automatické při Save (create)

---

Date

Zdroj: EspoCRM Core Účel: Pouze datum bez času Použití: Narozeniny, termíny, deadlines

Dostupná nastavení

Výchozí hodnota

• Výchozí: Prázdné
• Dnešní datum: Automatické vyplnění aktuálního data
• NASTAVENO: Konkrétní datum
• Dynamické: {today}, {tomorrow}, {first_day_of_month}

Required (povinné) /

• Výchozí: VYPNUTO
• ZAPNUTO: Datum musí být vyplněno
• VYPNUTO: Pole je volitelné

Rozsah dat

• Výchozí: Neomezeno (1900-2100)
• Od: Minimální povolené datum
• Do: Maximální povolené datum
• Relativní: Např. +30 dní od dneška

Projev v UI

• Edit view: Date picker kalendář bez času
• Detail view: Lokalizovaný formát (DD.MM.YYYY)
• List view: Krátký formát nebo relativní (za 3 dny)
• Calendar: Zobrazeno jako celodenní událost
• Search: Datum rozsahy (od-do, tento měsíc, atd.)

---

⏰ Time

Zdroj: EspoCRM Core Účel: Pouze čas bez data Použití: Pracovní doba, schůzky, rozvrhy

Dostupná nastavení

Výchozí hodnota

• Výchozí: Prázdné
• Aktuální čas: Současný čas
• NASTAVENO: Konkrétní čas (08:00)
• Dynamické: {now_time}

Formát času

• Výchozí: 24h formát (HH:MM)
• 12h: AM/PM formát
• Sekundy: Volitelné zobrazení sekund

Minuty krok

• Výchozí: 15 minut
• Možnosti: 1, 5, 10, 15, 30, 60 minut
• Efekt: Krok při výběru v time pickeru

Required (povinné) /

• Výchozí: VYPNUTO
• ZAPNUTO: Čas musí být vyplněn
• VYPNUTO: Pole je volitelné

Projev v UI

• Edit view: Time picker s dropdown hodinami/minutami
• Detail view: Formátovaný čas podle uživatelského locale
• List view: Krátký formát (HH:MM)
• Search: Časové rozsahy (od-do, dopoledne, odpoledne)

---

Number

Zdroj: EspoCRM Core Účel: Univerzální číselné pole Použití: Množství, hodnoty, skóre

Dostupná nastavení

Typ čísla

• Integer: Celá čísla (-∞ až +∞)
• Float: Desetinná čísla s precision
• Decimal: Přesná desetinná čísla pro finance

Počet desetinných míst

• Výchozí: Automaticky podle typu
• Rozsah: 0-10 míst
• Integer: Vždy 0 míst

Minimální hodnota

• Výchozí: Neomezeno
• NASTAVENO: Vlastní minimum
• Validace: Chyba při menší hodnotě

Maximální hodnota

• Výchozí: Neomezeno
• NASTAVENO: Vlastní maximum
• Validace: Chyba při větší hodnotě

Required (povinné) /

• Výchozí: VYPNUTO
• ZAPNUTO: Číslo musí být vyplněno
• VYPNUTO: Pole je volitelné

Tisíce oddělovač /

• Výchozí: ZAPNUTO
• ZAPNUTO: 1,000,000 nebo 1 000 000
• VYPNUTO: 1000000

Projev v UI

• Edit view: Číselné pole s validací rozsahu
• Detail view: Formátované podle locale
• List view: Pravě zarovnané
• Search: Číselné rozsahy a operátory (>, <, =)

---

Média a soubory

File

Zdroj: EspoCRM Core Účel: Nahrávání a ukládání souborů Použití: Dokumenty, přílohy, certifikáty, smlouvy

Dostupná nastavení

Povolené typy souborů

• Výchozí: Všechny povolené v systému
• OMEZENO: Filter na konkrétní typy (pdf,doc,docx,jpg,png)
• Bezpečnost: Automaticky blokuje spustitelné soubory

Maximální velikost (MB)

• Výchozí: Systémové nastavení (PHP upload_max_filesize)
• NASTAVENO: Konkrétní limit (např. 10 MB)
• Efekt: Validační chyba při větším souboru

Náhled obrázků /

• Výchozí: ZAPNUTO
• ZAPNUTO: Malý náhled obrázků místo ikony
• VYPNUTO: Pouze ikona podle typu souboru

Download po kliknutí /

• Výchozí: ZAPNUTO
• ZAPNUTO: Kliknutí = automatický download
• VYPNUTO: Kliknutí otevře soubor v novém okně/tabu

Projev v UI

• Upload: Drag & drop oblast nebo "Browse" tlačítko
• Edit view: dokument.pdf [] [x] - název + ikona + smazat
• Detail view: dokument.pdf (2.3 MB) - klikatelný odkaz
• List view: Ikona souboru + název (zkrácený)
• Progress bar: Během nahrávání

---

Image

Zdroj: EspoCRM Core Účel: Obrázky s náhledy a automatickou optimalizací Použití: Loga, fotky produktů, profilové obrázky

Dostupná nastavení

Povolené formáty

• Výchozí: JPG, PNG, GIF
• OMEZENO: Pouze vybrané (např. jen PNG pro loga)
• WebP: Moderní formát (pokud podporován)

Maximální velikost (MB)

• Výchozí: Systémové nastavení
• NASTAVENO: Konkrétní limit (např. 5 MB)

Automatická změna velikosti /

• Výchozí: ZAPNUTO
• ZAPNUTO: Velké obrázky se automaticky zmenší
• VYPNUTO: Obrázky se ukládají v původní velikosti

Maximální rozměry (pixely)

• Výchozí: 1920x1080
• NASTAVENO: Vlastní rozměry (např. 800x600)
• Efekt: Větší obrázky se zmenší, zachová se poměr stran

Náhled v seznamu /

• Výchozí: ZAPNUTO
• ZAPNUTO: Miniatura v list view
• VYPNUTO: Pouze ikona obrázku

Lightbox náhled /

• Výchozí: ZAPNUTO
• ZAPNUTO: Kliknutí otevře obrázek v popup
• VYPNUTO: Kliknutí stáhne obrázek

Projev v UI

• Upload: Drag & drop s náhledem
• Edit view: Miniatura + tlačítko pro změnu
• Detail view: Klikatelný náhled obrázku
• List view: Malá miniatura (pokud zapnuto)
• Lightbox: Full-size popup s navigací

---

Pokročilé datové struktury

Array

Zdroj: EspoCRM Core Účel: Seznam textových hodnot Použití: Tagy, klíčová slova, seznamy položek

Dostupná nastavení

Maximální počet položek

• Výchozí: Neomezeno
• NASTAVENO: Limit počtu položek (např. max 10)
• Efekt: Nelze přidat více položek než limit

Duplicitní hodnoty /

• Výchozí: VYPNUTO (duplicity povoleny)
• ZAPNUTO: Každá hodnota jen jednou
• VYPNUTO: Lze přidat stejnou hodnotu vícekrát

Výchozí hodnoty

• Výchozí: Prázdný seznam
• NASTAVENO: Seznam předvyplněných hodnot
• Formát: Oddělené novými řádky

Required (povinné) /

• Výchozí: VYPNUTO
• ZAPNUTO: Alespoň jedna položka musí být přidána
• VYPNUTO: Může zůstat prázdné

Řazení /

• Výchozí: Podle pořadí přidání
• ZAPNUTO: Automatické alfabetické řazení
• Drag & Drop: Manuální přeřazování položek

Projev v UI

• Edit view: Tag input s možností přidávání nových položek
• Detail view: Seznam hodnot jako tagy/čipy
• List view: Počet položek nebo zkrácený seznam
• Search: Multi-select pro filtrování podle hodnot

---

WYSIWYG

Zdroj: EspoCRM Core Účel: Bohatě formátovaný text s editorem Použití: Články, popisy, emailové šablony

Dostupná nastavení

Výška editoru

• Výchozí: 300px
• NASTAVENO: Vlastní výška (200-800px)
• Auto: Automatická podle obsahu

Toolbar nástroje

• Základní: Bold, italic, underline, link
• Kompletní: Seznamy, tabulky, obrázky, barvy
• Vlastní: Výběr konkrétních nástrojů

Upload obrázků /

• Výchozí: ZAPNUTO
• ZAPNUTO: Drag & drop obrázků do editoru
• VYPNUTO: Pouze odkazy na externí obrázky

HTML režim /

• Výchozí: ZAPNUTO
• ZAPNUTO: Přepnutí do HTML kódu
• VYPNUTO: Pouze WYSIWYG editace

Maximální délka

• Výchozí: Neomezeno
• NASTAVENO: Limit znaků s počítadlem
• Efekt: Varování při blížení se limitu

Projev v UI

• Edit view: Plnohodnotný WYSIWYG editor (TinyMCE)
• Detail view: Renderovaný HTML s formátováním
• List view: Plain text verze (bez HTML tagů)
• Search: Fulltextové vyhledávání v obsahu
• Export: Zachování formátování v PDF/Word

---

Array

Zdroj: EspoCRM Core Účel: Seznam textových hodnot Použití: Tagy, klíčová slova, seznamy položek

Dostupná nastavení

Maximální počet položek

• Výchozí: Neomezeno
• NASTAVENO: Limit počtu položek (např. max 10)
• Efekt: Nelze přidat více položek než limit

Duplicitní hodnoty /

• Výchozí: VYPNUTO (duplicity povoleny)
• ZAPNUTO: Každá hodnota jen jednou
• VYPNUTO: Lze přidat stejnou hodnotu vícekrát

Řazení /

• Výchozí: Podle pořadí přidání
• ZAPNUTO: Automatické alfabetické řazení
• Drag & Drop: Manuální přeřazování položek

Projev v UI

• Edit view: Tag input s možností přidávání nových položek
• Detail view: Seznam hodnot jako tagy/čipy
• List view: Počet položek nebo zkrácený seznam
• Search: Multi-select pro filtrování podle hodnot

---

ArrayInt

Zdroj: EspoCRM Core Účel: Pole celých čísel Použití: Seznam ID, číselné konfigurace

Dostupná nastavení

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou systémové)
• ZAPNUTO: Nelze editovat ručně
• VYPNUTO: Teoreticky editovatelné

Maximální počet

• Výchozí: Neomezeno
• NASTAVENO: Limit počtu čísel
• Systémové: Řízeno aplikační logikou

Projev v UI

• Edit view: JSON array editor (většinou skryté)
• Detail view: Seznam čísel (pokud viditelné)
• List view: Počet prvků nebo první hodnoty
• Admin: Většinou pouze v systémových pohledech

---

JSONArray

Zdroj: EspoCRM Core Účel: JSON pole s objekty Použití: Strukturovaná konfigurace, metadata

Dostupná nastavení

Schema validace /

• Výchozí: VYPNUTO
• ZAPNUTO: Kontrola struktury JSON
• VYPNUTO: Volná JSON data

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou systémové)
• ZAPNUTO: Nelze editovat ručně
• VYPNUTO: Editovatelné pro admin

Projev v UI

• Edit view: JSON tree viewer (pouze pro admin)
• Detail view: Strukturované zobrazení objektů
• List view: Počet objektů v poli
• Developer: Hlavně pro konfiguraci systému

---

JSONObject

Zdroj: EspoCRM Core Účel: JSON objekt s key-value páry Použití: Nastavení, metadata, flexibilní data

Dostupná nastavení

Výchozí struktura

• Výchozí: Prázdný objekt
• NASTAVENO: Předpřipravená struktura
• Template: Šablona s klíči

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou systémové)
• ZAPNUTO: Nelze editovat ručně
• VYPNUTO: Editovatelné key-value páry

Projev v UI

• Edit view: Key-value tabulka (pouze pro admin)
• Detail view: Strukturované zobrazení párů
• List view: Počet klíčů v objektu
• Configuration: Hlavně pro nastavení systému

---

Password

Zdroj: EspoCRM Core Účel: Bezpečnostní pole pro hesla Použití: User entity, API tokeny

Dostupná nastavení

Minimální délka

• Výchozí: 6 znaků
• NASTAVENO: Vlastní minimální délka
• Bezpečnost: Doporučeno 8+ znaků

Hash algoritmus

• Výchozí: bcrypt
• Alternativy: SHA256, MD5 (deprecated)
• Salt: Automatické přidání salt

Síla hesla /

• Výchozí: ZAPNUTO
• ZAPNUTO: Kontrola komplexity hesla
• VYPNUTO: Pouze délka

Projev v UI

• Edit view: Skryté znaky (••••••••) s validací síly
• Detail view: Jen indikace že je nastaveno
• List view: Ikona zámku nebo prázdné
• Security: Změna pouze přes speciální formuláře

---

ColorPicker

Zdroj: EspoCRM Core Účel: Výběr barvy s color pickerem Použití: Barevné kategorie, UI témata

Dostupná nastavení

Formát barvy

• HEX: #FF5733 (výchozí)
• RGB: rgb(255, 87, 51)
• HSL: hsl(14, 100%, 60%)

Přednastevené palety /

• Výchozí: ZAPNUTO
• ZAPNUTO: Paleta běžných barev
• VYPNUTO: Pouze color picker

Průhlednost /

• Výchozí: VYPNUTO
• ZAPNUTO: Alpha kanál (RGBA)
• VYPNUTO: Pouze plné barvy

Projev v UI

• Edit view: Barevný čtverec + color picker + hex kód
• Detail view: Barevný čtverec s hodnotou
• List view: Malý barevný čtverec
• Categories: Barevné označení kategorií a tagů

---

↔ RangeInt

Zdroj: EspoCRM Core Účel: Rozsah celých čísel (od-do) Použití: Věkové rozsahy, počty, intervaly

Dostupná nastavení

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou pro filtrování)
• ZAPNUTO: Nelze editovat, jen pro search
• VYPNUTO: Editovatelné rozsahy

Validace rozsahu

• Minimum: "Od" musí být menší než "Do"
• Překrývání: Kontrola překrývajících se rozsahů
• Prázdné: Povolení prázdných hodnot

Projev v UI

• Edit view: Dva integer fieldy [Od] [Do] pro filtrování
• Detail view: Rozsah jako "5 - 10"
• List view: Kompaktní rozsah
• Search: Specializovaný filtr pro rozsahové hodnoty

---

↔ RangeFloat

Zdroj: EspoCRM Core Účel: Rozsah desetinných čísel Použití: Cenové rozsahy, měření

Dostupná nastavení

Desetinná místa

• Výchozí: 2 místa
• Rozsah: 0-4 místa
• Konzistence: Stejný počet pro oba konce

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou pro filtrování)
• ZAPNUTO: Jen pro search filtry
• VYPNUTO: Editovatelné rozsahy

Projev v UI

• Edit view: Dva float fieldy pro rozsahové vyhledávání
• Detail view: Rozsah jako "1.50 - 5.75"
• List view: Formátovaný rozsah
• Filters: Pokročilé filtrování podle rozsahů

---

↔ RangeCurrency

Zdroj: EspoCRM Core Účel: Rozsah měnových hodnot Použití: Cenové filtry, rozpočtové rozsahy

Dostupná nastavení

Výchozí měna

• Systémová: Podle systémového nastavení
• Uživatelská: Podle uživatelských preferencí
• Fixní: Konkrétní měna pro rozsah

Pouze ke čtení /

• Výchozí: ZAPNUTO (většinou pro filtrování)
• ZAPNUTO: Jen pro search a reporty
• VYPNUTO: Editovatelné cenové rozsahy

Projev v UI

• Edit view: Dva currency fieldy s automatickými přepočty
• Detail view: Rozsah s měnou "100 CZK - 500 CZK"
• List view: Kompaktní měnový rozsah
• Reports: Filtrování podle cenových pásem

---

Base

Zdroj: EspoCRM Core Účel: Abstraktní základní typ pro všechna pole Použití: Pouze pro dědičnost, nelze vytvořit

Dostupná nastavení

Nedostupné pro uživatele

• Framework: Pouze interní použití
• Abstraktní: Nelze vytvořit instance
• Dědičnost: Základ pro všechny ostatní typy

Projev v UI

• Nikde viditelný: Framework základ
• Developer: Pouze pro vývoj vlastních typů
• Inheritance: Všechny typy dědí od Base