VibeFox GLS ParcelShop for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 から 9.x。ParcelShop の選択は Classic と Hummingbird のテーマで動作します。

PHP: 8.0 以降。モジュールは古い PHP バージョンではインストールできません。

GLS: モジュールは GLS のアカウントや API キーを使用せず、必要ともしません。ParcelShop のマップは公開されています。選択した ParcelShop へ荷物を配送するには、GLS との契約が必要です。

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

インストール

1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。

2. アップロードが完了したら Configure をクリックするか、後でモジュール一覧から VibeFox GLS ParcelShop を見つけて Configure をクリックします。

3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（「ライセンスキー」を参照）。

4. 料金を設定します: Country prices の行を少なくとも 1 つ（例: * Default）、または Fallback cost（「設定」を参照）を入力し、Save をクリックします。

インストール時、モジュールは配送日数のテキスト Delivery to a GLS ParcelShop of your choice を付けて GLS ParcelShop 配送業者を作成します。配送業者はすべての顧客グループと、GLS マップ対象国のゾーン（標準的なショップでは通常 Europe と Europe (non-EU)）に割り当てられます。ゾーン、顧客グループ、配送日数のテキスト、ロゴは Shipping > Carriers で変更できます。料金はそこでは設定しないでください。料金は常にモジュールから取得されます。

設定

すべての設定はモジュールのページにあります: Modules > Module Manager > VibeFox GLS ParcelShop > Configure。各セクションには独自の Save ボタンがあり、ページ全体が保存されます。

ページ上部の警告は設定の問題を示します。配送業者が見つからない、ショップの重量単位がモジュールで認識されない（International > Localization の Local units で kg、g、lb、oz のいずれかを設定してください）、料金が設定されていない、または選択した Countries (ignore zones mode) の一部もしくはすべてが GLS マップの対象外である、といった内容です。無効な数値または負の数値は、該当する項目名を示すメッセージとともに拒否され、以前の値が保持されます。他の項目は保存されます。

General

このセクションには GLS マップの対象国が一覧表示されます。対象外の配送先国では配送業者は提供されません。

Enable/Disable: GLS ParcelShop を有効または無効にします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。

Name: 購入者に表示される配送方法の名前（配送業者の名前）。デフォルト: GLS ParcelShop。必須、64 文字以内。

Tax status: 配送業者の税ルール。None は配送料に税をかけないことを意味します。配送料に税をかける場合は税ルールを選択します。

Prices

料金はショップのデフォルト通貨で、税抜きで入力します。小数点はカンマまたはピリオドで入力できます（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 行が使用されます。新しい行は * Default で始まり、すべての列が 0 になります。すべての料金が 0 の行は送料無料になるため、保存前に国を選び、料金を入力してください。テーブル内の値が有効な数値でない場合は、テーブル全体が保存されず、メッセージに誤った値が一覧表示されます。

Fallback cost: テーブルに配送先国の行がなく、* Default 行もない場合に使用される料金。これらの国では配送業者を表示しないよう、空欄のままにします。

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

Availability

Minimum weight (kg): カートの重量がこれより軽い場合、配送業者を非表示にします。重量はショップの重量単位から換算されます。空欄または 0 は制限なしを意味します。

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

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

Ignore shipping zones: 有効にすると、配送業者は無効なゾーンを含むすべてのゾーンに関連付けられ、ゾーンに含まれていなくても下で選択した国に対して提供されます。後から作成されたゾーンも関連付けられます。無効にすると、配送業者は以前のゾーンを取り戻し、そのゾーンでのみ提供されます。デフォルト: 無効。

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

Advanced

Debug log: 配送料の計算と ParcelShop の選択を、モジュールフォルダ内の logs/vfd_glps_debug.log.php に書き込みます。このファイルは Web から開くことはできません。エラーは常に記録されます。購入者の個人データは記録されません。作業が終わったらログを無効にしてください。

Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると内容を消去できます。

Remove data on uninstall: 有効にすると、モジュールをアンインストールしたときに設定、配送業者、ログが削除されます。無効にすると、再インストールに備えてすべてが保持されます。注文に保存された ParcelShop は常に保持されます。

注文手続き時の動作

PrestaShop が配送ステップを表示すると、モジュールに GLS ParcelShop の料金を問い合わせます。対象となるのは実物商品のみです。バーチャル商品は重量に加算されず、カート小計にも含まれません。モジュールはまず条件を確認します: 配送先の国が GLS マップの対象であること（このモードが有効な場合は Countries (ignore zones mode) で選択されていること）、カートの重量、そしてカートの最低小計です。カート小計が Free shipping from に達した場合、配送は無料です。それ以外の場合は、国の行（または * Default 行）と重量列から料金が取得されるか、Fallback cost から取得されます。料金が見つからない場合は、配送業者が非表示になります。

購入者が GLS ParcelShop を選ぶと、配送業者の下に Select GLS ParcelShop ボタンのある GLS ParcelShop のボックスが表示されます。ボタンを押すと、配送先の国に対応する GLS ParcelShop の公式マップが開きます。ParcelShop を選ぶと、その名前と住所が表示され、ボタンは Change ParcelShop に変わります。選択内容はカートに保存されるため、配送ステップが更新されたりページが再読み込みされたりしても保持されます。配送先住所を別の国に変更した場合、購入者は ParcelShop を選び直す必要があります。

