포함(embed)된 게시물

포함(embed)된 게시물은 Facebook 사용자 또는 페이지를 통해 웹사이트나 웹 페이지의 콘텐츠에 전체 공개 게시물을 손쉽게 포함하는 방법입니다. Facebook 페이지와 프로필의 전체 공개 게시물만 포함(embed)할 수 있습니다.

코드 생성 도구

게시물 URL
게시물의 픽셀 너비(350~750)

설정

설정 설명 기본값

data-href

게시물의 절대 URL입니다.

n/a

data-width

게시물의 너비입니다. 최소 350픽셀. 최대 750픽셀. 유동 너비를 사용하려면 비워두세요.

유동 너비

data-show-text

사진 게시물에 적용됩니다. Facebook 게시물(있는 경우)의 텍스트를 포함하려면 true로 설정하세요.

false

게시물에서 코드 가져오기

1. 게시물로 이동

게시물에서 포함(embed)된 코드를 바로 가져올 수 있습니다. 전체 공개 게시물이면 Facebook에서 게시물의 오른쪽 상단에 표시되는 아이콘을 클릭합니다.

드롭다운 메뉴에서 Embed Post를 선택합니다.

사진 게시물의 경우 오른쪽 하단에서 Embed Post 버튼을 선택합니다.

2. 코드를 복사하여 붙여넣기

게시물을 포함(embed)하는 데 필요한 코드가 있는 대화 상자가 표시됩니다. 표시할 웹 페이지로 이 코드를 복사하여 붙여넣습니다.

기술적인 상세 정보는 수동으로 코드 추가하기 섹션을 참조하세요.

수동으로 코드 추가하기

코드 생성 도구 외에도 수동으로 코드를 포함(embed)할 수 있습니다.

1. 게시물의 URL 가져오기

먼저 공유할 게시물의 URL을 가져와야 합니다. 게시물은 반드시 전체 공개(게시 시간 옆 회색 지구본 아이콘이 표시됨) 상태여야 합니다.

테스트를 위해 다음 예제 URL을 사용할 수 있습니다.

"https://www.facebook.com/20531316728/posts/10154009990506729/"

2. JavaScript SDK 읽어들이기

포함(embed)된 게시물 플러그인 또는 다른 모든 소셜 플러그인을 사용하려면 웹사이트에 Facebook JavaScript SDK를 추가해야 합니다. 페이지에서 단 한 번만 SDK를 읽어들여야 합니다. <body> 태그 바로 다음에 삽입하는 것이 가장 좋습니다.

<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = "https://connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.5";
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>

JavaScript SDK - 빠른 시작에는 JavaScript SDK를 구현하는 방법에 대한 추가 도움말이 있습니다.

3. 포함(embed)된 게시물 태그 배치

다음으로 포함(embed)된 게시물 태그를 웹사이트의 원하는 위치에 삽입합니다. {your-post-url}을 게시물의 URL로 바꿉니다.

<div class="fb-post" data-href="{your-post-url}"></div>

4. 테스트

이러한 단계를 완료하고 나면 포함(embed)된 게시물을 테스트할 수 있습니다. 통합하고 나면 다음과 같이 표시됩니다.

<html>
  <title>My Website</title>
<body>
  <script src="//connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.5" 
      async></script>  
  <div class="fb-post" 
      data-href="https://www.facebook.com/20531316728/posts/10154009990506729/"
      data-width="500"></div>
</body>
</html>

테스트 예제의 결과가 아래 스크린샷에 표시됩니다.

5. 맞춤 설정

이 페이지 아래에 있는 안내에 따라 크기, 언어 및 기타 설정을 조정합니다.

게시물의 URL 가져오기

CMS에서 포함(embed)된 코드를 만드는 시나리오에서는 원본 게시물 URL만 있으면 됩니다. 게시물의 URL을 가져오는 방법은 다음 2가지입니다.

  1. 브라우저 주소 표시줄에서 고유 링크의 URL을 복사합니다.
  2. 게시물의 게시 시간을 마우스 오른쪽 버튼으로 클릭하고 링크 주소를 복사합니다.

아래 스크린샷에서 두 방법 모두 빨간색으로 강조 표시됩니다.

그래프 API 사용

