=== MW Tracker ===
Contributors: marekszmit, markowyweb
Donate link: https://marekszmit.pl
Tags: analytics, tracking, google-analytics, meta-pixel, tiktok, gtm, woocommerce, elementor
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Kompleksowa implementacja tagów śledzących (Google Analytics, Google Tag Manager, Meta Pixel, TikTok) z zaawansowaną konfiguracją zdarzeń.

== Description ==

MW Tracker to zaawansowana wtyczka WordPress do implementacji tagów śledzących z pełną kontrolą nad zdarzeniami — zaprojektowana pod potrzeby specjalistów SEM.

**Główne funkcje:**

* Google Analytics (GA4), Google Tag Manager i dataLayer w formacie GA4 ecommerce
* Meta Pixel + Conversions API (CAPI) z deduplikacją event_id
* TikTok Pixel + Events API z deduplikacją event_id i capture ttclid
* GA4 Measurement Protocol (server-side backup)
* Consent Mode v2 i integracja CMP (CACSP, Complianz, Cookiebot, CookieYes, Borlabs)
* Selektywne włączanie zdarzeń dla Google, Meta i TikTok
* WooCommerce — pełny lejek e-commerce (classic + Blocks Checkout/Cart)
* Formularze: Elementor, Contact Form 7, WPForms, Gravity Forms + skaner
* Panel diagnostyczny (health check, log CAPI/MP)
* Własne zdarzenia JavaScript (klik, scroll, mikro-konwersje)
* Checklist wdrożenia dla SEM w panelu administracyjnym
* Kompatybilność z WordPress 7.0

**Wsparcie dla:**

* WooCommerce — automatyczne zdarzenia e-commerce
* Elementor Forms — zdarzenia formularzy
* Contact Form 7, WPForms, Gravity Forms
* Cookies and Content Security Policy (CACSP)

== Installation ==

1. Zainstaluj wtyczkę z pliku ZIP lub prześlij folder `mw-tracker` do `/wp-content/plugins/`.
2. Aktywuj wtyczkę przez ekran Wtyczki w WordPressie.
3. Przejdź do MW Tracker w menu WordPress i skonfiguruj Google, Meta, TikTok oraz zdarzenia.

== Frequently Asked Questions ==

= Jak skonfigurować Google Analytics? =

Przejdź do MW Tracker → Google i wprowadź ID Google Analytics (GA4) lub kontener GTM.

= Jak przełączyć się na Google Tag Manager? =

W ustawieniach Google wybierz metodę "dataLayer (Google Tag Manager)" i wprowadź ID GTM.

= Czy wtyczka wykrywa WooCommerce automatycznie? =

Tak, jeśli WooCommerce jest aktywny, wtyczka automatycznie wykryje go i udostępni zdarzenia e-commerce.

= Czy wtyczka jest kompatybilna z WordPress 7.0? =

Tak. MW Tracker jest testowany i kompatybilny z WordPress 7.0 (wymaga minimum WordPress 5.8).

= Czy potrzebuję tokenów CAPI i Measurement Protocol? =

Nie — podstawowe śledzenie (Pixel + GA4/GTM w przeglądarce) działa bez tokenów. CAPI i MP są opcjonalne i zwiększają pokrycie danych przy adblockerach i ograniczeniach cookies.

== Changelog ==

= 1.1.3 =
* **Google GTM**: snippet kontenera GTM osadzany na stronie niezależnie od metody wysyłki zdarzeń (gtag vs dataLayer)
* **Google tagi**: GA4, GTM i Google Ads mogą być ładowane równolegle według podanych ID
* **Consent Mode**: inicjalizacja dataLayer przed GTM także przy metodzie gtag.js
* **Panel admin**: zaktualizowane opisy pól GTM i metody wysyłki zdarzeń
* **WordPress 7.0**: potwierdzona kompatybilność (Tested up to: 7.0)

