VibeFox GLS ParcelShop for OpenCart — ヘルプ

要件

OpenCart：3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）。デフォルトテーマとワンページチェックアウトを使用します。

PHP：8.0 以降。

GLS：本拡張機能は GLS アカウントや API キーを使用せず、必要ともしません。ParcelShop マップは公開されています。選択した ParcelShop へ荷物を発送するには、GLS との契約が必要です。

コンテンツセキュリティポリシー：店舗でコンテンツセキュリティポリシーを送信している場合は、GLS マップのスクリプトの読み込み元である map.gls-croatia.com を許可してください。

VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

ダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。このファイルには README.txt、OpenCart 3 用のパッケージ vfd_gls_parcelshop-oc3-(version).ocmod.zip、OpenCart 4 用のパッケージ vfd_gls_parcelshop.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に進み、Upload をクリックして、ファイル vfd_gls_parcelshop-oc3-(version).ocmod.zip を選択します。本拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions に進み、拡張機能の種類で Shipping を選択します。VibeFox GLS ParcelShop を見つけて、Install（緑色の + ボタン）をクリックします。

3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。

4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（License key を参照）。

5. 料金を設定します。少なくとも 1 つの Country prices の行（例：* Default）か、Fallback cost（設定の項を参照）を入力します。Enable/Disable をオンにして、Save をクリックします。

OpenCart 4

1. 管理画面で Extensions > Installer に進み、Upload をクリックして、ファイル vfd_gls_parcelshop.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。

2. 同じページのインストール済み拡張機能の一覧にパッケージが表示されます。その横の Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に進み、拡張機能の種類で Shipping を選択します。VibeFox GLS ParcelShop を見つけて、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。

4. ライセンスキーと設定は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとそのフィールドは両方のバージョンで同じです。

インストール後は、Enable/Disable をオンにして保存するまで、この配送方法はオフのままです。拡張機能をアンインストールした後に再インストールすると、保持されていた設定が再び使用されます。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit。セクションは左側に一覧表示されます。ページ下部の Save ボタン 1 つで、ページを再読み込みせずにページ全体を保存できます。この拡張機能の変更権限を持つ管理者ユーザーのみが設定を保存できます。

ページ上部、および保存のたびに再表示される警告は、設定の問題を示します：料金が 1 つも設定されていない、選択した Countries (ignore zones mode) の一部またはすべてが GLS マップの対象外である、またはストアの重量単位が拡張機能で認識されず、kg の重量クラスがない（System > Localisation > Weight Classes で追加してください）。無効な値や負の数値は、フィールド名を示すメッセージとともに拒否されます。例：Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. 他のフィールドは保存されます。無効な Name、並び順、税クラス、ジオゾーンも同様に拒否されます。

一般

このセクションには、GLS マップの対象国が一覧表示されています：オーストリア、ベルギー、ブルガリア、クロアチア、チェコ、デンマーク、フィンランド、フランス、ドイツ、ギリシャ、ハンガリー、イタリア、ルクセンブルク、オランダ、ポーランド、ポルトガル、ルーマニア、セルビア、スロバキア、スロベニア、スペイン。その他の配送先国では、この配送方法は提供されません。

Enable/Disable：チェックアウトで GLS ParcelShop を表示するかどうかを切り替えます。初期値：オフ。

Name：購入者に表示される配送方法名。初期値：GLS ParcelShop。必須、64 文字以内、文字 < > ; = # { } は使用できません。

Tax status：None (shipping is not taxed)、または配送料に課税される場合に適用する税クラス。

Sort order：チェックアウトで配送方法の中に表示される順序。整数です。

料金

料金はストアの初期通貨で、税抜きで入力します。小数点はカンマまたはピリオドを使用できます（4,99 または 4.99）。購入者には、その通貨で料金が表示されます。

Calculation type：料金の適用方法。

Country prices：配送先の国ごとに 1 行ある表です。Add country をクリックすると行を追加できます。各行には Country、Price、5 つの重量列があります：XS（1 kg まで）、S（1～2 kg）、M（2～3 kg）、L（3～5 kg）、XL（5 kg 超）。カートの重量に該当する列が使われます。0 のままの重量列は Price 列を使用します。* Default 行は、独自の行がない国に使用されます。すべての料金が 0 の行は送料無料になるため、保存する前に国を選び、料金を入力してください。表内の値が 0 以上の有効な数値でない場合、表全体は保存されず、メッセージに誤った値が表示されます。

Fallback cost：表に配送先国の行がなく、* Default 行もない場合に使用される料金。この場合に配送方法を非表示にするには、空欄のままにします。

Free shipping from：GLS ParcelShop への配送が無料になるカート小計（割引後、税抜き）。配送が無料になることがない場合は、空欄のままにします。

利用条件

Minimum weight (kg)：カートの重量がこの値未満の場合、配送方法を非表示にします。重量は商品の重量クラスから換算されます。空欄または 0 は制限なしを意味します。