購入者が配送ステップで Continue をクリックすると、モジュールは ParcelShop が選択されているかどうか、そしてその 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 マップのスクリプトを読み込めない場合は、ページを再読み込みするか別の配送方法を選ぶようにというメッセージが表示されます。

GLS マップは購入者のブラウザ上で動作します。チェックアウトでは、モジュールが map.gls-croatia.com からマップのスクリプトを読み込み、マップは GLS から ParcelShop のデータとマップのタイルを読み込みます。GLS は訪問者の通常のリクエストデータ（IP アドレス、ブラウザ）を受け取ります。お使いのサーバーから GLS へ送信されるデータはありません。

注文が入った後に Shipping > Carriers で配送業者を編集すると、PrestaShop はそれを配送業者の新しいバージョンとして保存します。モジュールは自動的に新しいバージョンに従います。

モジュールは GLS からリアルタイムの料金を取得せず、GLS の荷物の作成、ラベルの印刷、荷物の追跡も行いません。サーバー上に ParcelShop の一覧はないため、ParcelShop ID を GLS と照合することはできません。注文の ParcelShop ID は、通常の方法で GLS に渡してください（MyGLS、GLS のソフトウェア、または別のモジュール）。

受け取り場所

注文が確定すると、カート内の ParcelShop が注文と一緒に保存されます: その ID、名前と住所、そして国です。カートが変更されても、その後は変わりません。

管理画面の注文ページ: GLS ParcelShop のブロックに、ParcelShop の名前と住所が ParcelShop ID と国とともに表示されます。ParcelShop が設定されていない GLS ParcelShop の注文では、ブロックに No ParcelShop was selected for this order. と表示されます。

購入者のページ: ParcelShop は注文確認ページと、購入者アカウントの注文詳細ページに表示されます。

メール: 購入者に送られる注文確認メールでは、ParcelShop が配送業者の名前に追加されます。販売者宛ての新規注文メール（Mail alerts モジュール）にも ParcelShop ID が含まれます。

ライセンスキー

本モジュールは vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox GLS ParcelShop は、Modules > Module Manager > VibeFox GLS ParcelShop > Configure ページで設定の上にある最初のブロックです。キーを License key に貼り付けて Activate をクリックします。その後、このブロックにはキーがマスクされた状態で表示され、ステータス（例: ライセンスの有効期限日とお使いのドメイン）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）のボタンが表示されます。その下には Product: presta-shipping-gls-parcelshop の行と、vibefox.net のアカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、このモジュールの Configure 権限を持つスタッフのみです。ブロックのテキストはバックオフィスの言語に従います（英語とロシア語を含みます）。

キーが受け付けられない場合、ブロックにその理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または License expired on と日付。ショップのアドレスを変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認されたステータスで動作を続けます。

1 つのキーは 1 つのドメインで使用できます。メインショップのドメインで、マルチストア構成でも同様です。ショップからキーを削除しても、ドメイン枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、GLS ParcelShop の配送業者は注文手続き時に購入者には表示されず、料金も計算されません。PrestaShop のフロントエンドは、バックオフィスにログインしていることを認識しないため、管理者にも配送業者は非表示になります。キーを購入する前にモジュールを設定することはできますが、注文手続きでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。

ライセンスの期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週に 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

注文手続きに GLS ParcelShop が表示されない: ライセンスが有効で、Enable/Disable がオンになっていることを確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループを対象にしていることを確認してください（または Ignore shipping zones をオンにして Countries (ignore zones mode) を確認してください）。配送先の国が GLS マップの対象国のいずれかであり、料金（国の行、* Default 行、または Fallback cost）があることを確認してください。重量制限と Minimum cart subtotal も確認してください。商品ページで商品が特定の配送業者に制限されている場合もあります。Debug log をオンにして、Log の欄で理由を確認してください。

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

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

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

配送業者 GLS ParcelShop が見つからないと表示される: Shipping > Carriers で配送業者が削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。リセットしても既存の配送業者のステータスは保持されます。無効化された配送業者は無効のままです。

注文に ParcelShop がなく、ログにはカートの ParcelShop がすでに別の注文に保存されていると記録されている: 1 つのカートが 2 つの注文になりました。最初の注文が ParcelShop を保持します。2 つ目の注文は手動で GLS に渡してください。

アンインストール

Modules > Module Manager に移動し、VibeFox GLS ParcelShop の横にあるメニューを開いて Uninstall を選択します。ライセンスキーとライセンスステータスは常に削除されます。Remove data on uninstall が有効な場合、配送業者は削除されます（注文は履歴を保持します）。また、設定、ログ、注文のないカートの ParcelShop も削除されます。無効な場合は、配送業者は無効化されるだけで、すべての設定が保持されます。モジュールを再インストールすると、保存されていた配送業者は以前のステータスに戻ります。注文に保存された ParcelShop は常に保持されます。

GLS は、それぞれの所有者の商標です。本モジュールは GLS と提携しておらず、GLS による推奨も受けていません。