# 확장 기능

WCPOS는 판매 시점 관리에 새로운 기능을 추가하는 확장 기능을 지원합니다. 확장 기능 디렉터리에서 사용 가능한 확장 기능을 찾아보고, POS 설정에서 직접 설치하며, 업데이트를 관리할 수 있습니다.

Pro 기능

확장 기능을 설치하고 관리하려면 [WCPOS Pro](/ko/getting-started/pro-license.md)가 필요합니다. 무료 버전에서는 확장 기능 카탈로그가 표시되지만 설치 및 활성화 컨트롤은 비활성화됩니다.

## 사용 가능한 확장 기능[​](#available-extensions "사용 가능한 확장 기능으로 직접 링크")

### 결제 게이트웨이[​](#payment-gateways "결제 게이트웨이으로 직접 링크")

대면 POS 사용을 위해 설계된 사용자 지정 결제 게이트웨이입니다.

[Stripe 터미널Stripe Terminal 하드웨어(S700, WisePOS E)에서 대면 카드 결제를 처리합니다. MOTO 및 시뮬레이터 모드를 지원합니다.](/ko/payment/gateways/stripe-terminal.md)

[SumUp 터미널SumUp 카드 리더를 통해 카드 결제를 받습니다.](/ko/payment/gateways/sumup-terminal.md)

[Vipps MobilePay 결제QR 코드 또는 푸시 알림을 통한 휴대폰 기반 결제입니다. Vipps(노르웨이), MobilePay(덴마크, 핀란드).](/ko/payment/gateways/vipps-mobilepay.md)

[이메일 청구서고객에게 결제 링크를 이메일로 보내 온라인으로 주문을 결제하도록 합니다.](/ko/payment/gateways/email-invoice.md)

직접 구축하려면 [게이트웨이 템플릿](/ko/reference/gateway-template.md)에서 시작하세요. 전체 목록은 [사용자 지정 게이트웨이 개요](/ko/payment/gateways/.md)를 참조하세요.

### 다국어[​](#multilingual "다국어으로 직접 링크")

POS 상품을 언어별로 필터링하여 번역된 중복 항목이 캐셔 검색과 카탈로그 그리드에 표시되지 않도록 합니다.

[WCPOS Polylang 통합Polylang 통합 — WCPOS Pro용 언어별 상품 동기화 및 매장별 언어 선택.](/ko/extensions/polylang.md)

[WCPOS WPML 통합WPML 통합 — POS 상품을 단일 언어로 필터링합니다.](/ko/extensions/wpml.md)

[WCPOS WP Multilang 통합WP Multilang 통합 — POS 상품을 단일 언어로 필터링합니다.](/ko/extensions/wp-multilang.md)

### 쿠폰 및 스토어 크레딧[​](#coupons-and-store-credit "쿠폰 및 스토어 크레딧으로 직접 링크")

[WCPOS StoreApps Smart Coupons 통합영수증 잔액 라벨과 주문 메모 감사 기록을 포함해 WCPOS에서 StoreApps Smart Coupons 스토어 크레딧을 사용합니다.](/ko/extensions/storeapps-smart-coupons.md)

### 재고[​](#inventory "재고으로 직접 링크")

[WCPOS ATUM 통합위치별 재고, 가격, SKU를 위해 WCPOS Pro 매장을 ATUM Multi-Inventory 위치에 연결합니다.](/ko/extensions/atum.md)

## 확장 기능 둘러보기[​](#browsing-extensions "확장 기능 둘러보기으로 직접 링크")

`POS Settings > 확장` 에서 확장 기능 디렉터리를 엽니다(일부 버전에서는 **플러그인**으로 표시됨).

디렉터리는 사용 가능한 확장 기능을 카드 그리드로 표시합니다. 각 카드에는 다음이 표시됩니다:

* **아이콘** (또는 확장 기능에서 제공하지 않는 경우 퍼즐 조각 대체 아이콘)
* **이름 및 버전**
* **설명**
* **카테고리 배지**
* **상태** — 활성, 비활성, 업데이트 가능 또는 설치되지 않음

### 필터링 및 검색[​](#filtering-and-search "필터링 및 검색으로 직접 링크")

상단의 **카테고리 필 버튼**을 사용하여 카테고리별로 확장 기능을 필터링합니다. **검색 필드**를 사용하여 이름, 설명 또는 태그로 확장 기능을 찾을 수도 있습니다.

## 확장 기능 설치[​](#installing-an-extension "확장 기능 설치으로 직접 링크")

1. `POS Settings > 확장` 을 엽니다.
2. 원하는 확장 기능을 찾아 **설치**를 클릭합니다.
3. 확장 기능은 WordPress 플러그인 설치 관리자를 사용하여 다운로드 및 설치됩니다.
4. 설치가 완료되면 **활성화**를 클릭하여 사용 설정합니다.

내부적으로 WCPOS는 설치 처리를 위해 WordPress의 기본 `Plugin_Upgrader` 를 사용하므로, 확장 기능은 다른 WordPress 플러그인과 동일한 절차를 따릅니다.

## 활성화 및 비활성화[​](#activating-and-deactivating "활성화 및 비활성화으로 직접 링크")

설치된 각 확장 기능의 카드에는 **활성화** 및 **비활성화** 버튼이 있습니다.

* **활성화**는 확장 기능을 켜서 POS에서 실행할 수 있게 합니다.
* **비활성화**는 제거하지 않고 확장 기능을 끕니다. 확장 기능 파일은 서버에 그대로 남아 있으며 언제든지 다시 활성화할 수 있습니다.

