VibeFox LP Express for OpenCart — 도움말

요구 사항

OpenCart: 3.0.x(3.0.5.0에서 테스트됨) 또는 4.0.2 이상(4.1.0.3에서 테스트됨), 기본 테마와 OpenCart 표준 체크아웃을 사용.

PHP: 8.0 이상.

LP Express: API 계정은 필요하지 않습니다. LP Express에는 공개된 요금 API가 없고, 이 확장 기능은 Unisend API를 사용하지 않으므로 (계약) 요금은 직접 입력합니다. 소포는 Unisend 계정("Mano siuntos")에서 생성하십시오.

소포 터미널 목록: 이 확장 기능은 LP Express의 공개 터미널 목록(https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals)을 사용합니다. 키는 필요하지 않습니다. 이 온라인 목록을 사용할 수 없으면, 확장 기능은 내려받아 둔 마지막 사본이 있으면 그것을 사용하고, 없으면 자체 목록을 사용합니다. 자체 목록을 입력할 준비를 해 두십시오(설정 참조).

리투아니아: 국가는 System > Localisation > Countries에서 활성화되어 있어야 합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 작동합니다.

설치

다운로드는 두 OpenCart 버전용 패키지가 들어 있는 zip 파일 하나입니다. 컴퓨터에서 압축을 푸십시오. 파일에는 README.txt, OpenCart 3 패키지 vfd_lp_express-oc3-(version).ocmod.zip, OpenCart 4 패키지 vfd_lp_express.ocmod.zip이 들어 있습니다. 사용 중인 OpenCart 버전의 패키지만 설치하십시오. 라이선스 키는 두 버전 모두 같습니다.

OpenCart 3

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 vfd_lp_express-oc3-(version).ocmod.zip 파일을 선택합니다. 이 확장 기능은 OCMOD 수정 사항을 추가하지 않으므로 Extensions > Modifications를 새로 고칠 필요가 없습니다. Installer 대신 패키지의 upload 폴더 내용을 쇼핑몰의 루트 폴더에 복사해도 됩니다.

2. Extensions > Extensions로 이동하여 확장 기능 유형으로 Shipping을 선택합니다. VibeFox LP Express를 찾아 Install(녹색 + 버튼)을 클릭합니다.

3. Edit(연필 버튼)를 클릭하여 설정 페이지를 엽니다.

4. Edit 페이지 상단의 라이선스 블록에 있는 License key 칸에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다(라이선스 키 참조).

5. 요금 표를 작성합니다(최소 한 행; 처음 추가하는 행은 리투아니아입니다) 또는 대체 비용을 입력합니다. 페이지 상단의 소포 터미널 관련 상태 줄을 확인하고, 온라인 목록을 사용할 수 없으면 자체 터미널 목록을 추가합니다. Enable/Disable을 켜고 Save를 클릭합니다.

OpenCart 4

1. 관리자 화면에서 Extensions > Installer로 이동하여 Upload를 클릭하고 vfd_lp_express.ocmod.zip 파일을 선택합니다. 파일 이름을 바꾸지 마십시오. OpenCart 4는 파일 이름에서 확장 기능 코드를 가져오므로, 이름을 바꾼 패키지는 작동하지 않습니다.

2. 같은 페이지의 설치된 확장 기능 목록에 패키지가 나타납니다. 그 옆의 Install(녹색 + 버튼)을 클릭합니다.

3. Extensions > Extensions로 이동하여 확장 기능 유형으로 Shipping을 선택합니다. VibeFox LP Express를 찾아 Install(녹색 + 버튼)을 클릭한 다음 Edit(연필 버튼)를 클릭합니다.

4. OpenCart 3의 4단계와 5단계와 같이 라이선스 키와 설정을 입력합니다. 설정 페이지와 그 필드는 두 버전에서 같습니다.

설치 시 확장 기능은 작은 테이블 두 개(선택한 터미널과 캐시된 터미널 목록)를 만들고, 체크아웃과 주문 페이지용 OpenCart 이벤트를 등록합니다. Enable/Disable을 켜고 저장하기 전까지는 이 배송 방법이 꺼져 있습니다. 제거한 후 다시 설치하면, 보관해 둔 설정이 다시 사용됩니다.

