==========
[facebook]
==========

FaceBook 제품에 대한 필수 API 를 정의

--------------
환경설정 
--------------

* Facebook API를 사용하기 위해서는 아래와 같은 순서로, 프로젝트 변환 및 환경 값 설정이 필요 하다.
 
	 .. code-block:: xml

	     가. Facebook 개발자 계정 생성 및 API 키 획득  
	     나. Facebook 앱 키 등록
	     다. 앱딜리게이트 연결

가. Facebook 개발자 계정 생성 및 API 키 획득 
-------------------------------

	- `Facebook 개발자 사이트 <https://developers.facebook.com/docs/facebook-login/ios>`_.
	- `Facebook 앱 아이디 확인  <https://developers.facebook.com/docs/facebook-login/ios/?locale=ko_KR>`_.
	   .. 새 앱을 만들어, 앱 ID를 획득 한다.


나. Facebook 앱 키 등록 
-------------------------------
	`Facebook 개발자 사이트 <https://developers.facebook.com/docs/facebook-login/ios>`_.의 4.info.plist 구성을 참고하여,
	facebook_app_id / fb_login_protocol_scheme 를 획득 한다. 


다. 앱딜리게이트 연결
-------------------------------
	- Appdelegate.m 파일에서 AppDelegate+MThirdPartyFacebook.h 파일을 import한다.
	- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 메서드 내에
    - [self application:application didFinishLaunchingWithOptionsForFacebook:launchOptions]; 을 추가한다.


---------
FaceBook API
---------

FaceBook 제품에 대한 3rd Party연동 기능을 제공한다.


.. _AuthType:
 
Auth Type
-----------------

 * Facebook 인증 기능에 대한 정의

=======================  =============
Type                     Description             
=======================  =============
login            		 	로그인
gettoken             		토큰,권한조회 
profile            		 	profile
graphrequest            	정보가져오기
monitor	            		변경모니터링
=======================  =============


Facebook 인증 API  
--------------

.. js:function:: M.plugin('3rd_iOS_facebook').auth( setting )

	.. versionchanged:: 2.0.0
	
	:param Object setting: 설정 정보
	:param String setting.command: 기능 ( :ref:`AuthType` )
	:param Object setting.param: 파라메터
	:param Object setting.param.permissions: "login" 권한(array)
	:param String setting.param.path: "graphrequest" path
	:param String setting.param.method: "graphrequest" method
	:param Object setting.param.parameters: "graphrequest" parameters(Dictionary)
	:param Function setting.callback: API 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API호출 결과값
		:param Object result: 3rd Party 모듈 결과 값   
		:param String result.result: Facebook command 결과값

Example:

    .. code-block:: javascript

    	var parameters={};
	    parameters.fields = "name,id,email";
    
   		var params = {};
    	params.path = "me";
    	params.method = "GET";
    	params.parameters = parameters;

        M.plugin('3rd_iOS_facebook').auth({
            'command': 'graphrequest',
            'param': params,
            callback:function(status, result){
                alert(JSON.stringify(result));
             }
        });


FaceBook 사용하기  
--------------

.. js:function:: M.plugin('3rd_iOS_facebook').facebook( setting )

	.. versionchanged:: 2.0.0
	
	:param Object setting: 설정 정보
	:param String setting.command: 기능
	:param Object setting.param: 파라메터
	:param String setting.param.contentUrl: 이동 URL
	:param String setting.param.title: 제목
	:param String setting.param.description: 부가설명
	:param String setting.param.imageUrl: 이미지URL
	:param Function setting.callback: API 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API호출 결과값
		:param Object result: 3rd Party 모듈 결과 값   
		:param String result.result: FaceBook command 결과값

Example:

    .. code-block:: javascript
        
        var params={};
        params.contentUrl="http://www.naver.com";
        params.title="제목입니다.";
        params.description="부가 설명입니다.";
        params.imageUrl="http://dev.uracle.co.kr/image.jpg";

        M.plugin('3rd_iOS_facebook').facebook({
            'command': 'link',
            'param': JSON.stringify(params),
            callback:function(status, result){
                alert(JSON.stringify(result));
             }
        });