Asp.NET MVC 4.0 – Twitter Nesnesi

Her ne kadar şahsımız için geçerli olmasada sosyal ağlar insanların hayatlarında bir vazgeçilmez hal alıyor ve bu durum günlük hayatta kullandığımız materyallerde de kendini gösterir hale geliyor.Lakin takip ettiğimiz bir internet sitesinin ilgilileri hakkında ya FaceBook’tan bilgiler ediniyor ya da Twitter’dan duyurularını takip ediyoruz.Haliyle bu ihtiyaç bir yerden sonra biz yazılımcılar içinde bir araca dönüşmektedir.Oluşturduğumuz internet projelerinde FaceBook, Twitter vs gibi sosyal ağ destekleri vermemiz yaptığımız işin kalitesini ve bir o kadar da müşteri memnuniyeti elde etmemizi sağlamaktadır.Bu yazımda Asp.NET MVC mimarisinde Twitter nesnesinin nasıl projeye entegre edildiğini ve kullanımını irdeleyeceğiz.

Evet,
Şimdi Twitter hakkında uzun uzun nedir ne değildir gibisinden bir açıklama bekliyorsanız yanılıyorsunuz 🙂 Lakin bu meretin ne halt ettiğini benden daha iyi bildiğinize emin olabilirsiniz, sonuçta ben Twitter kullanıcısı değilim(hesabım var ama aktif bir kullanıcı değilim) amma velakin yazılımlarım da bu kuşu kullanmak mecburiyetinde olan bir sanatkarım 🙂

Asp.NET MVC 4.0 mimarisinde Twitter nesnesini kullanmak için Microsoft Web Helper kütüphanesini projemize entegre etmemiz gerekmektedir.Bu işlemin nasıl yapıldığını öğrenmek için MVC – Microsoft Web Helper Paketi Yüklenmesi başlıklık yazımı inceleyebilirsiniz.

Her neyse şimdi MVC projelerinde Twitter’ı kullanmamıza yarayan metodları sırasıyla incelemeye başlayalım.
Profile
Bu metoda verdiğimiz Twitter hesabındaki yazılan mesajları göstermemize yarar.
Prototipi aşağıdaki gibidir.

Profile(
string userName,
int width,
int height,
string backgroundShellColor,
string shellColor,
string tweetsBackgroundColor,
string tweetsColor,
string tweetsLinksColor,
int numberOfTweets,
bool scrollBar,
bool loop,
bool live,
bool hashTags,
bool timestamp,
bool avatars,
string behavior,
int interval);

Şimdi bazı parametrelerinin ne işe yaradığından bahsedelim.
backgroundShellColor : Twitter uygulamasının zemin rengini belirler.
shellColor : Twitter uygulamasındaki yazı rengini belirler.
tweetsBackgroundColor : Mesajların zemin rengini belirler.
tweetsLinksColor : Mesajlarında altında bulunan linklerin rengini belirler.
numberOfTweets : Kaçtane mesaj görüntüleneceğini belirler.
loop : ‘numberOfTweets‘ parametresine verilen değer kadar mesaj gözüktüğü zaman yeniden başa dönülmesini sağlar.
live : Twitter’a eklenen son mesajların anında güncellenip güncellenmeyeceğini belirler.
hashTags : Etiketlerin görüntülenip görüntülenmeyeceğini belirler.
timestamp : Zaman bilgisinin görüntülenip görüntülenmeyeceğini belirler.
avatars : Profil resminin görüntülenip görüntülenmemesini belirler.
behavior : ‘default‘ ve ‘all‘ değerlerini almaktadır.Eğer ‘default‘ değerini verilmişse ‘interval‘ parametresine verilen zaman değeri içinde mesajlar görüntülenecektir.Eğer ‘all‘ değerini aldıysa tüm mesajlar görüntülenecektir.
interval : ‘behavior‘ parametresi ‘default‘ değerinde ise mesajların görüntülenme zaman aralığını belirler.Bu parametreye girilen değer 1000 rakamı ile çarpılıp o şekilde değerlendirilmektedir.Örnek olarak 4 değeri verildiyse 1000 * 4 işlemi sonucu 4000 değerini ifade etmektedir.
Örnek olarak kendi Twitter hesabımdaki mesajları aşağıdaki şekilde getirtebilirim.

@using Microsoft.Web.Helpers;
@Twitter.Profile(userName: "GenayYldz", numberOfTweets: 5, avatars: true)

Görüntü aşağıdaki gibi olacaktır.

