Collection of Pages with Components

매개변수 페이지

매개변수 페이지를 사용하면 동일한 URL 아래에 여러 페이지를 캡슐화할 수 있습니다.

/{country}/landingPage   // 국가를 고려한 랜딩 페이지
/{lang}/products        // 여러 언어를 위한 제품 목록 페이지
/{categories}/{blogPost} // 카테고리별로 구분된 맞춤 블로그 게시물

매개변수 페이지가 동작하는 방식은 다음과 같습니다:

• 사용자 지정 구성 요소를 {country} 또는 {lang} 슬러그, 혹은 {categories}처럼 원하는 슬러그에 연결합니다.
• {categories} 와 같은 사용자 지정 슬러그의 경우 연결된 구성 요소는 컴포넌트 빌더에서 "Route Slug"를 정의해야 합니다.
• 해당 스키마에서 문서를 생성하여 여러 페이지를 동적으로 만들어 냅니다.

1단계. 매개변수 라우트를 설정하세요

관리자 패널에서 /{country}/landingPage 매개변수 라우트를 만듭니다.

그리고 {country} 슬러그를 Country 스키마에 연결합니다.

“No default slug field configured for this component” 경고는 시스템이 아직 어떤 스키마 필드를 URL 슬러그로 사용해야 하는지 알지 못한다는 뜻입니다. 이는 다음 단계에서 해결됩니다.

2단계. 스키마와 문서를 생성하세요

CMS에서 Country 스키마를 생성합니다.

예시 구조:

{
  "code": "us",
  "name": "United States",
  "language": "English"
}

현재 이 스키마에 문서가 3개 있다고 가정합니다.

3단계. 필드를 라우트 슬러그에 바인딩하세요

Country schema → Edit Schema로 이동합니다.

code 필드를 Route Slug Field로 바인딩합니다.

이는 유효한 라우트가 /us/landingPage가 됨을 의미합니다.

잘못된 라우트:

• /English/landingPage
• /United States/landingPage

결과

• 각 문서는 새로운 페이지를 생성합니다
• 문서 3개 = 랜딩 페이지 3개
• 문서를 추가하면 라우트가 자동으로 더 생성됩니다

다음 단계

렌더러로 매개변수 페이지를 렌더링하려면 Setting up Parametric Routing 가이드를 참고하세요