M Cookie Consent

Diegimas ir kas iš tikrųjų nutinka įjungus

Įjungus sukuriamos dvi parinktys: mcc_settings su numatytaisiais nustatymais ir tuščias mcc_consent_log, kuriame iškart atsiranda vienintelis įrašas „activated“. Naudojama add_option funkcija, tad pakartotinis įjungimas jau sukonfigūruotoje svetainėje nieko neperrašo. Lankytojai kol kas nemato nieko: kol neįrašytas nė vienas sekimo ID, viešojoje svetainės dalyje nerodoma nei juosta, nei Consent Mode paleidimo eilutė, neįkeliami nei CSS, nei JavaScript failai. Įskiepis nesukuria jokio cron įvykio, jokios duomenų bazės lentelės, jokio REST maršruto ir niekaip nesikiša į el. laiškų siuntimą.

1. Įdiekite ZIP failą per Įskiepiai → Pridėti naują → Įkelti įskiepį arba nukopijuokite aplanką m-cookie-consent į /wp-content/plugins/.
2. Įjunkite įskiepį. Antraštėje nurodyti minimalūs reikalavimai: WordPress 6.5 ir PHP 7.4.
3. Atverkite M Consent kairiajame administravimo meniu. Nuoroda Settings atsiranda ir šalia įskiepio pavadinimo ekrane Įskiepiai. Abu pavadinimai yra paties įskiepio, todėl lieka angliški, kol jo kas nors neišvers.

• Sutikimo režimas: „Stay fully blocked“ (visiškas blokavimas), saugiausias variantas, nustatytas iš karto.
• Slapuko galiojimas: 180 dienų.
• Plaukiojantis nustatymų mygtukas: įjungtas.
• Dizainas: Modern, plaukiojanti kortelė apačioje kairėje.
• Akcento spalva #6d5cf5, teksto spalva #14171f.
• Savo skripto kategorija: Marketing.
• Sutikimo versija: 1.
• Skiltyje Nustatymai → Privatumas, dalyje Policy Guide, atsiranda siūloma privatumo politikos pastraipa.
• Kol neužpildyta bent viena sekimo integracija, viešojoje svetainės dalyje neišvedama nieko.

Kur rasti įskiepio ekranus

Įskiepis prideda vieną pagrindinio lygio meniu punktą M Consent su privatumo dashicon piktograma, 80 pozicijoje, todėl jis atsiduria meniu apačioje, netoli Nustatymų. Vienintelis jo poskyris vadinasi Settings ir atveria tą patį puslapį wp-admin/admin.php?page=m-cookie-consent. Meniu, puslapio atvaizdavimas ir pakartotinio sutikimo veiksmas reikalauja manage_options teisės, todėl paprastoje svetainėje juos pasiekia tik administratoriai. Ekranas padalytas į dvi puses: kairėje keturios nustatymų sekcijos, dešinėje dvi plokštės, Live preview ir Status & tools.

• Tracking integrations: GA4, Tag Manager, Meta Pixel ir savo skripto laukai.
• Consent behaviour: sutikimo režimas, slapuko galiojimas, plaukiojantis mygtukas, politikų nuorodos.
• Banner texts: septyniolika neprivalomų laukų, perrašančių įdiegtus tekstus.
• Appearance: dizainas, išdėstymas, akcento spalva, teksto spalva.
• Live preview: sumažinta juostos peržiūra, atsinaujinanti berašant.
• Status & tools: veikiančių paslaugų sąrašas, dabartinė sutikimo versija, „Preview on my site“ ir „Ask all visitors for consent again“. Ši plokštė rodo, kas išsaugota, o ne kas tinkama, todėl netinkamas ID čia vis tiek atrodo kaip veikianti paslauga.

Sekimo integracijos ir ką kiekviena atrakina

Visi šios sekcijos laukai atkeliauja tušti. Įrašykite tik tas paslaugas, kurias iš tikrųjų naudojate: juostoje rodomos būtent tos kategorijos, kurias įjungia jūsų konfigūracija, todėl svetainė vien su GA4 gauna dviejų kategorijų juostą ir nieko daugiau. Kiekvienas ID tikrinamas išsaugant ir dar kartą prieš išvedant į puslapį.

