VibeFox GLS ParcelShop for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降。インストールされて有効になっている必要があります。WooCommerce がない場合、本プラグインは有効化できません。
PHP: 8.0 以降。
GLS: 本プラグインは GLS のアカウントや API キーを使用せず、必要ともしません。ParcelShop マップは公開されています。選択した ParcelShop へ荷物を配送するには、GLS との契約が必要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_gls_parcelshop フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop。または、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 名称と料金を設定します: Country prices の行を少なくとも 1 つ（例: * Default）、または Fallback cost を設定します（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、VibeFox GLS ParcelShop を配送ゾーンに追加するか、Ignore shipping zones をオンにします。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop。設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加すると、ゾーンのウィンドウには次の 1 つの項目だけが表示されます:
Title (zone): そのゾーンで購入者に表示される配送方法の名称。空欄のままにすると、全体の Name が使われます。
設定ページの上部に表示される警告は、設定上の問題を示します。たとえば、料金が 1 つも設定されていない場合や、選択した国がどれも GLS マップの対象外の場合です。無効な数値は、メッセージとともに受け付けられず、以前の値が保持されます。
一般
このセクションには、GLS マップの対象国が表示されます。それ以外の配送先国では、この配送方法は提供されません。
Enable/Disable: この配送方法をすべてのゾーンでまとめてオンまたはオフにします。初期値: オン。
Name: 購入者に表示される配送方法の名称。ゾーンごとに独自の Title で上書きできます。初期値: GLS ParcelShop。
Tax status: Taxable は配送料に WooCommerce の税を加算し、None は加算しません。初期値: Taxable。
料金
料金はストアの通貨で入力します。小数点はカンマまたはピリオドを使用できます（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: カート小計（割引後、税抜き）がこの金額に達した場合にのみ配送方法を提供します。最低金額がない場合は空欄のままにします。
Excluded shipping classes: カートに、これらの WooCommerce 配送クラスのいずれかに属する商品が含まれている場合、配送方法を非表示にします。
Ignore shipping zones: オンにすると、対応する配送ゾーンに追加されていない場合でも、下で選択した国に対して配送方法が提供されます。オフの場合は、追加されたゾーンでのみ提供されます。初期値: オフ。
Countries (ignore zones mode): このモードでの配送先国。空欄のままにすると、GLS マップのすべての国が使われます。GLS マップの対象外の国はスキップされます。このフィールドは Ignore shipping zones がオンの場合にのみ使われます。
詳細設定
Debug log: 料金の計算と ParcelShop の選択内容を WooCommerce > Status > Logs に記録します（ソース: vfd-gls-parcelshop）。購入者の個人データは記録されません。作業が終わったらログをオフにしてください。
Remove data on uninstall: オンの場合、プラグインを削除すると、この配送方法の設定とゾーンのインスタンスが削除されます。プラグインを無効化しても、何も削除されません。注文に保存された ParcelShop は常に保持されます。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce は料金をプラグインに問い合わせます。プラグインはまず条件を確認します。配送先の国が GLS マップの対象であるか、カートの重量、カート最低小計、除外される配送クラスです。カート小計が Free shipping from に達していれば、配送は無料です。そうでない場合は、その国の行（または * Default 行）と重量列から料金が取得されるか、Fallback cost から取得されます。料金が見つからない場合、配送方法は非表示になります。
購入者が GLS ParcelShop を選択すると、配送方法の下に Select GLS ParcelShop ボタンが表示されます。ボタンをクリックすると、配送先の国の GLS ParcelShop 公式マップが開きます。ParcelShop を選ぶと、その名称と住所が表示され、ボタンは Change ParcelShop に変わります。選択内容は購入者のセッションに保存されるため、チェックアウトの更新やページの再読み込み後も保持されます。
注文を確定すると、プラグインは ParcelShop が選択されているか、配送先の国に含まれているかを確認します。そうでない場合、購入者には GLS ParcelShop を選択してください。 または 選択された GLS ParcelShop は配送先の国にありません。ParcelShop を選び直してください。 と表示され、注文は確定されません。GLS マップのスクリプトを読み込めない場合、購入者にはページを再読み込みするか、別の配送方法を選ぶよう求めるメッセージが表示されます。
GLS マップは購入者のブラウザで動作します。チェックアウトページでは、プラグインが map.gls-croatia.com から GLS マップのスクリプトを読み込み、マップは GLS から ParcelShop のデータとマップのタイルを読み込みます。GLS には、訪問者の通常のリクエストデータ（IP アドレス、ブラウザ）が届きます。貴店のサーバーから GLS へ送信されるデータはありません。
この配送方法は、クラシックチェックアウトとカートブロック、チェックアウトブロックで動作します。WooCommerce の高性能注文保存機能（HPOS）に対応しています。
プラグインは GLS のリアルタイム料金を取得せず、GLS の荷物の作成、ラベルの印刷、荷物の追跡も行いません。貴店のサーバーには ParcelShop の一覧がないため、ParcelShop ID を GLS に照合して検証することはできません。注文の ParcelShop ID は、いつもの方法（MyGLS、GLS のソフトウェア、または別のプラグイン）で GLS に渡してください。
受け取り場所
選択された ParcelShop は、ID、名称と住所、国とともに注文に保存されます。
管理画面の注文ページ: ParcelShop の名称と住所が、ParcelShop ID と国とともに配送先住所の下に表示されます。GLS ParcelShop の注文に ParcelShop がない場合、画面には この注文では ParcelShop が選択されていません。 と表示されます。
購入者のページ: ParcelShop は、お礼ページと、購入者アカウントの注文表示ページに表示されます。
メール: ParcelShop は注文メールに追加されます（HTML とプレーンテキストの両方）。ストア管理者宛てのメールには、ParcelShop ID も含まれます。
開発者は、注文のメタデータ _vfd_glps_parcelshop_id、_vfd_glps_parcelshop_name、_vfd_glps_parcelshop_country から ParcelShop の情報を読み取れます。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop のページ上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ライセンスの有効期限日や貴社のドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、GLS ParcelShop はチェックアウトで購入者に表示されません。ログイン中のストア管理者には、（未ライセンス — 管理者のみに表示）と表示された状態で表示されるため、キーを購入する前にプラグインの設定とテストができます。プラグインページと WooCommerce のページには、注意を促す表示が出ます。既存の注文には影響しません。
ライセンスの有効期限が切れた後も、プラグインは動作を続けます。ただし、アップデートとサポートを受けるには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに GLS ParcelShop が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、購入者の国のゾーンに配送方法が追加されていること（または Ignore shipping zones がオンで、その国が許可されていること）を確認してください。配送先の国が GLS マップの対象国であり、料金が設定されていること（国の行、* Default 行、または Fallback cost）を確認してください。重量の上限、Minimum cart subtotal、Excluded shipping classes を確認してください。Debug log をオンにすると、WooCommerce > Status > Logs で理由を確認できます。
マップが開かない: GLS のスクリプトが、広告やプライバシーのブロッカー、コンテンツセキュリティポリシー、または GLS の障害によってブロックされている場合、購入者には「GLS ParcelShop マップを読み込めませんでした...」と表示されます。コンテンツセキュリティポリシーで map.gls-croatia.com を許可してください。
ある国で誤って配送が無料になる: Country prices のその国の行を確認してください。Price と重量列がすべて 0 の行は、無料配送になります。
表または項目が保存されない: 値が有効な数値ではありません。ページ上部のメッセージに、該当する値が表示されます。小数点として、カンマまたはピリオドを使った数字を入力してください。
開発者向けフィルター: vfd_glps_map_countries は GLS マップの国リストを変更し、vfd_glps_widget_url は GLS マップのスクリプトの URL を変更します。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、古いキャッシュやバージョン 1.0 のログファイルとともに、常に削除されます。この配送方法の設定とゾーンのインスタンスは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後日再インストールできるように残されます。注文に保存された ParcelShop は常に保持され、既存の注文は配送の明細も保持されます。
GLS は、それぞれの所有者の商標です。本プラグインは GLS と提携しておらず、GLS の承認も受けていません。