# 워드프레스 전체 사이트 편집 완전 가이드

URL: https://noonwp.com/ko/journal/wordpreseu-jeonche-saiteu-pyeonjip
Type: blog
Locale: ko
Published: 2026-09-01
Updated: 2026-09-02

---

> 프리랜서와 에이전시를 위한 워드프레스 전체 사이트 편집 실전 가이드. 블록 테마 구조, Pattern Overrides, 운영 마찰 지점을 실제 클라이언트 사이트 기준으로 정리합니다.

워드프레스 전체 사이트 편집(FSE)은 2026년 현재 선택의 문제가 아닙니다. WordPress 6.9 기준으로 신규 설치의 68%가 기본적으로 블록 기반 아키텍처를 채택합니다. 클래식 PHP 테마로 클라이언트 사이트를 납품하는 프리랜서와 에이전시에게 FSE 도입은 시기의 문제가 아니라 방법의 문제입니다.

이 포리오는 마케팅 문구가 아닌 실제 메커니즘을 다룹니다. WordPress 6.8과 6.9를 실제 클라이언트 사이트에서 테스트한 결과를 바탕으로 합니다.

## FSE가 대체하는 것과 남기는 것

클래식 테마는 PHP 템플릿 파일(`single.php`, `page.php`, `functions.php`)로 구성됩니다. FSE 블록 테마는 이 파일들을 HTML 템플릿과 `theme.json` 설정으로 대체합니다. PHP가 사라지는 것이 아니라, 직접 건드릴 일이 줄어드는 것입니다.

유지되는 것은 다음과 같습니다. 워드프레스 훅 시스템, 커스텀 포스트 타입, REST API, 플러그인 생태계. FSE는 프레젠테이션 레이어의 변화이지, 워드프레스 코어 자체의 교체가 아닙니다.

실제로 확인한 것: 복잡한 필터 구조와 커스텀 필드 의존도가 높은 사이트일수록 FSE 전환의 마찰이 큽니다. 단순한 브로슈어 사이트는 하루 안에 블록 테마로 전환할 수 있습니다.

## 최소 블록 테마: 세 가지 파일

블록 테마가 작동하기 위한 최소 요건은 세 파일입니다.

`style.css`는 테마 헤더만 포함하면 됩니다. 스타일 정의 의무가 없습니다. `templates/index.html`은 가장 기본적인 폴백 템플릿으로, `<!-- wp:query -->` 블록 하나로 시작할 수 있습니다. `theme.json`은 전역 색상, 타이포그래피, 스페이싱 토큰을 정의합니다.

이 세 파일만으로도 워드프레스는 FSE 테마로 인식합니다. 나머지는 점진적으로 추가하면 됩니다. 완성되지 않은 테마를 처음부터 완성하려다 일정이 늘어지는 경우가 많습니다. 최소 구성으로 시작해 필요한 부분을 채워가는 방식이 실전에서 더 안정적입니다.

