Page Designer와 PWA Kit 통합
Page Designer를 사용하면PWA(Progressive Web App) Kit사이트에 대해 재사용 가능한 페이지 유형 및 구성요소 유형을 생성할 수 있습니다. Business Manager에서 코드 없는 시각적 편집기를 사용하여 사이트의 Page Designer 페이지를 디자인, 스케줄링, 게시할 수 있습니다. PWA Kit 사이트와 통합되면 Page Designer를 사용하면 React 구성 요소를 사용하여 동적 반응형 페이지를 렌더링할 수 있습니다.
이 가이드에서는 사이트에서 Page Designer 페이지를 표시할 수 있도록 PWA Kit를 구성하는 방법을 설명합니다.
이 튜토리얼의 명령을 실행하기 전에 Placeholder를 실제 값으로 바꿉니다. 자리 표시자는 $PLACEHOLDER와 같은 형식입니다.
Page Designer를 PWA Kit 사이트와 통합하려면:
-
다음 구현 중 하나를 사용하여 사이트를 빌드합니다.
- Retail React 앱 템플릿을사용하여 전체 사이트에 대한 컴포저블 스토어프런트(PWA Kit 버전 2.7.0 이상)
- 단계적 헤드리스 롤아웃 ( Storefront Reference Architecture - SFRA및 PWA Kit 버전 2.7.0 이상, Retail React 앱 템플릿 사용)
-
SLAS 공용 또는 개인 클라이언트를 만들거나 업데이트합니다. SLAS 클라이언트 만들기의 단계를 따르거나registerClient API 엔드포인트를 사용합니다.
-
범위필드에 다음 범위를
sfcc.shopper-experience포함합니다.SLAS 개인 클라이언트는 공용 클라이언트에 비해 몇 가지 이점을 제공합니다. SLAS 프라이빗 클라이언트 사용을 참조하십시오.
-
-
Business Manager에서 Page Designer 페이지를 생성합니다. Page Designer 시각적 편집기를 사용하여 페이지 생성하기
- PWA Kit는 분리된 웹앱이므로 Page Designer ISML(Internet Store Markup Language) 구성 요소와 해당 PWA Kit React 구성 요소를모두 만들어야 합니다.
- 사이트에서 사용할 ISML 구성요소가 Page Designer에 없는 경우 Business Manager에서 생성합니다. 자세한 내용은 Page Designers 구성 요소를 구현하는 방법을참조하십시오.
- ISML과 일치하는 일부 PWA Kit React 구성 요소가 있습니다. React 및 ISML 구성 요소 일치를 참조하십시오. 일치하는 React 구성 요소가 없으면 빌드할 수 있습니다.
- Business Manager의 미리보기 기능은SFRA(Storefront Reference Architecture) ISML 구성요소를 렌더링합니다. 따라서 React 사이트의 실제 모습은 미리보기와 다를 수 있습니다. PWA Kit 사이트를 보다 정확하게 미리 보려면스토어프런트 미리 보기를사용하십시오.
-
PWA Kit 프로젝트에서 라는
app/pages/page-viewer/index.jsx파일을 만들고 이 코드를 추가합니다.이 파일의 목적은 구성요소를 사용하여 Page Designer 페이지를 렌더링하도록 페이지 뷰어를 설정하는 것입니다. 이 코드에는 데모를 위한 샘플 구성 요소가 포함되어 있습니다. 코드의 구성요소를 사이트에 적용되는 구성요소로 바꿉니다. 이 통합 예에서는
@salesforce/commerce-sdk-react.
-
PWA Kit 프로젝트에서 ''로 이동하는 경로를 열고
app/routes.jsx추가합니다. Business Manager에서 Page Designer 페이지에 대해 정의한 페이지 ID로 바꿉니다
$PAGE_ID.
-
웹 서버를 로컬로 시작하려면 다음을 실행합니다.
npm start -
React.js에서 렌더링된 Page Designer 페이지를 보려면
`http:localhost:3000/page-viewer/$ PAGE_ID '를 열고 2단계에서 식별한 페이지 ID를 사용합니다.
예를 들어 페이지 ID가 123인 경우 로 이동합니다
http://localhost:3000/page-viewer/123.
이것은 일치하는 ISML 대응물이 있는 React 구성 요소 목록입니다. PWA Kit용 Page Designer GitHub 리포지토리에서 React 구성 요소를 찾을 수 있습니다.
| React 컴포넌트 | ISML 컴포넌트 |
|---|---|
| 캐러셀 | commerce_layouts .carousel |
| mobileGrid1r1c | commerce_layouts .mobileGrid1r1c |
| mobileGrid2r1c | commerce_layouts .mobileGrid2r1c |
| mobileGrid2r2c | commerce_layouts .mobileGrid2r2c |
| mobileGrid2r3c | commerce_layouts .mobileGrid2r3c |
| mobileGrid3r1c | commerce_layouts .mobileGrid3r1c |
| mobileGrid3r2c | commerce_layouts .mobileGrid3r2c |
| 이미지 타일 | commerce_assets .photoTile |
| 텍스트 | commerce_assets가 있는 이미지 .imageAndText |
- 깃허브:PWA Kit용 Page Designer 리포지토리
- _ Salesforce 도움말:_ Page Designer 페이지 수