신규 케이테마 설치 및 활성화

예상 읽기 시간:1분 9 조회수
항목내용
적용최신 케이테마
개발 기준K Theme Starter 1.6.x / K Theme Child 1.0.x / KTheme Premium 2.2.x
적용 WordPress6.0 이상, 상한 호환성 검증 대기
적용 Elementor3.0.0 이상, 상한 호환성 검증 대기
문서 상태공개 시범 문서
초안 작성일2026-07-28
최종 검수일개발 서버 재현 후 입력
이전 버전 문서문서 하단 기존 테마 사용자 참조

케이테마의 부모테마, 자식테마, Elementor와 KTheme Premium을 새 WordPress 사이트에 설치하는 방법을 설명합니다. 기존 케이테마가 이미 활성화된 사이트는 이 문서대로 바로 교체하지 말고 기존 사이트 업데이트 전 점검 문서를 먼저 확인하세요.

완료 후 상태

설치가 끝나면 다음 상태가 되어야 합니다.

  • K Theme Starter가 설치되어 있음
  • K Theme Child가 활성 테마로 표시됨
  • Elementor가 활성화되어 있음
  • KTheme Premium이 활성화되어 있음
  • 페이지 목록에서 Elementor로 편집을 사용할 수 있음
  • Elementor 위젯 패널에서 K-Theme Widgets를 찾을 수 있음

설치 전 확인

필요한 파일

구매 페이지에서 내려받은 패키지에서 다음 ZIP 파일을 확인합니다. 파일의 버전 숫자는 배포 시점에 따라 달라질 수 있습니다.

ktheme_starter-{버전}.zip
ktheme_child-{버전}.zip
ktheme-premium-{버전}.zip

ZIP 파일을 다시 압축하거나 내부 폴더 이름을 변경하지 않습니다.

최소 요구사항

현재 개발 패키지 메타데이터의 최소값입니다. 실제 발행 시에는 업데이트·호환성 페이지의 검증표를 우선합니다.

항목최소값
WordPress6.0 이상
PHP7.4 이상
Elementor3.0.0 이상

기존 사이트라면 테마를 설치하기 전에 파일과 데이터베이스를 백업하고, 현재 활성 테마 이름을 기록합니다.

1. 부모테마 설치

  1. WordPress 관리자에 로그인합니다.
  2. 외모 → 테마로 이동합니다.
  3. 상단의 새 테마 추가를 선택합니다.
  4. 테마 업로드를 선택합니다.
  5. ktheme_starter-{버전}.zip을 선택하고 지금 설치를 실행합니다.
  6. 설치 완료 화면이 나타나면 아직 부모테마를 활성화하지 않고 테마 화면으로 돌아갑니다.

부모테마는 공통 기능과 업데이트를 제공하는 기반입니다. 사이트별 수정은 자식테마에서 관리합니다.

2. 자식테마 설치 및 활성화

  1. 외모 → 테마 → 새 테마 추가 → 테마 업로드로 이동합니다.
  2. ktheme_child-{버전}.zip을 선택하고 설치합니다.
  3. 설치가 완료되면 활성화를 선택합니다.
  4. 테마 화면에서 K Theme Child활성 표시가 있는지 확인합니다.

부모테마가 설치되지 않은 상태에서는 자식테마가 정상적으로 활성화되지 않습니다. 자식테마 설치 오류가 나오면 K Theme Starter 설치 여부부터 확인하세요.

3. Elementor 설치

  1. 플러그인 → 새 플러그인 추가로 이동합니다.
  2. 검색창에 Elementor를 입력합니다.
  3. Elementor Website Builder를 설치하고 활성화합니다.
  4. 플러그인 → 설치한 플러그인에서 Elementor가 활성 상태인지 확인합니다.

Elementor Pro를 사용하는 경우 Elementor 기본 플러그인을 먼저 활성화한 뒤 Pro 플러그인을 설치합니다.

4. KTheme Premium 설치

  1. 플러그인 → 새 플러그인 추가로 이동합니다.
  2. 상단의 플러그인 업로드를 선택합니다.
  3. ktheme-premium-{버전}.zip을 선택하고 지금 설치를 실행합니다.
  4. 설치 완료 후 플러그인 활성화를 선택합니다.
  5. 설치한 플러그인 목록에서 KTheme Premium이 활성 상태인지 확인합니다.

KTheme Premium은 Elementor가 없거나 지원 최소 버전보다 낮으면 관리자 알림을 표시합니다. 알림이 나타나면 KTheme Premium을 반복 설치하기 전에 Elementor 설치와 버전을 확인하세요.

5. 설치 확인

다음 순서로 설치 상태를 확인합니다.

  1. 외모 → 테마에서 K Theme Child가 활성 상태인지 확인합니다.
  2. 플러그인 → 설치한 플러그인에서 Elementor와 KTheme Premium이 활성 상태인지 확인합니다.
  3. 페이지 → 모든 페이지로 이동합니다.
  4. 편집할 페이지에 Elementor로 편집이 표시되는지 확인합니다.
  5. 테스트 페이지를 Elementor로 열고 위젯 검색에서 K-Theme을 검색합니다.

여기까지 정상이라면 설치 후 최초 설정 체크리스트로 이동합니다.

KTheme Starter 설치 후 개발 사이트 메인 화면
설치와 최초 설정이 끝난 뒤 개발 사이트에서 KTheme 헤더와 메인 화면이 정상 표시되는지 확인합니다.

문제가 발생한 경우

자식테마가 손상된 테마로 표시됨

K Theme Starter 부모테마가 먼저 설치되어 있는지 확인합니다. 부모테마의 폴더명은 ktheme_starter여야 합니다.

K-Theme Widgets가 보이지 않음

  1. Elementor와 KTheme Premium이 모두 활성 상태인지 확인합니다.
  2. Elementor 최소 버전을 확인합니다.
  3. KTheme Premium을 비활성화한 뒤 다시 활성화합니다.
  4. 캐시를 삭제하고 Elementor 편집기를 다시 엽니다.

활성화 후 사이트가 정상 표시되지 않음

  1. 관리자에 접속할 수 있으면 이전에 사용하던 테마를 다시 활성화합니다.
  2. KTheme Premium을 비활성화합니다.
  3. 캐시를 삭제하고 사이트를 다시 확인합니다.
  4. 기존 테마와 플러그인을 삭제하지 않은 상태로 지원센터에 문의합니다.

기존 테마 사용자

기존 케이테마 사용자는 현재 설치 문서를 계속 이용할 수 있습니다.

참고

페이지 공유

신규 케이테마 설치 및 활성화

URL 주소 공유

목차