VibeFox SmartPost for WooCommerce — 도움말

요구 사항

WordPress: 5.8 이상.

WooCommerce: 7.0 이상, 설치되어 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인이 활성화되지 않습니다.

PHP: 8.0 이상, SimpleXML 확장 포함(대부분의 PHP 설치에 포함되어 있습니다).

SmartPost: API 계정이나 키는 필요하지 않습니다. 픽업 포인트 목록은 공개된 SmartPost 장소 목록에서 가져옵니다. SmartPost에는 공개된 요금 API가 없으므로, 자체(계약) 요금을 직접 입력해야 합니다. 배송 건은 SmartPost(SmartPosti) 비즈니스 계정에서 생성하세요.

국가: SmartPost 픽업 포인트는 에스토니아, 라트비아, 리투아니아, 핀란드에 있습니다. 그 밖의 배송 국가에서는 이 배송 방법이 표시되지 않습니다.

VibeFox 라이선스 키: vibefox.net에서 구입합니다. 키 하나는 도메인 하나에서만 사용할 수 있습니다.

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동하여 플러그인 ZIP 파일을 선택한 다음 Install Now를 클릭합니다. FTP로 vfd_smartpost 폴더를 /wp-content/plugins/에 업로드할 수도 있습니다.

2. Activate를 클릭합니다.

3. 설정을 엽니다: WooCommerce > Settings > Shipping > VibeFox SmartPost. 또는 Plugins 페이지에서 플러그인 이름 아래의 Settings를 클릭합니다.

4. 페이지 상단의 라이선스 블록에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다.

5. 페이지 상단에서 요금 표(기본 요금은 이미 입력되어 있습니다), 박스 크기, 픽업 포인트 상태를 확인합니다.

6. WooCommerce > Settings > Shipping > Shipping zones에서 에스토니아, 라트비아, 리투아니아 및/또는 핀란드가 포함된 지역에 VibeFox SmartPost를 추가하거나, Ignore shipping zones를 켜고 국가를 선택합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Shipping > VibeFox SmartPost. 설정은 모든 배송 지역에 적용됩니다. 배송 방법을 지역에 추가하면 지역 창에는 필드가 하나만 표시됩니다:

Title (zone): 이 지역에서 고객에게 보이는 이름입니다. 비워 두면 전역 Method title을 사용합니다.

페이지 상단의 알림에는 문제와 픽업 포인트 상태가 표시됩니다. 요금이 하나도 설정되지 않은 경우 빨간색 알림이 나타나며, 이때는 체크아웃에 배송 방법이 표시되지 않습니다. Pickup points available at checkout 블록에는 국가별로 사용 가능한 픽업 포인트 수와 도시 수가 표시됩니다. 또한 SmartPost 목록을 지금 사용할 수 없어 저장된 사본을 사용하는 경우, 국가 목록을 전혀 불러오지 못한 경우, 요금이 설정되지 않은 국가가 있는 경우에도 알려 줍니다. Refresh pickup point lists now 버튼은 목록을 다시 다운로드하고 새 수치를 표시합니다.

일반

Enable/Disable: 모든 지역에서 SmartPost를 한꺼번에 켜거나 끕니다.

Method title: 고객에게 표시되는 배송 방법 이름입니다. 지역별 방법의 Title이 이를 대신합니다. 기본값: SmartPost parcel locker.

Tax status: Taxable을 선택하면 배송비에 WooCommerce 세금이 추가되고, None을 선택하면 추가되지 않습니다.

요금(쇼핑몰 통화로 입력합니다. 소수는 3.50 또는 3,50으로 쓸 수 있습니다)

Price table: 국가(에스토니아, 라트비아, 리투아니아, 핀란드)마다 한 행이 있으며, 박스 크기 S, M, L, XL마다 요금을 입력하고 Free from 열이 있습니다. 0은 무료를 뜻합니다. 빈 칸은 해당 박스 크기를 제공하지 않는다는 뜻이며, 소포가 그 박스를 필요로 하면 배송 방법이 숨겨집니다. 모든 칸이 비어 있는 국가에는 서비스하지 않습니다. Free from은 해당 국가에서 SmartPost가 무료가 되는 장바구니 금액입니다. 무료 배송이 없으면 비워 두세요. 숫자가 아닌 요금은 저장 후 알려 주며 비워 둡니다. 기본 요금: 에스토니아 3.50, 라트비아 4.00, 리투아니아 4.00, 핀란드 5.00(모든 박스 공통).