• Google Analytics 4 ID. Numatytoji reikšmė tuščia. Formatas: G- ir nuo 4 iki 20 raidžių ar skaitmenų; išsaugoma didžiosiomis. Užpildžius juostoje atsiranda Analytics kategorija, o žyma įsijungia tik gavus sutikimą jai.
• Google Tag Manager ID. Numatytoji reikšmė tuščia. Formatas: GTM- ir nuo 4 iki 10 raidžių ar skaitmenų; išsaugoma didžiosiomis. Užpildžius juostoje atsiranda abi kategorijos, Analytics ir Marketing, nes konteinerio turinys nežinomas. Pačiai konteinerio žymai priskiriamos abi kategorijos, o skriptas ją paleidžia vos gavęs sutikimą bent vienai iš jų. Taigi lankytojas, sutikęs vien su Analytics, vis tiek užsikrauna visą konteinerį, o jame esančias reklamos žymas stabdo tik Consent Mode signalai, ne šis įskiepis. Jei GA4 jau yra konteineryje, GA4 lauką palikite tuščią.
• Meta Pixel ID. Numatytoji reikšmė tuščia. Tik skaitmenys, nuo 5 iki 20. Įsijungia tik gavus sutikimą Marketing kategorijai. noscript iframe atsarginio varianto sąmoningai nėra: lankytojas be JavaScript juostos nemato, vadinasi, sutikti negali.
• Custom tracking script. Numatytoji reikšmė tuščia. Neapdorotas HTML head sekcijai, kartu su script žymomis. Keisti gali tik paskyros su unfiltered_html teise; visiems kitiems laukas yra tik skaitomas, o pateiktas pakeitimas atmetamas su pranešimu ir grąžinamas ankstesnis skriptas. Multisite tinkle šią teisę turi tik super administratoriai. Prieš ką nors čia klijuodami perskaitykite 8 skyrių: blokuojama siauriau, nei leidžia suprasti lauko pavadinimas.
• Custom script category. Numatytoji reikšmė Marketing. Galimi pasirinkimai: Functional, Analytics ir Marketing. Necessary sąmoningai nesiūloma, kad sekimo kodas niekada neapeitų sutikimo.

Sutikimo elgsena (Consent behaviour)

Šioje sekcijoje sprendžiama, kaip griežtai stabdomos Google žymos, kiek laiko atsimenamas sprendimas ir kaip lankytojas gali jį atšaukti. Dvi politikų nuorodos rodomos juostos apačioje.

• Before consent, Google tags…: numatytasis „Stay fully blocked (recommended)“ iki sutikimo nesiunčia Google jokios užklausos. „Load with all consent signals denied (Advanced Consent Mode)“ Google žymas įkelia iš karto, be slapukų, siunčiant anoniminius signalus Google konversijų modeliavimui.
• Remember the choice for: numatytoji reikšmė 180 dienų. Leistina nuo 30 iki 730 dienų, o reikšmė už šių ribų išsaugant pakeičiama artimiausia leistina. Kai išsaugotas sprendimas pasensta, lankytojo klausiama iš naujo.
• Floating settings button: numatytai įjungtas. Tai įdiegtas būdas lankytojui vėl atverti nuostatų langą ir atšaukti sutikimą.
• Privacy policy link: numatytai tuščias, tada juosta naudoja puslapį, nurodytą Nustatymai → Privatumas.
• Cookie policy link: numatytai tuščias. Cookie policy nuoroda juostoje atsiranda tik tada, kai čia įrašytas adresas.

Juostos tekstai (Banner texts)

Visi septyniolika tekstų laukų atkeliauja tušti, o tuščias laukas reiškia, kad atvaizdavimo metu parenkamas įdiegtas išverstas tekstas. Bet koks jūsų įrašytas tekstas jį pakeičia iš karto visomis kalbomis, todėl daugiakalbėje svetainėje protingiausia čia nerašyti nieko ir išversti patį įskiepį. Teksto domenas yra m-cookie-consent, POT failas guli aplanke /languages; daugiakalbis įskiepis taip pat gali prisikabinti prie mcc_get_text filtro ir išversti jūsų išsaugotas reikšmes.

• Įdiegta antraštė yra „We value your privacy“. Įdiegtas atmetimo mygtuko tekstas yra „Only necessary“, nors pats nustatymų laukas pavadintas „Reject all“ button.
• Juostos žinutėje ir keturiuose kategorijų aprašymuose leidžiamas ribotas HTML: a su href, rel ir target, taip pat br, em ir strong. Visi kiti laukai paverčiami grynu tekstu.
• Simbolių skaitikliai yra tik patariamieji, tekstas niekada nekarpomas. Rekomenduojamos ribos: 300 simbolių juostos žinutei, 200 kategorijos aprašymui, 25 mygtukams ir nuorodoms, 60 visiems likusiems laukams.
• Nuostatų lange rodomos tik tos kategorijos, kurias įjungia jūsų integracijos, todėl nenaudojamų kategorijų tekstai tiesiog niekada nepasirodo.

Išvaizda (Appearance)

Juostos išvaizdą valdo keturi nustatymai. Iš abiejų spalvų parinkiklių sudaromi CSS kintamieji, kurie įrašomi ir į :root bloką, ir tiesiai į kiekvieną juostos elementą, todėl CSS optimizavimo įskiepis jų nepašalins. Du šviesesni atspalviai pagrindiniam tekstui ir nuorodoms išvedami iš jūsų teksto spalvos automatiškai.

• Design: numatytasis yra Modern, įdiegta apvalinta kortelė su akcento gradientu ir slapuko piktograma. „Match my website theme“ pateikia neutralią juostą, perimančią jūsų temos šriftą ir vizualiai neįkyrią.
• Banner layout: numatytasis variantas yra plaukiojanti kortelė apačioje kairėje. Kiti variantai: apatinė juosta per visą plotį ir plaukiojanti kortelė apačioje dešinėje.
• Accent colour: numatytoji #6d5cf5. Ji valdo pagrindinį mygtuką, piktogramą, jungiklius ir plaukiojantį mygtuką.
• Text colour: numatytoji #14171f. Ji valdo antraštę ir pagrindinį tekstą tiek juostoje, tiek nuostatų lange.