![블록 테마 레이아웃 구조가 모던 웹 디자인 인터페이스에 표시된 화면](https://fdzlnqpwsaniezitwiuw.supabase.co/storage/v1/object/public/cms-media/noonwp/2026-09/57b5f1-img-1.webp)

## WordPress 6.9 사이트 편집기: 다섯 영역, 하나의 계층

사이트 편집기는 다섯 가지 주요 영역으로 구성됩니다. 템플릿, 템플릿 파트, 패턴, 스타일, 페이지입니다.

템플릿은 특정 콘텐츠 유형에 적용되는 레이아웃입니다. 단일 포스트, 아카이브, 404 오류 페이지마다 별도의 템플릿을 설정할 수 있습니다. 템플릿 파트는 헤더, 푸터처럼 여러 템플릿에서 재사용되는 구성 요소입니다. 패턴은 블록 조합을 저장하고 재사용하는 단위로, 디자인 시스템의 핵심입니다.

계층 구조는 명확합니다. 템플릿이 최상위에 오고, 템플릿 파트가 그 안에 포함되며, 패턴은 어디서든 삽입할 수 있습니다. 이 계층을 이해하지 않으면 편집기 안에서 길을 잃기 쉽습니다.

## 템플릿 파트: 올바른 추상화, 잘못된 사용

템플릿 파트의 가장 흔한 오용은 콘텐츠 섹션을 템플릿 파트로 만드는 것입니다. 템플릿 파트는 사이트 전역에서 동일하게 유지되어야 하는 구조적 요소에 적합합니다. 헤더, 푸터, 사이드바가 그 예입니다.

콘텐츠 내에서 반복되는 레이아웃은 패턴을 사용하는 것이 올바릅니다. 템플릿 파트를 남용하면 편집기 성능이 저하되고, 클라이언트에게 인계할 때 혼란을 초래합니다. 실제 프로젝트에서 이 구분을 잘못 이해한 채 납품한 사이트를 수정하는 비용이 생각보다 큽니다.

## Query Loop 블록: PHP 없는 루프

Query Loop 블록은 `WP_Query`를 시각적으로 구성하는 도구입니다. 카테고리, 태그, 포스트 타입 필터링, 그리드와 리스트 레이아웃 전환을 코드 없이 처리합니다.

주의할 점이 있습니다. Query Loop 블록의 중첩 블록은 각자의 쿼리 컨텍스트 안에서 동작합니다. 커스텀 필드를 표시하려면 Block Bindings API나 ACF 블록이 필요합니다. 순수 블록만으로 해결되지 않는 케이스가 아직 존재합니다. 이 한계를 프로젝트 초반에 클라이언트에게 명확히 전달하는 것이 중요합니다.

![theme.json 설정 파일이 다크 모드 코드 에디터에서 열린 화면](https://fdzlnqpwsaniezitwiuw.supabase.co/storage/v1/object/public/cms-media/noonwp/2026-09/3750e1-img-2.webp)

## theme.json: 무엇을 제어하고 무엇을 위임하는가

WordPress 6.7에서 도입된 theme.json v3는 설정 범위를 명확히 정리했습니다. 색상 팔레트와 그라디언트, 타이포그래피, 스페이싱 스케일, 레이아웃 너비, 블록별 설정 재정의를 제어합니다.

위임하는 것도 명확합니다. 복잡한 애니메이션과 인터랙션, 서드파티 플러그인의 커스텀 블록 스타일, 클래식 PHP 테마와의 하이브리드 설정은 theme.json 밖에서 처리합니다.

핵심 원칙: theme.json으로 정의한 토큰은 편집기 UI에 자동으로 반영됩니다. 클라이언트가 승인된 색상만 선택하도록 제한할 수 있습니다. 브랜드 가이드라인을 코드 리뷰 없이 강제할 수 있다는 점이 실전에서 큰 장점입니다.

## Pattern Overrides: 잠긴 구조, 편집 가능한 콘텐츠

WordPress 6.8에서 도입된 Pattern Overrides는 2026년 클라이언트 인계의 핵심 기능입니다. Block Bindings API의 `core/pattern-overrides` 소스를 활용합니다.

작동 방식은 단순합니다. 패턴 내에서 특정 블록, 예를 들어 제목, 단락, 이미지만 편집 가능하도록 설정합니다. 레이아웃 구조는 잠기고 콘텐츠만 수정할 수 있습니다. 에이전시가 승인된 레이아웃 구조를 잠그고 클라이언트에게는 텍스트와 이미지만 교체하는 권한을 부여하는 시나리오에서 가장 잘 작동합니다.

이 기능 덕분에 디자인 시스템의 일관성을 코드 리뷰 없이 유지할 수 있습니다. 클라이언트가 레이아웃을 실수로 망가뜨리는 상황이 크게 줄었다는 것이 실제 납품 이후 확인된 효과입니다.

## 실제 운영에서 여전히 문제가 되는 것

FSE는 아직 완성되지 않았습니다. 실제 클라이언트 사이트에서 확인된 마찰 지점 세 가지입니다.

첫째, 템플릿 데이터베이스 재정의 문제입니다. 편집기에서 수정한 템플릿은 데이터베이스에 저장됩니다. 코드 기반 템플릿을 업데이트할 때 데이터베이스 버전이 우선합니다. 의도치 않은 재정의가 발생할 수 있습니다. 배포 파이프라인에 이 동작을 반드시 반영해야 합니다.

둘째, RTL 지원 공백입니다. 아랍어, 히브리어 RTL 사이트에서 특정 블록의 정렬이 예상대로 동작하지 않습니다. Group 블록과 Columns 블록에서 반복적으로 확인됩니다. RTL 사이트의 경우 배포 전 전체 블록을 RTL 환경에서 직접 테스트해야 합니다.

셋째, 중첩 DOM 깊이 문제입니다. 블록을 중첩할수록 렌더링되는 HTML의 DOM 깊이가 급격히 늘어납니다. 퍼포먼스 영향은 미미하지만 커스텀 CSS 작성 시 선택자가 복잡해집니다.

이 마찰들을 미리 알고 시작하면, 클라이언트 브리핑 단계에서 정확한 예상 범위를 설정할 수 있습니다.

## FSE 실전 개발에 유용한 도구

Create Block Theme 플러그인을 사용하면 기존 사이트에서 블록 테마를 내보낼 수 있습니다. 마이그레이션의 시작점으로 유용합니다.

Gutenberg 플러그인은 코어에 병합되기 전 기능을 미리 테스트하는 환경을 제공합니다. WordPress 6.9 이후 기능을 프리뷰하려면 필수입니다.

Block Visibility 플러그인은 블록별로 표시 조건을 설정합니다. 사용자 역할, 디바이스, 날짜 기반으로 블록을 보이거나 숨길 수 있습니다. PHP 조건부 로직을 블록 레이어에서 처리할 수 있어 클라이언트 인계 후 유지보수 부담을 줄입니다.

이 도구들은 마케팅 문구가 아니라 실제 워크플로에서 검증된 선택지입니다. 실제 사이트에 적용하기 전 스테이징 환경에서 반드시 테스트하십시오.

## FAQ

### 클래식 테마에서 FSE 블록 테마로 마이그레이션할 때 콘텐츠가 손실되나요?

콘텐츠 자체(포스트, 페이지, 미디어)는 데이터베이스에 있으므로 손실되지 않습니다. 클래식 위젯, 커스터마이저 설정, 일부 쇼트코드는 수동 재구성이 필요합니다.

### theme.json과 커스텀 CSS 중 어느 것을 우선해야 하나요?

theme.json을 우선합니다. 커스텀 CSS는 theme.json으로 해결할 수 없는 경우에만 사용합니다. 두 방식이 충돌하면 CSS 특이성 문제가 발생합니다.

### Pattern Overrides는 구텐베르크 플러그인 없이 사용할 수 있나요?

WordPress 6.8부터 코어에 포함됩니다. 별도 플러그인이 필요하지 않습니다. 단, 6.8 미만 버전에서는 Gutenberg 플러그인이 필요합니다.

### FSE에서 ACF(Advanced Custom Fields)는 여전히 유효한가요?

유효합니다. ACF Block과 Block Bindings API 통합을 통해 FSE 환경에서도 커스텀 필드를 활용할 수 있습니다. ACF 5.x 이상에서 지원됩니다.

### 블록 테마와 하이브리드 테마의 차이는 무엇인가요?

하이브리드 테마는 theme.json을 포함하지만 클래식 PHP 템플릿을 유지합니다. 블록 테마는 PHP 템플릿 없이 순수 블록 에디터 기반으로 동작합니다.

### FSE에서 RTL(오른쪽에서 왼쪽) 언어 지원은 어떤 상태인가요?

개선 중이지만 완전하지 않습니다. Group 블록과 Columns 블록에서 정렬 문제가 보고됩니다. RTL 사이트의 경우 각 블록의 RTL 동작을 배포 전 반드시 확인해야 합니다.

### WordPress 6.9에서 FSE의 가장 주목할 변화는 무엇인가요?

신규 설치의 68%가 블록 기반 아키텍처를 기본값으로 채택합니다. 블록 잠금 기능 개선과 Query Loop 블록의 필터 옵션 확장도 6.9의 주요 변경 사항입니다.