WP Consent API

Опис

WP Consent API је додатак који уједначава преношење прихваћених категорија сагласности између додатака. Потребан му је додатак за банер колачића и бар још један додатак који подржава WP Consent API.

Са овим додатком сви подржани додаци могу да користе исти скуп метода за читање и регистровање тренутне категорије сагласности, што омогућава да додаци за управљање сагласношћу и други додаци раде заједно и побољшава усклађеност са законима о приватности.

УПОЗОРЕЊЕ: сам додатак неће управљати сагласношћу. Показаће вам колико имате додатака без подршке за Consent API и побољшаће усклађеност вашег сајта обезбеђивањем несметане комуникације између додатака за банер колачића и додатака који постављају колачиће или прате податке корисника.

Који проблем решава овај додатак?

Тренутно је могуће да додатак за управљање сагласношћу блокира услуге трећих страна као што су Facebook, Google Maps, Twitter итд. Али ако Вордпрес додатак постави PHP колачић, додатак за управљање сагласношћу то не може да спречи.

Друго, неки додаци уграђују кôд за праћење на страни клијента у JavaScript датотеке које, када се блокирају, кваре сајт.

Или, ако је JavaScript таквог додатка умањен, због чега URL постаје непрепознатљив и неће га открити скрипта за аутоматско блокирање.

На крају, приступ блокирања захтева списак свих врста URL-ова који прате податке. Општи API кога се додаци придржавају може знатно
да олакша администратору сајта да сајт учини усклађеним.

Да ли коришћење овог API-ја спречава услуге трећих страна да прате податке корисника?

Овај API је пре свега намењен усклађеним колачићима прве стране или праћењу од стране Вордпрес додатака. Ако такав додатак покреће, на пример, Facebook,
коришћење овог API-ја ће помоћи. Ако корисник угради Facebook iframe, потребна је алатка за блокирање која у почетку искључује iframe и/или скрипте.

Скрипте трећих страна морају бити блокиране функцијом блокирања у додатку за управљање сагласношћу. Радити то у основи било би превише наметљиво, а није ни применљиво на све кориснике: такву функцију захтевају само корисници са посетиоцима из opt-in региона као што је Европска унија. Таква функција такође носи ризик да нешто поквари. Осим тога, блокирање и приказивање лепог чувара места захтева још сложенији кôд, који по мом мишљењу, из истих разлога, не би требало да буде део основе Вордпреса.

Како ради?

Постоје два показатеља који заједно говоре да ли је дата сагласност за одређену категорију сагласности, нпр. „marketing“:
1) consent_type заснован на региону, који
може бити opt-in, opt-out или неки други могући consent_type;
2) и избор посетиоца: није постављен, allow или deny.

Функција consent_type обухвата филтер „wp_get_consent_type“. Ако не постоји додатак за управљање сагласношћу који би га поставио, вратиће false. То ће довести до тога да све категорије сагласности врате true, чиме се дозвољава постављање колачића у свим категоријама.

Ако је помоћу овог филтера постављен opt-in, категорија ће вратити true само ако је вредност избора посетиоца „allow“.

Ако је consent_type заснован на региону opt-out, вратиће true ако избор посетиоца није постављен или је „allow“.

На страни клијента, додатак за управљање сагласношћу може динамички да мења врсту сагласности и поставља више категорија колачића.

Додатак може да користи куку за ослушкивање промена или проверу вредности дате категорије.

Категорије и већина других ствари могу се проширити помоћу филтера.

Сагласност на нивоу услуге

Поред сагласности засноване на категоријама, API подржава управљање сагласношћу на нивоу услуге. То омогућава додацима за управљање сагласношћу да дају или одбију сагласност за одређене услуге (као што су ‘google-analytics’ или ‘facebook-pixel’) независно од њихове категорије. Приликом провере сагласности за услугу помоћу wp_has_service_consent(), API прво проверава да ли постоји изричита сагласност за ту услугу. Ако изричита сагласност није постављена, користи се стање сагласности категорије те услуге. Тако је могуће детаљно управљање: корисник може у начелу прихватити статистичке колачиће, али изричито одбити одређену аналитичку услугу.

Сагласност за услугу може се проверити и поставити и на серверу (PHP) и на клијенту (JavaScript):

PHP:

