상품 리스트
쇼핑몰에서 판매하는 상품의 리스트를 전시하는 화면입니다.
🅐 전시 카테고리
쇼핑몰 어드민에 매핑된 상품 카테고리를 출력하는 영역입니다. 상위 depth의 카테고리의 경우 해당 카테고리 하위 카테고리에 매핑된 전체 상품을 출력합니다.
아래 어드민 경로에서 설정하실 수 있습니다.
shop by basic/pro : 상품 > 상품 분류 관리 > 전시 카테고리 관리
shop by premium : 전시관리 > 전시 카테고리 관리► 전시 카테고리 조회 쇼핑몰의 모든 카테고리 정보를 조회합니다.
쇼핑몰 화면에서 카테고리란, 화면이 바뀌어도 대부분의 경우 화면에 상시 노출되는 요소입니다.
아래 2가지 형태의 카테고리 데이터를 제공합니다.
flatCategories : 모든 카테고리를 하나의 배열에 쭉 나열한 형태
multiLevelCategories : 계층을 가지는 카테고리 형태 (최대 5depth)
기본 스킨에서는 multiLevelCategories를 사용하고 있습니다. 따라서 카테고리는 아래와 같이 계층 구조로 구성되며, 최대 5depth까지 어드민에서 카테고리를 추가할 수 있습니다.
🅑 상품 리스트 조회 영역
아래 GET /products/search 호출을 통해 리턴 값으로 받은 상품 리스트를 노출하는 영역입니다.
► 상품 검색하기 다양한 검색 옵션에 맞는 상품 리스트를 조회합니다.
선택 값인 파라미터(Parameters)에 어떤 값을 입력하느냐에 따라 카테고리, 정렬, 검색 등 다양한 조건의 상품 리스트를 가져올 수 있습니다.
㉠ 정렬 조건 order.by
판매량순 : 주문 건 수 기준
낮은/높은 가격순 : 할인 적용가 기준
상품 후기순
신상품순
㉡ 카테고리 categoryNos
㉢ 키워드 검색 filter.keywords
키워드 검색창(search engine)에 입력하여 검색 시, 기본 스킨에서는 '{검색어} 검색결과 N개' 라고 안내문구가 출력되며, 검색된 결과가 없는 경우 '검색 결과가 없습니다.' 라고 상품 리스트 출력 영역에 안내 문구가 노출됩니다.
🅒 좋아요 버튼
상품 리스트 화면에서 기본 스킨의 상품 리스트 조회 영역은 메인 상품진열 영역의 디스플레이 유형 중 '갤러리형'으로 제공됩니다. 따라서 좋아요 버튼이 제공되며, 장바구니 버튼은 제공되지 않습니다.
좋아요 기능은 쇼핑몰 회원(member)의 경우에만 사용 가능하므로, 버튼 클릭 시 로그인 여부를 확인해야 합니다.
비회원(guest)
비회원의 경우 좋아요 기능을 지원하지 않습니다.
좋아요 버튼 클릭 시 로그인 여부를 확인하여, 미로그인(비회원)시 서비스이용불가 안내창 노출 후 로그인 페이지로 현재창 이동해야 합니다.
회원(member)
로그인한 상태에서 좋아요 버튼 클릭 시, 아래 POST /profile/like-products를 호출합니다.
해당 API로 좋아요가 적용된 상품은 마이페이지_쇼핑정보 내 '좋아요' 리스트에 추가됩니다.
▶ 회원이 상품을 좋아한다고 추가/삭제하기 회원이 좋아요한 상품을 목록에 추가하거나 삭제합니다
Last updated
Was this helpful?