포함(embed)된 게시물

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

코드 생성기

게시물 URL

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

전체 게시물 포함

코드 받기

설정

설정	설명	기본값
`data-href`	게시물의 절대 URL입니다.	`n/a`
`data-lazy`	`true`로 설정하면 `loading="lazy"` iframe 속성을 설정하여 브라우저의 지연 로딩 메커니즘을 사용합니다. 플러그인이 뷰포트와 가깝지 않아서 전혀 보이지 않을 수 있는 경우 브라우저가 플러그인을 렌더링하지 않는 효과가 있습니다. `true` 또는 `false`(기본값)일 수 있습니다.	`false`
`data-width`	게시물의 너비입니다. 최소 `350`픽셀. 최대 `750`픽셀. 유동 너비를 사용하려면 비워두세요.	유동 너비
`data-show-text`	사진 게시물에 적용됩니다. Facebook 게시물(있는 경우)의 텍스트를 포함하려면 `true`로 설정하세요.	`false`

게시물에서 코드 가져오기

1. 게시물로 이동

게시물에서 퍼가기 코드를 직접 가져올 수 있습니다. 전체 공개 게시물인 경우 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 async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v3.2"></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 async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v3.2"></script>  
  <div class="fb-post" 
      data-href="https://www.facebook.com/20531316728/posts/10154009990506729/"
      data-width="500"></div>
</body>
</html>

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

5. 맞춤 설정

이 페이지 아래의 지침에 따라 크기, 언어 및 기타 설정을 조정합니다.

게시물의 URL 가져오기

CMS에서 퍼가기 코드를 만들고 원본 게시물 URL만 필요한 경우가 있습니다. 게시물의 URL을 가져오는 두 가지 방법은 다음과 같습니다.

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

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

그래프 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)된 게시물의 너비를 조정할 수 있습니다. 350과 750픽셀 사이의 값을 선택합니다.

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 게시물에서 얻을 수 있는 복사하여 붙여넣기 픽셀 코드를 통해 게시물을 포함(embed)하는 경우, WordPress에서 모든 & 문자를 #038;로 변환하여 플러그인이 중단되므로 포함(embed)된 게시물 플러그인이 렌더링되지 않을 가능성이 큽니다.

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

<script>
  window.fbAsyncInit = function() {
    FB.init({
      xfbml      : true,
      version    : 'v21.0'
    });
  }; 
</script>
<script async defer src="https://connect.facebook.net/en_US/sdk.js"></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)된 게시물에서 사용자에게 표시되는 내용은 무엇인가요?

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

고유 링크

게시물을 삭제하거나 게시물의 공개 대상 선택 도구를 변경하면 어떻게 되나요?

포함(embed)된 게시물 대신 다음 메시지가 표시됩니다.

고유 링크