//check if a specific service has consent
if ( wp_has_service_consent( 'google-analytics' ) ) {
    //activate google analytics
}

//check if a service is explicitly denied
if ( wp_is_service_denied( 'facebook-pixel' ) ) {
    //service was explicitly denied by user
}

//set service consent
wp_set_service_consent( 'google-analytics', true ); //grant consent
wp_set_service_consent( 'facebook-pixel', false ); //deny consent

//listen for service consent changes
add_action( 'wp_consent_service_changed', function( $service, $consented ) {
    error_log( "Service {$service} consent changed to: " . ( $consented ? 'granted' : 'denied' ) );
}, 10, 2 );

JavaScript:

//check service consent
if ( wp_has_service_consent( 'youtube' ) ) {
    //activate tracking
}

//провера да ли је изричито одбијено

if ( wp_is_service_denied( 'facebook-pixel' ) ) {
    //service denied
}

//постављање сагласности за услугу

wp_set_service_consent( 'youtube', true );

//ослушкивање промена сагласности за услугу

document.addEventListener( 'wp_consent_api_status_change_service', function( e ) {
    console.log( 'Service: ' + e.detail.service + ', consented: ' + e.detail.value );
});

Постојеће интеграције

Разврстано по категоријама и поређано по абецеди

Пример додатка

• Пример додатка. Додатак се у суштини састоји од кратког кода са div елементом који приказује поруку о праћењу или непраћењу. Никакво стварно праћење се не обавља 🙂

Пружаоци услуге управљања сагласношћу

• Abconsent Sirdata CMP.
• Beautiful Cookie Consent Banner.
• Clickio Consent
• Cookie Consent CMP.
• Complianz GDPR/CCPA.
• Consent Studio.
• consentmanager.
• Conzent.
• Cookiebot.
• CookieFirst.
• CookieHub.
• CookieTractor.
• CookieYes – Cookie Banner for Cookie Consent.
• GDPR Cookie Compliance.
• GDPR Cookie Consent Plugin – CCPA Ready.
• GetTerms.
• iubenda | All-in-one Compliance.
• Lawwwing.
• Pressidium Cookie Consent.
• TrustArc Cookie Consent Manager

Додаци којима је потребна сагласност

• AddToAny.
• AFL UTM Tracker Plugin.
• Burst Statistics.
• Google Site Kit.
• Pixel Manager for WooCommerce.
• Woo.
• WP Statistics.

Сајт за приказ

wpconsentapi.org
Испод су наведени додаци коришћени за постављање сајта за приказ:

• Complianz
• Пример додатка

javascript, додатак за управљање сагласношћу

//set consent type
window.wp_consent_type = 'optin'

//dispatch event when consent type is defined. This is useful if the region is detected server side, so the consent type is defined later during the pageload
let event = new CustomEvent('wp_consent_type_defined');
document.dispatchEvent( event );

//consent management plugin sets cookie when consent category value changes
wp_set_consent('marketing', 'allow');

javascript, додатак за праћење

//listen to consent change event
document.addEventListener("wp_listen_for_consent_change", function (e) {
  var changedConsentCategory = e.detail;
  for (var key in changedConsentCategory) {
    if (changedConsentCategory.hasOwnProperty(key)) {
      if (key === 'marketing' && changedConsentCategory[key] === 'allow') {
        console.log("just given consent, track user")
      }
    }
  }
});

//basic implementation of consent check:
if (wp_has_consent('marketing')){
  activateMarketing();
  console.log("set marketing stuff now!");
} else {
  console.log("No marketing stuff please!");
}

PHP

//declare compliance with consent level API
$plugin = plugin_basename( __FILE__ );
add_filter( "wp_consent_api_registered_{$plugin}", '__return_true' );

/**
* Example how a plugin can register cookies with the consent API
 * These cookies can then be shown on the front-end, to the user, with wp_get_cookie_info()
 */

function my_wordpress_register_cookies(){
    if ( function_exists( 'wp_add_cookie_info' ) ) {
        wp_add_cookie_info( 'AMP_token', 'AMP', 'marketing', __( 'Session' ), __( 'Store a unique User ID.' ) );
    }
}
add_action('plugins_loaded', 'my_wordpress_register_cookies');


if (wp_has_consent('marketing')){
//do marketing stuff
}

Имате предлоге за кôд? Налазимо се и на GitHub-у!