설정

모든 설정은 확장 기능 페이지에 있습니다: Extensions > Extensions > Shipping > VibeFox LP Express > Edit. 섹션은 왼쪽에 나열되어 있습니다. 하단의 Save 버튼 하나로 페이지 전체를 새로 고침 없이 저장합니다. 저장할 때마다 터미널 목록도 다시 불러옵니다. 이 확장 기능에 대한 수정 권한이 있는 관리자 사용자만 설정을 저장할 수 있습니다.

페이지 상단에는 알림으로 문제와 터미널 상태가 표시됩니다. 가격이 설정되어 있지 않거나 사용 가능한 소포 터미널이 없으면 배송 방법이 체크아웃에 표시되지 않으므로 경고가 나타납니다. 또한 쇼핑몰에 단위가 kg인 무게 클래스가 없으면 경고가 나타납니다. 이 경우 상품 무게는 단위 이름(kg, g, lb, oz)에 따라 읽히며, 그 밖의 단위는 모두 kg로 취급됩니다. 정보 줄에는 사용 가능한 소포 터미널이 몇 개 도시에 몇 개 있는지, 그리고 출처(온라인 목록, 온라인 목록의 저장된 사본(날짜 포함), 또는 자체 목록)가 표시됩니다.

저장할 때, 방법 제목이 비어 있거나 < > ; = # { } 문자 중 하나를 포함하면 Enter a valid method title. 메시지와 함께 거부됩니다. 64자를 넘는 제목도 거부됩니다. 정수가 아닌 정렬 순서도 거부됩니다. 이 경우에는 아무것도 저장되지 않습니다. 숫자가 아니거나(또는 음수인) 금액이나 무게는 알림이 표시되고 이전 값이 유지됩니다. Maximum weight (kg)보다 큰 Minimum weight (kg)(최대값이 비어 있으면 30 kg)도 알림이 표시됩니다. 배송 방법이 결코 표시되지 않기 때문입니다. 두 무게 모두 이전 값을 유지합니다. 표의 숫자가 아닌 요금은 알림이 표시되고 빈칸으로 남습니다. 나머지 값은 저장됩니다.

일반

Enable/Disable: 체크아웃에서 LP Express를 표시하거나 숨깁니다(이 확장 기능의 상태). 기본값: off.

Method title: 장바구니와 체크아웃에서 고객에게 보이는 배송 방법 이름. 기본값: LP Express parcel terminal. 필수 항목, 최대 64자.

Tax class: --- None ---(기본값)은 아래 요금이 최종 금액임을 뜻합니다. 세금 클래스를 선택하면 OpenCart가 아래 요금에 배송비 세금을 더합니다.

Sort order: 체크아웃의 배송 방법 중 LP Express의 위치. 정수입니다.

요금(쇼핑몰의 기본 통화로, 섹션 제목에 표시됩니다. 소수는 2.99 또는 2,99로 쓸 수 있습니다)

Price table: 배송 대상 국가마다 한 행. Add country를 클릭하면 행이 추가되고, 삭제 버튼으로 행을 제거합니다. 자체 행이 없는 모든 국가에는 * Any other country를 선택합니다. 각 행에는 Base price와 무게 열이 있습니다: XS는 1 kg까지, S는 2 kg까지, M은 3 kg까지, L은 5 kg까지, XL은 5 kg 초과입니다. 무게는 장바구니의 무게이며, Per item을 선택하면 상품 한 개의 무게입니다. 비어 있는 열은 그 행의 기본 요금을 사용합니다. 0은 무료를 뜻합니다. 요금이 하나도 없는 행은 저장되지 않습니다.

Fallback cost: 배송 대상 국가에 대한 행(또는 요금)이 요금 표에 없을 때 사용됩니다. 그런 국가에서 배송 방법을 숨기려면 비워 둡니다.

Calculation: 요금을 계산하는 방식.

