Come impostare un'applicazione lettore RSS di Facebook per il tuo blog

Come impostare un’applicazione lettore RSS di Facebook per il tuo blog

Versione 1.0
Autore: Falko Timme

Questa guida mostra come puoi costruire un’applicazione lettore RSS per il social network Facebook che visualizzerà il feed RSS del tuo blog/sito web sulle pagine del profilo degli utenti di Facebook (che hanno installato l’applicazione lettore RSS). Ogni elemento del feed RSS avrà un pulsante Condividi in modo che le persone possano condividere la storia con i loro amici, e l’applicazione avrà un link Invita in modo che le persone possano invitare fino a dieci amici alla volta a installare anche questa applicazione lettore di feed. Userò PHP5 per costruire l’applicazione lettore RSS. Per analizzare il feed RSS e generare HTML da esso, utilizzerò Magpie RSS.

Puoi vedere questa applicazione in azione installando il lettore RSS di HowtoForge per Facebook.

Questo documento viene fornito senza alcuna garanzia di alcun tipo! Non rilascio alcuna garanzia che questo funzionerà per te!

1 Nota preliminare

Questa guida si basa su un esempio reale, il lettore RSS di HowtoForge per Facebook, e utilizzerò gli URL e gli script reali in questo esempio (sostituendo solo i dati segreti come la chiave API e il Segreto).

Come ho già accennato, sto usando PHP5 per costruire questa applicazione, utilizzando la Facebook PHP Client Library. Teoricamente puoi usare anche PHP4, ma la piattaforma client è ottimizzata per PHP5, quindi dovresti usare quello se possibile.

Sto usando l’host fb.howtoforge.com in questo esempio per ospitare l’applicazione; è un sito web compatibile con PHP5.

Prima di poter iniziare a scrivere la tua applicazione Facebook, devi registrarti su Facebook (se non hai ancora un account) e aggiungere l’applicazione Facebook Developer al tuo account, come descritto su http://developers.facebook.com/get_started.php:

Dopo, dovresti iniziare con questi esempi per abituarti a creare app Facebook. Tuttavia, userò questi esempi in questo tutorial di nuovo (all’inizio) per assicurarmi che tutto funzioni come previsto prima di provare a scrivere le mie cose.

2 Imposta una nuova applicazione

Prima di iniziare a programmare la nostra applicazione, dobbiamo informare Facebook al riguardo, e Facebook ci darà quindi una chiave API e un Segreto di cui abbiamo bisogno per costruire l’applicazione.

Ora che hai aggiunto l’applicazione Facebook Developer al tuo account, vai alla tua pagina Facebook - dovresti ora vedere l’app Developer nella navigazione a sinistra. Clicca su di essa. Si apre la pagina Developer, dove clicchi sul pulsante + Imposta nuova applicazione (vicino all’angolo in alto a destra):

Ora siamo sulla pagina Nuova applicazione. Voglio chiamare la mia app HowtoForge RSS Feed Reader, quindi compilo questo come Nome dell’applicazione. Spunto la casella sotto questo campo per mostrare che accetto i termini della piattaforma Facebook. Poi compilo un indirizzo email di supporto (dovrebbe essere un indirizzo dove tu o i tuoi colleghi sviluppatori possono essere contattati). L’URL di Callback è il luogo dove l’app sarà ospitata. La mia sarà ospitata sotto http://fb.howtoforge.com/fb/htf_feed_reader/, quindi lo compilo. L’URL della pagina Canvas è l’indirizzo Facebook che desideri che la tua app abbia. Compila il tuo indirizzo desiderato (ad es. http://apps.facebook.com/htf_feed_reader), e il modulo ti dirà se l’indirizzo è ancora disponibile o meno. Poi seleziona Usa FBML e Sito web (entrambi dovrebbero già essere la selezione predefinita):

Una nota importante riguardo all’URL di Callback: È assolutamente importante che l’URL termini con una barra ( /); se non lo fa, le persone riceveranno in seguito il famoso errore The URL … did not respond. ogni volta che visitano la tua app nei loro account, come questo:

Successivamente, sempre sulla pagina Nuova applicazione, compila le altre opzioni. Rispondi alla domanda Può la tua applicazione essere aggiunta su Facebook? con Sì. Puoi lasciare vuoto il campo URL TOS se non hai termini di servizio. Aggiungi sviluppatori aggiuntivi se ce ne sono. Come URL Post-Add, utilizzi l’URL della pagina Canvas ( http://apps.facebook.com/htf_feed_reader nel mio caso). Compila una descrizione per la tua applicazione. L’URL Post-Remove può essere lasciato vuoto. Nel campo FBML predefinito, puoi inserire del testo che desideri appaia sui profili utente se la tua app non fornisce contenuti per la pagina del profilo. Poi seleziona in quale colonna del profilo desideri che i tuoi contenuti appaiano. Poiché ci sono molti testi nei feed RSS, la colonna larga è una buona scelta nel nostro caso:

Più in basso sulla pagina Nuova applicazione, c’è solo un altro campo che dobbiamo compilare, l’URL della navigazione laterale. Anche questo è lo stesso dell’URL della pagina Canvas ( http://apps.facebook.com/htf_feed_reader nel mio caso). Tutti gli altri campi possono essere lasciati vuoti. Clicca su Invia dopo:

Ora dovresti essere sulla pagina Le mie applicazioni dove puoi trovare la chiave API e il Segreto per la tua app. Copiali, ne avremo bisogno per la nostra app più tardi.

Più in basso sulla pagina Le mie applicazioni, vedrai un link alla PHP (4 e 5) Client Library: