=== Emailcampaigns.eu ===
Contributors: commercemedia
Tags: emailkampane, email marketing, woocommerce, newsletter, e-mail kampane
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 8.0
WC tested up to: 10.7

Propojení WooCommerce s platformou Emailkampane.cz – synchronizace kontaktů, sledování košíků, objednávek a pohybu na webu.

== Popis ==

Oficiální plugin pro integraci WooCommerce s e-mailingovou platformou [Emailkampane.cz](https://www.emailkampane.cz/).

= Hlavní funkce =

* **Synchronizace kontaktů** – automatický import zákazníků do 4 skupin kontaktů (Objednávky, Registrace, Newsletter Subscription, Do not send newsletters)
* **Sledování košíků** – tracking přidání, odebrání a změn množství produktů v košíku
* **Sledování objednávek** – kompletní tracking dokončených objednávek na thank-you stránce
* **Sledování pohybu na webu** – pageVisit tracking a identifikace přihlášených uživatelů
* **Newsletter checkbox** – konfigurovatelný opt-in checkbox na stránce pokladny (klasický i blokový checkout)
* **Integrace s cookie lištou** – podpora Complianz, CookieBot, CookieYes a vlastních řešení
* **Šifrování API hashe** – AES-256-CBC šifrování přihlašovacích údajů v databázi
* **HPOS kompatibilita** – plná podpora WooCommerce High-Performance Order Storage a Cart/Checkout Blocks
* **Log viewer** – prohlížeč protokolů přímo v nastavení pluginu
* **Hromadná synchronizace** – jednorázový import existujících objednávek a uživatelů
* **GDPR** – volitelná synchronizace bez souhlasu, integrace s WP Privacy Tools pro výmaz kontaktů

= Požadavky =

* WordPress 6.4+
* WooCommerce 8.0+
* PHP 8.1+
* Aktivní účet na [Emailkampane.cz](https://www.emailkampane.cz/)

== Description ==

Official plugin for WooCommerce integration with the [Emailkampane.cz](https://www.emailkampane.cz/) email marketing platform (Emailcampaigns.eu).

= Key Features =

* **Contact synchronization** – automatic import to 4 contact groups (Orders, Registration, Newsletter yes/no)
* **Cart tracking** – addToCart, removeFromCart, updateCart events
* **Order tracking** – complete order data on thank-you page with duplicate protection
* **Page visit tracking** – pageVisit and loggedUser identification
* **Newsletter checkbox** – configurable opt-in on checkout (classic + WC Blocks)
* **Cookie banner integration** – Complianz, CookieBot, CookieYes, custom
* **API hash encryption** – AES-256-CBC with WordPress auth salts
* **HPOS compatible** – Custom Order Tables + Cart/Checkout Blocks
* **GDPR** – optional sync without consent, WP Privacy Tools integration

== Instalace ==

1. Nahrajte složku `emailkampane` do `/wp-content/plugins/`
2. Aktivujte plugin v administraci WordPress
3. Přejděte do WooCommerce → Nastavení → Emailkampane.cz
4. Zadejte e-mail účtu, API hash a tracking klíč
5. Ověřte připojení a vytvořte skupiny kontaktů

== Installation ==

1. Upload the `emailkampane` folder to `/wp-content/plugins/`
2. Activate the plugin in WordPress admin
3. Go to WooCommerce → Settings → Emailkampane.cz
4. Enter account email, API hash and tracking key
5. Verify connection and create contact groups

== Frequently Asked Questions ==

= Kde najdu API hash a tracking klíč? =
API hash naleznete v nastavení účtu na Emailkampane.cz → API. Tracking klíč v sekci Sledování pohybu návštěvníků na webu.

= Je plugin kompatibilní s HPOS a blokovým checkoutem? =
Ano, plugin plně podporuje WooCommerce High-Performance Order Storage i blokový checkout (Cart/Checkout Blocks).

= Mohu přepsat šablonu checkboxu? =
Ano, zkopírujte soubor `templates/checkout-optin-checkbox.php` do `vaše-téma/emailkampane/checkout-optin-checkbox.php`.

= Jak funguje GDPR ochrana? =
Plugin umožňuje v nastavení vypnout synchronizaci kontaktů, kteří nedali souhlas s newsletterem. Také se integruje s WordPress Privacy Tools pro export a výmaz osobních údajů.

== Changelog ==

= 1.1.3 =
* Plugin header přepnut na oficiální název "Emailcampaigns.eu"; v CS/SK lokalizaci se zobrazí jako "Emailkampane.cz"
* Plugin URI a Description se přepínají podle locale přes překlad
* Přidán link "Návod k použití" do plugin listingu v adminu
* CS překlady doladěné podle zpětné vazby

= 1.1.2 =
* Opraven locale fallback pro admin user locale (sv_SE, de_DE, fr_FR...) - reálně se nyní načte EN překlad
* Newsletter checkbox text se nyní překládá runtime podle aktuálního locale (předtím držel jazyk v jakém byl uložen)
* Text checkboxu má nyní placeholder místo natvrdo uloženého defaultu

= 1.1.1 =
* Locale fallback: non-CS/SK locale nyní zobrazuje EN texty místo CZ
* EN brand: v anglické verzi se plugin prezentuje jako Emailcampaigns.eu
* UI: tlačítko "Získat nový tracking klíč" přesunuto inline za pole Tracking klíč
* UI: Ověřit připojení rozšířeno o warning pokud chybí tracking klíč
* UI: sekce Sledování zobrazuje stav tracking klíče
* UI: 4 odkazy (Info + Návod, CZ/EN) ve welcome notice a hlavičce nastavení
* UI: bulk sync správně rozliší "není co synchronizovat" od reálného běhu
* CSS: širší první sloupec v nastavení pro lepší čitelnost
* Vylepšení: chybové stavy bulk syncu se logují s ID záznamu pro snazší diagnostiku
* Dokumentace: přidán soubor DOKUMENTACE.md (instalace, konfigurace, hooks, troubleshooting)
* Překlady: kompletně přepracované CZ a EN .po soubory, 147/147 řetězců

= 1.1.0 =
* Hlavička `X-Consumer-Identification: WP_WOOCOMMERCE` ve všech voláních proti `api.emailkampane.cz`
* Vytváření chráněných systémových skupin (`protected: "D"` + unikátní `protected_type`)
* Automatické získávání tracking klíče z endpointu `tr-web.emailkampane.cz/tracking-code` po uložení credentials, plus tlačítko pro manuální obnovu
* Hromadná synchronizace běží na pozadí přes Action Scheduler — bez limitu velikosti, s progress barem a možností zrušit

= 1.0.0 =
* Prvý stabilní release
* Kompletní synchronizace kontaktů, sledování košíků a objednávek
* Newsletter checkbox s podporou blokového checkoutu
* Log viewer, hromadná synchronizace, GDPR integrace

== Screenshots ==

1. Nastavení připojení
2. Skupiny kontaktů
3. Synchronizace a sledování
4. Newsletter checkbox
5. Protokoly (log viewer)
