Bu koşulu kontrol edip içeriği göstermek için yine kod yazmak gerekiyor (tamam, çok karmaşık değil bu defa).

Öncelikle bir uygulama tanımlıyoruz. Bu defa tüm alanları doldurmaya gerek yok. Authentication tab’ında uygulamayı kimlerin ekleyebileceği seçeneği olarak Fan Page’i işaretlemek gerekiyor.

Sonraki adımda Profiles tab’ındaki Tab İsmi ve Tab Url alanlarını doldurmak yeterli (canvas url’i zaten tanımladığınızı varsayıyorum).

Normalde uygulama canvas sayfası için Facebook’un gönderdiği değerler, Profile Canvas için çalışmıyor (aslında çalışıyor, ancak page owner olarak Fan page göründüğü için, gelen UserId Fan page’e ait, dolayısıyla kullanıcının bilgilerini almak profil tab’ı için pek kolay değil), bunun yine Facebook’un post ettiği form değerlerini kontrol ediyoruz.

// form degerlerini al
$country = $_POST["fb_sig_country"];
$locale = $_POST["fb_sig_locale"];

Facebook Platformu, ilk olarak Mayıs 2007′de f8 adlı bir etkinlikle duyurulmuş ve böylece Facebook üzerinde uygulama geliştirme imkanı sağlanmıştı. Bu sene 21 Nisan’da, f8 ile Facebook bir kez daha Platform’un henüz gün yüzü görmemiş özelliklerini duyuruyor olacak.

Haftalardır, hatta aylardır, f8‘de neler duyurulacağına dair tahminde bulunuldu, konuşuldu ve yazıldı. Genel kanı iki ana özellik üzerinde toplandı;

1. Facebook Credit; Facebook para biriminin tüm uygulama geliştiricilere açılması (şu anda beta ve bazı büyük geliştiricilere açık sadece, Zynga vs gibi)
2. Konum (lokasyon) bilgisinin de paylaşılabilir hale gelmesi ve bu fonksiyonun uygulama geliştiricilere açılması. (2010 konum paylaşım yılı, haliyle Facebook’un da bundan geri kalması düşünülemezdi).

En kaba haliyle; Facebook Credit, Facebook üyelerinin kredi kartları ile  satın alabilecekleri sanal kontör olarak adlandırılabilir.

Uygulama geliştiriciler tarafındaysa %70-%30 gibi bir gelişr paylaşım modeli var. Yani Credit sistemini kullanmak isteyen geliştiricilere Facebook, her satış için, satışın %70′ini veriyor. (Facebook’un payına düşen %30 miktarının çok fazla olduğu tartışmalarının da devam ettiğini hatırlatmakta fayda var.)

Sistem şu anda beta aşamasında ve sadece limitli sayıda uygulamada kullanımına izin verilmiş durumda. Örneğin; sanal eşya (virtual goods) satışlarının yoğun olduğu sosyal oyunlarda (FarmVille vb) alternatif ödeme kanalı olarak hali hazırda kullanılıyor.

Peki başka nerelerde kullanılabilir? Aşağıdaki gibi senaryoları da kapsayan modellerde kullanımı mümkün olabilir. (Liste tabii ki sadece bu maddelerle sınırlı değil, ilk etapta aklıma gelenler bunlar. Sizlerin de fikirlerinizi almak isterim.)

• Kampanyalara kullanıcıları çekmek artık eskisi kadar kolay değil. Bu noktada hem marka hem de son kullanıcı için kazan-kazan sistemi olabilecek yapılar kurulabilir (Orangeplus olarak bu konuyla ilgili aktif bir çalışma yürütüyoruz. Sürprizlerin yolda olduğunu da fısıldamış olayım ).
• Birinci/ikinci el ilan ve/veya takas sistemlerinde (uygulamalarında) satışlar Facebook Credit para birimiyle gerçekleştirilebilir (%30 gibi yüksek bir komisyon oranını da göz önüne almak gerek tabi).
• Melodi, duvar kağıdı, mobil servis vb gibi mobil içerik satışlarında kullanılabilir.
• P2P (peer-to-peer) (kişiden kişiye) sanal para (Credit) transferlerinde, transfer aracı olarak yer alabilir.

Konum paylaşım Facebook’a dahil edilmesiyle artık arkadaşlarımızın sadece ne zaman ve  ne yaptıklarını değil nerede, ne zaman ve ne yaptıklarını biliyor olacağız (sahte statü güncellemelerine son ).

