#EZFB 0.0.6
Last modified : 2014-05-27
##Index of content
##Overview
EZFB는 JavaScript용 Facebook SDK 도우미입니다. JS를 이용해 페이스북 관련 앱이나 웹을 만들 때 도움이 됩니다.
##Usage
###시작하기
EZFB은 아주 쉽게 시작할 수 있습니다. 아래의 코드를 HTML 페이지 어디에든 삽입하면 됩니다. 태그에 넣어도 되고 태그에 넣어도 됩니다. 태그의 시작 부분에 넣어도 끝 부분에 넣어도 아무 상관 없습니다.
<script type="text/javascript" src="EZFB.min.js"></script>
<script type="text/javascript">
EZFB.appInit( 'YOUR_APP_ID' );
</script>
###초기화 이벤트
페이스북 서버에서 SDK 파일을 로드해오기 때문에 이벤트를 통해서 초기화 시점을 알 수 있습니다.
EZFB.appInit( 'YOUR_APP_ID' );
EZFB.init( initHandler );
EZFB.init( setCanvas ); // 여러개의 콜백을 등록할 수도 있습니다.
function initHandler() {
console.log( 'init!' );
}
function setCanvas() {
EZFB.canvasAutosize();
}
이미 초기화가 된 상태라면 등록되는 콜백 함수가 바로 실행됩니다.
###페이스북 로그인 하기
페이스북 로그인 팝업을 띄우거나, 로그인 화면으로 이동시킬 수 있습니다. 웹 페이지일 경우 팝업이 뜨게 되고, 앱 페이지일 경우 모달 팝업 형태로 로그인 창이 나타납니다. 모바일의 경우 팝업으로 뜬 창에서 로그인 완료에 대한 콜백을 받을 수 없으므로, 리디렉트 주소를 이용하는 편이 좋습니다.
퍼미션에 대한 요청이 필요할 수 있습니다. 퍼미션의 종류에 대해서는 페이스북 개발자 센터의 로그인 퍼미션 페이지를 참조하세요.
EZFB.appInit( 'YOUR_APP_ID' );
// 두번재 인자가 함수일 경우 팝업으로 로그인 창을 띄우고 로그인 시 콜백으로 실행됩니다.
EZFB.login( 'email,user_likes', function( $response ) {
console.log( $response );
} );
// 두번째 인자가 주소일 경우 리디렉트 처리가 됩니다.
EZFB.login( 'email,user_likes', 'http://grotesq.com/ezfb' );
###좋아요 버튼 이벤트 활용하기
현재 페이지 내의 좋아요 버튼을 누를 때와 취소할 때에 대한 이벤트를 사용할 수 있습니다.
// 이벤트를 추가합니다.
EZFB.like( likeHandler );
EZFB.unlike( unlikeHandler );
function likeHandler() {
alert( '이 페이지를 좋아해 주셔서 감사합니다!' );
// 이벤트를 제거합니다.
EZFB.removeLike( likeHandler );
}
function unlikeHandler() {
alert( '이 페이지를 안 좋아하시는군요..' );
}
###여러개의 이벤트 동시에 등록, 해제하기
on()을 이용해 여러개의 이벤트를 동시에 등록하고 해제할 수 있습니다. 여러개의 이벤트를 등록할 때에 이벤트 이름은 띄어쓰기로 구분합니다.
EZFB.on( 'like unlike', likeHandler );
function likeHandler() {
window.location.reload();
}
###메소드 체인
대부분의 메소드는 자기 자신을 반환하기 때문에, 메소드 체인 형태의 코드 작성을 하실 수 있습니다.
EZFB.init( function(){} ).appInit( 'YOUR_APP_ID' );
##API Reference
##Contact
- Email : unknown@grotesq.com
##Lisence
MIT 라이센스를 따릅니다. 자유롭게 이용하세요.