Per order (tier by total cart weight): 장바구니 전체에 대해 하나의 요금을 적용하며, 장바구니 총 무게에 따라 무게 열이 선택됩니다. 이것이 기본값입니다.

Per item (each item priced by its own weight x quantity): 각 상품은 자체 무게에 수량을 곱한 값으로 요금이 매겨지고, 그 금액들이 합산됩니다.

Free shipping from: LP Express가 무료가 되는 장바구니 합계(배송이 필요한 상품, 할인 후, 세금 제외). 요금 표보다 먼저 적용되므로 자체 행이 없는 국가에도 적용됩니다. 무료 배송이 없으면 비워 둡니다.

이용 가능 여부

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

Maximum weight (kg): 장바구니가 이보다 무거우면 배송 방법을 숨깁니다. LP Express 터미널은 최대 30 kg의 소포를 받습니다. 기본값: 30. 0은 제한이 없음을 뜻합니다. 비어 있으면 30 kg이며, Ignore shipping zones가 켜져 있으면 제한이 없습니다.

Minimum cart total: 이 장바구니 합계(배송이 필요한 상품, 할인 후, 세금 제외) 이상일 때만 배송 방법을 표시합니다. 항상 표시하려면 비워 둡니다.

Geo zone: 이 지오존 내의 주소에 대해서만 배송 방법을 제공합니다. All Zones(기본값)는 모든 지역을 뜻합니다. 지오존은 System > Localisation > Geo Zones에서 관리합니다. Ignore shipping zones가 켜져 있으면 지오존은 확인하지 않습니다.

Ignore shipping zones: 지오존과 관계없이 아래에 나열된 국가에 대해 LP Express를 제공합니다. 이 모드에서는 지오존을 확인하지 않습니다. 꺼져 있으면 국가는 지오존으로 정해집니다. 이 옵션을 권장합니다. 기본값: off.

Countries (without zones): 이 모드의 배송 대상 국가. 이 필드는 Ignore shipping zones가 켜져 있을 때만 사용됩니다. 모든 국가에 배송 방법을 제공하려면 비워 둡니다.

소포 터미널

Terminal list: 터미널의 출처.

LP Express online list: 온라인 목록은 하루에 한 번 내려받습니다. 불러올 수 없으면 마지막으로 내려받은 사본을 사용하고, 그다음으로 아래의 자체 목록을 사용합니다. 이것이 기본값입니다.

Only my own list: 아래에 입력한 터미널만 제공됩니다.

고급

Debug log: 요금 계산 및 터미널 목록의 세부 정보를 storage/logs/vfd_lpex_debug.log.php(OpenCart 4에서는 system/storage/logs/vfd_lpex_debug.log.php)에 기록합니다. 이 파일은 웹에서 읽을 수 없습니다. 터미널 목록을 사용할 수 없거나 터미널이 없는 주문과 같은 오류는 항상 기록됩니다. 고객 데이터는 기록되지 않습니다. 파일이 5 MB에 도달하면 새 로그가 시작됩니다.

Log: 로그의 크기와 최근 항목을 표시합니다. Clear log를 클릭하면 비워집니다.

Remove data on uninstall: 켜져 있으면 확장 기능을 제거할 때 설정, 저장된 터미널 목록, 로그, 완료되지 않은 체크아웃의 터미널이 삭제됩니다. 꺼져 있으면(기본값) 재설치를 위해 설정이 유지됩니다. 주문에 저장된 터미널은 항상 유지됩니다.

가져오기 / 내보내기

Export: Download JSON을 클릭하면 설정을 JSON 파일로 저장합니다.

Import: 이전에 내보낸 JSON을 붙여 넣고 Import를 클릭하면 설정이 복원됩니다. 예를 들어 다른 쇼핑몰에서 사용할 수 있습니다. 값은 일반 저장과 같은 방식으로 검사됩니다.

체크아웃에서의 작동 방식

