위치:
선택적 커뮤니티 DIS 제품 이미지 래퍼
선택 사항인 오픈 소스 dis-product-image-wrapper 프로젝트는 일부 Salesforce Reference Architecture(SFRA) 및 SiteGenesis 프로젝트에서 제품 이미지 매개 변수를 중앙 집중화하고 JavaScript 도우미를 사용하는 데 도움이 됩니다. B2C Commerce API의 URLUtils 및 MediaFile을 대체할 필요는 없습니다.
권장되는 B2C Commerce 경로는관련 Dynamic Imaging Service 항목및Dynamic Imaging Service 를 참조하십시오. URLUtils및MediaFile참조는Script API를 참조하십시오 . 아래 섹션에서는 커뮤니티 카트리지에 대해서만 설명합니다.
커뮤니티 프로젝트가 제공하는 것
GitHub 프로젝트는plugin_dis카트리지, 보기 형식의 JSON 구성(예: 대형 / 중형/ 소형차원) 및 Internet Store Markup Language(ISML)에서 이미지 개체를 가져오기 위한도우미(예: ProductImageDIS )를 문서화합니다. 저장소의 동작 및 파일 이름은 릴리스 간에 변경될 수 있습니다. 이전 문서에서 인쇄된 줄 번호나 경로가 아닌 저장소의현재 README 및 wiki를 사용합니다.
저장소 및 액세스
- 저장소: GitHub의SalesforceCommerceCloud/dis-product-image-wrapper
- Wiki(게시된 경우): 템플릿 목록 및 프로젝트별 변경 사항에 대한dis-product-image-wrapper wiki
- 액세스에는 GitHub 계정, 2단계 인증 및 리포지토리에 설명된 Commerce 커뮤니티 프로세스가 필요할 수 있습니다. 변경 사항이 있을 때 해당 지침을 따르십시오. 오래된 PDF 또는 가이드의 자격 증명 단계를 신뢰할 수 있는 것으로 복사하지 마십시오.
SFRA 지원(요약)
현재리포지토리 설명서가 이 개요를 대체합니다. plugin_dis , ProductImageDIS.js또는image_config_DIS.json를 사용하는 단계는 작성 당시의 일반적인 커뮤니티 레이아웃을 설명합니다. 파일 이름 및 위치는 변경될 수 있습니다.
- GitHub에서 현재 리포지토리를 복제합니다.
- 에서
app_storefront_base전에카트리지 경로에plugin_dis추가합니다. 예:app_mystorefront:plugin_dis:app_storefront_base. - JSON 파일(예: 소유한 카트리지 아래의
image_config_DIS.json)에서 보기 유형 및 차원을 구성합니다. 일반적인 파일은 보기 유형(예:large,medium,small,swatch), 더 작은 보기 유형이 더 큰 소스에서 파생되도록 선택적viewTypeMapping및missingImages대체를 정의합니다. - 고해상도 소스 이미지(예: 제품 히어로 이미지의 경우 2400 x 2400픽셀)를에서 업로드합니다. 각 이미지를 소스 보기 유형(예:
고해상도또는대형)과 연결합니다. - ISML에서 프로젝트의 도우미(예:
ProductImageDIS.getImage(product, viewType, index))를 호출하고img태그를 작성할 때 반환된 객체의getURL(),alt및title속성을 사용합니다. - 생성된 URL이 스토어프런트고유(Vanity ) 도메인을 사용하는지, 변환이 적용되는
/dw/image/v2/를 포함하는지, 구성한 크기와 일치하는지 확인하십시오. 요청이 4xx, 시간 초과 또는 손상된 이미지를 반환하는 경우문제 해결 및 마이그레이션을 참조하세요.
SiteGenesis 활성화(요약)
SiteGenesis 프로젝트는 동일한 카트리지 설치를 따르지만 템플릿 업데이트는 수동으로 수행됩니다. 카트리지 경로 예: app_mystorefront:plugin_dis:sitegenesis_controllers:sitegenesis_core . wiki 목록에 있는 스토어프런트 템플릿에서 제품 이미지 호출을 업데이트합니다. 트래픽이 많은 템플릿에는 일반적으로 제품 세부 정보 페이지, 제품 타일, 카트 및 미니 카트, 체크아웃 요약, 제품 이메일이 포함됩니다. 기본 SiteGenesis 템플릿이 변경되었기 때문에 이전 구현 가이드의 줄 번호별 지침보다 패턴 기반 대체(기존 이미지 조회를 찾아 도우미를 통과하는 호출로 대체)를 선호합니다.