## 확장 기능 업데이트[​](#updating-extensions "확장 기능 업데이트으로 직접 링크")

설치된 확장 기능의 새 버전이 제공되면 카드에 **업데이트 가능** 배지와 **업데이트** 버튼이 표시됩니다.

### 자동 업데이트[​](#auto-updates "자동 업데이트으로 직접 링크")

디렉터리에서 설치한 확장 기능은 **기본적으로 자동 업데이트가 활성화되어 있습니다**. 디렉터리의 각 확장 기능 카드에서 자동 업데이트를 켜거나 끌 수 있습니다. 자동 업데이트가 켜져 있으면 WordPress는 자동 업데이트가 활성화된 플러그인과 마찬가지로 새 버전을 자동으로 적용합니다.

## 문제 해결[​](#troubleshooting "문제 해결으로 직접 링크")

### 버튼의 "Pro 필요" 메시지[​](#requires-pro-message-on-buttons "버튼의 \"Pro 필요\" 메시지으로 직접 링크")

WCPOS 무료 버전에서는 설치, 활성화, 업데이트 버튼이 비활성화됩니다. 확장 기능을 관리하려면 [WCPOS Pro](/ko/getting-started/pro-license.md)로 업그레이드하세요.

### 확장 기능 설치 실패[​](#extension-fails-to-install "확장 기능 설치 실패으로 직접 링크")

* WordPress 서버에 `wp-content/plugins` 디렉터리에 대한 쓰기 권한이 있는지 확인하세요.
* 서버에서 외부 HTTPS 요청을 보낼 수 있는지 확인하세요(일부 호스트는 외부 다운로드를 차단합니다).
* `WP Admin > POS > 지원 > 로그` 에서 오류 세부 정보를 확인하세요.

### 설치 후 확장 기능이 표시되지 않음[​](#extension-not-appearing-after-install "설치 후 확장 기능이 표시되지 않음으로 직접 링크")

* POS를 새로 고치세요. 확장 기능 목록은 최대 12시간 동안 캐시됩니다.
* 확장 기능이 활성화되어 있는지 확인하세요(설치되었지만 비활성 상태인 확장 기능은 실행되지 않습니다).

### 카탈로그가 로드되지 않음[​](#catalog-not-loading "카탈로그가 로드되지 않음으로 직접 링크")

확장 기능 카탈로그는 원격 소스에서 가져와 로컬에 12시간 동안 캐시됩니다. 카탈로그가 로드되지 않는 경우:

* 서버의 인터넷 연결 상태를 확인하세요.
* 캐시가 만료된 후 다시 시도하거나 서버의 transient 캐시를 지우세요.

***

## 개발자를 위한 정보[​](#for-developers "개발자를 위한 정보으로 직접 링크")

### POS 확장 프로그램 만들기[​](#creating-a-pos-extension "POS 확장 프로그램 만들기으로 직접 링크")

WCPOS 확장 프로그램은 WCPOS 훅과 API를 통해 POS와 통합되는 표준 WordPress 플러그인입니다. 만드는 방법은 다음과 같습니다.

1. **WordPress 플러그인으로 시작하세요.** 확장 프로그램에는 다른 WooCommerce 또는 WordPress 플러그인과 마찬가지로 표준 플러그인 헤더와 진입 파일이 필요합니다.
2. **WCPOS와 통합하세요.** WCPOS에서 제공하는 훅과 필터를 사용하여 POS 인터페이스 또는 백엔드에 기능을 추가합니다.
3. **GitHub에 릴리스를 호스팅하세요.** 확장 프로그램 디렉터리는 GitHub Releases를 사용하여 버전을 추적하고 업데이트를 제공합니다.

### 디렉터리에 제출하기[​](#submitting-to-the-directory "디렉터리에 제출하기으로 직접 링크")

확장 프로그램 카탈로그는 [`wcpos/extensions`](https://github.com/wcpos/extensions) GitHub 저장소에서 관리됩니다. 확장 프로그램을 등록하려면 다음을 수행하세요.

1. 저장소의 README에서 카탈로그 형식과 메타데이터 요구 사항을 검토합니다.
2. 풀 리퀘스트를 열어 확장 기능의 메타데이터를 `catalog.json` 에 추가합니다.
3. 병합되면 확장 프로그램이 모든 WCPOS Pro 사용자에게 디렉터리에 표시됩니다.

### GitHub 릴리스 규칙[​](#github-release-conventions "GitHub 릴리스 규칙으로 직접 링크")

업데이트 수명 주기는 GitHub Releases에 의존합니다:

* 시맨틱 버전 관리(예: `v1.0.0`, `v1.2.3`)를 사용해 **버전에 태그를 지정합니다**.
* 릴리스 자산으로 **플러그인 zip을 첨부합니다** — 사용자가 설치하거나 업데이트할 때 다운로드되는 파일입니다.
* 디렉터리에서 감지할 수 있도록 **릴리스를 게시합니다**(초안이 아님).

새 릴리스를 게시하면 확장 프로그램을 설치한 사용자에게 확장 프로그램 디렉터리에서 사용 가능한 업데이트가 표시됩니다. 자동 업데이트가 활성화되어 있으면 자동으로 적용됩니다.

카탈로그 스키마와 제출 절차에 대한 전체 세부 정보는 [`wcpos/extensions`](https://github.com/wcpos/extensions) 저장소를 참조하세요.