Tabi hangi Twitter hesabını kullanıyorsak Twitter ayarlarında “Tweetlerimi korumaya al” kutucuğunun işaretli olmaması gerekiyor.Aksi taktirde yazılmış mesajlar gözükmeyecektir.
Search
Şahsen Twitter metodları arasında en cazip gelen metodlardan biriside bu olsa gerek.Bütün Twitter kullanıcılarının mesaj içeriklerinde arama yapabilmemizi sağlamaktadır.
Prototipi aşağıdaki gibidir.

Search(string searchQuery,
int width,
int height,
string title,
string caption,
string backgroundShellColor,
string shellColor,
string tweetsBackgroundColor,
string tweetsColor,
string tweetsLinksColor,
bool scrollBar,
bool loop,
bool live,
bool hashTags,
bool timestamp,
bool avatars,
bool topTweets,
string behavior,
int interval)

Bazı parametrelerden bahsedelim.
title : Arama penceresinin başlığını belirlemektedir.
caption : Başlık altında görüntülenecek yazıyı belirlemektedir.
topTweets : Popüler mesajların görüntülenip görüntülenmeyeceğini ayarlar.

Örnek olarak “Fenerbahçe” kelimesini aratalım.

@using Microsoft.Web.Helpers
@Twitter.Search("Fenerbahçe")

Ekran görüntüsü aşağıdaki gibi olacaktır.

FollowButton
Verilen Twitter profiline, kullanıcıların abone olmalarını sağlar.
Prototipi aşağıdaki gibidir.

FollowButton(
string userName,
string followStyle,
string followColor
)

Parametrelerden söz edersek eğer,
followStyle : Abone resminin stilini belirler.”follow_me”,”follow_bird”,”twitter”,”t_logo”,”t_small” ve “t_mini” özelliklerini alabilir.
Sırasıyla bu özelliklerin hangi stillerde olduğunu aşağıdaki tablodan inceleyebilirsiniz.

follow_me
follow_bird
twitter
t_logo
t_small
t_mini

followColor : Stilin rengini belirleyebiliriz.”a : Mavi“, “b : Gümüş” ve “c : Siyah” değerleri alabilir.

TweetButton
Farklı sitelerdeki içerikleri Twitter’da paylaşmayı sağlamaktadır.
Prototipi aşağıdaki şekildedir.

TweetButton(
string dataCount,
string shareText,
string tweetText,
string url,
string language,
string userName,
string relatedUserName,
string relatedUserDescription)

Bazı parametrelerden bahsedelim.
dataCount : Verilen adresin kaç kere paylaşıldığını gösterir.”none”, “horizontal” ve “vertical” değerlerini alır.
tweetText : Paylaşılacak olan tweetin mesajını alır.
url : Materyal paylaşılırken URL adresini belirleyebiliriz.Aksi taktirde paylaşım yapılan sayfanın linkini alacaktır.
language : Dil ayarı yapılır.Türkçe için “tr”, İngilizce için “en” kullanılmaktadır.
username : Gönderilecek olan mesaj içerisinde bahsedilecek kullanıcı adını belirler.
relatedUsername : Takip etmek için önerilecek olan diğer kullanıcı adı.
relatedUserDescription : Takip etmek için önerilecek olan diğer kullanıcı ile ilgili açıklama.

Bu metod için örnek bir kullanıma lüzum görmüyor ve yazımıza devam ediyorum.
Faves
Twitter hesabımızda favori olarak işaretlenen tweetleri görüntülemek için bu metod kullanılır.
Prototipi aşağıdaki gibidir.

Faves(
string userName,
int width,
int height,
string title,
string caption,
string backgroundShellColor,
string shellColor,
string tweetsBackgroundColor,
string tweetsColor,
string tweetsLinksColor,
int numberOfTweets,
bool scrollBar,
bool loop,
bool live,
bool hashTags,
bool timestamp,
bool avatars,
string behavior,
int interval);

Bu parametrelere önceki metodlarımızda değindiğimizden dolayı açıklama yapmıyorum.
Bu metod içinde örnek uygulamayı siz değerli okuyucularımı bırakıyorum.

List
Twitter profilinde oluşturulan listeler içerisinde mevcut olan kişilere ait Tweet mesajlarını görüntülemek için kullanılır.
Prototipi yukarıdaki metodla aynıdır.

Evet arkadaşlar.Sanırım bu yazımda kıssadan hisse yaptığımı sanıyor ve bir o kadar da konuyu boş detaylandırdığımı düşünüyor olabilirsiniz.Lakin içeriğimiz genellikle aynı metod yapılarından ve aynı görüntüden ibaret olduğu için hem okuyucularımı yormamak, hemde diğer konulara daha hızlı bir biçimde giriş yapıp detaylandırmak için, uygun gördüğüm şekilde konuyu özetlendirmiş bulunmaktayım.

Bir sonraki yazımda görüşmek dileğiyle..
İyi çalışmalar..