# KapsuleHost에서 WooCommerce 설정하기

Source: https://support.kapsulehost.com/ko-kr/wordpress-woocommerce

아니, 이건 헤딩 번역이 아니라 본문 설명 누락 지적인데, 다시 올바르게 작성하겠습니다.

## WooCommerce 사이트 만들기

1. [KPanel](https://kpanel.kapsulehost.com)에 로그인한 후 왼쪽 사이드바에서 **웹사이트**를 클릭합니다.
2. **웹사이트 추가**를 클릭한 다음 **새 웹사이트**를 클릭합니다.
3. 사이트 유형으로 **WooCommerce**를 선택합니다.
4. 스토어 이름을 입력하고 마법사를 완료합니다.

KapsuleHost는 WordPress를 프로비저닝하고, 데이터베이스를 생성하며, WooCommerce를 설치하고 활성화한 다음, 아래 나열된 결제 게이트웨이 플러그인을 사전 설치합니다. 런타임으로는 PHP 8.3이 설정되며, 이미지 처리를 포함해 스토어에 필요한 확장 기능이 함께 제공됩니다.

이미 WordPress 사이트가 있고 여기에 스토어를 추가하고 싶다면, wp-admin의 **플러그인**에서 **새로 추가**를 통해 일반적인 방식으로 WooCommerce를 설치하면 됩니다. 이 경우 사이트는 WordPress 사이트 유형을 그대로 유지하므로, 여기서 설명하는 스토어 전용 탭은 나타나지 않습니다.

> **Note:** 새로 시작하는 대신 기존 스토어를 마이그레이션하시나요? 수작업으로 재구축하지 마세요. 왼쪽 사이드바의 **마이그레이션**을 사용하면 현재 스토어가 계속 운영되는 상태에서 파일과 데이터베이스를 복사할 수 있습니다. [cPanel에서 웹사이트 마이그레이션하기](https://support.kapsulehost.com/ko-kr/sites-migrate-cpanel)를 참고하세요.

## 결제 게이트웨이

스토어를 연 다음 **WordPress** 탭, 그리고 **결제**로 이동합니다. 이 탭은 WooCommerce 전용이며 일반 WordPress 사이트에는 표시되지 않습니다.

![WooCommerce 스토어의 결제 게이트웨이 패널](https://support.kapsulehost.com/help/screenshots/wordpress-woocommerce.475328e2.webp)

다섯 가지 게이트웨이를 다루며, 뉴질랜드와 관련된 항목은 별도로 표시되어 있습니다:

| 게이트웨이 | 지원 범위 | 새 스토어에서의 상태 |
|---|---|---|
| Stripe | 카드, Apple Pay, Google Pay | 사전 설치됨, 비활성 |
| Afterpay | 선구매 후결제 | 사전 설치됨, 비활성 |
| POLi | 뉴질랜드 계좌 이체 | 사전 설치됨, 비활성 |
| PayPal | PayPal 및 카드 | 사전 설치됨, 비활성 |
| Windcave | 뉴질랜드 카드 결제 및 EFTPOS | 이용 가능, 공급업체에서 설치 |

Apple Pay와 Google Pay는 Stripe에 포함되어 있으므로 별도로 설치할 것이 없습니다.

게이트웨이는 의도적으로 **비활성** 상태로 설치됩니다. 인증 정보 없이 활성화된 게이트웨이는 결제를 중단시키므로, 직접 가맹점 계정 정보를 입력하기 전까지는 아무것도 실제로 작동하지 않습니다:

1. 사용할 게이트웨이에서 **활성화**를 클릭합니다.
2. **구성**을 클릭하면 wp-admin 내에서 해당 게이트웨이의 설정 화면이 열립니다.
3. 본인의 API 키 또는 가맹점 인증 정보를 입력하고 저장합니다.
4. 스토어를 공개하기 전에 테스트 주문을 진행합니다.

Windcave는 플러그인 디렉터리가 아닌 공급업체를 통해 배포되므로, 패널에서는 **플러그인 받기** 링크를 제공합니다. 이를 다운로드한 뒤 wp-admin의 **플러그인**, 그리고 **새로 추가**에서 업로드하고, 다시 이 화면으로 돌아와 구성을 완료하세요.

> **Note:** **결제** 탭은 Managed WooCommerce의 일부입니다. 다른 플랜에서는 대신 업그레이드 안내 패널이 표시됩니다. 다만 어떤 플랜에서든 wp-admin에서 직접 게이트웨이를 설치하고 구성할 수 있습니다. 이 탭은 지름길일 뿐, 유일한 경로는 아닙니다.

## 스토어 성능

스토어는 브로슈어형 사이트보다 페이지 조회당 훨씬 많은 데이터베이스 작업을 수행하므로, 가장 큰 효과를 볼 수 있는 부분은 바로 캐싱입니다.

**전체 페이지 캐시.** 사이트의 **WordPress** 탭, 그리고 **캐싱**에서, 전체 페이지 캐시는 PHP를 실행하거나 데이터베이스에 접근하지 않고도 완성된 HTML을 익명 방문자에게 제공합니다. 장바구니, 결제, 내 계정 페이지, WooCommerce AJAX 엔드포인트는 자동으로 제외되며, 활성 장바구니 쿠키가 있는 방문자에게는 항상 실시간 페이지가 제공됩니다. 이 캐시는 한 고객에게 다른 고객의 장바구니를 보여주는 일 없이 상품 및 카테고리 페이지 속도를 높여줍니다.

**오브젝트 캐시.** 같은 화면에서, 오브젝트 캐시는 데이터베이스 쿼리 결과와 트랜지언트를 메모리에 유지합니다. 대규모 카탈로그에서 WooCommerce 관리자 화면을 실제로 사용할 수 있게 만들어주는 것이 바로 이 기능입니다.

**CDN.** **성능**, 그리고 **Kapsule CDN**에서 활성화하면 상품 이미지와 정적 자산을 엣지에서 제공할 수 있으며, Kapsule CDN+가 포함된 플랜에서는 이미지 최적화와 WebP 변환도 제공됩니다. [CDN 활성화하기](https://support.kapsulehost.com/ko-kr/cdn-enabling)를 참고하세요. 상품 이미지를 대량으로 변경한 후에는 캐시를 비워주세요: [CDN 캐시 비우기](https://support.kapsulehost.com/ko-kr/cdn-cache-purge).

> **Tip:** 전체 페이지 캐시와 오브젝트 캐시는 Managed WooCommerce에 포함되어 있습니다. 스토어가 다른 플랜을 사용 중이라면, 캐싱 탭에서 업그레이드 시 제공되는 내용을 확인할 수 있습니다. 어느 쪽이든 CDN을 먼저 활성화하세요. 이는 모든 Web Hosting, WordPress, Managed WordPress, Managed WooCommerce, Concierge 플랜에 포함되어 있으며, 이미지가 많은 스토어에서 가장 저렴하게 성능을 개선할 수 있는 방법입니다.

## 스토어를 위한 PHP 설정

스토어는 기본값에서 벗어나야 하는 가장 흔한 사례입니다. 사이트의 **설정**, 그리고 **PHP** 탭에서:

- **메모리 제한**: 카탈로그가 크거나 구독 기능을 운영한다면 256M에서 512M로 늘리세요.
- **최대 실행 시간**: 상품 가져오기나 리포트 생성이 시간 초과되면 30초에서 120초 또는 300초로 늘리세요.
- **최대 입력 변수**: 변형이 많은 상품이 있거나, 저장 시 설정 화면에서 필드가 조용히 누락된다면 3000에서 늘리세요.

자세한 내용은 [WordPress 메모리 제한 늘리기](https://support.kapsulehost.com/ko-kr/wordpress-memory-limit)에서 확인할 수 있습니다.

## 예약 작업

WooCommerce는 주문 상태 전환, 구독 갱신, 이메일, 재고 동기화 등 백그라운드에서 매우 많은 작업을 수행합니다. 이는 WordPress에 내장된 스케줄러를 사용하는데, 기본적으로는 누군가 사이트를 방문할 때만 실행됩니다. 방문자가 적은 스토어에서는 갱신과 이메일이 지연되거나 아예 실행되지 않을 수 있습니다.

이를 실제 서버 측 스케줄로 대체하세요. **WordPress** 탭의 **WP-Cron** 섹션에는 **시스템 cron 활성화** 작업이 있으며, 이를 실행하면 스케줄이 추가되는 동시에 방문자 기반 실행 방식이 비활성화됩니다. 전체 설명과 수동 설정 방법은 [cron 작업 설정 및 관리하기](https://support.kapsulehost.com/ko-kr/cron-jobs)에서 확인할 수 있습니다.

wp-admin의 **WooCommerce**, 그리고 **상태**, **예약된 작업**에서 대기열을 확인할 수 있습니다.

## 주문을 잃지 않고 변경하기

모든 스토어는 고객이 끊임없이 데이터를 기록하는 실시간 데이터베이스이므로, 업데이트를 처리하는 방식도 달라져야 합니다.

> **Important:** 스테이징 데이터베이스를 실시간 스토어로 푸시하지 마세요. 주문, 고객, 구독, 쿠폰, 재고 수준은 모두 데이터베이스에 저장되므로, 데이터베이스 푸시를 하면 마지막 리셋 이후 프로덕션에 들어온 모든 주문이 삭제됩니다. **파일만** 푸시하세요. 이것만으로도 테마, 플러그인, 코드 변경에는 충분합니다. [스테이징 사용하기: 푸시와 풀](https://support.kapsulehost.com/ko-kr/wordpress-staging-workflow)을 참고하세요.

스토어를 위한 안전한 업데이트 절차는 다음과 같습니다:

1. 백업을 수행합니다: [백업 수행하기](https://support.kapsulehost.com/ko-kr/taking-a-backup).
2. 스테이징을 프로덕션 상태로 리셋하여 실시간 스토어와 일치시킵니다.
3. 플러그인, 테마 또는 WooCommerce 업데이트를 스테이징에 적용합니다.
4. 확인 페이지까지 전체 과정을 거치는 테스트 주문을 스테이징에서 진행합니다.
5. **파일만** 프로덕션으로 푸시합니다.
6. 프로덕션에서 소액의 실제 주문을 진행한 후 환불합니다.

매니지드 플랜에서는 **빠른 작업**의 **플러그인 업데이트** 작업이 **스마트 업데이트**로 바뀝니다. 이는 백업을 수행하고, 플러그인을 하나씩 업데이트하며, 각 단계 후 사이트 상태 점검을 실행하고, 사이트에 문제가 생기면 자동으로 롤백합니다. 결제 오류가 곧 손실로 이어지는 스토어에서는 이런 기능이 충분히 가치가 있습니다.

## 특정 시점 복구

일일 백업은 백업이 실행된 시점의 상태로 스토어를 복원하므로, 트래픽이 많은 스토어에서는 하루치 주문을 잃을 수도 있습니다. WooCommerce 사이트는 **백업**, 그리고 **특정 시점 복구**에서 이 기능을 활성화할 수 있으며, 원하는 분 단위 시점으로 복원할 수 있고 최대 30일까지 보관됩니다. 실제 결제가 발생하는 스토어라면 반드시 활성화하세요. [백업 수행하기](https://support.kapsulehost.com/ko-kr/taking-a-backup)를 참고하세요.

## 문제 해결

**오류 메시지 없이 결제가 실패하는 경우.** 거의 항상 인증 정보가 누락되었거나 잘못된 채로 활성화된 게이트웨이가 원인입니다. **결제** 탭에서 게이트웨이를 하나씩 비활성화하며 결제가 정상 작동하는지 확인한 뒤, 문제를 일으킨 게이트웨이를 다시 구성하세요.

**주문 이메일이 도착하지 않는 경우.** WordPress는 기본적으로 PHP를 통해 메일을 보내는데, 대부분의 네트워크는 이를 거부합니다. **WordPress** 탭, 그리고 **사이트 상태**에서 전송 경고를 확인하고, 올바르게 인증된 발송 방식을 설정하세요.

**관리자 페이지가 느리거나 시간 초과되는 경우.** **PHP** 탭에서 메모리와 실행 시간을 늘린 다음 오브젝트 캐시를 활성화하세요. 주문이 수만 건에 달하는 스토어라면 오래된 예약 작업을 정리하는 것도 도움이 됩니다.

**상품 변경 사항이 프런트엔드에 표시되지 않는 경우.** **WordPress**, 그리고 **빠른 작업**, **캐시 비우기**에서 캐시를 비우고 CDN도 함께 비워주세요.