Box sizes (cm): 각 박스의 내부 치수이며, 가장 짧은 변이 먼저 옵니다(Side 1 (smallest), Side 2, Side 3 (largest)). 상품의 변도 같은 순서로 정렬해 나란히 비교하며, 들어가는 가장 작은 박스를 사용합니다. 치수가 없는 상품은 S 박스에 들어가는 것으로 봅니다. 어떤 박스에도 들어가지 않는 소포가 있으면 배송 방법이 숨겨집니다. 상품 치수는 쇼핑몰의 치수 단위에서 변환됩니다. 기본값: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. 양수가 아닌 치수는 저장 후 알려 주며 변경되지 않습니다.

Calculation: 요금이 계산되는 방식입니다.

표시 조건

Minimum weight (kg): 장바구니가 이보다 가벼우면 배송 방법을 숨깁니다. 비워 두거나 0이면 제한이 없습니다.

Maximum weight (kg): 장바구니가 이보다 무거우면 배송 방법을 숨깁니다. 기본값: 25. 0이면 제한이 없습니다.

Minimum cart total: 이 장바구니 금액부터만 배송 방법을 표시합니다. 항상 표시하려면 비워 두세요.

Excluded shipping classes: 장바구니에 이 WooCommerce 배송 클래스의 상품이 있으면 배송 방법을 숨깁니다.

Ignore shipping zones: 지역에 추가하지 않고 아래 국가에 SmartPost를 제공합니다. 꺼져 있으면 국가는 배송 방법이 추가된 배송 지역에 따라 정해집니다. 이 옵션을 권장합니다.

Countries (without zones): 이 모드의 배송 대상 국가입니다. 에스토니아, 라트비아, 리투아니아, 핀란드 중에서 선택합니다. 이 필드는 Ignore shipping zones가 켜져 있을 때만 사용됩니다. 네 나라 모두에서 배송 방법을 제공하려면 비워 두세요.

픽업 포인트

Pickup point types: 고객이 선택할 수 있는 SmartPost 포인트입니다: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO), Posti post offices (Finland). 비워 두면 택배 보관함, 택배 상자, 택배 매장을 제공합니다(기본값). 어떤 유형이 있는지는 국가에 따라 다릅니다. 예를 들어 라트비아에는 택배 상자만 있으며, 우체국은 핀란드에만 있습니다.

City order: 켜면 주요 도시(탈린, 리가, 빌뉴스, 헬싱키 등 큰 도시)가 먼저 나오고, 나머지는 알파벳순으로 나옵니다. 끄면 모든 도시가 알파벳순으로 나옵니다.

고급

Debug log: 요금 계산과 픽업 포인트 목록의 세부 정보를 WooCommerce > Status > Logs(소스 vfd-smartpost)에 기록합니다. 픽업 포인트 목록을 사용할 수 없는 등의 오류는 항상 기록됩니다. 고객 데이터는 기록되지 않습니다.

Remove data on uninstall: 켜져 있으면 플러그인을 삭제할 때 설정, 지역 배송 방법, 캐시된 픽업 포인트가 제거됩니다. 플러그인을 비활성화해도 설정은 절대 삭제되지 않습니다. 주문에 저장된 픽업 포인트는 유지됩니다.

체크아웃에서의 동작

고객이 배송 주소를 입력하면 WooCommerce가 플러그인에 요금을 요청합니다. 플러그인은 에스토니아, 라트비아, 리투아니아, 핀란드에서만 동작합니다. 장바구니 무게, 최소 장바구니 금액, 제외할 배송 클래스를 확인하고, 소포에 맞는 박스를 찾은 다음 배송 국가의 행에서 요금을 가져옵니다. 박스에 요금이 없거나 소포가 어떤 박스에도 들어가지 않으면 배송 방법이 숨겨집니다. 국가에 픽업 포인트가 없으면(목록을 불러올 수 없고 저장된 사본도 없는 경우) 역시 숨겨지므로, 고객이 완료할 수 없는 체크아웃을 보는 일은 없습니다. 장바구니 금액이 해당 국가의 Free from에 도달하면 요금은 0이 됩니다.