Maximum weight (kg)：カートの重量がこの値を超える場合、配送方法を非表示にします。初期値：20。GLS ParcelShop は通常 20 kg までの荷物を受け付けるため、GLS の契約内容をご確認ください。空欄または 0 は制限なしを意味します。最小値が最大値より大きい場合、両方の重量はメッセージとともに拒否され、以前の値が保持されます。

Minimum cart subtotal：カート小計（割引後、税抜き）がこの金額に達した場合にのみ、配送方法を提供します。最低額を設けない場合は、空欄のままにします。

Geo zone：この地域の住所に対してのみ配送方法を提供します。All zones は制限なしを意味します。Ignore shipping zones がオンの場合は使用されません。ジオゾーンは System > Localisation > Geo Zones で管理されます。

Ignore shipping zones：オンの場合、ジオゾーンに関係なく、下で選んだ国に対して配送方法を提供します（リストが空の場合は GLS マップのすべての国）。オフの場合は、上で指定したジオゾーンでのみ提供されます。初期値：オフ。

Countries (ignore zones mode)：このモードでの配送先国。空欄にすると、GLS マップのすべての国を使用します。GLS マップの対象外の国はスキップされます。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。

詳細設定

Debug log：料金の計算と ParcelShop の選択内容を storage/logs/vfd_glps_debug.log.php（OpenCart 4 では system/storage/logs/vfd_glps_debug.log.php）に書き込みます。このファイルはウェブから読み取ることはできません。エラーは常に記録されます。購入者の個人データは記録されません。作業が終わったらログをオフにしてください。ファイルが 5 MB に達すると、vfd_glps_debug.old.log.php に移動され、新しいログが開始されます。

Log：デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。

Remove data on uninstall：オンの場合、拡張機能をアンインストールすると、設定とログが削除されます。オフの場合は、再インストール用にすべてが保持されます。注文に保存された ParcelShop は常に保持されます。

インポート / エクスポート

Export：Download JSON をクリックすると、設定を JSON ファイルとして保存します。

Import：以前にエクスポートした JSON を貼り付けて Import をクリックすると、別のストアなどで設定を復元します。無効な値は報告され、インポートされません。

チェックアウトでの動作

OpenCart が配送方法を表示するとき、拡張機能に GLS ParcelShop の料金を問い合わせます。Geo zone が設定されていて（かつ Ignore shipping zones がオフの）、住所がその外にある場合、配送方法は提供されません。Requires Shipping が Yes に設定された商品のみがカウントされます。それ以外の商品は重量に加算されず、カート小計にも含まれません。小計は、これらの商品のクーポン割引後、税抜きの価格です。その後、拡張機能は条件を確認します：配送先の国が GLS マップの対象であること（このモードがオンの場合は Countries (ignore zones mode) で選択されていること）、カートの重量、およびカートの最小小計。カート小計が Free shipping from に達した場合、配送は無料です。それ以外の場合、料金は国の行（または * Default 行）と重量列から取得されるか、Fallback cost から取得されます。料金が見つからない場合、配送方法は非表示になります。料金はデフォルト通貨の小数点以下の桁数に丸められ、選択した Tax status の税額とともに表示されます。

購入者が GLS ParcelShop を選択すると、配送方法の下に Select GLS ParcelShop ボタンのある GLS ParcelShop のボックスが表示されます。このボタンを押すと、配送先の国の公式 GLS ParcelShop マップが開きます。別の国の ParcelShop は直ちに拒否されます。ParcelShop を選択すると、その名前と住所が表示され、ボタンは Change ParcelShop に変わります。選択内容は購入者のセッションに保持されるため、配送のステップを再読み込みしても残ります。配送先住所が別の国に変更された場合、購入者は ParcelShop を選び直す必要があります。

購入者が配送方法のステップで Continue をクリックすると、拡張機能は ParcelShop が選択されていて、かつ配送先の国にあることを確認します。そうでない場合、購入者には Please select a GLS ParcelShop. または The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. が表示され、そのステップにとどまります。ParcelShop を保存できない場合、購入者には The ParcelShop could not be saved. Please try again. が表示されます。GLS マップのスクリプトを読み込めない場合、購入者には The GLS ParcelShop map could not be loaded. Please reload the page or choose another shipping method. が表示されます。

OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで GLS ParcelShop を選択します。GLS ParcelShop のボックスと Select GLS ParcelShop ボタンが、そのウィンドウ内の配送方法の下に表示され、GLS マップがウィンドウの上に開きます。ウィンドウの Continue ボタンは、有効な ParcelShop がなければ先に進まず、同じメッセージが表示されます。OpenCart 4 は、チェックアウト用の注文を 1 つ保持し、購入者が再度確定するたびに更新します。その際、注文の ParcelShop も一緒に更新されます。

GLS マップは購入者のブラウザで動作します。チェックアウトページでは、拡張機能が map.gls-croatia.com から GLS マップのスクリプトを読み込み、マップは GLS から ParcelShop のデータとマップのタイルを読み込みます。GLS は、訪問者の通常のリクエストデータ（IP アドレス、ブラウザ）を受け取ります。貴店のサーバーから GLS へは何も送信されません。拡張機能のエラーが他の配送方法のチェックアウトを妨げることはなく、ログに記録されます。

