CJakCiasteczko
Moduł Magento 2

Zgodny sklep Magento 2
w 10 minut, bez edycji szablonu.

Cookies Magento (sesja, koszyk, form_key, mage-cache-storage) domyślnie sklasyfikowane jako niezbędne — checkout działa bez kliknięcia w banner. Banner pyta tylko o GA4 enhanced ecommerce, Meta Pixel, Google Ads.

Co banner NIE pyta, a co pyta

Niezbędne — bez zgody
  • PHPSESSIDsesja klienta
  • mage-cache-storagecache prywatnych sekcji
  • mage-cache-sessidID cache klienta
  • private_content_versionwersjonowanie sekcji prywatnych
  • section_data_idscustomer-section sync
  • form_keyCSRF na checkoutie
  • X-Magento-Varyvarnish keying per klient
Wymaga zgody — banner pyta
  • _ga, _ga_*GA4 enhanced ecommerce
  • _gcl_*, IDEGoogle Ads + remarketing
  • _fbp, frMeta Pixel
  • _hjSessionUser_*Hotjar nagrania
  • _clck, _clskMicrosoft Clarity
  • external_no_cachemoduły 3rd-party gdy ustawione przez analitykę
0130 sekund

Pobierz moduł

Załóż konto na cjakciasteczko.pl, dodaj domenę sklepu, w panelu Integracje pobierz cjakciasteczko-magento.zip. Plik ~10 KB.

cjakciasteczko.pl/app/integrations

Magento 2

v1.0.0

Moduł Magento 2 dla CJakCiasteczko. Cookies sklepu auto-niezbędne.

M2: 2.3–2.4.x
↓ Pobierz 10 KB
cjakciasteczko-magento-1.0.0.zip pobrany
022 minuty

Wgraj do app/code/

Rozpakuj zip do app/code/ — powstanie app/code/Aveneo/CJakCiasteczko/. Włącz moduł: bin/magento module:enable Aveneo_CJakCiasteczko, potem setup:upgrade i cache:clean.

terminal
$ unzip cjakciasteczko-magento-1.0.0.zip -d app/code/$ bin/magento module:enable Aveneo_CJakCiasteczko$ bin/magento setup:upgrade$ bin/magento cache:clean
0330 sekund

Wklej klucz w admin config

Stores → Configuration → aveneo → CJakCiasteczko. Wklej klucz instalacyjny, Save Config. Moduł zweryfikuje raz przy zapisie i pokaże powiązaną domenę poniżej.

admin → Stores → Configuration → aveneo → CJakCiasteczko
Klucz instalacyjny
cjc_live_a4f8…0c91
Save Config
✓ Powiązana domena: twojsklep.pl
04po cache:clean

Sklep zgodny

bin/magento cache:clean (Magento agresywnie cachuje config). Otwórz produkt w incognito — banner. Akceptuj → GA4 + Ads odblokowują się przez Consent Mode v2. Odrzuć → koszyk i checkout działają bez analityki.

twojsklep.pl/catalog/product/view/id/123
🛒 koszyk: 3
🍪 Cookies w sklepie

Używamy GA4 enhanced ecommerce do mierzenia konwersji. Bez nich sklep też działa — koszyk i checkout zawsze są dostępne.

AkceptujęTylko niezbędnePreferencje

U realnego sklepu Magento

„W Magento mieliśmy custom banner od dewelopera za 8 tysięcy złotych który psuł się przy każdym update. CJakCiasteczko wgrane przez naszego DevOpsa w 15 minut, działa niezależnie od wersji M2."
M
Polski sklep B2B na Magento 2
15 mln PLN obrotu rocznie · 3 store views

Magento Open Source vs Adobe Commerce

Moduł działa z obiema dystrybucjami. Adobe Commerce dorzuca kilka funkcjonalności (B2B, customer segmentation, page builder personalization) które wpływają na cookie footprint — moduł sklasyfikuje je odpowiednio.

