VibeFox DHL Packstation for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされて有効になっている必要があります。WooCommerce がなければプラグインは有効化できません。
PHP：8.0 以降。
DHL API key：受取場所の一覧は、無料の DHL Location Finder API から取得します。DHL 開発者ポータル（developer.dhl.com）に登録し、アプリを作成して「Location Finder - Unified」API を追加し、アプリの API キーをコピーしてください。この API に DHL の法人契約は不要です。キーがない場合、チェックアウトではこの配送方法が非表示になります。DHL アプリのリクエスト上限にご注意ください。郵便番号または都市を新しく検索するたびに、API リクエストが 1 回消費されます。
VibeFox license key：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_dhl_packstation フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > DHL Packstation。または、Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. DHL API キーを貼り付けて保存し、Test API key をクリックします。受取場所の種類を選び、国ごとの料金を入力します（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、配送ゾーン（例：ドイツ）に DHL Packstation を追加するか、Ignore shipping zones を有効にします。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > DHL Packstation。設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます：
Title (zone)：このゾーンのチェックアウトで表示される、この配送オプションの名前です。空欄にすると、全体の Name が使われます。
設定の上部には、DHL API キーが空の場合や、国別料金の入力形式が正しくない場合の警告が表示されます。設定を保存するたびに、受取場所のキャッシュが消去されます。
一般
Enable/Disable：すべてのゾーンでこの方法を一度に有効または無効にします。
Name：購入者に表示される配送方法の名前です。初期値：DHL Packstation。ゾーンは独自の Title で上書きできます。
Tax status：Taxable は送料に WooCommerce の税金を加算し、None は加算しません。
DHL Location Finder API
DHL API key：developer.dhl.com 上のアプリの API キーです。キーがない場合、チェックアウトではこの方法が非表示になります。
Connection test：Test API key ボタンは、保存済みのキーを使って 53113 Bonn 付近の受取場所を検索し、受取場所のキャッシュを消去します。先に設定を保存してください。見つかった受取場所の数、または DHL がキーを拒否した（401/403）ことを表示します。
受取場所
Location types：購入者が選択できる DHL の受取場所です：Packstation (parcel locker)、Post Office (Postfiliale)、DHL Parcel Shop (Paketshop)。初期値はすべて選択されています。どれも選択されていない場合、この方法は非表示になります。Packstation の場合、購入者は自分の DHL Postnummer を入力する必要があります。
Search radius (meters)：検索した郵便番号または都市の周囲の半径です。初期値：5000。DHL は最大 25000 m まで対応しています。
Max results：1 回の検索で表示する受取場所の最大数です。初期値：20。DHL は最大 50 まで対応しています。
Shipping address：選択した受取場所を注文の配送先住所として使用します。初期値は有効です。住所 1 行目は例えば「Packstation 105」、2 行目は「Postnummer」と番号になり、受取場所の郵便番号と都市も加わります。そのため、注文から印刷したラベルが正しい場所に届きます。Postnummer は _shipping_dhl_postnum としても保存されます。これは公式プラグイン「DHL Shipping Germany for WooCommerce」が読み取るフィールドです。
料金
Country prices：配送先の国ごとの料金です。ストアの通貨で、CC:PRICE の形式で入力し、カンマまたは改行で区切ります。初期値：DE:4.99, AT:5.99。小数点のカンマも使えます（DE:4,99）。
Other countries：Country prices にない配送先の国の料金です。初期値：5.99。空欄にすると、それらの国では方法が非表示になります。
Calculation：Per order は料金を 1 回だけ請求します。Per item (price x quantity) はカート内の商品数を掛けます。
Free shipping from：この送料が無料になるカートの小計です。空欄にすると、無料になることはありません。
利用条件
Min weight (kg)：カートの最小重量です。商品の重量は、ストアの単位から換算されます。0 は制限なしを意味します。
Max weight (kg)：カートの重量がこの値を超えると、方法が非表示になります。初期値：31.5。Packstation は最大 31.5 kg の荷物を受け付けるためです。0 は制限なしを意味します。
Minimum subtotal：カートの小計がこの値以上の場合にのみ、この方法を表示します。空欄にすると、常に表示されます。
Excluded shipping classes：カートに、これらの WooCommerce 配送クラスに属する商品が含まれている場合、この方法は非表示になります。
Ignore shipping zones：対応するゾーンにこの方法が含まれていなくても、下記の国に対してこの方法を提供します。
Countries (ignore zones)：このモードの配送先の国です。空欄にすると、すべての国が対象になります。Ignore shipping zones と一緒に使用される場合にのみ適用されます。
詳細設定
Debug log：API リクエストとチェックアウトの手順を、WooCommerce > Status > Logs に記録します。ソースは vfd-dhl-packstation です。この設定がオフでも、API エラーは常に記録されます。API キー、Postnummer、購入者の住所は、記録されることはありません。
Remove data on uninstall：有効にすると、プラグインを削除したときに、その設定とゾーンの配送方法が削除されます。無効化しても何も削除されません。選択した受取場所は注文に残ります。
チェックアウト時の動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはカートの重量、最低小計、除外される配送クラスを確認し、配送先の国の料金（またはその他の国の料金）を取得します。小計が十分に高い場合は送料無料を適用します。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。
本プラグインは、DHL の配送の作成、ラベルの印刷、荷物の追跡を行いません。DHL のビジネスカスタマーポータル、またはラベルプラグインを使用してください。注文には、Packstation の住所と、想定された形式の Postnummer がすでに含まれています。本プラグインは DHL のリアルタイム料金を計算せず、地図も表示しません。DHL API に接続できない場合、購入者にはメッセージが表示され、API が復旧するまでこの方法は使用できません。Packstation の番号を手動で入力することはできません。
受取場所
購入者が DHL Packstation を選択すると、配送オプションの下に選択欄が表示されます。配送先の郵便番号または都市の近くにある DHL の受取場所が読み込まれます。購入者は別の郵便番号や都市を検索できます。受取場所は種類（Packstation、Post Office、Parcel Shop）ごとにグループ化され、距離順に並べられます。
Packstation の場合、購入者は DHL Postnummer を入力する必要があります。これは、DHL アプリまたは DHL アカウントにある、6〜12 桁の DHL 顧客番号です。その他の受取場所では任意です。受取場所がない場合、または Postnummer が無効な場合、注文はできません。これはサーバー側で確認され、ブロックチェックアウトにも適用されます。
検索結果は 12 時間キャッシュされます。失敗した検索は 10 分間キャッシュされるため、チェックアウトは更新のたびに DHL の応答を待つ必要がありません。API のタイムアウトは 12 秒です。
受取場所（ID、種類、番号、名前、住所）と Postnummer は注文に保存されます。注文画面の配送先住所の下、サンクスページ、My account > Orders、注文メール（HTML とプレーンテキスト）に、DHL pickup location と DHL Postnummer として表示されます。
注文画面で、受取場所の横にある Edit をクリックし、郵便番号または都市で検索して別の受取場所を選択し、Postnummer を変更してから Save location をクリックします。変更のたびに注文メモが追加されます。Shipping address が有効になっている場合、配送先住所も更新されます。表示するにはページを再読み込みしてください。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > DHL Packstation の上部にあります。License key にキーを貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。枠を解放するには、vibefox.net のアカウントで操作してください。
有効なキーがない場合、DHL Packstation はチェックアウトで購入者に表示されません。ログイン中のストア管理者には表示され、(unlicensed — visible to admins only) と表示されます。そのため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作し続けます。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
DHL Packstation がチェックアウトに表示されない：ライセンスが有効か、Enable/Disable が有効か、購入者の国のゾーンにこの方法が追加されているか（または Ignore shipping zones が有効で、その国が許可されているか）を確認してください。DHL API key が入力されているか、少なくとも 1 つの受取場所の種類が選択されているか、配送先の国に料金があるか（または Other countries が設定されているか）、重量・小計・配送クラスのルールによって非表示になっていないかを確認してください。
受取場所が表示されない：Test API key をクリックしてください。DHL がキーを拒否する（401/403）場合は、キーと、アプリに「Location Finder - Unified」API があることを確認してください。Debug log を有効にし、WooCommerce > Status > Logs を開いて、ソースが vfd-dhl-packstation のログを確認してください。DHL アプリのリクエスト上限に達していないかも確認してください。
ある住所の近くに受取場所がない：Search radius (meters) または Max results を増やすか、購入者に別の郵便番号または都市を検索させてください。
ライセンスブロックにエラーが表示される：ブロックのメッセージに従ってください。例えば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作し続けます。
アンインストール
プラグインを無効化しても、すべての設定は保持されます。消去されるのは受取場所のキャッシュだけです。プラグインを削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータス、および受取場所のキャッシュは、常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall が有効だった場合にのみ削除されます。そうでない場合は、後で再インストールするために残ります。選択した受取場所は注文に残り、既存の注文は配送の明細を保持します。
DHL と Packstation は、それぞれの所有者の商標です。本プラグインは DHL と提携しておらず、DHL による承認も受けていません。