매뉴얼 URL 블록(상품 템플릿)
매뉴얼 URL 블록(Manual URL blocks)을 사용하면, 앱에서 PDF를 먼저 연결하지 않아도 상품 템플릿에 PDF를 표시할 수 있습니다.
예를 들어 product 또는 product.custom 템플릿을 사용하는 “모든 상품”에 동일한 PDF URL(1개 이상)을 공통으로 보여주고 싶을 때 유용합니다.
매뉴얼 블록이란?
PDF Connect는 매뉴얼 상품 블록 2종을 제공합니다.
- PDF Embedded Manual - 페이지 안에 PDF를 인라인(Inline)으로 표시
- PDF Button Manual - 클릭하면 PDF가 열리는 버튼을 표시
연결(Linked) 블록과 달리 매뉴얼 블록은:
- 연결된 리소스 정보를 읽지 않습니다.
- PDF 메타필드(metafields)를 읽지 않습니다.
- 상품별(per-product) 연결이 필요하지 않습니다.
- Shopify 테마 편집기의 블록 설정 값만으로 렌더링됩니다.
매뉴얼 블록 추가 방법
앱에서 추가(권장)
- PDF Connect에서 PDF 상세 페이지를 엽니다.
- Link/Add 드롭다운을 엽니다.
- **Add PDF block to product template (manual URLs)**를 선택합니다.
- 다음 항목을 선택합니다.
- 상품 템플릿(예:
product,product.custom) - 블록 유형(
pdf_embedded_manual또는pdf_button_manual)
- 상품 템플릿(예:
- 이어서 Shopify 테마 편집기를 엽니다.
- 블록 설정에 PDF URL을 1개 또는 여러 개 붙여넣습니다.
- 테마를 저장(Save)합니다.
Shopify 테마 편집기에서 직접 추가
- Shopify 관리자에서 Online Store > Themes > Customize로 이동합니다.
- 상품 템플릿을 엽니다.
- PDF Connect에서 앱 블록을 추가합니다.
- PDF Embedded Manual 또는 PDF Button Manual을 선택합니다.
- URL/설정을 입력하고 저장합니다.
매뉴얼 블록의 뷰어 유형
매뉴얼 블록은 다음 4가지 뷰어 유형을 지원합니다.
- Native Browser
- Custom Viewer (PDF.js)
- Flipbook
- Light Viewer
매뉴얼 블록은 뷰어 동작을 “PDF별 저장된 앱 설정”이 아니라 “테마 블록 설정”에서 구성합니다. 또한 블록 단위의 뷰어 설정 1개가 해당 블록에 입력한 모든 URL에 공통으로 적용됩니다.
여러 URL과 라벨(표시명)
- 여러 PDF URL은 줄바꿈으로 구분해 입력합니다.
- PDF 버튼 매뉴얼 블록에서는 라벨(표시명)을 선택적으로 입력할 수 있으며, 라벨도 줄바꿈으로 구분합니다.
- 라벨 개수가 URL보다 적으면, 남은 URL은 파일명/기본 텍스트로 표시됩니다.
연결(Linked) 블록 vs 매뉴얼(Manual) 블록
| 유형 | 데이터 소스 | 추천 사용 사례 |
|---|---|---|
연결(Linked) 블록 (pdf_embedded, pdf_button) | 앱 연결 + 메타필드 | 리소스별 PDF, PDF별 뷰어 설정 |
매뉴얼(Manual) 블록 (pdf_embedded_manual, pdf_button_manual) | 테마 블록 설정만 사용 | 연결 없이 템플릿 단위로 공통 PDF 제공 |
중요한 제한 사항
- 현재 앱의 “초기 매뉴얼 흐름(early manual flow)”은 상품 템플릿(product templates)만 지원합니다.
- 매뉴얼 블록은 “리소스 단위”가 아니라 “템플릿 단위”로 적용됩니다.
- 매뉴얼 블록은 앱 라이브러리의 PDF 레코드와 자동 동기화되지 않습니다.
빠른 트러블슈팅 체크
매뉴얼 블록에 콘텐츠가 표시되지 않는다면:
https://로 시작하는 유효한 PDF URL이 최소 1개 설정되어 있는지 확인합니다.- 블록이 현재 사용 중인 상품 템플릿에 추가되어 있는지 확인합니다.
- 테마 변경 사항을 저장한 뒤, 스토어프론트를 강력 새로고침(hard refresh)합니다.
- 뷰어별 문제를 분리하기 위해 뷰어 유형을 Native Browser로 바꿔 테스트해 봅니다.