Technote

테마 · 플러그인 실무

연재 콘텐츠 모델링 8부 중 3부

반복은 대개 반복 필드가 아니라 별도 타입입니다

반복 필드는 값을 인덱스가 붙은 키로 흩어 저장합니다. 순서를 바꾸면 전부 다시 쓰이고, 조건으로 찾을 수 없습니다. 타입으로 올리면 그 셋이 공짜로 해결됩니다.

콘텐츠 모델을 그리다 보면 “이 안에 항목이 여러 개 들어갑니다” 라는 구조가 반드시 나옵니다. 성과 지표 다섯 줄, 커리큘럼 열 개, 자주 묻는 질문 여덟 개 같은 것들입니다. 이때 가장 먼저 떠오르는 답은 반복 필드지만, 대부분의 경우 그 반복은 별도 포스트 타입으로 올리는 편이 낫습니다. 이유는 취향이 아니라 저장 방식에 있습니다.

반복 필드가 값을 저장하는 방식

반복 필드는 항목마다 값을 인덱스가 붙은 키로 흩어 저장합니다. 지표 세 줄이면 metrics_0_label · metrics_0_value · metrics_1_label 같은 식으로 행이 늘어납니다. 화면에는 하나의 표로 보이지만, 저장된 형태는 서로 관계를 모르는 값 여러 개입니다. 여기서 세 가지가 어려워집니다.

반복 필드에서 어려워지는 것들 — 전부 "항목이 독립돼 있지 않기 때문" 이다

실무에서 가장 아픈 것은 정렬 변경입니다. 편집자가 두 번째 항목을 맨 위로 올리면 값 하나가 이동하는 것이 아니라 여러 행의 내용이 통째로 다시 쓰입니다. 항목이 늘수록 이 조작은 무거워지고, 중간에 실패하면 절반만 바뀐 상태가 남습니다.

두 번째는 조회입니다. “지표가 등록된 항목만” 이나 “이 값이 들어 있는 항목” 같은 조건을 걸 수 없습니다. 값이 인덱스 키에 묻혀 있어서, 찾으려면 전부 읽어서 코드로 걸러야 합니다.

타입으로 올리면 공짜로 따라오는 것

같은 반복이라도 담는 그릇이 나중에 할 수 있는 일을 정한다

항목이 레코드가 되면 정렬 순서 · 검색 · 관리 목록 · REST 가 그냥 딸려 옵니다. 정렬은 항목이 가진 값이 되므로 순서를 바꿔도 다른 항목이 다시 쓰이지 않고, 조회는 코어 기능이 되며, 항목마다 초안 · 발행 상태를 따로 가질 수 있습니다.

이 사이트도 같은 결정을 했습니다. 자주 묻는 질문을 서비스 화면 안의 반복 필드로 두지 않고 별도 타입으로 두었는데, 덕분에 같은 FAQ 를 랜딩과 최적화 지원 사업 화면이 각자 필요한 만큼 꺼내 씁니다. 반복 필드였다면 그 답변은 둘 중 한 화면에만 살아 있었을 것입니다.

또 하나 큰 이점은 자동화입니다. 항목이 레코드이면 명령 한 줄로 만들 수 있고, 그래서 초기 데이터 입력 · 이전 · 대량 수정이 전부 스크립트가 됩니다. 반복 필드에서는 같은 일이 화면을 열고 손으로 하는 작업으로 남습니다.

그래도 반복 필드가 맞는 경우

규칙에는 예외가 있고, 이 예외는 꽤 분명합니다. 세 가지가 모두 성립하면 반복 필드가 더 낫습니다.

첫째, 항목이 부모 없이는 의미가 없을 때입니다. 어떤 화면의 배너 슬라이드 세 장은 그 화면을 떠나서 존재할 이유가 없습니다. 둘째, 개수가 적고 고정일 때입니다 — 세 칸짜리 특징 소개 같은 것입니다. 셋째, 따로 조회하거나 검색할 일이 영영 없을 때입니다.

애매하면 이렇게 물어보세요. “이 항목 하나에 고유 주소가 있어야 하나?” 조금이라도 그렇다면 타입입니다. 확실히 아니라면 필드로 두어도 됩니다. 그리고 판단이 반반이면 타입 쪽으로 기웁니다 — 타입에서 필드로 내리는 것보다 필드에서 타입으로 올리는 일이 훨씬 비쌉니다.

구조 결정이 유지보수에 미치는 영향은 테마 · 플러그인 아카이브에서 이어집니다.

다음 회차

데이터를 어디에 담을지 정했으면 이제 화면입니다. 다음 회차는 콘텐츠와 레이아웃의 경계 — 레이아웃이 데이터베이스에 들어갈 때 무엇이 사라지는지를 다룹니다.

이 주제의 다른 글

노하우 목록으로

테마 · 플러그인 실무

“사례 섹션이 필요해요” 는 화면 요구가 아닙니다

화면 요구는 대개 데이터 요구가 옷을 갈아입은 것입니다. 섹션 하나를 만들자는 말에는 콘텐츠 타입 · 필드 · 목록 화면 · 편집 흐름 네 가지가 들어 있습니다.

기획자 3분 읽기

테마 · 플러그인 입문

필드는 편집자가 채울 수 있는 형태로 쪼갭니다

쪼개는 이유는 화면에 따로 그리기 위해서가 아니라 값을 따로 쓰기 위해서입니다. 그래서 멈출 자리도 정해져 있습니다 — 조각이 따로 쓸모없어지는 순간입니다.

기획자 3분 읽기

₩270,000 · 신청하기