확장 기능
WCPOS는 판매 시점 관리에 새로운 기능을 추가하는 확장 기능을 지원합니다. 확장 기능 디렉터리에서 사용 가능한 확장 기능을 찾아보고, POS 설정에서 직접 설치하며, 업데이트를 관리할 수 있습니다.
확장 기능을 설치하고 관리하려면 WCPOS Pro가 필요합니다. 무료 버전에서는 확장 기능 카탈로그가 표시되지만 설치 및 활성화 컨트롤은 비활성화됩니다.
사용 가능한 확장 기능
결제 게이트웨이
대면 POS 사용을 위해 설계된 사용자 지정 결제 게이트웨이입니다.
직접 구축하려면 게이트웨이 템플릿에서 시작하세요. 전체 목록은 사용자 지정 게이트웨이 개요를 참조하세요.
다국어
POS 상품을 언어별로 필터링하여 번역된 중복 항목이 캐셔 검색과 카탈로그 그리드에 표시되지 않도록 합니다.
쿠폰 및 스토어 크레딧
재고
확장 기능 둘러보기
POS Settings > 확장 에서 확장 기능 디렉터리를 엽니다(일부 버전에서는 플러그인으로 표시됨).
디렉터리는 사용 가능한 확장 기능을 카드 그리드로 표시합니다. 각 카드에는 다음이 표시됩니다:
- 아이콘 (또는 확장 기능에서 제공하지 않는 경우 퍼즐 조각 대체 아이콘)
- 이름 및 버전
- 설명
- 카테고리 배지
- 상태 — 활성, 비활성, 업데이트 가능 또는 설치되지 않음
필터링 및 검색
상단의 카테고리 필 버튼을 사용하여 카테고리별로 확장 기능을 필터링합니다. 검색 필드를 사용하여 이름, 설명 또는 태그로 확장 기능을 찾을 수도 있습니다.
확장 기능 설치
POS Settings > 확장을 엽니다.- 원하는 확장 기능을 찾아 설치를 클릭합니다.
- 확장 기능은 WordPress 플러그인 설치 관리자를 사용하여 다운로드 및 설치됩니다.
- 설치가 완료되면 활성화를 클릭하여 사용 설정합니다.
내부적으로 WCPOS는 설치 처리를 위해 WordPress의 기본 Plugin_Upgrader 를 사용하므로, 확장 기능은 다른 WordPress 플러그인과 동일한 절차를 따릅니다.
활성화 및 비활성화
설치된 각 확장 기능의 카드에는 활성화 및 비활성화 버튼이 있습니다.
- 활성화는 확장 기능을 켜서 POS에서 실행할 수 있게 합니다.
- 비활성화는 제거하지 않고 확장 기능을 끕니다. 확장 기능 파일은 서버에 그대로 남아 있으며 언제든지 다시 활성화할 수 있습니다.
확장 기능 업데이트
설치된 확장 기능의 새 버전이 제공되면 카드에 업데이트 가능 배지와 업데이트 버튼이 표시됩니다.
자동 업데이트
디렉터리에서 설치한 확장 기능은 기본적으로 자동 업데이트가 활성화되어 있습니다. 디렉터리의 각 확장 기능 카드에서 자동 업데이트를 켜거나 끌 수 있습니다. 자동 업데이트가 켜져 있으면 WordPress는 자동 업데이트가 활성화된 플러그인과 마찬가지로 새 버전을 자동으로 적용합니다.
문제 해결
버튼의 "Pro 필요" 메시지
WCPOS 무료 버전에서는 설치, 활성화, 업데이트 버튼이 비활성화됩니다. 확장 기능을 관리하려면 WCPOS Pro로 업그레이드하세요.
확장 기능 설치 실패
- WordPress 서버에
wp-content/plugins디렉터리에 대한 쓰기 권한이 있는지 확인하세요. - 서버에서 외부 HTTPS 요청을 보낼 수 있는지 확인하세요(일부 호스트는 외부 다운로드를 차단합니다).
WP Admin > POS > 지원 > 로그에서 오류 세부 정보를 확인하세요.
설치 후 확장 기능이 표시되지 않음
- POS를 새로 고치세요. 확장 기능 목록은 최대 12시간 동안 캐시됩니다.
- 확장 기능이 활성화되어 있는지 확인하세요(설치되었지만 비활성 상태인 확장 기능은 실행되지 않습니다).
카탈로그가 로드되지 않음
확장 기능 카탈로그는 원격 소스에서 가져와 로컬에 12시간 동안 캐시됩니다. 카탈로그가 로드되지 않는 경우:
- 서버의 인터넷 연결 상태를 확인하세요.
- 캐시가 만료된 후 다시 시도하거나 서버의 transient 캐시를 지우세요.
개발자를 위한 정보
POS 확장 프로그램 만들기
WCPOS 확장 프로그램은 WCPOS 훅과 API를 통해 POS와 통합되는 표준 WordPress 플러그인입니다. 만드는 방법은 다음과 같습니다.
- WordPress 플러그인으로 시작하세요. 확장 프로그램에는 다른 WooCommerce 또는 WordPress 플러그인과 마찬가지로 표준 플러그인 헤더와 진입 파일이 필요합니다.
- WCPOS와 통합하세요. WCPOS에서 제공하는 훅과 필터를 사용하여 POS 인터페이스 또는 백엔드에 기능을 추가합니다.
- GitHub에 릴리스를 호스팅하세요. 확장 프로그램 디렉터리는 GitHub Releases를 사용하여 버전을 추적하고 업데이트를 제공합니다.
디렉터리에 제출하기
확장 프로그램 카탈로그는 wcpos/extensions GitHub 저장소에서 관리됩니다. 확장 프로그램을 등록하려면 다음을 수행하세요.
- 저장소의 README에서 카탈로그 형식과 메타데이터 요구 사항을 검토합니다.
- 풀 리퀘스트를 열어 확장 기능의 메타데이터를
catalog.json에 추가합니다. - 병합되면 확장 프로그램이 모든 WCPOS Pro 사용자에게 디렉터리에 표시됩니다.
GitHub 릴리스 규칙
업데이트 수명 주기는 GitHub Releases에 의존합니다:
- 시맨틱 버전 관리(예:
v1.0.0,v1.2.3)를 사용해 버전에 태그를 지정합니다. - 릴리스 자산으로 플러그인 zip을 첨부합니다 — 사용자가 설치하거나 업데이트할 때 다운로드되는 파일입니다.
- 디렉터리에서 감지할 수 있도록 릴리스를 게시합니다(초안이 아님).
새 릴리스를 게시하면 확장 프로그램을 설치한 사용자에게 확장 프로그램 디렉터리에서 사용 가능한 업데이트가 표시됩니다. 자동 업데이트가 활성화되어 있으면 자동으로 적용됩니다.
카탈로그 스키마와 제출 절차에 대한 전체 세부 정보는 wcpos/extensions 저장소를 참조하세요.