VibeFox GIG Logistics for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 5.0 以降。インストールされ、有効であること。WooCommerce がない場合、プラグインは有効化できません。
PHP: 8.0 以降。
GIG Logistics API 認証情報（リアルタイム料金の場合のみ）: リアルタイム料金は GIG Logistics のサードパーティ API を使用します。GIG Logistics は法人のお客様に API ユーザー名（通常はメールアドレス）とパスワードを発行します。GIG Logistics の開発者ページ（giglogistics.com/developer）で申請してください。テスト用の認証情報はテスト API でのみ使用できます。料金表とフォールバック料金だけを使う場合、API 認証情報は不要です。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_gig_logistics フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Shipping > VibeFox GIG Logistics。または、プラグイン一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 料金表またはフォールバック料金（あるいはその両方）を入力します。リアルタイム料金を使う場合は、API のユーザー名とパスワード、集荷先の電話番号、市区町村と州（State）も入力します。ストアの通貨が NGN でない場合は、通貨換算レートも入力します（設定を参照）。
6. WooCommerce > Settings > Shipping > Shipping zones で、ナイジェリア向けの配送ゾーンに VibeFox GIG Logistics を追加するか、Ignore shipping zones を有効にして国を選択します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Shipping > VibeFox GIG Logistics。設定はすべての配送ゾーンに適用されます。ゾーンに配送方法を追加すると、ゾーンのウィンドウには 1 つの項目だけが表示されます：
Title (zone): このゾーンで購入者に表示される名前。空欄にすると、全体の Method title が使われます。
項目の上には、リアルタイム料金を使えない場合に警告が表示されます：API のユーザー名かパスワードのどちらか一方だけが入力されている、Sender phone または集荷先の市区町村と州が未入力である、またはストアの通貨が NGN でなく Currency conversion rate が設定されていない場合です。設定を保存するたびに、キャッシュされた料金と API トークンは消去されます。
General
Enable/Disable: すべてのゾーンで配送方法を一括で有効または無効にします。初期値: 有効。
Method title: カートとチェックアウトに表示される配送方法の名前。初期値: GIG Logistics。ゾーンのタイトルが設定されていれば、それが優先されます。
Tax status: Taxable は料金にストアの配送税を加算し、None は加算しません。GIG の料金に請求したいものがすべて含まれている場合は None を選びます。
GIG Logistics API（リアルタイム料金）（任意）
API 認証情報を入力すると、ナイジェリアの住所ごとに料金を GIG Logistics に問い合わせます。認証情報がない場合、または API が料金を返さない場合は、料金表とフォールバック料金が使われます。
API username: GIG Logistics のサードパーティ API ユーザー名。通常はメールアドレスです。
API password: GIG Logistics のサードパーティ API パスワード。API へのログインにのみ使われ、ログには記録されません。
Test mode: GIG Logistics のテスト（dev）API を使用します。テスト用の認証情報はテスト API でのみ使えます。実際の料金を使うにはオフにします。初期値: オフ。
Currency conversion rate: GIG Logistics は料金を NGN で返します。ストアの通貨が NGN でない場合は、1 NGN がストアの通貨でいくらに当たるかを入力します（1 NGN = ? ストアの通貨、例: 0.0006）。設定がなければ、GIG のリアルタイム料金は使われません。ストアの通貨が NGN であれば、この項目は不要です。小数点区切りとしてピリオドとカンマのどちらも使えます。
集荷（送り主）住所
GIG Logistics がナイジェリアで荷物を集荷する場所です。ストアがナイジェリアにある場合、空欄の番地・市区町村・州には WooCommerce > Settings > General のストア住所が使われます。
Sender name: GIG Logistics に送信される送り主の名前。空欄の場合はサイト名になります。
Sender phone: 電話番号（例: 08030000000）。リアルタイム料金には GIG Logistics が必要とします。
Street address: 集荷先の番地。
City / area: 集荷先の市区町村またはエリア（例: Victoria Island）。リアルタイム料金には必須です。
State: 集荷先住所のナイジェリアの州。初期値ではストアの州が使われます。リアルタイム料金には必須です。
Pickup latitude: 地図上の集荷地点の緯度（任意、例: 6.4281）。GIG Logistics は距離に基づいて料金を計算します。空欄の場合は、住所から座標を検索します。
Pickup longitude: 地図上の集荷地点の経度（任意、例: 3.4219）。
Address lookup: OpenStreetMap（Nominatim）で住所の地図上の座標を検索します。GIG Logistics は集荷先と配送先の座標から料金を計算します。購入者の番地、市区町村、州は nominatim.openstreetmap.org に送信され、結果は 30 日間キャッシュされます。この項目を無効にすると、住所のテキストだけが送信され、GIG Logistics が料金を返さない場合があります。初期値: 有効。
料金表とフォールバック料金
他の国の場合、リアルタイム料金が設定されていない場合、または GIG Logistics が料金を返さない場合に使われます。料金はストアの通貨で入力します。
Country prices: 国ごとの基本料金を設定する表です。Add country をクリックして行を追加し、×印で行を削除します。独自の行がないすべての国には * Any other country を選びます。XS（1 kg まで）、S（2 kg まで）、M（3 kg まで）、L（5 kg まで）、XL（5 kg 超）の列は任意の重量区分料金です。0 より大きい区分料金は、その区分のカートに対して基本料金を置き換えます。料金 0 は送料無料を意味します。空欄の料金セルは 0 として保存されるため、追加した行ごとに基本料金を入力してください。行がない国（* の行がない場合）は、料金表による料金は設定されません。
Fallback cost: GIG Logistics も料金表も料金を返さない場合に使われます。空欄の場合、その状況では配送方法は非表示になります。
Table / fallback price is: Per order は料金を 1 回だけ請求します。Per item (multiplied by the number of items) はカート内の商品数を掛けた料金を請求します。GIG のリアルタイム料金は常に注文全体に対するものです。
条件
Free shipping from: この小計以上のカートで送料が無料になる金額。空欄の場合は、無料になることはありません。
Minimum subtotal: カートの小計がこの金額に達した場合にのみ配送方法を表示します。空欄の場合は、常に表示します。
Min weight (kg): カートの最低重量（kg）。商品の重量はストアの重量単位から換算されます。0 は上限なしを意味します。
Max weight (kg): カートの最大重量（kg）。初期値: 30。0 は上限なしを意味します。
Excluded shipping classes: カートに、ここで指定した WooCommerce の配送クラスの商品が含まれている場合、配送方法を非表示にします。
配送ゾーンを使わない場合の提供条件
Ignore shipping zones: 配送方法がゾーンに追加されていなくても、下記の国に対して提供します。オフの場合、配送方法は追加された配送ゾーンにのみ表示されます。
Countries: このモードの配送先の国。空欄の場合は、配送可能なすべての国が対象になります。Ignore shipping zones を使う場合にのみ使われます。
詳細設定
Debug log: 料金の計算を WooCommerce > Status > Logs に記録します（ソース: vfd-gig-logistics）。ログが無効でも、API のエラーは常に記録されます。パスワード、トークン、購入者の住所は書き込まれません。
Remove data on uninstall: オンにすると、プラグインを削除したときに、その設定、ゾーンの配送方法、キャッシュが削除されます。プラグインを無効化しても、何も削除されません。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは最初に条件を確認します：配送先の国、カートの重量、最低小計、除外する配送クラス。小計が Free shipping from に達した場合、配送方法は料金 0 で表示されますが、その国に料金がある場合のみです：Country prices の行、Fallback cost、またはリアルタイムの GIG Logistics 料金のいずれかです。GIG Logistics への問い合わせは、料金表とフォールバック料金が料金を返さない場合にのみ行われます。
その後、料金は料金を返す最初のソースから取得されます。まず、API 認証情報が入力されている、住所がナイジェリアにある、購入者が市区町村または州を入力している、集荷先の電話番号、市区町村、州が設定されている、そして NGN 以外のストアの場合は換算レートが設定されている場合、リアルタイムの GIG Logistics 料金を使います。プラグインは GIG Logistics API にログインし、集荷先と配送先の住所と座標、そしてカート内の商品の名称、数量、重量、価格を送信します。重量のない商品は 1 kg として送信されます。料金は bike 配送で問い合わせます。次に Country prices の料金表。3 番目が Fallback cost です。どのソースも料金を返さない場合、そのカートでは配送方法は非表示になります。
GIG からの各応答は 1 時間キャッシュされるため、同じカートで新たなリクエストが発生することはありません。失敗したリクエストやログインは 10 分間キャッシュされ、チェックアウトの更新のたびに GIG Logistics を待つことがないようにします。ログイン トークンは 30 分間保持され、GIG に拒否された場合は自動的に更新されます。API のタイムアウトは 10 秒、住所検索のタイムアウトは 5 秒です。
GIG Logistics がエラーまたは 0 の料金を返した場合でも、購入者にエラーは表示されません。料金表またはフォールバック料金が使われ、エラーはログに記録されます。
この配送方法は、クラシックチェックアウトと、カートとチェックアウトのブロックで動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。
本プラグインが行うのは料金の計算だけです。GIG Logistics の出荷、送り状、ラベルは作成せず、集荷の予約、荷物の追跡、購入者によるサービスセンターの選択も行いません。注文は通常どおり、貴店の GIG Logistics アカウントから出荷されます。リアルタイム料金は、ナイジェリアの住所に対してのみ問い合わせます。その他の国では、料金表をご利用ください。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox GIG Logistics の上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ライセンスの有効期限日やドメインなどのステータスが表示されます。ステータスを再確認するには Check now、別のキーを入力するには Change key、このサイトからキーを削除するには Remove key を使用します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、GIG Logistics は購入者のチェックアウトに表示されません。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示されたうえで表示されるため、キーを購入する前にプラグインの設定と動作確認ができます。プラグインのページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスが期限切れになっても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
GIG Logistics がチェックアウトに表示されない: ライセンスが有効か、Enable/Disable が有効か、配送方法が購入者の国のゾーンに追加されているか（または Ignore shipping zones が有効で、その国が許可されているか）を確認してください。重量制限、Minimum subtotal、Excluded shipping classes も確認します。料金表（その国または *）または Fallback cost が、その国の料金を返すかを確認してください。
料金が GIG Logistics ではなく料金表から来ている: リアルタイム料金には、API のユーザー名とパスワード、Sender phone、集荷先の市区町村と州、市区町村または州を含むナイジェリアの配送先住所が必要です。さらに、NGN 以外のストアの場合は Currency conversion rate も必要です。設定ページ上部の警告を確認してください。Debug log を有効にし、チェックアウトを再読み込みして、WooCommerce > Status > Logs（ソース: vfd-gig-logistics）を開くと、理由を確認できます。失敗したリクエストは 10 分後に再試行されます。
ログに Login failed と表示される: GIG Logistics が API のユーザー名またはパスワードを拒否しました。それらを確認し、Test mode も確認してください。テスト用の認証情報はテスト API でのみ使えます。設定を保存すると、すぐに再試行されます。
GIG Logistics が料金を返さない: GIG は距離に基づいて料金を計算します。Address lookup を有効のままにするか、Pickup latitude と Pickup longitude を入力してください。本番運用の前に、GIG Logistics のアカウントで料金を確認してください。
GIG の料金に税金が上乗せされる: GIG の料金に請求したいものがすべて含まれている場合は、Tax status を None にしてください。
変更後に料金が古く見える: 設定ページを保存してください。キャッシュされた料金とトークンが消去されます。
独自のジオコーダー: 開発者は vfd_gigl_pre_geocode フィルターを使って、独自の住所検索を提供できます。
ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーがすでに別のドメインで使われている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、プラグインを無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。設定、ゾーンの配送方法、キャッシュされた料金、トークン、住所検索は、Remove data on uninstall が有効な場合にのみ削除されます。それ以外の場合は、再インストール用に保持されます。既存の注文は、配送行を保持します。
GIG Logistics は、それぞれの所有者の商標です。本プラグインは GIG Logistics と提携しておらず、GIG Logistics による推奨も受けていません。