Magento Open Source

  • · Standardowy zestaw cookies (sesja, koszyk, form_key)
  • · Banner integruje się z natywnym GTM container Magento
  • · Działa od 2.3.x wzwyż (rekomendowane 2.4.4+)
  • · Brak licencji Adobe → instalacja przez composer/manual

Adobe Commerce

  • · Wszystko z Open Source PLUS:
  • · _b2b_* — segmentation cookies (analytics)
  • · Page Builder personalization tags (marketing)
  • · Sensei tracker (Adobe Sensei AI) — analytics
  • · Dodatkowe powierzchnie wymagają zgody, banner je obsłuży

Wydajność — czemu moduł nie spowolni sklepu

Magento agresywnie cachuje przez Varnish + Full Page Cache (FPC). Banner musi być cache-friendly, inaczej zerwiemy hit-rate na pierwszej stronie produktu.

Single block, before="-"

Moduł rejestruje JEDEN block w view/frontend/layout/default.xml z atrybutem before="-" — render na samym początku <head>. Block nie wykonuje DB query (czyta config z scope-config który już jest w pamięci), więc nie rozbija FPC.

Async script, 0 render-blocking

Tag <script async src="..."> ładuje się w tle, nie blokuje parse'owania HTML. CrUX / PageSpeed Insights nie widzą wpływu na LCP / CLS.

Brak cookies wstrzykniętych przez Magento

Cookies dla bannera ustawia visitor's browser z naszego CDN-a (cjakciasteczko.pl) — nie z Twojego origin. To znaczy że Cache-Control Twojego sklepu nie ma niczego do cachowania per-visitor — FPC hit-rate stays at 100%.

FAQ — Magento 2

Multi-store / multi-website — różne klucze per sklep?

Tak. Backend model ApiKey zapisuje klucz na poziomie scope (default → website → store). W system.xml ustawiliśmy showInWebsite=1 + showInStore=1, więc admin może mieć inny klucz dla każdego store_view. Każdy store ma swoją domenę CJakCiasteczko z własną konfiguracją bannera.

Jak działa z Adobe Commerce Cloud (managed Magento)?

Identycznie jak self-host. Jedyna różnica: na Cloud nie masz SSH dostępu do CLI, więc bin/magento module:enable robi się przez deploy z repo. Dodaj nasz moduł do composer.json projektu, push, Cloud sam zrobi setup:upgrade w build phase.

Headless / PWA Studio / Hyvä — czy banner zadziała?

Tak, ale jest pułapka. Headless frontend (Vue Storefront, PWA Studio, Hyvä SPA) nie używa Magento layout XML, więc nasz default.xml block się nie wczyta. W tych przypadkach wstaw 2-line snippet ręcznie w app shell albo index.html headless frontu — najpierw inline window.CookieConsentConfig z polem domain, dopiero potem async script tag z naszym CDN.

GraphQL / REST API requesty — czy moduł je gateuje?

Nie. Moduł wstrzykuje skrypt tylko na frontend HTML pages (view/frontend/layout). API endpoints (GraphQL, REST V1) nie mają head'a do wstrzyknięcia. Jeśli chcesz zgateować API requesty na 3rd-party tagi, użyj server-side GTM (sGTM) — to inna warstwa, niezależna od bannera.

bin/magento setup:upgrade błąd przy aktywacji?

Najczęstsze przyczyny: (1) cache nie został wyczyszczony przed enable — odpal bin/magento cache:flush najpierw; (2) deploy:mode=production wymaga di:compile po enable — dodaj bin/magento setup:di:compile do flow; (3) rights na app/code/Aveneo/CJakCiasteczko/ — chmod -R 755 + chown www-data:www-data.

10 minut do RODO-zgodnego sklepu Magento.

30 dni za darmo, bez karty. Działa od Magento 2.3 + PHP 7.4.