각 국가의 픽업 포인트 목록은 24시간 동안 캐시되며, 마지막으로 성공한 목록의 사본도 보관됩니다. 다운로드 실패는 15분 동안 기억되므로, 체크아웃이 새로 고칠 때마다 목록을 기다리지 않습니다. 다운로드 시간 제한은 15초입니다. 같은 도시의 다른 표기(예: Riga와 Rīga)는 하나의 도시로 표시됩니다.

이 배송 방법은 클래식 체크아웃과 장바구니 및 체크아웃 블록에서 동작합니다. WooCommerce의 고성능 주문 저장소(HPOS)와 호환됩니다. 요금은 쇼핑몰 통화로 표시됩니다. 플러그인은 통화를 환산하지 않습니다.

플러그인은 SmartPost 요금을 조회하지 않으며, 배송 건을 만들거나, 라벨을 출력하거나, 택배 기사를 호출하거나, 소포를 추적하지 않습니다. 배송 건은 SmartPost(SmartPosti) 비즈니스 계정에서 생성하세요. 택배 기사가 문 앞까지 배송하는 서비스는 이 배송 방법에 포함되지 않으며, 지도 보기도 없습니다.

픽업 포인트

고객이 SmartPost를 선택하면 배송 방법 아래에 두 개의 목록이 나타납니다: -- Select city --와 -- Select pickup point --. 목록은 항상 배송 국가를 기준으로 합니다. 클래식 체크아웃에서는 배송 주소의 국가이며, 주문을 다른 주소로 보내지 않는 경우에는 청구지 주소의 국가입니다. 국가가 바뀌면 목록이 다시 만들어집니다. 블록 체크아웃에서는 목록이 배송 주소의 국가를 따릅니다. 배송 주소의 도시가 목록의 도시와 일치하면 그 도시가 자동으로 선택됩니다. 각 포인트는 이름과 주소와 함께 표시됩니다. 선택 내용은 체크아웃 과정에서 기억되므로, 체크아웃이 새로 고쳐져도 사라지지 않습니다.

픽업 포인트 선택은 필수입니다. 클래식 체크아웃에서 고객에게는 Please select a SmartPost pickup point in the shipping country.가 표시됩니다. 블록 체크아웃에서는 포인트를 선택할 때까지 Place order가 비활성화됩니다. 두 체크아웃 모두 서버가 배송 국가의 목록을 기준으로 포인트를 다시 확인하므로, 위조되었거나 오래된 포인트 ID나 다른 국가의 포인트는 거부됩니다. 해당 국가의 목록을 일시적으로 사용할 수 없으면 고객에게 메시지가 표시되며, 고객은 다른 배송 방법을 선택할 수 있습니다.

포인트의 ID, 이름, 도시, 국가는 주문에 저장됩니다. 주문 화면에서는 배송 주소 아래(장소 ID 포함)에, 주문 접수 페이지와 My account > Orders, 주문 이메일(HTML 및 일반 텍스트)에는 SmartPost pickup point라는 이름으로 표시됩니다.

주문의 포인트를 바꾸려면 주문을 열고 SmartPost pickup point 옆의 Change를 클릭합니다. 주문의 배송 국가에서 도시와 포인트를 고릅니다. 새 포인트는 즉시 저장되며, 주문 메모에 이전 포인트와 새 포인트가 기록됩니다.

라이선스 키

이 플러그인은 vibefox.net에서 받은 VibeFox 라이선스 키로 동작합니다. 라이선스 블록은 WooCommerce > Settings > Shipping > VibeFox SmartPost 페이지 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭합니다. 블록에는 상태가 표시됩니다. 예를 들어 라이선스가 유효한 날짜와 도메인입니다. Check now로 상태를 다시 확인하고, Change key로 다른 키를 입력하고, Remove key로 이 사이트에서 키를 제거합니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서만 사용할 수 있습니다. 사이트에서 키를 제거해도 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하세요.

활성 키가 없으면 SmartPost는 체크아웃에서 고객에게 표시되지 않습니다. 로그인한 쇼핑몰 관리자에게는 여전히 보이며, (unlicensed — visible to admins only)라고 표시됩니다. 그래서 키를 구입하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 페이지와 WooCommerce 페이지에는 알림이 표시됩니다. 기존 주문에는 영향을 주지 않습니다.

