In quest’ultima settimana ho studiato le api di facebook e ho incominciato a giocherellare creando qualche applicazione. Ho notato però, che in rete non c’è molta documentazione, specialmente in italiano. Per realizzare un’applicazione per facebook abbiamo bisogno di :

• Un account su facebook
• L’applicazione per lo sviluppo di facebook (Facebook Developer).
  Per installarla fare click su ‘Add Facebook Developer Application’
• Un server con php5 Se non lo abbiamo, si può utilizzare un server gratuito
• La libreria per php5 di facebook.

UPDATE : Versione aggiornata dell’articolo su : Come creare un applicazione per FaceBook (senza librerie php)

Una volta soddisfatti questi requisiti possiamo iniziare :

1. Aprire l’applicazione ‘Facebook Developer’ e cliccare su ‘Setup New Application’
2. Quindi nella nuova schermata aggiungere il nome dell’applicazione (1) , accettare i termini del contratto e cliccare sul link ‘Optional Fields’ (2) per aprire un nuovo pannello per inserire il resto delle informazioni
   
3. Nella sezione ‘Optional Fields’ inserire
   1 ) l’indirizzo di callback , ovvero l’indirizzo dove risiede la nostra applicazione, qualcosa tipo www.miosito.it/nomeapplicazione/
   2) il nome che identifica l’applicazione in facebook (può coincidere con quello della tua applicazione, se non è stato già assegnato)
   3) Selezionare some tipo di applicazione ‘Web Site’
   4) Selezionare ‘YES’ per indicare a Facebook, che la tua applicazione può essere aggiunta dagli utenti.
   Quest’ultima opzione aprirà una nuova sezione da riempire
   
4. Nella nuova sezione riempire solo i seguenti campi:
   1)Inserire il link a cui gli utenti verranno indirizzati dopo aver aggiunto la nostra applicazione ovvero : http://apps.facebook.com/nomeapplicazione
   2)Inserire un testo che vogliamo venga visualizzato nel profilo utente se non è specificato dalla nostra applicazione (es. ‘Ciao Mondo’)
   3)Inserire il link della nostra applicazione su facebook ovvero : http://apps.facebook.com/nomeapplicazione
   4) lasciamo gli altri campi invariati e clicchiamo su ‘Submit’
   

A questo punto la nostra applicazione è stata creata e FaceBook gli assegnato dei valori che dobbiamo segnarci, perchè dobbiamo inserirli nel nostro programmino presente sul nostro server. I valori sono la chiave dell’applicazione (API KEY) ed un numero segreto (SECRET). Per vedere questi valori andare nella lista delle ‘mie applicazioni‘

Ora dobbiamo creare la nostra applicazione vera e propria, per farlo scarichiamo la libreria php5 per facebook , e copiamo il file facebook.php sul nostro sito e creiamo due file : ‘appinclude.php’ e ‘index.php‘

appinclude.php

1
2
3
4
5
6
7
8

<?php
require_once 'facebook.php';
$appapikey = "CHIAVE DELL'APPLICAZIONE";
$appsecret = 'NUMERO SEGRETO';
$facebook = new Facebook($appapikey, $appsecret);
$user = $facebook->require_login();
$appcallbackurl = "http://www.miosito.it/nomeapplicazione/";
?>

ovviamente inseriamo i valori della chiave dell’applicazione (API KEY), il numero segreto (SECRET) e l’indirizzo corretto del nostro sito.

index.php

<?php
require_once 'appinclude.php';
echo 'Il tuo ID utente è :'.$user;
?>

Il nucleo della nostra applicazione e tutto nel file index.php, per ora ci limitiamo a scrivere un breve messagio, nei successivi articoli, vedremo di creare qualcosa di più interessante.

Ora la nostra applicazione è identificata da due indirizzi:

• http://www.miosito.it/nomeapplicazione/ : indrizzo di callback (che viene chiamato da facebook direttamente)
• http://apps.facebook.com/nomeapplicazione/ : indirizzo del applicazione su facebook (canvas url)

Per provarla utilizziamo uno dei due indirizzi ed aggiungiamo l’applicazione al nostro account facebook.
Se tutto è andato bene, dovremmo vedere ‘ciao ‘ seguito dal nostro nome, mentre se andiamo nel nostro profilo vi sarà una nuova sezione ‘nomeapplicazione’ con all’interno il messaggio ‘Ciao Mondo’.

Attenzione: Nel copiare ed incollare il codice, state attenti agli apici!

Link : Gennaro Varriale su Facebook: