WordPress 테마 제작
목표는 디자인은 코드에 고정되고 콘텐츠는 편집기에서 편집 가능한 테마입니다. 템플릿에 하드코딩된 텍스트는 클라이언트가 사소한 수정을 위해 다시 찾아오는 가장 흔한 이유입니다.
접근 방식 선택
| 접근 방식 | 선택 시점 |
|---|---|
블록 테마 (theme.json, HTML 템플릿) | 새 구축, 클라이언트가 사이트 편집기에서 편집, 콘텐츠는 대부분 표준 블록으로 구성 |
하이브리드 클래식 테마 (PHP 템플릿 + theme.json 및 블록 패턴) | 정확한 HTML 제어가 필요한 복잡한 커스텀 마크업 또는 무거운 애니메이션 |
| 차일드 테마 | 기존 테마 수정 시; 업데이트 시 덮어쓰기 때문에 부모 테마를 직접 편집하지 마십시오 |
애니메이션이 포함된 디자인 중심 마케팅 사이트의 경우 하이브리드 접근 방식이 일반적으로 실용적입니다. PHP로 정확한 마크업을 작성하고, 패턴, 필드 및 블록 편집기를 통해 콘텐츠를 편집 가능하게 만듭니다.
최소 구조
my-theme/
├── style.css # 테마 헤더 주석 (필수)
├── functions.php # 설정, 등록, 초기화
├── theme.json # 팔레트, 타입 스케일, 간격, 레이아웃 너비
├── index.php # 폴백 템플릿 (클래식/하이브리드)
├── front-page.php # 홈페이지
├── header.php footer.php
├── template-parts/ # 섹션당 하나의 파일
├── patterns/ # 블록 패턴 (자동 등록)
├── assets/css assets/js assets/media
└── screenshot.png # 1200x900
style.css 헤더:
/*
Theme Name: My Theme
Author: Your Name
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: my-theme
*/
변환 워크플로우
- 정적 빌드를 고정합니다. HTML, CSS, JS를 먼저 완료하고 검증합니다. 변경 중인 대상을 변환하면 작업량이 두 배가 됩니다.
- 부분으로 분할합니다. 헤더와 푸터는
wp_head()및wp_footer()와 함께header.php및footer.php로 이동합니다. 각 홈페이지 섹션은template-parts/디렉토리의 파일이 되며,get_template_part()로 로드됩니다. - 토큰을
theme.json으로 이동합니다. (팔레트, 글꼴 크기, 간격, 콘텐츠 너비) 편집기가 프론트엔드와 동일한 선택지를 표시하도록 합니다. CSS 사용자 정의 속성과 동일한 값을 유지하십시오. WordPress는--wp--preset--*변수를 생성하며, 이를 별칭으로 사용할 수 있습니다.webcraftCLI를 사용할 수 있는 경우,webcraft tokens "#brand" --format theme-json -o theme.json명령은tokens.css와 동일한 값으로 버전 3 파일을 작성합니다. - 애셋을 등록하고, 절대 하드코딩하지 마십시오:
add_action('wp_enqueue_scripts', function () {
$v = wp_get_theme()->get('Version');
$uri = get_theme_file_uri('assets');
wp_enqueue_style('my-theme', "$uri/css/main.css", [], $v);
wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
wp_enqueue_script('my-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});
가능하면 CDN보다 라이브러리를 로컬에 번들링하십시오. 타사 요청과 동의 문제를 피할 수 있습니다. 5. 콘텐츠를 편집 가능하게 만듭니다. 섹션별로 선택:
- 자체 페이지가 있는 반복 항목(서비스, 포트폴리오, 사용후기):
WP_Query로 쿼리되는 커스텀 포스트 타입. - 일회성 섹션 텍스트 및 이미지: 클라이언트가 삽입하고 편집하는 블록 패턴 또는 커스텀 필드.
- 전역 항목(전화번호, 소셜 링크, 푸터 텍스트): 커스터마이저 또는 작은 옵션 페이지.
- 내비게이션:
register_nav_menus()및wp_nav_menu().
- 출력 시 모든 것을 이스케이프 처리합니다:
esc_html(),esc_attr(),esc_url(), 리치 텍스트의 경우wp_kses_post(). 문자열을 텍스트 도메인과 함께__()또는esc_html__()로 래핑합니다. - 이미지:
wp_get_attachment_image()를 사용하여srcset,sizes, 치수 및 지연 로딩이 생성되도록 합니다.add_image_size()로 필요한 크기를 등록합니다. - 테마 지원:
title-tag,post-thumbnails,editor-styles,responsive-embeds,html5,wp-block-styles.
WordPress 내 애니메이션
- 콘텐츠를 숨기는 스크립트는 블록 편집기에서 실행되어서는 안 됩니다. 프론트엔드에서만 등록하십시오(
wp_enqueue_scripts,enqueue_block_assets아님). - 관리자 바는 고정 헤더를 32px(모바일에서는 46px) 밀어냅니다.
body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }로 오프셋을 조정합니다. - JS를 지연시키거나 결합하는 캐싱 및 최적화 플러그인은 로드 순서를 깨뜨릴 수 있습니다. 종속성을 올바르게 선언하여 존중되도록 하고, 플러그인이 활성화된 상태에서 테스트하십시오.
- 편집기에서 추가된 콘텐츠에는 애니메이션 속성이 없습니다. JS에서 블록 클래스별로 애니메이션을 적용하거나, 속성이 포함된 패턴을 제공하십시오.
하지 말아야 할 것
- WordPress 코어 또는 부모 테마를 편집하지 마십시오.
- 테마 전환 시 유지되어야 하는 기능(커스텀 포스트 타입, 단축 코드)을 클라이언트가 테마를 변경할 수 있는 경우 테마에 넣지 마십시오. 작은 플러그인이 올바른 위치입니다.
- 루프 내에서 재설정 없이 쿼리하지 마십시오(
wp_reset_postdata()). WP_DEBUG알림이 있는 상태로 배송하지 마십시오.WP_DEBUG를 켜고 개발하십시오.- 재배포를 허용하지 않는 라이선스의 유료 플러그인 또는 애셋을 번들링하지 마십시오.
인계 체크리스트
- 클라이언트가 코드를 건드리지 않고 모든 표시 텍스트, 이미지, 메뉴 항목 및 연락처 세부 정보를 변경할 수 있습니다.
- 설정, 읽기 아래에 홈페이지가 설정되어 있고, 고유주소가 글 이름으로 설정되어 있습니다.
- 파비콘(사이트 아이콘), 404 템플릿, 검색 템플릿, 개인정보 보호 페이지가 있습니다.
- 스크린샷이 포함된 한 페이지짜리 편집 가이드가 있습니다.
- 그런 다음
launch-qa스킬을 실행합니다.