Pirmasis nustatymas iš eilės

Atlikite šiuos veiksmus tokia tvarka ir nieko nereikės kartoti. Kiekvienas sekimo ID, savo skripto, jo kategorijos ar sutikimo režimo pakeitimas pakelia sutikimo versiją, todėl sudėjus visus pakeitimus į vieną išsaugojimą lankytojų klausiama vieną kartą, o ne penkis.

1. Įrašykite tik tuos sekimo ID, kuriuos iš tikrųjų naudojate. Jei GA4 jau yra Tag Manager konteineryje, įrašykite tik GTM ID, o GA4 lauką palikite tuščią.
2. Jei klijuojate savo skriptą, klijuokite tik script žymas ir nieko daugiau, tada nurodykite kategoriją. Numatytoji Marketing yra saugi prielaida bet kokiam reklamos kodui. Kas nutinka viskam, kas nėra script žyma, paaiškinta 8 skyriuje.
3. Palikite „Before consent, Google tags…“ ties „Stay fully blocked (recommended)“.
4. Nurodykite privatumo politikos nuorodą arba palikite lauką tuščią ir sutvarkykite puslapį per Nustatymai → Privatumas. Cookie policy nuorodą pridėkite tik jei turite atskirą puslapį.
5. Palikite plaukiojantį nustatymų mygtuką įjungtą.
6. Nustatykite akcento ir teksto spalvas ir patikrinkite jas Live preview lange.
7. Visus Banner texts laukus palikite tuščius, nebent teisininkas pasakė kitaip.
8. Išsaugokite ir perskaitykite pranešimus ekrano viršuje. Atmestas ID paminimas tik ten.
9. Patikrinkite, ar Status & tools rodo būtent tas paslaugas, kurių tikitės, ir įsidėmėkite sutikimo versiją.
10. Išvalykite puslapių talpyklą ir CDN. Padarykite tai prieš bandymą, o ne po jo: senas talpyklos puslapis neša seną sutikimo versiją ir bandymo rezultatas apgaus.
11. Atverkite „Preview on my site“, tada išbandykite tikrą juostą privačiame naršyklės lange: sutikite, perkraukite, atšaukite plaukiojančiu mygtuku, atmeskite, perkraukite. Atvirame puslapyje atšaukimas veikia ne akimirksniu: atmetimo signalas, fbq revoke ir tiekėjų slapukų valymas įvyksta iš karto, bet į tą puslapį jau įterpti GA4, GTM ir Pixel skriptai tebeveikia, kol neperkrausite. Vertinkite rezultatą po perkrovimo.
12. Įdėkite [m_cookie_settings] į privatumo ar slapukų politikos puslapį, kad sutikimą būtų galima atšaukti iš pastovaus adreso.

Pavojingi veiksmai ir kaip juos atitaisyti

Niekas šiame įskiepyje negali užrakinti jūsų wp-admin, blokuoti prisijungimo, paliesti wp_mail ar sukurti cron užduoties. Viešosios dalies klasė kuriama tik tada, kai užklausa nėra administravimo užklausa, o kode nėra nė vienos prisijungimo, pašto, cron ar REST integracijos. Užtat jis gali sugadinti viešuosius puslapius, užkrauti trečiųjų šalių išteklius dar niekam nesutikus, padaryti juostą nenaudojamą, panaikinti visus išsaugotus sutikimus, perrašyti jūsų konfigūraciją ir sunaikinti atskaitomybės žurnalą. Prie kiekvieno punkto nurodytas tikslus kelias atgal. Pirmuosius keturis perskaitykite dar prieš ką nors klijuodami į Custom tracking script.

