테마에 PDF 게시(Publish)하기
PDF를 리소스(상품/페이지/컬렉션 등)에 연결한 다음에는, 고객이 볼 수 있도록 해당 리소스에 대응하는 테마 템플릿에 Theme App Extension을 추가해야 합니다. 이 작업은 템플릿당 1번만 하면 됩니다(예: product, product.local, pages, page.contact, 컬렉션 템플릿 등).
상품을 하나씩 연결하지 않고 템플릿 단위로 공통 PDF를 보여주고 싶다면 매뉴얼 URL 블록(Manual URL blocks)을 사용하세요.
게시하는 방법 2가지
1) PDF 상세 페이지에서 바로 게시(권장)
Theme App Extension을 가장 빠르게 추가 하는 방법입니다.
- PDF 상세 페이지에서 Publish 섹션을 엽니다.
- 아직 해당 템플릿에 Theme App Extension이 추가되지 않았다면 Publish 안내가 표시됩니다.
- Publish를 클릭하고 표시 스타일(Embedded Viewer 또는 Button)을 선택합니다.
- 확장이 추가된 상태로 테마 편집기가 새 탭/창에서 열립니다.
- 필요하면 설정을 조정한 뒤, 테마 편집기에서 Save를 클릭합니다.
2) 테마 편집기에서 수동으로 추가
확장(Extension) 배치 위치를 더 세밀하게 제어하고 싶을 때 사용합니다.
- Shopify 관리자에서 Online Store > Themes로 이동합니다.
- 사용 중인 테마에서 Edit Theme를 클릭합니다.
- PDF를 연결한 페이지에 해당하는 템플릿으로 이동합니다(예: 상품 템플릿).
- Add section 또는 Add block을 클릭합니다(테마에 따라 다름).
- Apps 섹션에서 PDF Connect 확장 2종을 찾습니다.
- PDF Embedded Viewer 또는 PDF Button을 추가합니다.
- Save를 클릭합니다.
또는 테마 편집기에서 표시 옵션 커스터마이징 →도 참고하세요.
대안: 매뉴얼 URL 블록(연결 없이 사용)
특정 상품 템플릿을 사용하는 “모든 상품”에 하나 이상의 PDF를 공통으로 표시하고 싶을 때 사용합니다.
- 앱에서 PDF를 열고 Link/Add 드롭다운을 엽니다.
- **Add PDF block to product template (manual URLs)**를 선택합니다.
- 상품 템플릿과 매뉴얼 블록 유형을 선택합니다.
- 테마 편집기를 열고 블록 설정에 URL을 직접 붙여넣습니다.
- 테마를 저장합니다.
매뉴얼 블록은 다음 두 가지입니다.
- PDF Embedded Manual
- PDF Button Manual
자세히 보기: 매뉴얼 URL 블록 가이드 →
표시 스타일 선택하기
Embedded Viewer - 페이지 안에 PDF를 바로 표시하며 전체 내비게이션 컨트롤을 제공합니다.
PDF Button - 버튼을 클릭하면 팝업 오버레이로 PDF가 열립니다.
Embedded Manual / Button Manual - 표시 방식은 동일하지만, 연결된 리소스 대신 테마 블록 설정의 URL을 사용합니다.
콘텐츠와 레이아웃에 가장 잘 맞는 방식을 찾기 위해 두 가지를 모두 테스트해 보세요.
PDF 표시 확인하기
Theme App Extension을 추가한 뒤:
- 테마 변경 사항을 저장합니다.
- PDF를 연결한 페이지로 이동합니다.
- 이제 고객에게 PDF가 표시되어야 합니다.
트러블슈팅
PDF가 표시되지 않는다면:
- 라이브러리에서 PDF 상태가 Active인지 확인합니다.
- 올바른 템플릿에 Theme App Extension을 추가했는지 확인합니다.
- 실제로 PDF가 연결된 페이지를 보고 있는지 확인합니다.
- 몇 초 기다린 뒤 페이지를 새로고침합니다.
- 확장(Extension) 표시(Visibility) 설정이 켜져 있는지 확인합니다.
다음 단계
기본 설정을 완료했습니다. 이제 다음을 진행해 보세요.