포함(embed)된 게시물을 자동으로 웹사이트에 통합하려면 그래프 API를 사용해야 합니다. 예를 들어, 페이지 피드 API 엔드포인트fields 매개변수 permalink_url을 사용할 수 있습니다.

/{page-id}/feed?fields=permalink_url 요청에 대한 응답은 다음과 같은 응답을 보냅니다.

{
  "data": [
    {
      "id": "1234567890_3456789012", 
      "permalink_url": "https://www.facebook.com/1234567890/posts/3456789012"
    }
  ]
}

데스크톱의 레이아웃

아래 예제에서처럼 포함(embed)된 게시물 태그의 data-width 속성을 통해 데스크톱에 표시될 포함(embed)된 게시물의 너비를 조정할 수 있습니다. 350750픽셀 사이의 값을 선택합니다.

플러그인의 크기를 조정하는 데 CSS 스타일 태그를 사용하지 마세요. 디스플레이 오류가 발생할 수 있습니다.

<!-- WRONG! -->
<style type="text/css">
.fb-post {
  width: 500px;
}
</style>
<div 
  class="fb-post"
  data-href="{your-post-url}">
</div>

<!-- CORRECT -->
<div 
  class="fb-post" 
  data-width="500"
  data-href="{your-post-url}">
</div>

모바일 웹의 레이아웃

모바일 웹에서는 포함(embed)된 게시물이 컨테이너의 너비로 자동 확대됩니다.

Wordpress

Wordpress 사이트에서 이미 JavaScript용 Facebook SDK를 사용 중인 경우 fb-post 태그를 Wordpress 게시물에 추가하기만 하면 포함(embed)된 게시물 플러그인을 사용할 수 있습니다.

<div class="fb-post" data-href="https://www.facebook.com/20531316728/posts/10154009990506729/" data-width="500"></div>

JavaScript용 Facebook SDK를 사용하지 않고 각 Facebook 게시물에서 얻을 수 있는 복사하여 붙여넣기 픽셀 코드를 통해 게시물을 포함하는 경우, Wordpress에서 모든 & 문자를 #038;으로 변환하여 플러그인이 중단되므로 포함(embed)된 게시물 플러그인이 렌더링되지 않을 가능성이 큽니다.

대신 다음 코드를 사용하여 플러그인을 추가합니다.

<script>
  window.fbAsyncInit = function() {
    FB.init({
      xfbml      : true,
      version    : 'v2.11'
    });
  }; 
  (function(d, s, id){
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) {return;}
    js = d.createElement(s); js.id = id;
    js.src = "https://connect.facebook.net/en_US/sdk.js";
    fjs.parentNode.insertBefore(js, fjs);
  }(document, 'script', 'facebook-jssdk'));
</script>
  
<div 
  class="fb-post" 
  data-href="https://www.facebook.com/20531316728/posts/10154009990506729/" 
  data-width="500"></div>

사용하기 쉬운 새 Wordpress 통합이 곧 출시될 예정입니다.

FAQ

HTML5 또는 XFBML 버전을 사용하는 경우 라이브러리를 인스턴스화할 때 언어 코드를 포함해야 합니다.

SDK를 읽어들일 때 개발자의 언어를 사용하도록 js.src 값을 변경합니다. en_US는 개발자의 언어로 대체합니다. 예를 들면 프랑스 개발자는 fr_FR(프랑스어)로 변경합니다.

// Example 1:
'https://connect.facebook.net/fr_FR/sdk.js';

// Example 2:
js.src = "https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.6"; 

지원 언어는 Facebook 언어 XML 파일에서 참조하세요.

다른 언어에서도 사용할 수 있도록 소셜 플러그인의 너비를 조정해야 할 수도 있습니다. 자세한 정보는 현지화 및 번역 페이지에서 확인하세요.

포함(embed)된 게시물에는 연결된 모든 미디어와 게시물에 있는 댓글, 공유 및 좋아요 수가 표시됩니다. 게시물을 포함하면 개발자의 웹사이트를 사용하는 사용자가 Facebook.com에 표시되는 것과 동일하게 풍부한 정보를 볼 수 있으며, 포함(embed)된 게시물에서 직접 콘텐츠 작성자나 페이지를 팔로우하거나 좋아요를 클릭할 수 있습니다.