본문으로 건너뛰기

확장(Extension) 유형별 PDF 표시 제어

여러 PDF가 같은 리소스(예: 상품)에 연결되어 있고, 템플릿에 Theme App Extension이 2개(임베디드 + 버튼) 모두 추가되어 있다면, 어떤 PDF가 어떤 확장(Extension)에 표시될지 선택할 수 있습니다.

여러 PDF를 사용할 때의 문제​

하나의 리소스(예: 상품)에 여러 PDF를 연결하고, 템플릿에 PDF Embedded Viewer와 PDF Button 확장을 모두 추가하면:

기본 동작: 연결된 모든 PDF가 두 확장(임베디드/버튼)에 모두 표시됩니다.

원하는 동작: 확장별로 서로 다른 PDF만 표시하고 싶을 수 있습니다.

Example scenario:

  • 상품 매뉴얼 → 상품 설명 아래에서 임베디드 뷰어에만 표시
  • 보증 안내 → 페이지 하단에서 버튼 확장에만 표시

이 옵션은 언제 보이나요?​

확장 표시를 제어하는 체크박스는 다음 조건을 모두 만족할 때만 나타납니다.

  1. 같은 리소스에 여러 PDF를 연결한 경우
  2. 템플릿에 Theme App Extension이 2개(임베디드 + 버튼) 모두 추가된 경우

이 체크박스는 PDF 상세 페이지의 Publish 섹션에서 확인할 수 있습니다.

확장 제어 체크박스 사용 방법​

Publish 섹션에서 다음처럼 표시됩니다.

Published extensions:
☑ pdf_embedded (enabled)
☑ pdf_button (enabled)

특정 확장에서 PDF를 숨기려면:

  • 해당 확장 유형의 체크를 해제합니다.
  • 그 확장의 템플릿 배열에서 해당 PDF가 제거됩니다.
  • 그 확장에서는 더 이상 PDF가 표시되지 않습니다.

Example:

Published extensions:
☑ pdf_embedded (enabled)  ← PDF shows in embedded viewer
☐ pdf_button (disabled)   ← PDF hidden from button extension

사용 사례​

Scenario 1: Primary vs. supplementary content​

시나리오 1: 핵심 콘텐츠 vs 보조 콘텐츠​

PDF 2개가 연결된 상품:

  • 사용 설명서(핵심) → 임베디드 뷰어에만 표시
  • 보증 안내(보조) → 버튼 확장에만 표시

Setup:

  1. 두 PDF를 모두 상품에 연결합니다.
  2. 상품 템플릿에 두 확장을 모두 추가합니다.
  3. 사용 설명서: ☑ embedded, ☐ button
  4. 보증 안내: ☐ embedded, ☑ button

Scenario 2: Quick reference vs. detailed docs​

시나리오 2: 빠른 참고 vs 상세 문서​

PDF 3개가 연결된 컬렉션:

  • 빠른 구매 가이드 → 임베디드 뷰어
  • 전체 카탈로그 → 버튼 확장
  • 사이즈표 → 버튼 확장

Setup:

  1. 모든 PDF를 컬렉션에 연결합니다.
  2. 컬렉션 템플릿에 두 확장을 모두 추가합니다.
  3. 빠른 가이드: ☑ embedded, ☐ button
  4. 전체 카탈로그: ☐ embedded, ☑ button
  5. 사이즈표: ☐ embedded, ☑ button

Scenario 3: Show all PDFs in both extensions​

시나리오 3: 두 확장에 모두 표시​

매뉴얼이 여러 개인 상품:

  • 모든 PDF를 임베디드/버튼 모두에서 제공

Setup:

  1. 모든 PDF를 연결합니다.
  2. 두 확장을 모두 추가합니다.
  3. 모든 체크박스를 체크된 상태(기본값)로 유지합니다.

템플릿 파일별 추적​

앱은 각 PDF에 대해 어떤 템플릿 파일에서 어떤 확장이 게시(Published)되어 있는지 추적합니다.

Article template example:

article.articleTemp2 - 1 extension
  Published extensions:
    pdf_button

blog.blogTemp2 - 2 extensions
  Published extensions:
    ☑ pdf_embedded (enabled)
    ☐ pdf_button (disabled)

의미:

  • article 템플릿에는 버튼 확장만 있습니다.
  • blog 템플릿에는 두 확장이 모두 있지만, 이 PDF는 임베디드 확장에서만 표시되도록 설정되어 있습니다.

여러 템플릿을 함께 관리하기​

같은 리소스 유형이 여러 템플릿 파일을 사용한다면, 템플릿마다 별도로 표시되며 각각 확장 설정을 따로 제어할 수 있습니다.

Article Pages - Published

  article.articleTemp1 - 1 extension
    ☑ pdf_button

  article.articleTemp2 - 1 extension  
    ☑ pdf_button

같은 PDF라도 템플릿마다 확장 구성(체크 상태)을 다르게 설정할 수 있습니다.

베스트 프랙티스​

Start simple​

템플릿당 Theme App Extension 1개로 먼저 시작하세요. 확장별로 다른 PDF를 구성해야 할 때만 두 번째 확장을 추가하는 것을 권장합니다.

Plan your PDF hierarchy​

두 확장을 모두 추가하기 전에, 어떤 PDF가 핵심(임베디드)인지 보조(버튼)인지 먼저 정리해 두세요.

Use consistent patterns​

여러 템플릿에서 두 확장을 함께 사용한다면, 확장별 PDF 배치를 비슷한 패턴으로 유지하면 관리가 쉬워집니다.

Test the customer experience​

고객 입장에서 페이지를 확인해, 올바른 PDF가 올바른 위치에 표시되는지 점검하세요.

트러블슈팅​

체크박스가 보이지 않음:

  • 템플릿에 확장 유형이 1개만 추가되어 있는 경우
  • 두 확장을 모두 추가해야 체크박스가 표시됩니다.

PDF가 잘못된 확장에 표시됨:

  • Publish 섹션의 체크박스 설정을 확인합니다.
  • 올바른 템플릿 파일을 보고 있는지 확인합니다.

어디에도 PDF가 표시되지 않음:

  • 최소한 하나의 체크박스는 선택되어 있어야 합니다.
  • PDF가 리소스에 연결되어 있는지 확인합니다.
  • PDF 상태가 Active인지 확인합니다.

스토어프론트에 변경이 반영되지 않음:

  • 페이지를 새로고침하세요(몇 초 걸릴 수 있음).
  • 브라우저 캐시를 지워보세요.
  • 앱에서 변경 사항을 저장했는지 확인하세요.

다음 단계​