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 で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

ダウンロードは、両方の OpenCart バージョン向けのパッケージを含む 1 つの 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. 料金表に入力します（少なくとも 1 行。最初に追加する行はリトアニアです）。または予備の費用を入力します。ページ上部の荷物ターミナルに関するステータス行を確認し、オンライン一覧が利用できない場合は独自のターミナル一覧を追加します。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 と同じように入力します。設定ページとそのフィールドは両バージョンで同じです。

インストール時に、本拡張機能は 2 つの小さなテーブル（選択されたターミナルとキャッシュされたターミナル一覧）を作成し、チェックアウトと注文ページ用の OpenCart イベントを登録します。Enable/Disable をオンにして保存するまで、この配送方法はオフのままです。アンインストール後に再インストールした場合は、保持されていた設定が再び使用されます。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox LP Express > Edit。セクションは左側に並んでいます。下部にある 1 つの 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: 配送先の国ごとに 1 行。Add country をクリックすると行が追加され、削除ボタンで行を削除できます。独自の行がない国には * Any other country を選択します。各行には Base price と重量列があります。XS は 1 kg まで、S は 2 kg まで、M は 3 kg まで、L は 5 kg まで、XL は 5 kg を超える場合です。重量はカートの重量、または Per item の場合は 1 商品の重量です。空の列はその行の基本料金を使用します。0 は無料を意味します。料金が 1 つもない行は保存されません。

Fallback cost: 配送先の国について料金表に行（または料金）がない場合に使用されます。その国で配送方法を非表示にするには空欄のままにします。

Calculation: 料金の計算方法。

Per order (tier by total cart weight): カート全体に対して 1 つの料金を適用します。カートの合計重量に応じて重量列が選ばれます。これが既定値です。

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: オンライン一覧は 1 日 1 回ダウンロードされます。読み込めない場合は、最後にダウンロードされたコピーが使用され、その後に下の独自の一覧が使用されます。これが既定値です。

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 のブロックが表示され、2 つのリストが含まれます：-- 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 オプションの下に、2 つのリストを含む 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 はチェックアウト用の注文を 1 つだけ保持し、購入者が再確認するたびにそれを更新します。注文のターミナルもそれに合わせて更新されます。購入者がその注文を別の配送方法に切り替えた場合、そのターミナルは削除されます。

ライセンスキー

本拡張機能は、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 をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認できたステータスで動作を続けます。

1 つのキーは 1 つのドメインで使用できます。ドメインとは、OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、LP Express の配送方法はチェックアウトで購入者に表示されず、料金も計算されません。同じブラウザで管理画面にログインしている管理者は、ストア内で引き続きこの方法を (unlicensed — visible to admins only) の表示付きで見ることができるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアは管理者のログインを認識しないため、有効なキーがない場合、この方法はすべての人に対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文は影響を受けません。

ライセンスの期限が切れても拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。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 との提携や承認を受けたものではありません。