(Facebook’un gizlilik yaklaşımından yola çıkılırsa) konum paylaşmak da isteğe bağlı olacaktır. Yani gizlilik ayarlarından konum bilginizi kapatmak mümkün olacaktır diye tahmin ediyorum. Her ne kadar opsiyonel de olsa bir çok kişinin bu özelliği kullanacağından eminim.

Öncelikle http://www.facebook.com/developers adresinden yeni bir uygulama ekleyelim (Set Up New Application).

Set Up New Application

Uygulamanıza bir isim verip, kullanım koşullarını da onaylayınca Facebook uygulamanızın taslak halini hazırlar.

Uygulama adı ve kullanım koşulları

Sonraki ekranda karşımıza Application ID, API Key ve Secret gibi değerleri, uygulamanın tanıtıcı metnini ve uygulamaya ait logoların yükleneceği bölümler ve de Developer Modunda (uygulamanızın sadece developer olarak atanan kişiler tarafından çalıştırılabildiği, stream, wall post vb gibi aksiyonları da yine sadece developer olanların görebildiği mod) test etmesini istediğiniz arkadaşlarınızı seçebileceğiniz alanlar yer alır.

Facebook Application ID, API Key, Secret

Application ID, API Key ve Secret değerlerini kaydedip Authentication sekmesine tıklayalım. Bu sekmede uygulamamızın Facebook kullanıcıları tarafından mı yoksa Facebook Pages tarafından mı kurulabileceğini belirtiyoruz. Hemen alttaki iki alan dikkatimizi çekmiş olmalı:

• Post-Authorize Callback URL: Bir kullanıcı (ya da Facebook Page) uygulamanızla etkileşime girdiği an, Facebook bu adrese ping atar ve size bildirimde bulunur. Böylece veritabanınızda yeni kullanıcıyla ilgili işlemleri yapmak için size olanak sağlar (eğer ki böyle bir mekanizmanız varsa). Bu sayfa FBML sayfası değil, kendi sunucunuzda yer alan ve uygulama içerisinde yer alan bir sayfa olmalı.
• Post-Remove Callback URL: Uygulamanızı kurmuş olan bir kullanıcı (ya da Facebook Page) uygulamanızı kaldırdığı an Facebook bu sayfaya ping atar. Böylece siz de hangi kullanıcının uygulamanızı kaldırdığını bilir ve uygulamanızda ona göre aksiyon alabilirsiniz. Yine bu sayfa da FBML değil kendi sunucunuzda yer alan ve uygulama içerisinde yer alan bir sayfa olmalı.

Authentication

Canvas sekmesine geldiğimizde, Facebook’un uygulamamızı hangi adresten çağıracağı, uygulama görüntüleme türünü (FBML  -Facebook Developer Markup Language- veya iFrame), çerçeve genişliğini, uygulamanın tekil adını girebileğiniz bölümler yer alır.