= 1.1.2 =
* **TikTok PageView dedup**: wspólny `event_id` dla `ttq.page()` i Events API
* **TikTok consent-safe load**: `ttq.load` dopiero po zgodzie marketingowej (brak skryptu w `<head>` przed CMP)
* **TikTok EMQ**: telefon w formacie E.164 przed SHA-256, `identify` z zamówienia/formularza, Automatic Advanced Matching (`auto_config`)
* **TikTok admin**: Limited Data Use (LDU), debug pixel, auto advanced matching
* **Events API**: `page.referrer` w payloadzie
* **Borlabs CMP**: mapowanie zgody marketingowej dla TikTok

= 1.1.1 =
* **TikTok WooCommerce JS**: AddToCart, ViewContent (select item), Blocks Checkout (InitiateCheckout, ViewContent, AddPaymentInfo)
* **TikTok Events API**: format v1.3 (`event_source` + `data[]`), walidacja sukcesu po `code === 0`
* **TikTok Pixel**: `ttq.page()` i `identify` dopiero po zgodzie marketingowej (jak Meta)
* **Server relay**: dozwolone własne zdarzenia po `tiktok_name`

= 1.1.0 =
* **TikTok Pixel + Events API**: pełna integracja — pixel ttq w przeglądarce, Events API serwerowe, deduplikacja event_id, capture ttclid z URL
* **Panel admin**: nowa strona ustawień TikTok, trzecia zakładka zdarzeń, karta modułu i krok checklisty wdrożenia
* **Diagnostyka**: health check TikTok, test Events API, log kanału tiktok, kolejka async
* **Formularze i własne zdarzenia**: mapowanie SubmitForm/Contact/Subscribe, kolumna TikTok w skanerze formularzy, pole tiktok_name

= 1.0.1 =
* **Formularze (Elementor, CF7, WPForms, Gravity Forms)**: naprawiona pętla zdarzeń `generate_lead` / `contact` / `subscribe` — jedno wysłanie formularza = jedno zdarzenie (kolejka JS nie powtarza już relay serwerowego co 500 ms)
* **Kolejka zdarzeń (mw-tracker-core)**: server relay (CAPI / GA4 MP) wysyłany tylko raz na zdarzenie; kanały bez zgody lub wyłączone nie blokują opróżniania kolejki; ochrona przed wielokrotnym wysłaniem Google/Meta przy retry
* **Formularze**: trwała deduplikacja po udanym submitcie w sesji strony; unikalny `event_id` na każde wysłanie

= 1.0.0 =
* Pierwsze wydanie MW Tracker pod slugiem mw-tracker
* Google Analytics (GA4), GTM dataLayer, Consent Mode v2, Enhanced Conversions
* Meta Pixel + Conversions API z deduplikacją event_id
* GA4 Measurement Protocol (server-side)
* WooCommerce e-commerce: classic checkout + Blocks Checkout/Cart
* Formularze: Elementor, CF7, WPForms, Gravity Forms + skaner i intencje lead/contact/subscribe
* Integracja CMP (CACSP, Complianz, Cookiebot, CookieYes, Borlabs)
* Panel diagnostyczny, checklist wdrożenia SEM, własne zdarzenia JS
* HPOS: zgodność z WooCommerce High-Performance Order Storage
* Porządki przed premierą: usunięty martwy kod licencji, legacy CSS, nieużywane domyślne ustawienia i zbędne pliki; purchase tylko po opłaceniu zamówienia; panel admin bez podwójnej inicjalizacji trackerów

== Upgrade Notice ==

= 1.1.3 =
Naprawa osadzania Google Tag Manager przy metodzie gtag.js oraz potwierdzona kompatybilność z WordPress 7.0.

= 1.1.2 =
Poprawki TikTok z audytu: dedup PageView, opóźniony load pixela, E.164, LDU, auto advanced matching, identify z formularzy.

= 1.1.1 =
Uzupełnienie TikTok: pełne ścieżki WooCommerce JS, poprawiony Events API v1.3, PageView po zgodzie marketingowej.

= 1.1.0 =
Nowa integracja TikTok Pixel + Events API. Skonfiguruj Pixel ID i token w MW Tracker → TikTok.

= 1.0.1 =
Zalecana aktualizacja: naprawia wielokrotne zdarzenia lead po wysłaniu formularza Elementor (i innych integracji formularzy).

= 1.0.0 =
Pierwsze wydanie MW Tracker. Zainstaluj i skonfiguruj zgodnie z checklistą w panelu.