• Custom tracking script: neapdorotas kodas kiekvieno viešo puslapio head sekcijoje. Kodas netikrinamas. JavaScript sintaksės klaida jame nieko nesugadina: blokas išvedamas kaip type="text/plain", iki sutikimo apskritai neanalizuojamas, o po sutikimo įterpiamas kaip atskiras script elementas, tad klaida jame nepasiekia nei banner.js, nei jūsų temos. Tikrasis pavojus yra brokuotas HTML: neuždaryta žyma ar neuždarytas komentaras praryja likusią head dalį ir kartu su ja visą puslapį. Kaip atitaisyti: atverkite M Consent, ištuštinkite lauką, išsaugokite ir išvalykite talpyklą. Jei jūsų paskyra šio lauko keisti negali, tai nepadės, žiūrėkite ketvirtą šio sąrašo punktą.
• Blokuojami tik skriptai, paveikslėliai ir iframe elementai. transform_gated_html() neutralizuoja lygiai du dalykus: script žymas, kurių type yra tuščias, text/javascript, application/javascript arba module, ir img bei iframe src atributą. Visa kita išvedama lygiai taip, kaip parašėte: link, style su išoriniu url(), object, embed, video, source, noscript ir meta http-equiv="refresh". Todėl trečiosios šalies šriftų stilių failas užsikrauna kiekvienam lankytojui vos nupiešus puslapį, dar iki bet kokio sutikimo, ir sugriauna visą įskiepio prasmę. O čia įklijuotas meta refresh nukreipia kiekvieną viešą svetainės puslapį, nors wp-admin lieka pasiekiamas. Kaip atitaisyti: klijuokite tik script žymas; jau įvykus bėdai ištuštinkite lauką kaip aukščiau arba, jei viešoji dalis jau nukreipia, naudokite 9 skyriaus WP-CLI komandą.
• Skriptas su neįprastu type atributu apskritai neblokuojamas. Perrašymo mechanizmas veikia tik tada, kai type yra tuščias, text/javascript, application/javascript arba module. Visa kita grąžinama nepaliesta ir be blokavimo žymės, tad įskiepis tokio skripto ir po sutikimo neaktyvuoja. Jei naršyklė tą type vis dėlto laiko JavaScript, skriptas pasileidžia iškart ir be jokio sutikimo; jei nelaiko, jis nepasileidžia niekada. Kaip atitaisyti: pašalinkite type atributą iš savo iškarpos arba perkelkite sekimo kodą į tam skirtą integracijos lauką.
• Gali būti, kad savo skripto iš nustatymų ekrano ištrinti apskritai nepavyks. render_custom_script() pažymi laukelį kaip readonly kiekvienam be unfiltered_html teisės, o sanitize_custom_script() pateiktą tuščią reikšmę atmeta ir su pranešimu grąžina ankstesnį skriptą. Tai liečia kiekvieną multisite svetainės administratorių, kuris nėra super administratorius, ir kiekvieną svetainę, kurioje apibrėžta DISALLOW_UNFILTERED_HTML, o daugelis valdomos prieglobos paslaugų tiekėjų taip daro iš karto. Sugedusi iškarpa tada lieka kiekvieno viešo puslapio head sekcijoje ir per sąsają jos išimti nebeįmanoma. Kaip atitaisyti, pageidautina tvarka: paleiskite wp option patch update mcc_settings custom_script '' (WP-CLI aplinkoje tikrinimo funkcija neužsikrauna); arba paprašykite super administratoriaus ištuštinti lauką; arba pašalinkite DISALLOW_UNFILTERED_HTML konstantą iš wp-config.php ir ištuštinkite patys; arba išjunkite įskiepį, tada išvedimas nutyla, o visi nustatymai lieka.
• Advanced Consent Mode siunčia duomenis Google dar nesant jokio sutikimo. Pasirinkus „Load with all consent signals denied“, kiekvieno lankytojo naršyklė iškart parsisiunčia Google žymas ir išsiunčia atmestos būsenos signalus. Kelios ES priežiūros institucijos tokius signalus laiko duomenų tvarkymu. Kaip atitaisyti: grįžkite prie „Stay fully blocked (recommended)“ ir išsaugokite. Šis nustatymas susijęs su sutikimu, todėl sutikimo versija pakyla ir visų lankytojų klausiama iš naujo; išvalykite puslapių talpyklą.
• Neįrašius nė vieno sekimo ID juostos nebūna visai. Juosta, Consent Mode paleidimo eilutė ir viešosios dalies failai išvedami tik tada, kai naudojama bent viena neprivaloma kategorija. Svetainė, kurios temoje įrašytas GA4 arba kuri Meta Pixel kelia per kitą įskiepį, juostos nerodys ir seks visus. Kaip atitaisyti: perkelkite tuos sekimo kodus į šį įskiepį. Filtras mcc_force_banner nėra lygiavertis pakaitalas: jis tik perjungia banner_enabled(), tad juosta pasirodo, bet neblokuojama visiškai nieko, nes įskiepis stabdo tik savo paties išvedamas žymas. Temoje įrašytą gtag GA4 bent jau prilaiko atmestos Consent Mode numatytosios reikšmės, kurias paleidimo eilutė nustato wp_head prioritetu 0; per kitą įskiepį keliamas Meta Pixel savo PageView išsiunčia dar iki bet kokio sprendimo ir nėra pridengtas niekaip, nes fbq revoke suveikia tik lankytojui ką nors paspaudus. Filtras tinka tik tada, kai sprendimą surenka ir paskelbia juosta, o įvykdo jūsų pačių kodas, kuris klauso mcc:consent įvykio; sekimo kodų perkėlimo jis nepakeičia.
• Išjungus plaukiojantį nustatymų mygtuką nelieka nė vieno įdiegto būdo atšaukti sutikimą, o įprasta atsarginė išeitis gali neveikti. BDAR reikalauja, kad atšaukti būtų taip pat paprasta, kaip ir sutikti. Bėda ta, kad [m_cookie_settings], #mcc-settings ir window.mccShowSettings() visi remiasi banner.js ir nuostatų langu, o nė vienas, nė kitas nėra išvedamas, kol nenaudojama bent viena neprivaloma kategorija. Svetainėje, iš kurios sekimo priemonės vėliau buvo pašalintos, trumpasis kodas sukuria mygtuką, kuris nieko nedaro. Kaip atitaisyti: įjunkite plaukiojantį mygtuką atgal; o prieš jį išjungdami įsitikinkite, kad yra bent viena integracija arba kad mcc_force_banner filtras įjungtas.
• „Ask all visitors for consent again“ iš nustatymų ekrano atsukti nebegalima. Šis mygtukas padidina consent_version, o tai akimirksniu panaikina visus lankytojų slapukus. Tikrinimo funkcija neleidžia šio skaičiaus sumažinti: paimama didesnioji iš išsaugotos ir pateiktos reikšmės. Tas pats pakėlimas įvyksta automatiškai pakeitus GA4 ID, GTM ID, Pixel ID, savo skriptą, jo kategoriją ar sutikimo režimą. Kol lankytojai sutinka iš naujo, matavimuose bus spraga. Kaip atitaisyti: mažesnę consent_version reikšmę įrašyti tiesiai į mcc_settings parinktį, kaip parodyta kitame skyriuje.
• Filtruotus nustatymus į duomenų bazę visam laikui įrašo bet koks išsaugojimas nustatymų ekrane, o ne tik mygtukas „Ask all visitors for consent again“. handle_force_reconsent() nustatymus paima per MCC_Plugin::get_settings(), o šis jau būna praėjęs viešą mcc_settings filtrą, ir tą masyvą paduoda update_option() funkcijai. Paprastas Save Changes tą patį pasiekia kitu keliu: kiekvienas laukas užpildomas iš to paties filtruoto masyvo, tad forma įterptas reikšmes tiesiog grąžina atgal. Viskas, ką per tą filtrą įterpia tema, kodo iškarpa ar daugiakalbis įskiepis, praeina tikrinimo funkciją ir lieka išsaugota visam laikui, tyliai pakeisdama jūsų konfigūraciją: vykdymo metu išversta juostos antraštė tampa nuolatine juostos antrašte vos administratoriui pirmą kartą ką nors išsaugojus. Jei įterpta reikšmė paliečia su sutikimu susijusį raktą, pakyla ir versija, o paspaudus mygtuką šis pakėlimas prisideda prie paties mygtuko pakėlimo. Kaip atitaisyti: pašalinkite filtrą, tada iš naujo suveskite teisingas reikšmes nustatymų ekrane arba atkurkite mcc_settings iš duomenų bazės kopijos.
• Sutikimo versijos pakėlimas kartu su nepavalyta talpykla lankytojui kainuoja du klausimus, ne vieną. Versija įrašoma į talpykloje gulintį HTML, todėl lankytojai, gavę senus puslapius, susikuria slapukus su sena versija. Vos talpyklą pagaliau išvalius, griežtas versijos tikrinimas panaikina visus tuos slapukus ir tie patys žmonės klausiami dar kartą. Kaip atitaisyti: po fakto niekaip, todėl talpyklą ir CDN valykite iškart po kiekvieno išsaugojimo, kuris pakelia versiją, o ne kitą rytą.
• Atskaitomybės žurnalą naikina ne tik Delete, bet ir įprastas naudojimas. append_log() palieka paskutinius 50 įrašų, o visa kita nurašo per kiekvieną rašymą. Įtempta konfigūracijos keitimų savaitė tyliai perrašo seniausius įrašus, o eksporto mygtuko sąsajoje nėra. Kaip atitaisyti: niekaip. Jei mcc_consent_log laikote BDAR įrodymu, reguliariai nusikopijuokite jį komanda wp option get mcc_consent_log --format=json, o ne tik prieš šalindami įskiepį.
• Ištrynus įskiepį sunaikinamos abi parinktys. Išjungimas nieko nepašalina, bet mygtukas Ištrinti ekrane Įskiepiai paleidžia uninstall.php, kuris ištrina mcc_settings ir mcc_consent_log. Multisite tinkle jis pereina visas tinklo svetaines ir ištrina abi parinktis iš kiekvienos. Kaip atitaisyti: tik duomenų bazės atsarginė kopija.
• Šviesi teksto ar akcento spalva padaro juostą neįskaitomą visiems lankytojams. Nustatymų ekranas nenukenčia, todėl tai atitaisoma, bet Live preview yra vienintelė vieta, kur tai pastebėsite anksčiau už lankytojus. Kaip atitaisyti: grąžinkite spalvas Appearance sekcijoje arba įrašykite gamyklines reikšmes tiesiai į parinktį, kaip parodyta kitame skyriuje.

