VibeFox The Courier Guy for WooCommerce — ヘルプ
要件
WordPress：5.8 以降。
WooCommerce：7.0 以降。インストールされ、有効化されていること。WooCommerce がない場合、プラグインは有効化されません。
PHP：8.0 以降。
ShipLogic API キー（リアルタイム料金とロッカー用）：The Courier Guy は ShipLogic プラットフォーム上で稼働しています。The Courier Guy の宅配ポータルで、Settings > API Keys から API キーを作成してください（ビジネスアカウント）。キーがない場合は料金表のみが使用され、ロッカー配送は提供できません。
南アフリカへの配送：リアルタイム料金とロッカーは南アフリカの住所のみが対象です。ストアが南アフリカへ配送できるように設定されている必要があります（WooCommerce > Settings > General > Shipping location(s)）。
VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_the_courier_guy フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox The Courier Guy。または、プラグインの一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. ShipLogic の API key を入力します。リアルタイム料金を使用する場合は、発送元住所（番地、市区町村、州、郵便番号）を入力します。ストアの通貨が ZAR でない場合は、ZAR conversion rate も入力します。
6. 料金表、または代替料金（もしくはその両方）を入力します。
7. WooCommerce > Settings > Shipping > Shipping zones で、南アフリカ向けの配送ゾーンに VibeFox The Courier Guy を追加し、Delivery type（courier または TCG locker）を選択します。必要に応じてタイトルも入力します。もう一方の配送タイプを提供する場合は、この方法をもう一度追加します。
設定
主な設定は 1 つのページにまとめられています：WooCommerce > Settings > Shipping > VibeFox The Courier Guy。これらの設定はすべての配送ゾーンに適用されます。ゾーンにこの方法を追加すると、ゾーンのウィンドウに 2 つの項目が表示されます：
Title (zone)：このゾーンでチェックアウトに表示される、この料金の名前です。空欄にすると、全体の Method name が使用されます。
Delivery type (zone)：Courier to the door（既定値）または TCG locker (customer chooses a locker)。両方を提供するには、この方法を 2 回追加します。ロッカーには ShipLogic API キーが必要で、南アフリカでのみ利用できます。
設定を保存するたびに、キャッシュされた料金とロッカーが消去されます。設定の上部には、ストアが南アフリカへ配送しない場合、API キーがない場合、ZAR 換算レートや発送元住所がない場合、料金表と代替料金がどちらもない場合、または直近の ShipLogic リクエストが失敗した場合（日時とエラーを含む）に警告が表示されます。
一般
Enable/Disable：配送ゾーンを含むすべての場所で、この方法をオフにします。
Method name：チェックアウトに表示される名前です。ロッカー配送の場合は「locker」が追加され、例えば「The Courier Guy locker」となります。ゾーンは独自のタイトルで上書きできます。既定値：The Courier Guy。
Tax status：Taxable：リアルタイム料金は VAT 抜きで取得され、WooCommerce が独自に税を追加します。None：リアルタイム料金は VAT 込みで取得されます。
ShipLogic API（リアルタイム料金とロッカー）
API key：The Courier Guy のポータルで取得した ShipLogic API キーです。
Account ID：任意。ShipLogic の数値のアカウント ID です。キーが複数のアカウントにアクセスできる場合にのみ必要です。
リアルタイム料金（南アフリカの住所向け。リアルタイム料金がない場合は料金表が使用されます）
Price source：料金の取得元です。
ZAR conversion rate：ShipLogic は南アフリカ・ランド（ZAR）で見積もります。ストアの通貨が ZAR でない場合は、1 ZAR がストアの通貨でいくらに相当するかを入力してください（例：0.05）。これを入力しないと、リアルタイム料金は使用されず、料金表が適用されます。ストアの通貨が ZAR の場合は空欄にしてください。このレートは自動では更新されません。
発送元住所（リアルタイム料金用）（The Courier Guy が南アフリカで荷物を集荷する住所です。リアルタイム料金には、番地、市区町村、州、郵便番号が必要です）
Sender company：会社名です。
Sender street address：例：12 My Road
Sender suburb：発送元住所の地域名です。
Sender city：発送元住所の市区町村です。
Sender province：一覧から南アフリカの州を選択します。
Sender postal code：発送元住所の郵便番号です。
料金表（ストアの通貨で設定する独自の料金です。Price table only と併用するほか、南アフリカ以外の場合や、リアルタイム料金がない場合に使用されます。小数点はカンマでもピリオドでも入力できます）
Calculation type：料金表にのみ適用されます。リアルタイム料金は常に注文全体に対するものです。
Prices by weight：国の表で、Price 列と重量区分 XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）があります。+ Add row をクリックすると行を追加でき（新しい行は南アフリカから始まります）、× で削除できます。区分が空欄または 0 の場合は、Price 列が使用されます。料金が 0 の場合は送料無料になります。* Any country の行は、独自の行がない国や、料金が入っていない国の行に適用されます。
Fallback cost：リアルタイム料金も料金表の料金もない場合に使用されます。空欄にすると、その場合は方法が非表示になります。
条件
Min weight (kg)：カートの重量がこの値より小さい場合、この方法を非表示にします。0 は制限なしを意味します。
Max weight (kg)：カートの重量がこの値より大きい場合、この方法を非表示にします。既定値：30。0 は制限なしを意味します。
Minimum order amount：カートの小計がこの金額以上の場合にのみ、この方法を表示します。空欄にすると常に表示されます。
Free shipping from：カートの小計がこの金額以上の場合、この方法は送料無料になります。送料無料は、その配送先に料金が設定されている場合にのみ提供されます：リアルタイム料金、料金表の価格、または Fallback cost。料金表または Fallback cost に料金が設定されている場合、料金のために ShipLogic へのリクエストは送信されません。空欄にすると、送料無料は提供されません。
Excluded shipping classes：カートに、指定した WooCommerce の配送クラスの商品が含まれている場合、この方法を非表示にします。
配送ゾーンなしでの利用
Ignore shipping zones：どのゾーンにもこの方法が含まれていない場合でも、下記の国に対してこの方法を提供します。
Delivery type without zones：このモードで使用する courier または TCG locker です。Ignore shipping zones を有効にした場合にのみ使用されます。
Countries：このモードの配送先の国です。空欄にすると、配送可能なすべての国が対象になります。ロッカーは南アフリカでのみ提供されます。
詳細設定
Debug log：デバッグメッセージを WooCommerce > Status > Logs に書き込みます（ソースは vfd-the-courier-guy）。この設定がオフでも、API エラーは常に記録されます。API キーと顧客データは記録されません。
Remove data on uninstall：有効にすると、プラグインを削除したときに、この方法の設定とゾーンごとの料金が削除されます。プラグインを無効化しても、設定が削除されることはありません。注文に保存されたロッカーや追跡情報は保持されます。
チェックアウト時の動作
顧客が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインはまず条件を確認します：カートの重量、最低注文金額、除外する配送クラス。送料無料が適用され、配送先に料金が設定されている場合は、料金 0 でこの方法が表示されます。
Courier to the door：プラグインは、発送元住所から顧客の住所までの最も安いサービスを ShipLogic に問い合わせます。顧客の番地、市区町村、州、郵便番号が先に入力されている必要があります。それまでは料金表の料金が表示されます。
TCG locker：リアルタイム料金は、戸口からロッカーまでの最も安いサービスで、顧客の都市に最も近いロッカーまでの料金です。顧客が選んだロッカーに合わせて再計算されることはありません。
注文全体は 1 つの荷物として見積もられます：合計重量、最長の縦と横、そして積み重ねた高さです。寸法のない商品は 10 cm の立方体として扱われます。ランドの金額は、ストアの通貨に換算されます。サービスレベル（例：ECO）は配送行に保存されます。
ShipLogic へのリクエストは 12 秒でタイムアウトします。料金は 1 時間、ロッカーは 6 時間、失敗は 10 分間キャッシュされるため、API の応答が遅くても、チェックアウトの更新のたびに遅くなることはありません。リアルタイム料金がない場合、料金は料金表から、次に Fallback cost から取得されます。どちらも該当しない場合、この方法は非表示になります。
この方法は、クラシックチェックアウトと、カートおよびチェックアウトのブロックで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。
プラグインは、送り状やラベルの作成、追跡情報の自動更新は行いません。ロッカーの地図はなく、一覧から選択します。リアルタイム料金とロッカーは南アフリカのみが対象です。その他の国は料金表を使用します。ゾーンのインスタンスごとに表示される料金は 1 つだけです（最も安いサービスレベル）。チェックアウトでサービスレベル、保険、オプションを選ぶことはできません。
受け取りポイント
顧客がクラシックチェックアウトまたはブロックチェックアウトで TCG locker の料金を選択すると、その下にロッカーのセレクターが表示されます。配送先住所の都市について ShipLogic が返したロッカーが、近い順に一覧表示されます。顧客は別の都市、地域、郵便番号を入力し、Search をクリックできます。注文を確定する前に、ロッカーを 1 つ選ぶ必要があります。
ロッカーは、ShipLogic の一覧と照合してサーバー側で再度検証されます。ロッカーの名称と提供元は、ブラウザではなく ShipLogic から取得されます。選択内容はチェックアウトの更新後も保持され、住所が変更されるとリセットされます。
ShipLogic に接続できない場合、セレクターにはロッカーを読み込めないことが表示され、ロッカーなしで注文できます。その場合、注文には次のフラグが付きます：「Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer.」（未選択：チェックアウト時に ShipLogic が利用できませんでした。ロッカーは顧客と取り決めてください。）
注文
選択されたロッカー（名称、ID、提供元）は注文に保存されます。管理画面の注文画面、「ご注文ありがとうございます」ページおよび「マイアカウント」の注文ページ、注文メール（HTML とプレーンテキスト）に表示されます。管理者向けメールには、ロッカー ID も表示されます。
管理画面の注文画面では、この方法の注文に The Courier Guy tracking reference 欄があります。The Courier Guy のポータルの参照番号を入力し、Save をクリックしてください。この番号は、顧客の注文ページと、その後に送信されるメールに表示されます。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox The Courier Guy の上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ライセンスの有効期限日やお使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、The Courier Guy はチェックアウトで顧客に表示されません。ログインしている管理者には、(unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前に設定やテストができます。プラグインのページと WooCommerce のページに通知が表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れてもプラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
The Courier Guy がチェックアウトに表示されない：ライセンスが有効か、Enable/Disable がオンか、顧客の国の配送ゾーンにこの方法が追加されているかを確認してください（または Ignore shipping zones がオンで、その国が許可されているか）。重量制限、Minimum order amount、Excluded shipping classes を確認します。料金表または Fallback cost に料金が入っているかを確認します。ロッカーの料金は南アフリカの住所にのみ表示されます。
顧客にロッカーの一覧が表示されない：ロッカーには、API キー、Delivery type が「TCG locker」のゾーン方法、そして南アフリカの配送先住所が必要です。設定ページには、最後の ShipLogic エラーがある場合はそれが表示されます（例：キーが拒否された場合）。
料金が常に料金表の金額になる：設定ページの警告を確認してください。リアルタイム料金には、API キー、発送元住所の全項目、そしてランド以外の通貨を使うストアの場合は ZAR 換算レートが必要です。宅配の場合は、顧客の番地、市区町村、州、郵便番号が入力されている必要があります。ロッカーの場合は、ShipLogic が顧客の都市の近くでロッカーを見つける必要があります。Debug log をオンにして、WooCommerce > Status > Logs を開き、ソース vfd-the-courier-guy を確認してください。
ShipLogic が利用できない：料金表または代替料金が表示されます。ロッカーを指定した注文は、ロッカーなしで行うことができ、注文に印が付きます。
変更後に料金が古いように見える：設定ページを保存してください。キャッシュされた料金とロッカーが消去されます。
ライセンスブロックにエラーが表示される：ブロック内のメッセージに従ってください。例えば、キーが別のドメインで既に使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効化すると、設定は保持され、キャッシュされた料金とロッカーのみが消去されます。削除するには、無効化してから Plugins ページで削除します。このプラグインのライセンスキーとライセンスステータス、キャッシュされた料金とロッカー、最後のエラーは常に削除されます。設定とゾーンごとの料金は、Remove data on uninstall が有効だった場合にのみ削除されます。そうでない場合は、後で再インストールするために残ります。注文に保存されたロッカーと追跡番号は削除されることはなく、既存の注文は配送行をそのまま保持します。
The Courier Guy と ShipLogic は、それぞれの所有者の商標です。本プラグインは The Courier Guy または ShipLogic と提携しておらず、両社による推奨も受けていません。