Térkép- és témaintegrációk MU-pluginnal

Egyes integrációk túl nagy beavatkozást jelentenének ahhoz, hogy alapból benne legyenek a Complianzban. Ilyenkor (és például különleges Google Maps-megoldásoknál) az integrációk külön MU-pluginként vannak elérhetők. Az MU-plugin (must-use plugin) a /wp-content/mu-plugins/ mappába kerülő PHP-fájl, amelyet a WordPress automatikusan betölt. Ha a mappa nem létezik, hozd létre.

A beépített bővítményintegrációk a Complianz → Integrations → Plugins oldalon kapcsolhatók be. Az itt leírt MU-pluginek a Complianz saját integrációs fájljai közé tartoznak, és azoknál a megoldásoknál kellenek, amelyek nincsenek beépítve.

FlipperCode WP Maps (Pro)

Ha a Complianz 6.6.0 vagy újabb változatát használod, a FlipperCode saját oldalán megoldódott a függőségi lánc, ezért az alábbi módszerre nincs szükség: elég bekapcsolni a WP Google Map Plugin integrációt a Complianz → Integrations → Plugins oldalon.

Régebbi változatoknál a WP Maps Pro beépített GDPR-moduljával blokkolhatod a térképet a hozzájárulásig, és betöltheted, amikor a Complianzban megvan a hozzájárulás.

1. A WordPress menüben nyisd meg a WP Maps Pro → Plugin Settings oldalt, és keresd meg a Cookies Acceptance szakaszt.
2. Kapcsold be a Cookie Acceptance jelölőnégyzetet.
3. A megjelenő No Map notice mezőbe illeszd be ezt a gombot:

<button onClick="javascript:location.reload();"
class="cmplz-accept-marketing" href="#"
style="background-color: #007bff; color: #fff;
border: none; border-radius: 5px;
padding: 10px 20px; font-size: 16px; cursor: pointer;">
Click here to accept Marketing cookies and enable this Google Map</button>

4. Hozz létre egy új PHP-fájlt ezzel a tartalommal, majd töltsd fel a /wp-content/mu-plugins/ mappába:

<?php
add_filter( 'wpgmp_accept_cookies', 'wpgmp_accept_cookies' );

function wpgmp_accept_cookies( $is_allowed ) {
  if ( cmplz_has_consent( 'marketing' ) ) {
    $is_allowed = true;
  }
  return $is_allowed;
}

Az eredmény egy Google-térkép, amely a hozzájárulásig blokkolva van, és hozzájárulás után betöltődik.

Interico téma: Advanced Google Maps

Az Interico téma Advanced Google Maps elemére a interico-advanced.php MU-plugin ad megoldást. Blokkolja a Maps API-t és az arra épülő beágyazott Interico-szkriptet a látogató hozzájárulásáig.

1. Töltsd fel az interico-advanced.php fájlt a /wp-content/mu-plugins/ mappába.
2. A WPBakery Frontend Editorban add hozzá az oldalhoz az Advanced Google Map blokkot.
3. Mutass a térképre, és a ceruza ikonnal nyisd meg a beállításait.
4. Adj meg érvényes értéket az Advanced Google Map minden beállításánál: különben a térkép JavaScript-hibát dob, és nem tud betöltődni.
5. Mutass újra a térképre, és a ceruza ikonnal szerkeszd a térképet tartalmazó oszlopot (Column).
6. Az Extra class name mezőbe írd: my-maps-class.

Ha jól csináltad, a térkép hozzájárulásig blokkolva van, a hozzájárulás után betöltődik.

10Web Google Maps (10Web Map Builder)

A 10web.io Google Maps bővítményhez (más néven 10WebMapBuilder) a 10web-google-maps.php MU-plugin tartozik. Blokkolja a Maps API-t és az arra épülő JavaScriptet a hozzájárulásig, majd hozzájáruláskor feloldja és a helyes sorrendben újratölti a szkripteket.

1. Töltsd fel a 10web-google-maps.php fájlt a /wp-content/mu-plugins/ mappába.
2. Add meg a Google Maps API-kulcsot a 10Web Map Builder bővítményben.
3. Hozz létre egy új térképet, és tedd a shortcode-ját egy oldalra.

WoodMart téma: Google Maps

A WoodMart témához a woodmart-custom-google-maps.php MU-plugin tartozik. Blokkolja a Maps API-t és az arra épülő WoodMart-szkripteket a hozzájárulásig.

A WoodMart Google Maps eleme csak WPBakery használatakor érhető el.

