=== Onlinefotka Checkout Field Editor pro WooCommerce ===
Přispěvatelé: onlinefotka
Štítky: woocommerce, checkout pole, vlastní pole, editor checkoutu, úprava polí
Vyžaduje alespoň: 6.0
Testováno do: 6.8
Vyžaduje PHP: 7.4
WC vyžaduje alespoň: 7.0
WC testováno do: 9.9
Stabilní verze: 1.0.0
Licence: GPLv2 nebo novější
Licenční URI: https://www.gnu.org/licenses/gpl-2.0.html

Upravujte, přeřazujte, přidávejte a odstraňujte pole ve WooCommerce pokladně — s drag-and-drop, podmíněnou logikou, validací a plnou podporou blokové pokladny.

== Popis ==

**Checkout Field Editor od Onlinefotka** vám dává plnou kontrolu nad WooCommerce pokladnou — bez úpravy kódu.

Upravujte existující pole, přidávejte vlastní, přeřazujte je tažením, skrývejte pole na základě podmínek a validujte vstup vlastními pravidly.

Vytvořeno pro klasickou WooCommerce pokladnu i novou blokovou pokladnu (WC 8.6+).

=== Úprava vestavěných WooCommerce polí ===

* Změna názvů popisků a zástupného textu pro všechna fakturační, doručovací a objednávková pole
* Nastavení polí jako povinných nebo volitelných
* Povolení nebo zakázání jednotlivých polí
* Přeřazení polí tažením v rámci každé sekce
* Obnovení libovolné sekce na výchozí WooCommerce hodnoty jedním kliknutím

=== Přidávání vlastních polí ===

* Neomezený počet vlastních polí pro fakturaci, doručení nebo objednávku
* Typy polí: Text, E-mail, Telefon, Číslo, Textarea, Select, Radio, Zaškrtávací políčko, Datum, Skryté
* Nastavení popisku, zástupného textu, popisného textu (nápověda pod polem) a CSS třídy
* Ovládání pořadí řazení v rámci sekce
* Zobrazení nebo skrytí hodnoty pole v detailech objednávky v administraci
* Zobrazení nebo skrytí hodnoty pole v e-mailech s objednávkou

=== Podmíněná logika ===

* Zobrazení pole pouze tehdy, jsou-li splněny specifické podmínky
* Podmínky mohou odkazovat na libovolné pole pokladny — vestavěná WooCommerce pole nebo vlastní pole
* Operátory: rovná se, nerovná se, obsahuje, není prázdné, je prázdné
* Logika AND — všechny podmínky musí být splněny, aby se pole zobrazilo
* Skrytá pole jsou automaticky vyloučena z povinné validace a neukládají se do objednávky

=== Validační pravidla ===

* Přidejte vlastní regex vzor k libovolnému textovému poli (např. `^CZ[0-9]{10}$` pro české DIČ)
* Nastavte vlastní chybovou zprávu zobrazenou při nesplnění vzoru
* Validace se spouští pouze tehdy, když pole obsahuje hodnotu — prázdná volitelná pole nejsou odmítnuta

=== Podpora blokové pokladny (WC 8.6+) ===

* Vlastní pole typu Text, Select a Zaškrtávací políčko jsou automaticky zaregistrována přes WooCommerce Blocks API
* Funguje vedle klasické pokladny — oba typy mohou koexistovat na stejném webu
* Hodnoty polí se ukládají konzistentně bez ohledu na to, který typ pokladny zákazník použil

=== Virtuální a ke stažení dostupné produkty ===

* Volitelně skryjte celou sekci doručovací adresy, když košík obsahuje pouze virtuální nebo ke stažení dostupné produkty
* Pokud košík obsahuje alespoň jeden fyzický produkt, doručovací pole se zobrazí normálně

=== Údaje objednávky ===

* Hodnoty vlastních polí se zobrazují v detailech objednávky v administraci WooCommerce
* Hodnoty vlastních polí jsou zahrnuty v e-mailech s objednávkou WooCommerce (konfigurovatelné pro každé pole)
* Hodnoty jsou uloženy jako meta objednávky a jsou přístupné přes metody objednávky WooCommerce