Atkūrimas be nustatymų ekrano

Visa įskiepio būsena telpa į dvi parinktis ir vieną aplanką, todėl sugadintą viešąją dalį visada galima atkurti iš komandinės eilutės. Prieš rašydami įsidėmėkite: nustatymų klasė kuriama tik administravimo užklausose, todėl WP-CLI aplinkoje jos tikrinimo funkcija neužsiregistruoja. Įrašas per wp option patenka lygiai toks, kokį parašėte: be patikros, be reikšmių apkarpymo, be teisių tikrinimo savo skriptui ir be didėjančios versijos apsaugos. Būtent todėl tai veikiantis avarinis išėjimas. Ir būtent todėl klaidinga reikšmė čia yra blogesnė nei klaidinga reikšmė ekrane: įrašius ID, kurio įskiepis panaudoti negali, seną UA- formato ar ID su tarpu, kategorijų skaičiuoklė vis tiek laiko paslaugą veikiančia, Status & tools ją rodo, o išvedimo etapas tyliai nespausdina nieko. Rezultatas: juosta prašo lankytojų sutikti su sekimo priemone, kurios nėra, ir nė viename ekrane nėra jokios klaidos. Po kiekvieno patikslinimo parinktį perskaitykite atgal.

1. Pirmiausia sustabdykite žalą: išjunkite įskiepį arba pervardykite jo aplanką, jei net WP-CLI nepasiekiamas. Abu būdai iškart nutildo visą išvedimą ir nieko neištrina.
2. Jei kaltas tik savas skriptas, ištuštinkite vien tą raktą, o likusią konfigūraciją palikite ramybėje. Tai ir pirmasis kelias tada, kai jūsų paskyra šio lauko nustatymų ekrane keisti negali; kitus tris išvardija 8 skyrius.
3. Jei klaida buvo Advanced Consent Mode, grąžinkite consent_mode_style į basic.
4. Jei dėl spalvų pasirinkimo juosta tapo neįskaitoma, grąžinkite gamyklines reikšmes į text_color ir accent_color.
5. Jei netyčia pakėlėte sutikimo versiją, įrašykite ankstesnį skaičių. Lankytojai, kurių slapuke tebėra ta versija, vėl bus pripažinti.
6. Po kiekvieno atskiro patikslinimo perskaitykite abi parinktis ir įsitikinkite, kad pakeitimas įsirašė būtent taip, kaip norėjote. Šių įrašų niekas netikrina ir apie klaidingą nepraneša.
7. Išvalykite puslapių talpyklą ir CDN, tada perkraukite viešąją svetainę privačiame naršyklės lange.
8. Įjunkite įskiepį atgal arba grąžinkite aplanko pavadinimą. Išsaugoti nustatymai tebėra vietoje.