라이선스가 만료되어도 플러그인은 계속 동작하지만, 업데이트와 지원을 받으려면 갱신해야 합니다. 상태는 백그라운드에서 자동으로 다시 확인됩니다.

문제 해결

SmartPost가 체크아웃에 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 배송 국가가 에스토니아, 라트비아, 리투아니아, 핀란드 중 하나인지, 그리고 배송 방법이 고객 국가의 지역에 추가되어 있는지(또는 Ignore shipping zones가 켜져 있고 해당 국가가 허용되어 있는지) 확인하세요. 설정 페이지를 열면 요금이 설정되지 않았는지, 요금이 없는 국가가 있는지, 픽업 포인트가 없는 국가가 있는지 알림으로 확인할 수 있습니다. 무게 제한, Minimum cart total, Excluded shipping classes, 박스 크기도 확인하세요. 어떤 박스에도 들어가지 않는 소포나, 요금 칸이 비어 있는 박스가 있으면 배송 방법이 숨겨집니다. Debug log가 켜져 있으면 WooCommerce > Status > Logs(소스 vfd-smartpost)에서 배송 방법이 숨겨진 이유를 확인할 수 있습니다.

고객에게 다른 국가의 포인트가 보임: 목록은 배송 주소를 따릅니다. 배송 주소에 입력된 국가를 확인하세요(주문을 다른 주소로 보내지 않는 경우에는 청구지 주소를 확인하세요). 다른 국가의 포인트는 주문 시 거부됩니다.

특정 국가의 픽업 포인트가 없음: SmartPost 목록을 불러올 수 없었고 저장된 사본도 없습니다. 플러그인은 15분마다 다시 시도합니다. 나중에 Refresh pickup point lists now를 클릭하세요. 또한 Pickup point types에 그 국가에 존재하는 유형이 포함되어 있는지도 확인하세요.

픽업 포인트 목록이 오래됨: 설정 페이지에서 Refresh pickup point lists now를 클릭하세요. 목록은 24시간마다 자동으로 다시 다운로드됩니다.

고객이 주문할 수 없음: 배송 국가의 픽업 포인트를 선택해야 합니다. 고객에게 "The SmartPost pickup point list is temporarily unavailable"가 표시되면, 현재 그 국가에서 사용할 수 있는 포인트가 없는 것입니다.

요금의 통화: 쇼핑몰 통화입니다. 플러그인은 통화를 환산하지 않습니다.

개발자용: vfd_smpt_places_url 필터는 국가별 장소 목록의 URL을 변경합니다(인수: URL, 국가 코드). 예를 들어 같은 XML을 반환하는 미러 서버로 바꿀 때 사용할 수 있습니다.

라이선스 블록에 오류가 표시됨: 블록의 메시지를 따르세요. 예를 들어 키가 다른 도메인에서 이미 사용 중이면, vibefox.net 계정에서 슬롯을 해제한 뒤 Check now를 클릭하세요. 사이트 주소가 바뀌었다면 Check now를 클릭해 새 도메인에서 키를 활성화하세요. 라이선스 서버에 연결할 수 없으면 플러그인은 마지막으로 확인된 상태로 계속 동작합니다.

삭제

플러그인을 비활성화하면 모든 설정이 유지됩니다. 삭제되는 것은 캐시된 픽업 포인트 목록뿐입니다. 플러그인을 제거하려면 먼저 비활성화한 다음 Plugins 페이지에서 삭제하세요. 이 플러그인의 라이선스 키와 라이선스 상태, 캐시는 항상 삭제됩니다. 설정, 지역 배송 방법, 픽업 포인트 목록의 저장된 사본은 Remove data on uninstall이 켜져 있었을 때만 삭제됩니다. 그렇지 않으면 나중에 다시 설치할 때 쓸 수 있도록 남아 있습니다. 주문에 저장된 픽업 포인트는 절대 삭제되지 않으며, 기존 주문은 배송 항목을 그대로 유지합니다.

SmartPost 및 SmartPosti는 각 소유자의 상표입니다. 이 플러그인은 SmartPost와 제휴하거나 SmartPost의 승인을 받지 않았습니다.