=== Požadavky ===

* WordPress 6.0 nebo vyšší
* WooCommerce 7.0 nebo vyšší
* PHP 7.4 nebo vyšší

== Instalace ==

1. Nahrajte složku pluginu do `/wp-content/plugins/` nebo nainstalujte přes **Pluginy → Přidat nový**
2. Aktivujte plugin přes obrazovku **Pluginy**
3. Přejděte na **WooCommerce → Pole pokladny** a začněte upravovat

== Často kladené dotazy ==

= Funguje to s blokovou pokladnou WooCommerce? =

Ano. Vlastní pole typu Text, Select a Zaškrtávací políčko jsou automaticky zaregistrována přes WooCommerce Blocks API (vyžaduje WooCommerce 8.6+). Typy Textarea, Radio a Skryté se zobrazují pouze v klasické pokladně — Blocks API tyto typy nativně nepodporuje.

= Mohu přeřadit vestavěná WooCommerce pole? =

Ano. Na záložkách Fakturace, Doručení a Objednávka můžete táhnout řádky pro změnu pořadí. Nové pořadí se ukládá automaticky přes AJAX a také při kliknutí na Uložit změny.

= Ovlivní mé změny blokovou pokladnu? =

Změny popisků, zástupného textu, povinnosti a pořadí pro vestavěná WooCommerce pole (Jméno, E-mail atd.) se vztahují pouze na klasickou pokladnu. Bloková pokladna řídí vlastní vestavěná pole nativně. Vlastní pole, která přidáte, jsou zaregistrována v obou typech pokladny.

= Co se stane s hodnotami polí, když odstraním vlastní pole? =

Definice pole se odstraní z databáze a pole se přestane zobrazovat v pokladně. Dříve shromážděné hodnoty meta objednávky (údaje zákazníka) se NEVYMAŽOU — zůstanou na objednávkách, kde byly uloženy.

= Mohu použít podmíněnou logiku ke skrytí pole DIČ pro fyzické osoby? =

Ano. Přidejte pole Select nebo Radio "Typ zákazníka" s možnostmi "Fyzická osoba" a "Firma", poté přidejte vaše pole DIČ s podmínkou: Typ zákazníka rovná se Firma.

= Funguje regex validace v klasické i blokové pokladně? =

Regex validace běží na straně serveru během `woocommerce_checkout_process` (klasická) a je také aplikována přes Store API pro objednávky blokové pokladny.

= K čemu slouží pole CSS třídy? =

WooCommerce používá CSS třídy pro ovládání šířky polí. Běžné hodnoty: `form-row-wide` (plná šířka), `form-row-first` (levá polovina), `form-row-last` (pravá polovina).

= Smaže tento plugin moje data při odinstalaci? =

Ne, ve výchozím nastavení se při odinstalaci žádná data nevymažou. V Nastavení můžete povolit "Smazat všechna data pluginu při odinstalaci", pokud chcete čisté odstranění.

== Záznamy změn ==

= 1.0.0 =
* První vydání
* Úprava vestavěných WooCommerce fakturačních, doručovacích a objednávkových polí
* Přeřazení tažením s ukládáním přes AJAX
* Vlastní pole: Text, E-mail, Telefon, Číslo, Textarea, Select, Radio, Zaškrtávací políčko, Datum, Skryté
* Popisný text pro každé vlastní pole
* Regex validace s vlastními chybovými zprávami
* Podmíněná logika s AND pravidly
* Zobrazení vlastních polí v detailech objednávky a e-mailech
* Podpora blokové pokladny přes WooCommerce Blocks API (WC 8.6+)
* Skrytí doručovacích polí pro virtuální / ke stažení dostupné produkty
* Obnovení libovolné sekce na výchozí WooCommerce hodnoty
* Kompatibilita s HPOS (High Performance Order Storage)