# Stop all plugin output, keep every setting
wp plugin deactivate m-cookie-consent

# No WP-CLI? Renaming the folder deactivates it just as well
mv wp-content/plugins/m-cookie-consent wp-content/plugins/m-cookie-consent.off

# Clear only the custom tracking script.
# This works even when the settings screen refuses: the readonly textarea and
# the unfiltered_html check live in the admin sanitizer, which is not loaded here.
wp option patch update mcc_settings custom_script ''

# Return to full prior blocking
wp option patch update mcc_settings consent_mode_style basic

# Put the shipped colours back when the banner became unreadable
wp option patch update mcc_settings text_color '#14171f'
wp option patch update mcc_settings accent_color '#6d5cf5'

# Put the consent version back down (bypasses the monotonic guard)
wp option patch update mcc_settings consent_version 3

# Read back what is stored, after EVERY patch above.
# Nothing here is validated, so this is the only place a mistake shows up.
wp option get mcc_settings --format=json
wp option get mcc_consent_log --format=json

Gedimų paieška

Pirmiausia pažiūrėkite į Status & tools: ten matyti veikiančių paslaugų sąrašas ir dabartinė sutikimo versija, o šie du dydžiai paaiškina daugumą netikėtumų. Turėkite omenyje, kad plokštė rodo, kas išsaugota, o ne kas tinkama naudoti, tad ten įrašyta paslauga dar neįrodo, kad puslapyje kas nors išvedama.

• Viešojoje svetainės dalyje juostos nėra, o Status & tools rodo „Active services: none“. Arba ID buvo atmestas išsaugant, arba jo iš viso neįrašėte. Įrašykite iš naujo ir stebėkite pranešimą ekrano viršuje.
• Status & tools rodo paslaugą, bet puslapio kode dėl jos nėra nieko. Išsaugotas ID netinkamo formato, o taip nutinka, kai jis įrašytas per WP-CLI arba įterptas filtro. Juosta vis tiek prašo sutikimo tai kategorijai. Sutvarkykite ID nustatymų ekrane.
• Juosta rodoma, bet GA4 nepasileidžia. Įsitikinkite, kad iš tikrųjų duotas sutikimas Analytics kategorijai, tada puslapio kode raskite žymą su id mcc-ga4-loader. Visiško blokavimo režimu ji išvedama kaip type="text/plain", o po sutikimo skriptas pakeičia ją tikra script žyma.
• Užsikrovė visas GTM konteineris, nors lankytojas sutiko tik su Analytics. Taip ir sumanyta: konteinerio žymai priskirtos ir analytics, ir marketing kategorijos, o skriptas elementą aktyvuoja vos gavęs sutikimą bent vienai iš išvardytų. Konteineryje esančias reklamos žymas stabdo tik Consent Mode signalai.
• Lankytojui ką tik atšaukus sutikimą sekimo priemonės tebeveikia. Irgi taip sumanyta ir tik iki kito puslapio užkrovimo: atmetimo signalas, fbq revoke ir tiekėjų slapukų valymas įvyksta iš karto, bet į atvirą puslapį jau įterpti skriptai nešalinami. Tikrinkite po perkrovimo.
• Po atnaujinimo matomi seni tekstai ar senos spalvos. Abu failai versijuojami pagal MCC_VERSION, todėl versijos pakėlimas juos atnaujina, bet prieš svetainę stovinti talpykla ar CDN vis tiek atiduos seną HTML. Išvalykite abu.
• Be aiškios priežasties visų klausiama iš naujo. Bet koks sekimo ID, savo skripto, jo kategorijos ar sutikimo režimo pakeitimas pakelia sutikimo versiją; tą patį daro ir pakartotinio sutikimo mygtukas. Palyginkite Consent version skaičių Status & tools plokštėje su tuo, ko tikitės.
• Visų klausiama du kartus. Pirmą kartą paklausė senas talpyklos puslapis su sena versija; antrąjį klausimą sukėlė talpyklos išvalymas, dėl kurio ką tik įrašytas slapukas tapo negaliojantis. Kitą kartą talpyklą valykite iškart po išsaugojimo.
• Plaukiojantis mygtukas užstoja pokalbių valdiklį. Jis fiksuotas apačioje kairėje, z-index 99999. Arba išjunkite jį ir naudokite [m_cookie_settings] ar nuorodą į #mcc-settings, arba perstilizuokite .mcc-reopen savo temoje.
• [m_cookie_settings] mygtukas atsiranda, bet nieko nedaro. banner.js ir nuostatų langas išvedami tik tada, kai naudojama bent viena neprivaloma kategorija, tad svetainėje be integracijų trumpasis kodas yra negyvas. Grąžinkite integraciją arba įjunkite mcc_force_banner filtrą.
• Savas skriptas nepasileidžia net po sutikimo. Patikrinkite jo type atributą: viską, kas nėra tuščia, text/javascript, application/javascript ar module, blokavimo mechanizmas apskritai praleidžia, todėl toks skriptas niekada neaktyvuojamas.

Privatumas ir duomenys

Įskiepis pats nesiunčia jokių išorinių užklausų. Jame nėra nei licencijos tikrinimo, nei naudojimo statistikos, nei atnaujinimų signalo, nei GeoIP paieškos, o visi jo failai keliauja iš jūsų pačių domeno. Vienintelės trečiųjų šalių užklausos svetainėje yra tos, kurias sukonfigūravote patys, ir jos suveikia tik po sutikimo, išskyrus 8 skyriuje aprašytą atvejį: viskas, kas nėra skriptas, paveikslėlis ar iframe, į savo skripto lauką įklijuota apskritai neblokuojama.

• Lankytojo įrenginyje sukuriamas vienas slapukas mcc_consent. Jame saugomas JSON objektas su sutikimo versija, laiko žyma milisekundėmis ir pasirinktomis kategorijomis. Jokio identifikatoriaus.
• Slapuko galiojimą lemia jūsų nurodyta „Remember the choice for“ reikšmė dienomis. Jis apribotas jūsų svetainės adreso keliu, pažymėtas SameSite=Lax, o per HTTPS ir Secure.
• Duomenų bazėje saugomos dvi parinktys. mcc_settings laiko jūsų konfigūraciją. mcc_consent_log laiko paskutinius 50 konfigūracijos įvykių, kiekvieną su UTC laiko žyma, sutikimo versija ir tuo metu veikusių paslaugų sąrašu. Nė vienoje nėra nieko apie konkretų lankytoją. 50 įrašų riba galioja per kiekvieną rašymą, tad senesni įvykiai dingsta negrįžtamai.
• Atšaukus Analytics sutikimą, skriptas panaikina slapukus _ga, prasidedančius _ga_, taip pat _gid ir _gat. Atšaukus Marketing, tas pats padaroma su _fbp ir _fbc.
• Šis valymas apima ir patį serverio vardą, ir visus aukštesnio lygio domenus, tad lankytojas, paspaudęs „Only necessary“ adresu shop.example.com, sunaikina ir www.example.com slapukus _ga bei _ga_. Teisiškai tai nekenkia, bet nemaloniai nustebina, jei aukštesnio lygio svetainė priklauso kitiems. Numatykite tai iš anksto, jei juostą diegiate bendro domeno subdomene.
• Skiltyje Nustatymai → Privatumas, dalyje Policy Guide, atsiranda visa tai aprašanti siūloma pastraipa, paruošta perkelti į jūsų politiką.

Trumpasis kodas, nuorodos ir kabliukai kūrėjams

Sutikimo langą galima atverti iš bet kurios svetainės vietos, o visa įskiepio elgsena filtruojama. Praverčia, kai juosta turi tilpti į savą poraštę arba kai svetainė naudoja sekimo priemones, kurių šis įskiepis nevaldo. Du iš šių kabliukų turi pasekmių, kurių pavadinimai neišduoda, tad prieš naudodami perskaitykite paskutinius du punktus.

