Facebook: Obsah len pre fanúšikov?

V našej SK developerskej skupine na Facebook-u som sa stretával s veľmi častou otázkou, ktorá smerovala práve k tomu, aby sme napísali niečo o tom, ako rozlišovať fanúšikov a nefanušíkov. Tak si poďme napísať pár riadkov k tejto téme.

V prvom rade je nutné si uvedomiť, že k tomuto nepotrebujeme od používateľa žiadne práva, nakoľko túto informáciu nám poskytuje samostatný "podpísaný request" (signed_request) od Facebook-u. Ten obsahuje základné údaje o používateľovi a teda aj o stránke, na ktorej sa nachádza.

Ak správne rozparsujete signed_request, dostanete údaje, ktoré obsahujú:

• code
  kód podľa OAuth
  
• algorithm
  najčastejšie HMAC-SHA256
  
• user_id
  ID používateľa (facebook ID)
  
• user
  základné údaje o užívateľovi, akými je jazyková verzia, ktorú na FB používa (locale), krajina (country) a vek (obsahuje rozmedzie veku min-max), konkrétnejšie údaje získate len ak získate povolenie pre aplikáciu o prístup k daným údajom
  
• page
  ktorý obsahuje pre nás podstatné údaje ako napríklad liked, kde sa prenáša 0/1 ak užívateľ dal stránke LIKE, admin, kde je tiež 0/1 ak daný používateľ je pre danú stránku administrátorom.

Poďme rozlišovať obsah

Aby som nepísal zbytočne komplikované veci, berme to tak, že poznáme nejakú tú premennú, ktorú sme získali pomocou rozparsovania tzv. SIGNED_REQUEST-u, ktorý posiela Facebook každej stránke, ktorú načítava a teda aj do našej PAGE TAB-y. Volajme túto premennú ako $signed.

Ak chceme rozlišovať obsah podľa toho, či je napríklad používateľ admin-om, alebo klikol na LIKE, tak nám stačí jednoduchá podmienka.

<?php
if($signed['page']['liked'] == 1) {
/*
 * ...
 * kód, ktorý sa vykoná len ak je to používateľ, čo dal like stránke...
 * ...
 */
} else {
/*
 * ...
 * kód, ktorý sa vykoná ak užívateľ ešte musí lajkovať...
 * ...
 */

}
?>

Rovnako funguje aj kód pre overenie, či je užívateľ administrátorom. To sa hodí, ak chcete administrátorom povoliť nejaké menu navyše, pomocou ktorého vedia robiť napríklad úpravy v obsahu a tak podobne.

Práca so Signed Request-om

function parse_signed_request($signed_request, $secret) {
  list($encoded_sig, $payload) = explode('.', $signed_request, 2); 

  // decode the data
  $sig = base64_url_decode($encoded_sig);
  $data = json_decode(base64_url_decode($payload), true);

  if (strtoupper($data['algorithm']) !== 'HMAC-SHA256') {
    error_log('Unknown algorithm. Expected HMAC-SHA256');
    return null;
  }

  // check sig
  $expected_sig = hash_hmac('sha256', $payload, $secret, $raw = true);
  if ($sig !== $expected_sig) {
    error_log('Bad Signed JSON signature!');
    return null;
  }

  return $data;
}

function base64_url_decode($input) {
  return base64_decode(strtr($input, '-_', '+/'));
}

Verím, že táto maličkosť pomohla a ak nie, tak zopár zdrojov k tomu, ako pracovať s page tab-om a signed_request-om:

• Signed Request a práca s dekódovaním
• PAGE TAB a ako správne pridať page tab do stránok
• SNiPI.sk a pár info o autorovi tohto článku :)