本拡張機能は、GLS のリアルタイム料金の取得、GLS 発送の作成、ラベルの印刷、荷物の追跡は行いません。貴店のサーバーには ParcelShop の一覧がないため、ParcelShop ID を GLS に照合して検証することはできません。注文の ParcelShop ID は、いつもの方法（MyGLS、GLS のソフトウェア、またはほかの拡張機能など）で GLS に渡してください。

受け取り拠点

注文が行われると、チェックアウトで選択された ParcelShop が ID、名前と住所、国とともに注文に保存されます。注文が完了すると、選択内容は消去されるため、次のカートは ParcelShop なしで始まります。

Shipping method name：ParcelShop は注文の配送方法名に追加されます。例：GLS ParcelShop: name, address（配送方法名の後に ParcelShop が続く形式）（OpenCart 3 はこの名前のうち最大 128 文字、OpenCart 4 は最大 255 文字を保持します）。そのため、ParcelShop は購入者への注文確認メール、購入者の Order History の注文ページ、および Sales > Orders に表示されます。OpenCart は注文完了ページに配送方法を表示しません。

Admin order page：Sales > Orders で、GLS ParcelShop のパネルに ParcelShop の名前と住所が、ParcelShop ID と国とともに表示されます。ParcelShop がない GLS ParcelShop の注文では、パネルに No ParcelShop was selected for this order. と表示されます。このパネルは ParcelShop を表示するだけで、ここで変更することはできません。

販売者向けメール：ストアに届く新規注文の通知メールには、コメント欄に ParcelShop とその ParcelShop ID が含まれます。

ライセンスキー

本拡張機能は、vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox GLS ParcelShop は、Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit ページの最初のブロックで、設定の上にあります。キーを License key に貼り付けて Activate をクリックします。その後、ブロックにはキーがマスクされた状態で表示され、ステータス（ライセンスの有効期限日や、お使いのドメインなど）と、Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-shipping-gls-parcelshop の行と、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 のアカウントで枠を解放してください。

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

ライセンスの有効期限が切れても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに GLS ParcelShop が表示されない：ライセンスが有効で、Enable/Disable がオンになっていることを確認してください。Geo zone、または Ignore shipping zones と Countries (ignore zones mode) を確認してください。配送先の国が GLS マップの国の 1 つであり、料金（国の行、* Default 行、または Fallback cost）があることを確認してください。重量の制限と Minimum cart subtotal を確認し、商品の Requires Shipping が Yes に設定されていることを確認してください。Debug log をオンにして、Log フィールドで理由を確認してください。

マップが開かない：広告やプライバシーのブロッカー、コンテンツセキュリティポリシー、または GLS の障害によって GLS のスクリプトがブロックされると、購入者には "The GLS ParcelShop map could not be loaded..." と表示されます。コンテンツセキュリティポリシーで map.gls-croatia.com を許可してください。

配送方法の下に ParcelShop のボックスが表示されない：本拡張機能は、OpenCart のデフォルトテーマとそのチェックアウトで検証されました。配送方法のステップを置き換えるテーマやチェックアウトの拡張機能では、ボックスが表示されない場合があります。

ある国の配送が誤って無料になっている：Country prices のその国の行を確認してください。Price とすべての重量列が 0 の行は、送料無料になります。

表またはフィールドが保存されない：値が 0 以上の有効な数値ではありません。ページ上部のメッセージに、該当する値が示されます。小数点の区切りには、カンマまたはピリオドを使用した数字を入力してください。

注文に No ParcelShop was selected for this order と表示される：その注文は、配送先の国の ParcelShop なしで行われました。理由はログに記録されています。購入者に ParcelShop を確認し、手動で GLS に渡してください。

ページに "Warning: You do not have permission to modify VibeFox GLS ParcelShop!" と表示される：管理者のユーザーグループは、設定の閲覧のみが可能な可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_gls_parcelshop（OpenCart 3）または extension/vfd_gls_parcelshop/shipping/vfd_gls_parcelshop（OpenCart 4）の変更権限を付与してください。

開発者向け：GLS マップのスクリプトのアドレスは、設定 vfd_glps_widget_url で置き換えることができます。この設定は設定ページにはフィールドがありません。

アンインストール

Extensions > Extensions に進み、種類 Shipping を選択して、VibeFox GLS ParcelShop の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンス状態は常に削除されます。OpenCart は Enable/Disable、Sort order、Tax status、Geo zone を常にリセットします。拡張機能は、そのイベントを常に削除します。Remove data on uninstall がオンの場合は、その他の設定とデバッグログも削除されます。オフの場合は保持され、拡張機能を再インストールすると再び使用されます。開いているカートで選択された ParcelShop は、期限切れになるまで購入者のセッションに残ります。注文に保存された ParcelShop は常に保持され、既存の注文は配送方法と料金を維持します。

OpenCart 4 では、拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に進み、インストール済み拡張機能の一覧で VibeFox GLS ParcelShop の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱のボタン）をクリックします。

GLS は、各所有者の商標です。本拡張機能は GLS と提携しておらず、GLS の承認も受けていません。