신규 설치 및 활성화

케이테마의 부모테마, 자식테마, Elementor, KTheme Premium, KTheme Popup Manager를 새 WordPress 사이트에 설치하는 방법을 설명합니다. 이 문서는 일반 단일 사이트 관리자의 메뉴 명칭을 기준으로 작성했습니다. 멀티사이트는 네트워크 관리자가 테마와 플러그인을 먼저 설치해야 합니다.

기존 케이테마가 이미 활성화된 사이트는 이 문서대로 바로 교체하지 말고 기존 사이트 업데이트 전 점검을 먼저 확인하세요.

완료 후 상태

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

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

설치 전 확인

필요한 파일

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

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

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

최소 요구사항

현재 공개 패키지 메타데이터의 최소값입니다. 설치 전 WordPress와 PHP를 최신 보안 버전으로 업데이트하고, 서버에서 ZIP 업로드가 가능한지 확인합니다.

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

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과 Popup Manager 설치

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

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

KTheme Popup Manager는 데모·Elementor 키트의 팝업 콘텐츠를 정상적으로 가져오고 표시하는 데 필요합니다. 테마 활성화 후 필수 플러그인 안내가 나타나면 닫지 말고 설치 목록을 확인하세요.

5. 구매처별 라이선스 확인과 사이트 활성화

케이테마 쇼핑몰 구매자는 구매 계정의 마이페이지에서 자동 발급된 키를 확인합니다. CAFE24 구매자는 외부 구매 인증 안내에서 주문정보를 제출하고 발급 완료 상태를 확인합니다. 발급·확인된 키는 설치 사이트의 케이테마 → License → 라이선스 키 입력 → 활성화 순서로 적용하고 License Details의 상태가 Active인지 확인합니다.

6. 설치 확인

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

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

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

완료 확인

문제가 발생한 경우

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

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

K-Theme Widgets가 보이지 않음

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

데모·키트 메뉴는 보이지만 가져오기 버튼을 사용할 수 없음

1. 라이선스가 Active인지 확인합니다.
2. Elementor, KTheme Premium, KTheme Popup Manager가 모두 활성 상태인지 확인합니다.
3. 케이테마 → 시스템 점검에서 가져오기 권한과 라이선스 상태를 확인합니다.
4. 조건이 모두 정상인데 카탈로그 오류가 나오면 데모·키트 문제 해결 문서의 순서를 따릅니다.

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

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

기존 테마 사용자

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

• 기존 케이테마 다운로드 안내
• 기존 테마 설치 안내

참고

• WordPress 공식 테마 관리 문서
• WordPress 공식 플러그인 관리 문서