OpenCart가 배송 방법을 표시할 때, 확장 기능에 LP Express 요금을 요청합니다. Geo zone이 설정되어 있고 주소가 그 범위 밖이면 LP Express는 제공되지 않습니다. Ignore shipping zones를 사용하면 지오존은 확인하지 않습니다. 이때 LP Express는 나열된 국가에만 제공됩니다(목록이 비어 있으면 모든 국가). Requires Shipping이 Yes로 설정된 상품만 계산에 포함됩니다. 다른 상품은 무게를 더하지 않으며 장바구니 합계에도 포함되지 않습니다. 장바구니 합계는 쿠폰 할인 후, 세금 적용 전의 이 상품들의 가격입니다. 기프트 카드, 적립 포인트, 쇼핑몰 적립금은 고려되지 않습니다.

확장 기능은 장바구니 무게와 최소 장바구니 합계를 확인합니다. 무료 배송이 적용되면 요금은 0입니다. 그렇지 않으면 요금은 국가의 행(또는 * 행)에서 가져옵니다. 무게 열이 있으면 그것을, 없으면 기본 요금을, 그것도 없으면 대체 비용을 사용합니다. 요금이 없거나 사용 가능한 소포 터미널이 없으면 배송 방법이 숨겨지므로, 고객이 완료할 수 없는 체크아웃을 보게 되는 일은 없습니다.

요금과 금액은 쇼핑몰의 기본 통화입니다. 요금은 소수점 자릿수에 맞춰 반올림되며, 선택한 Tax class의 세금을 포함하여 고객의 통화로 표시됩니다.

온라인 터미널 목록은 24시간 동안 캐시됩니다. 다운로드에 실패하면 15분 동안 기억되므로, 체크아웃이 새로 고침할 때마다 목록을 기다리지 않습니다. 다운로드 제한 시간은 10초입니다. 목록에서 활성 상태인 터미널만 제공됩니다. 도시가 없는 터미널은 Other 아래에 나열됩니다.

OpenCart 4에서는 고객이 체크아웃 페이지의 배송 방법 블록에서 Choose를 클릭하고 Shipping method options 창에서 LP Express를 선택합니다. 요금은 OpenCart 3과 같습니다.

이 확장 기능은 LP Express나 Unisend의 요금을 조회하지 않으며, 배송 건을 생성하거나, 송장을 인쇄하거나, 택배 기사를 호출하거나, 소포를 추적하지 않습니다. 소포는 Unisend 계정("Mano siuntos")에서 생성하십시오. 택배 기사가 문 앞까지 배송하는 서비스는 이 배송 방법에 포함되지 않습니다.

수령 장소

고객이 배송 방법 단계에서 LP Express를 선택하면, 그 아래에 두 개의 목록이 있는 LP Express parcel terminal 블록이 나타납니다: -- Select city --와 -- Select parcel terminal --. 터미널 목록은 LP Express를 선택했을 때만 불러옵니다. 배송 주소의 도시가 목록의 도시와 일치하면 미리 선택됩니다. 각 터미널은 이름, 주소, 우편번호와 함께 표시됩니다. 선택 내용은 즉시 체크아웃용으로 저장되므로, 체크아웃이 새로 고침되어도 사라지지 않습니다.

터미널 선택은 필수입니다. 고객이 Continue를 클릭하면 서버가 목록과 대조하여 터미널을 다시 확인합니다. 터미널을 선택하지 않으면 체크아웃에 Please select an LP Express parcel terminal.이 표시됩니다. 위조되었거나 오래된 터미널 ID는 The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.라는 메시지와 함께 거부됩니다. 터미널을 전혀 불러올 수 없으면 고객에게 The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.가 표시됩니다.

OpenCart 4에서는 고객이 LP Express를 선택하면 Shipping method options 창의 LP Express 옵션 아래에 두 개의 목록이 있는 LP Express parcel terminal 블록이 나타납니다. 창의 Continue 버튼은 유효한 터미널을 선택하지 않으면 진행되지 않으며, 같은 메시지가 표시됩니다.

