본문으로 건너뛰기

자식 테마 사용법을 알고 싶습니다.

💡 요약 정리

  • 테마 파일을 직접 수정하면 업데이트 시 변경 내용이 원복되는 문제가 발생하므로, 자식 테마로 안전하게 커스터마이징하세요.
  • 방법 1) SSH/FTP(원격 터미널/파일 전송 프로그램)를 이용해 수동으로 폴더와 style.css를 생성합니다.
  • 방법 2) Child Theme Configurator 플러그인으로 간단히 생성합니다. 권장 방법입니다.
  • 생성 후 외모 > 테마에서 자식 테마를 활성화하고, 필요 시 SSH/FTP로 생성 여부를 확인합니다.

1. 자식 테마를 사용해야 하는 이유

워드프레스 테마마다 관리자 화면에서 변경 가능한 범위가 다릅니다. 직접 테마 파일을 수정해야 할 때가 있으며, 테마를 새 버전으로 업데이트하면 수정한 파일의 설정이 원복되는 문제가 발생합니다.

테마 업데이트 시 직접 수정한 내용이 사라지는 문제를 방지하려면, 자식 테마(Child Theme)를 생성해 사용하세요. 자식 테마를 사용하면 직접 수정한 설정과 코드를 안전하게 유지할 수 있습니다.

2. 수동으로 자식 테마 생성하기(SSH/FTP)

  • SSH: 서버에 접속해 명령을 실행하는 원격 터미널 방식
  • FTP/SFTP: 파일을 서버에 올리고 내려받는 파일 전송 프로그램

wp-contents/themes 폴더 하위에 "부모테마명-child" 폴더를 생성하고, 해당 폴더 안에 아래 내용을 가진 style.css 파일을 생성합니다.

  • 참고: 일반적으로 워드프레스 테마 경로는 wp-content/themes로 표기되기도 합니다.
# Theme Name 에는 자식테마명, Template에는 부모테마명을 입력 합니다.

/*
Theme Name: Twenty Twenty-Two Child
Theme URI: https://wordpress.org/themes/twentytwentytwo/
Template: twentytwentytwo
Author: the WordPress team
Author URI: https://wordpress.org/
Description: 
*/
  • Theme Name: 자식 테마 이름
  • Template: 부모 테마의 디렉터리 이름(예: twentytwentytwo)

추가 팁(스타일 적용 확인):

  • 일부 테마/환경에서는 자식 테마의 스타일시트를 명시적으로 로드해야 합니다. 자식 테마 폴더에 functions.php 파일을 만들고 아래 코드를 추가하세요.
<?php
// 부모 테마의 style.css를 먼저 로드하고, 필요 시 자식 테마 스타일도 로드합니다.
function child_theme_enqueue_styles() {
  // 부모 테마 스타일
  wp_enqueue_style('parent-style', get_template_directory_uri() . '/style.css');

  // 자식 테마 스타일(선택)
  wp_enqueue_style(
    'child-style',
    get_stylesheet_directory_uri() . '/style.css',
    array('parent-style')
  );
}
add_action('wp_enqueue_scripts', 'child_theme_enqueue_styles');
  • 스타일 우선순위 정리
    • CSS는 일반적으로 나중에 로드된 스타일이 먼저 로드된 스타일을 덮어씁니다.
    • 위 수동 예제는 parent → child 순으로 로드하여 최종적으로 자식 테마 스타일이 우선 적용되도록 합니다.
    • 플러그인 옵션 (6)의 취지도 동일하게 “자식 테마 스타일이 우선 적용되도록” 설정하는 것입니다. 즉, 표현은 달라도 결과는 같습니다.

3. 플러그인으로 자식 테마 생성하기(권장)

플러그인을 이용하면 더 간단하고 정확하게 자식 테마를 만들 수 있습니다. Child Theme Configurator 플러그인을 소개합니다.

3.1 설치

  1. 관리자 패널에서 플러그인 > 새로 추가로 이동해 Child Theme Configurator를 설치합니다.
Child Theme Configurator 설치 화면
  • 워드프레스 관리자에서 플러그인을 검색해 설치/활성화합니다.

3.2 테마 분석

  1. 플러그인 내 테마 설정 화면에서 현재 사용 중인 테마 정보를 확인한 뒤 Analyze를 클릭합니다.
Child Theme Configurator Analyze 화면
  • 현재 활성 테마를 기준으로 자식 테마를 만들 준비를 합니다.

3.3 자식 테마 생성

  1. 생성할 자식 테마 설정 값을 확인한 후 Create New Child Theme를 클릭합니다.
설정 항목 안내(원문 기준):

  • (4) 자식 테마를 생성할 디렉터리 이름을 설정합니다. 일반적으로 “부모테마-child” 형식을 사용합니다.

  • (5) 자식 테마에 사용될 스타일시트 설정 파일을 지정합니다. 대부분의 테마가 style.css를 사용하므로 기본값을 권장합니다.

  • (6) 부모 테마의 스타일시트보다 자식 테마의 스타일시트가 먼저 적용되도록 합니다. 기본값을 권장합니다.

  • (7) 자식 테마의 이름, 설명, 작성자, 버전 정보를 지정합니다. 기본값은 부모 테마의 데이터를 종속하여 가져옵니다.

  • (8) 자식 테마 생성 시 부모 테마의 설정을 그대로 복사합니다. 일반적으로 style.css, functions.php 파일이 복사됩니다. 처음 생성 시 체크하는 것을 권장합니다.

  • 참고: 스타일 우선순위 안내

    • 옵션 (6)의 목적은 “최종적으로 자식 테마 스타일이 우선 적용되도록” 하는 것입니다.
    • 수동 방식에서는 부모 스타일을 먼저, 자식 스타일을 그다음에 로드하여 같은 효과를 냅니다.
자식 테마 생성 옵션 설정 화면
  • 체크박스와 옵션을 확인한 뒤 생성 버튼을 클릭합니다.

4. 자식 테마 활성화

  1. 자식 테마가 생성되면 관리자 > 외모 > 테마에서 자식 테마를 활성화합니다.
자식 테마 활성화 화면
  • 자식 테마가 목록에 표시되면 활성화 버튼을 눌러 적용합니다.

5. 서버에서 생성 확인(SSH/FTP)

  1. SSH/FTP 접속을 통해 서버 내 생성된 테마 파일과 현재 선택된 테마 정보를 확인할 수 있습니다.
서버 내 wp-contents/themes 자식 테마 생성 확인
  • wp-contents/themes 경로 아래에 “부모테마명-child” 디렉터리가 생성되었는지 확인합니다.

추가로, 접속 방법은 아래 가이드를 참고하세요.