• Canvas Page URL: Uygulamanın tekil adı (Benim test uygulamam için orangeplusblog)
• Canvas Callback URL: Uygulamanın sunucudan çağırılacak olan adresi (web uygulamasının adresi) (Benim test uygulamam için http://facebook.orangeplus.net/orangeplus/). (En sondaki “/” slash işaretini koymayı unutmayın sakın!)

Canvas, FBML, 760px

Advanced sekmesinde Sandbox Mode‘u (developer mod) Enabled olarak işaretlemeyi da unutmamak gerek, uygulama test süreci boyunca bu modda kalmalı ve testleriniz bitince tekrar bu sayfaya gelerek Sandbox Mode’u kapatabilirsiniz.

Advanced Sekmesi, Sandbox Mode

Pekala, Facebook üzerinde yapacaklarımız bu kadar. Şimdi Visual Studio’yu açıp biraz kod yazalım.

Ekteki dosyada Visual Studio için örnek Facebook uygulama projesi yer alıyor (yazının devamı örnek şablon proje üzerinden devam edeceği için dosyayı indirmekte fayda var).

Web.config‘te APIKey, Secret, AppUniqueName (Canvas Page URL alanında yazdığımız değer), AppName (Application Name), CallbackUrl (Canvas Callback URL) değerlerini dolduruyoruz.

<?xml version="1.0"?>
<configuration>
	<appSettings>
		<add key="APIKey" value="XXXXXXX"/>
		<add key="Secret" value="YYYYYYY"/>
		<add key="AppUniqueName" value="orangeplusblog"/>
		<add key="AppName" value="Orangeplus.Blog"/>
		<add key="CallbackUrl" value="http://facebook.orangeplus.net/orangeplus/"/>
		<add key="InviteActionText" value="Haydi arkadaşını davet et!"/>
	</appSettings>

	<system.web>
		<customErrors mode="Off"/>
		<compilation debug="true"/>
		<authentication mode="Windows"/>
	</system.web>
</configuration>

Uygulamanın ana sayfasına (Default.aspx) bakalım;

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="Default" %>
<%@ Register Src="Controls/Style.ascx" TagPrefix="uc" TagName="style" %>
<%@ Register Src="Controls/Tabs.ascx" TagPrefix="uc" TagName="tab" %>
<%@ Register Src="Controls/GoogleAnalytics.ascx" TagPrefix="uc" TagName="ga" %>

<uc:style id="Style" runat="server" />
<uc:tab id="Tabs" runat="server" SelectedTabIndex="0" />

<div id="container">

	<p>
		<fb:profile-pic uid="<%= UserFbId %>" linked="true" size="small" />
		Merhaba <fb:name uid="<%= UserFbId %>" useyou="false" />,<br />
		Orangeplus.Blog; ASP.NET ile Facebook uygulaması nasıl yapılırla ilgili örnek bir uygulama aslında.
	</p>
	<p><a href="http://orangeplus.net" target="_blank">Orangeplus</a></p>

</div>

<uc:ga id="googleAnalytics" runat="server" />

Kodun içerisindeki  <fb> tag’ına dikkat etmişsinizdir. FBML (Facebook Markup Language) sayesinde, Facebook’un sağlamış olduğu hazır objeleri kullanma imkanı bulabiliyoruz böylece.

Default.aspx.cs

#region Usings
using System;
using System.Collections.Generic;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Configuration;

using Facebook;
using Facebook.Web;
using Facebook.Schema;
using Facebook.Session;
using Facebook.Rest;
#endregion

public partial class _Default : CanvasFBMLBasePage
{
	public string UserFbId;

	#region Page_PreInit
	protected void Page_PreInit(object sender, EventArgs e)
	{
		base.ApiKey = ConfigurationSettings.AppSettings["APIKey"].ToString();
		base.Secret = ConfigurationSettings.AppSettings["Secret"].ToString();
		base.RequireLogin = true;
	}
	#endregion

	#region Page_Load
	new protected void Page_Load(object sender, EventArgs e)
	{
		CanvasSession fs = new Facebook.Session.FBMLCanvasSession(
			ConfigurationSettings.AppSettings["APIKey"].ToString(),
			ConfigurationSettings.AppSettings["Secret"].ToString()
		);
		Api api = new Facebook.Rest.Api(fs);
		user fbUser = api.Users.GetInfo();	// Uygulamayi kullanan kullanicinin bilgileri

		UserFbId = fbUser.uid.ToString();
	}
	#endregion
}

Page_PreInit

metodunda uygulama Facebook’a tanıtılıyor (onay alınıyor).

Page_Load

‘ta ise yeni bir session oluşturup, uygulamayı o an kullanan kullanıcı hakkında Facebook’tan bilgi istiyoruz. Aldığımız uid değerini de FBML içerisinde kullanıp, kullanıcının adıyla ve profil fotosuyla onu karşılıyoruz.

Uygulamanın bitmiş hali

Orangeplus.Blog Facebook Application

Neler yapabileğinize dair (API, FBML) detaylı bilgiyi Facebook Developer Wiki sayfalarından edinebilirsiniz.

Daha sonraki yazılarımda Nasıl Wall Post Yapılır?, Stream’e Nasıl Basılır? gibi konulara da değineceğim Başlangıç için bu kadarı yeterli sanırım.

Öncelikle Facebook’ta Developers adlı uygulamayı kurmak gerekiyor ki kendi uygulamanızı ekleyebilesiniz. Daha sonra (ve her daim) yardımcınız olacak olan Developers Wiki sayfalarına göz atmakta fayda var. Wiki sayfalarındaki Getting Started bölümünde yer alan başlıkları incelemek de platforma aşinalık kazanmak açısından çok önemli.

Son olarak da yine Wiki’de yer alan Facebook Platform Client Libraries kısmında, hangi dilde kod yazıyorsanız, o dile ait kütüphaneyi bulup, makinanızı ve geliştirme ortamınızı ayarladıktan sonra uygulamanızı hazırlamaya başlayabilirsiniz.