Tietotekniikka 3/loppuraportti 5

Loppuraportti: Kuinka teet facebook-ohjelman

Taustaa

Tämän ohjeistuksen tarkoitus on antaa perusvalmiudet oman Facebook – applikaation luomiseen. Käytämme esimerkkiä ”Hei maailma!”- ohjelmistoa jota voit käyttää pohjna omalle ohjelmallesi.

Kehittääksesi Facebook applikaatioita, sinun tarvitsee a) olla Facebookin käyttäjä, b) asentaa Developer – applikaatio, jonka avulla voit hallinnoida, muunnella ja seurata sen käyttöä sekä asetuksia. Huom! Applikaatiot luodaan omalle palvelimelle jolloin voit käyttää haluamaasi ohjelmointikieltä. Facebookilla on myös omia ohjelmointikieliä: FBML (samanlainen kuin HTML) ja FQL (SQL).

Aloitus:

1. Luo tili facebookiin.
2. Lataa Developer – ohjelmisto (löytyy päänavin alapalkista tai etsimällä.)
3. Etsi sopiva Facebook – tiedosto koodaamista varten, esim. PHP tai Java hakemisto -olettaen että käytät sitä ensisijaisena ohjelmointikielenä. Nämä löytyvät esimerkiksi Developer-sivustolta. Lisäksi pystyt hyödyntämään Facebook API- käyttöliittymää. (Tämä säästää aikaa, sillä tiedosto sisältävät php-scriptejä joiden kanssa pääset alkuun.)

Kun hakemisto on asennettu palvelimelle, mene asentamaasi Developer-sivustolle (Facebookissa) ja klikkaa ”Setup New Application” jonka jälkeen sinun pitää nimetä se, sekä täyttää tietoja seuraavaan kaavakkeeseen Options-kohtaan:

Uusi Facebook - applikaation kaavake (täytä vähintään seuraavat kohdat)

1. Tässä ohjeita kaavakkeen käyttöön.

• Applikaation nimi: “Hei maailma!”
• Muista rastittaa käyttösopimukset-boksi!
• Valitse Optional Fields – josta pääset asetuksiin
• Support E-mail: your Ole tarkkana minkä s-postiosoitteen laitat tähän (voit esim. luoda uuden tilin applikaatiotasi varten esim. olenkohotvainot@gmail.com)
• Callback Url: esim. http://omaserveri.com/heimaailma/
• Canvas Page URL: http://apps.facebook.com/heimaailma/
• FBML: pidä tama asetus.
• Applikaation tyyppi: 'Website'.
• Can your application be added to Facebook: 'yes'
• Post-Add Url: http://apps.facebook.com/heimaailma/
• Default FBML: 'haluamaasi tekstiä'.
• Side Nav Url: http://apps.facebook.com/heimaailma/

1. Paina 'Submit'
2. Siirry 'My Applications' sivustolle ja tarkista, että ohjelmistosi on luotu.
3. Kopioi viimeisin versio PHP5 client library applikaatiosi luetteloon palvelimellesi.
4. downloads section –linkistä löydät lähdetiedostot.
5. Luo 'appinclude.php' tiedosto jonka sisällytät ensimmäiseksi kaikista php-koodista applikaatioosi. Kokeile seuraavaa koodipätkää tiedostoosi:

<?php

require_once 'facebook.php';

$appapikey = '[your api_key]';

$appsecret = '[your secret]';

$facebook = new Facebook($appapikey, $appsecret);

$user = $facebook->require_login();

$appcallbackurl = http://omaserveri.com/heimaailma/';

try {

if (!$facebook->api_client->users_isAppAdded()) {

$facebook->redirect($facebook->get_add_url());

}

} catch (Exception $ex) {

$facebook->set_user(null, null);

$facebook->redirect($appcallbackurl);

}

6. Korvaa [your app_key] ja [your secret] omaan applikaatiosi, joka näkyy application My Applications sivulla. Luo 'index.php' –niminen tiedosto, joka tulee olemaan applikaatiosi pääsivu. Kopioi seuraava koodi tiedostoon:

<?php

require_once 'appinclude.php';

echo "

Hei maailma!

";

7. Nyt kokeile YOUR APP's callback url:ia selaimessasi (eli http://apps.facebook.com/heimaailma)

8. Hyväksy käyttöehdot applikaatiollesi ja paina 'Add [Hei maailma!]' lisätäksesi sen

9. Tämän jälkeen ohjaudut etusivulle (canvas page url) joka sisältää index.php tiedoston sisällön

10. Mene profiiliisi ja katso, mikäli näet applikaatiossasi Hei maailma, niin olet onnistunut!!!