• [m_cookie_settings] sukuria mygtuką, atveriantį nuostatų langą. Galima nurodyti neprivalomą text atributą; jo nenurodžius, naudojamas jūsų „Choose individually“ tekstas. Mygtukas veikia tik tol, kol naudojama bent viena neprivaloma kategorija, nes kitaip banner.js ir nuostatų langas apskritai neišvedami.
• Tą patį langą atveria bet kokia nuoroda su href="#mcc-settings" ir bet koks elementas su klase mcc-open-settings. Taip pat veikia window.mccShowSettings() iškvietimas iš savo kodo. Galioja ta pati sąlyga.
• Prie bet kurio viešo adreso pridėjus ?mcc_preview=1, juosta parodoma priverstinai net ir turint galiojantį išsaugotą sutikimą. Teisių patikros nėra, tad tokia nuoroda gali pasinaudoti bet kas, o parodyta juosta yra visiškai gyva: kiekvienas jos mygtukas eina įprastu sprendimo keliu ir perrašo mcc_consent slapuką. Peržiūros nuorodą laikykite būdu pakeisti kito žmogaus sutikimą, o ne peržiūra tik skaitymui, ir jos niekam nedalykite. PHP pusė reaguoja į bet kokį mcc_preview parametrą ir įjungia įskiepio išvedimą; JavaScript pusė location.search tikrina neužfiksuotu šablonu /[?&]mcc_preview=1/, todėl juostą priverstinai atveria esant bet kuriai mcc_preview reikšmei, prasidedančiai skaitmeniu 1, taip pat ir 10, 1x ar 1abc. Mygtukas „Preview on my site“ sukuria nuorodą su paprasta reikšme 1.
• PHP filtrai: mcc_settings, mcc_categories, mcc_active_categories, mcc_get_text, mcc_should_load, mcc_force_banner, mcc_template_path.
• Atsargiausiai elkitės su mcc_settings. Jis suveikia kiekvieną kartą skaitant nustatymus: ir viduje mygtuko „Ask all visitors for consent again“, kuris rezultatą įrašo atgal per update_option, ir tada, kai užpildomas kiekvienas nustatymų ekrano laukas, tad paprastas Save Changes tas įterptas reikšmes lygiai taip pat grąžina į parinktį. Taigi viskas, ką jūsų filtras įterpia, tampa nuolatine reikšme vos administratoriui pirmą kartą ką nors išsaugojus, o ne tik paspaudus tą mygtuką. Jei reikia pakeisti išsaugotą tekstą vykdymo metu, naudokite mcc_get_text: jo rezultatas atgal neįrašomas.
• JavaScript: po kiekvieno sprendimo document elemente sukeliamas mcc:consent CustomEvent su kategorijų žemėlapiu detail.consent viduje, o į dataLayer įrašomas mcc_consent_update įvykis.

Šalinimas

Išjungus pasikeičia tik tai, kas išvedama: juosta dingsta, sekimo iškarpos nebespausdinamos, o visos parinktys lieka duomenų bazėje, todėl įjungus iš naujo atkuriama lygiai ta pati konfigūracija. Įskiepio ištrynimas ekrane Įskiepiai yra visiškai kitas veiksmas, nes paleidžiamas uninstall.php.

• Ištrinant pašalinama: mcc_settings parinktis su visa jūsų konfigūracija.
• Ištrinant pašalinama: mcc_consent_log parinktis su atskaitomybės įrašais.
• Multisite tinkle uninstall.php pereina visas tinklo svetaines ir ištrina abi parinktis iš kiekvienos, ne tik iš tos, kurioje dirbote.
• Lieka: mcc_consent slapukas, jau esantis lankytojų įrenginiuose. Serveris negali ištrinti slapuko, kurio pats ką tik nesukūrė, todėl jis tiesiog baigia galioti savo laiku.
• Lieka: pastraipa, kurią iš Policy Guide persikėlėte į savo privatumo politiką.
• Lieka: turinyje užsilikęs [m_cookie_settings], kuris nuo tol rodomas kaip paprastas tekstas, ir bet koks temos kodas, prikabintas prie įskiepio filtrų.

Automatiniai atnaujinimai

Įskiepis tikrina majevski.com dėl naujų versijų ir siūlo jas per įprastą WordPress atnaujinimų langą — tas pats pranešimas, keitimų sąrašas ir diegimas vienu paspaudimu kaip ir bet kurio kito įskiepio. Tikrinimai talpinami podėlyje, niekada nelėtina puslapių ir veikia saugiai: jei majevski.com nepasiekiamas, svetainė tiesiog dirba toliau ir pabando vėliau. Atnaujinimo paketas priimamas tik iš majevski.com per HTTPS, o senesnė versija niekada nesiūloma. Versijos iki 1.1.0 atnaujinimų kanalo dar nepažįsta, todėl naujų leidimų nemato — vieną kartą rankiniu būdu įdiekite 1.1.0 ar naujesnę, ir visi vėlesni leidimai atkeliaus savaime.