터미널 ID, 이름, 도시는 주문과 함께 저장됩니다. 관리자 주문 페이지(Sales > Orders, 주문 정보)의 LP Express parcel terminal 패널에는 도시, 터미널, 그리고 해당 Terminal ID가 표시됩니다. 주문의 배송 방법에는 방법 제목, 콜론, 도시, 터미널이 표시되므로(예: LP Express parcel terminal: Kaunas, …), 고객의 주문 상세 정보, 주문 이메일, 청구서에 나타납니다. 주문에 터미널이 없으면 관리자 주문 페이지에 No parcel terminal was chosen for this order.가 표시됩니다. 확장 기능이 비활성화된 상태에서 접수된 주문에도 이 패널이 표시됩니다. OpenCart 4에서는 이 패널이 History 위에 표시됩니다. OpenCart 4는 체크아웃용 주문을 하나만 유지하고, 고객이 다시 확인할 때마다 그 주문을 갱신하며, 주문의 터미널도 함께 갱신됩니다. 고객이 그 주문을 다른 배송 방법으로 바꾸면 해당 터미널은 제거됩니다.

라이선스 키

이 확장 기능은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. License — VibeFox LP Express 라이선스 블록은 Extensions > Extensions > Shipping > VibeFox LP Express > Edit 페이지에서 설정 위에 있는 첫 번째 블록입니다. 키를 License key에 붙여 넣고 Activate를 클릭하십시오. 그 뒤 블록에는 마스킹된 키, 상태(예: 라이선스가 유효한 날짜와 도메인), 그리고 Check now(상태 다시 확인), Change key(다른 키 입력), Remove key(이 쇼핑몰에서 키 제거) 버튼이 표시됩니다. 그 아래에는 Product: opencart-shipping-lp-express 줄과 vibefox.net 계정을 여는 Manage licenses and domains in your account 링크가 있습니다. 이 확장 기능의 Modify 권한이 있는 관리자 사용자만 키를 변경할 수 있습니다. 블록의 텍스트는 관리자 언어를 따릅니다(영어와 러시아어 포함).

키가 허용되지 않으면 블록에 이유가 표시됩니다. 예: Key not found, This key belongs to another product, Domain limit reached, 또는 날짜가 붙은 License expired on. 쇼핑몰 주소를 바꾼 후, 또는 계정에서 도메인 자리를 비운 후에는 Check now를 클릭하십시오. 라이선스 서버에 연결할 수 없으면 확장 기능은 마지막으로 확인된 상태로 계속 작동합니다.

키 하나는 도메인 하나에서 작동합니다. 도메인은 OpenCart 설정의 쇼핑몰 주소입니다. 쇼핑몰에서 키를 제거해도 도메인 자리는 비워지지 않습니다. vibefox.net 계정에서 자리를 비우십시오.

활성 키가 없으면 LP Express 배송 방법은 체크아웃에서 고객에게 표시되지 않고 요금도 계산되지 않습니다. 같은 브라우저에서 관리자 화면에 로그인한 관리자 사용자는 쇼핑몰에서 여전히 이 방법을 (unlicensed — visible to admins only) 표시와 함께 볼 수 있으므로, 키를 구매하기 전에 확장 기능을 설정하고 테스트할 수 있습니다. OpenCart 4에서는 이 미리보기를 사용할 수 없습니다. 쇼핑몰이 관리자 로그인을 인식하지 못하므로, 활성 키가 없으면 이 방법은 모든 사람에게 숨겨집니다. Edit 페이지를 한 번 연 뒤에는 관리자 Dashboard에 알림이 나타납니다. ×로 닫으면 7일 동안 숨겨집니다. 기존 주문은 영향을 받지 않습니다.

라이선스가 만료되어도 확장 기능은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 관리자 Dashboard 또는 Edit 페이지를 열면 상태가 자동으로 다시 확인됩니다. 키를 입력한 뒤 처음 14일 동안은 하루에 한 번, 그 후에는 일주일에 한 번입니다. cron 작업은 필요하지 않습니다. 확장 기능을 제거하면 라이선스 키와 라이선스 상태는 항상 삭제됩니다.

문제 해결