1. Töltsd fel a woodmart-custom-google-maps.php fájlt a /wp-content/mu-plugins/ mappába.
2. A WPBakery Frontend Editorban add hozzá az oldalhoz a Google Map blokkot.
3. Mutass a térképre, és a ceruza ikonnal nyisd meg a beállításait.
4. Add meg a Google Maps API-kulcsot, a többi mezőt pedig állítsd tetszés szerint.

Leaflet Map

A Leaflet Map bővítményhez a leaflet-maps.php MU-plugin tartozik.

1. Aktiváld a Leaflet Map bővítményt.
2. Töltsd fel a leaflet-maps.php fájlt a /wp-content/mu-plugins/ mappába.
3. Nyisd meg a Leaflet Map → Shortcode Helper oldalt, és hozd létre a térképhez tartozó shortcode-ot.
4. Másold be a shortcode-ot azokra az oldalakra, ahol a térképnek látszania kell.

Elementor háttérvideó (YouTube, Vimeo)

Ha egy Elementor-szakasz háttere YouTube-videó, a Complianz a teljes szakaszt blokkolja, hogy a YouTube ne töltődjön be. Mivel ez általában a nyitóoldal teljes szélességű, első benyomást adó szekciója, a látogató a videó helyén helyőrzőt és hozzájárulási gombot lát, és eltűnik a videóra ültetett szöveg és gomb is. Hozzájárulás után a videó fut, a szöveggel és gombokkal együtt.

Jobb megoldás az erre készített MU-plugin: itt eldöntheted, kell-e helyőrző. A legjobb eredményt akkor kapod, ha a plugin elejére tett CMPLZ_ELEMENTOR_BACKGROUND_PLACEHOLDER állandót false-ra állítod, és az Elementorban háttér-tartalékot (fallback) adsz meg azoknak, akik még nem járultak hozzá. Aki elfogadja a bannert, annak a videó lejátszódik, és a későbbi látogatásoknál is. Így a szöveg és a gombok megmaradnak. Ha kell, saját helyőrzőt is hozzáadhatsz (lásd reCAPTCHA kézi blokkolása és wpDiscuz).

A plugin két állandója:

Állandó	Mit csinál	Alapérték a példában
CMPLZ_ELEMENTOR_BACKGROUND_PLACEHOLDER	Ha false, nincs helyőrző, a háttér-tartalék látszik.	true
CMPLZ_ELEMENTOR_BACKGROUND_PLACEHOLDER_BUTTON	Ha true, a helyőrzőre hozzájárulási gomb kerül.	false

A plugin YouTube esetén a marketing, Vimeo esetén a statistics kategóriát használja, és csak akkor fut, ha a Complianz a megfelelő szolgáltatást használtnak jelöli (youtube vagy vimeo). A működésének lényege: a blokkoló szűrő (cmplz_cookie_blocker_output) megjelöli a háttérvideós szakaszokat, a böngészőben futó JavaScript pedig hozzájáruláskor visszaállítja az Elementor beállításait, és újraindítja a szakasz widgetjeit.

A telepítése ugyanúgy történik, mint a többi MU-pluginé: töltsd fel a fájlt (elementor-background-video.php) a /wp-content/mu-plugins/ mappába.

ChurchThemes: Google Térkép

A ChurchThemes „Saved” témájához külön MU-plugin tartozik (churchthemes-gmaps.php). Ez a hozzájárulásig blokkolja a Google Maps API-t és a ChurchThemes rá épülő szkriptjét.

1. Töltsd fel a churchthemes-gmaps.php fájlt a /wp-content/mu-plugins/ mappába.
2. Alapértelmezetten a téma Widget szakaszában lévő Google Térképre kerül helyőrző.

A helyőrzőt kapó elem osztálya megváltoztatható: a fájl 20. sorában a ctfw-google-map helyére írd be annak az elemnek az azonosítóját vagy osztályát, amelyre a helyőrzőnek kerülnie kell.

Beaver Builder PowerPack: Video elem

A Complianz integrálható a Beaver Builder PowerPack Video elemével. Így blokkolhatók az ilyen elemekben lévő YouTube-videók, egyéni takarással (overlay) és lightboxon belüli videóval együtt. Az integráció MU-pluginként érhető el (powerpack-beaver-builder.php).

1. Töltsd fel a powerpack-beaver-builder.php fájlt a /wp-content/mu-plugins/ mappába.
2. Kapcsold be a YouTube-integrációt a Complianz → Integrations → Services oldalon.
3. Szerkeszd az oldalt a Beaver Builder szerkesztőjében.
4. Kattints a szerkesztő jobb felső sarkában lévő „+” ikonra.
5. A Modules alatti legördülő listában válaszd a PowerPack Modules pontot.
6. A Media Modules - PowerPack alól húzz egy Video elemet az oldalra.