체크아웃에 LP Express가 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지 확인하십시오. Geo zone을 확인하십시오(또는 Ignore shipping zones가 켜져 있고 해당 국가가 허용되어 있는지 확인하십시오). 확장 기능 페이지를 열면 가격이 설정되지 않았거나 사용 가능한 소포 터미널이 없는 경우 경고에서 그 이유를 설명합니다. 무게 제한과 Minimum cart total, 그리고 상품의 Requires Shipping이 Yes로 설정되어 있는지도 확인하십시오. Debug log가 켜져 있으면 확장 기능 페이지의 Log 필드에 배송 방법이 숨겨진 이유가 표시됩니다.

소포 터미널이 없음: 온라인 목록을 불러오지 못했고, 저장된 사본이나 자체 목록도 없습니다. 확장 기능은 15분마다 다시 시도합니다. Own terminal list에 자체 목록을 입력하거나 Only my own list를 선택하십시오.

터미널 목록이 오래됨: 확장 기능 페이지에서 Save를 클릭하십시오. 이렇게 하면 터미널 목록이 다시 불러와집니다. 자체 목록을 사용하는 경우에는 행을 직접 업데이트하십시오.

고객이 계속 진행할 수 없음: 소포 터미널을 선택해야 합니다. 고객에게 터미널 목록을 일시적으로 사용할 수 없다는 메시지가 보이면 지금은 사용 가능한 터미널이 없는 것입니다. 자체 목록을 추가하십시오.

터미널 선택기가 나타나지 않음: 선택기는 OpenCart 표준 체크아웃의 배송 방법 단계(OpenCart 4에서는 Shipping method options 창)에 추가되며, 기본 테마로 테스트되었습니다. 많이 수정된 테마나 타사 체크아웃 확장 기능에서는 표시되지 않을 수 있습니다.

요금의 통화: 쇼핑몰의 기본 통화입니다. 다른 통화로 결제하는 고객에게는 OpenCart 환율로 환산된 요금이 표시됩니다.

페이지에 "Warning: You do not have permission to modify VibeFox LP Express!"가 표시됨: 관리자 사용자 그룹은 설정을 보기만 할 수 있습니다. System > Users > User Groups에서 해당 그룹에 extension/shipping/vfd_lp_express(OpenCart 3) 또는 extension/vfd_lp_express/shipping/vfd_lp_express(OpenCart 4)의 수정 권한을 부여하십시오.

개발자용: 터미널 목록 주소는 vfd_lpex_feed_url 설정(테스트용)으로 바꿀 수 있습니다. 이 설정은 설정 페이지에 입력란이 없습니다.

제거

Extensions > Extensions로 이동하여 유형으로 Shipping을 선택한 다음, VibeFox LP Express 옆의 Uninstall(빨간색 − 버튼)을 클릭하십시오. 이 확장 기능의 라이선스 키와 라이선스 상태는 항상 제거됩니다. OpenCart는 항상 Enable/Disable, Sort order, Tax class, Geo zone을 초기화합니다. 확장 기능의 이벤트는 항상 제거되며, 캐시된 터미널 목록도 삭제됩니다. Remove data on uninstall이 켜져 있으면 설정, 로그, 저장된 터미널 목록 사본, 완료되지 않은 체크아웃의 터미널도 함께 제거됩니다. 꺼져 있으면 나머지 설정과 저장된 사본이 유지되며, 확장 기능을 다시 설치할 때 다시 사용됩니다. 주문에 저장된 터미널은 절대 삭제되지 않으며, 기존 주문은 배송 방법에 그 터미널을 계속 보관합니다.

OpenCart 4에서 확장 기능의 파일까지 제거하려면, 제거한 뒤 Extensions > Installer로 이동하여 설치된 확장 기능 목록에서 VibeFox LP Express 옆의 Uninstall(주황색 − 버튼)을 클릭한 다음, 업로드한 패키지를 삭제하려면 Delete(빨간색 휴지통 버튼)를 클릭하십시오.

LP Express는 각 소유자의 상표입니다. 이 확장 기능은 LP Express와 제휴하거나 LP Express의 승인을 받은 것이 아닙니다.