VibeFox Packeta for WooCommerce — ヘルプ
要件
WordPress: 5.8 以降。
WooCommerce: 7.0 以降がインストールされ、有効であること。WooCommerce がない場合、プラグインは有効化できません。
PHP: 8.0 以降。
Packeta APIキー: Packeta のクライアント画面（client.packeta.com）の Client support にあります。16 文字の英数字です。ウィジェットがチェックアウトで開くために必要なため、APIキーを入力するまで購入者にはこの配送方法が表示されません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で /wp-content/plugins/ に vfd_packeta フォルダーをアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox Packeta、または Plugins ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスのブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Packeta の API key と料金を入力します。少なくとも 1 つの Country prices の行（例: * Default）か Fallback cost を設定してください。保存すると、Packeta がキーを受け入れたかどうかがページに表示されます。
6. WooCommerce > Settings > Shipping > Shipping zones で、チェコ、スロバキア、ハンガリー、ルーマニア向けの配送ゾーンに VibeFox Packeta を追加するか、Ignore shipping zones を有効にします。
設定
すべての設定は 1 つのページにあります。WooCommerce > Settings > Shipping > VibeFox Packeta です。設定はすべての配送ゾーンに適用されます。配送ゾーンにこの方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone): このゾーンで購入者に表示される名前です。空欄にすると、全体の Name が使われます。
この方法は、Packeta 独自の受け取りポイントネットワークに含まれる国、CZ、SK、HU、RO に対してのみ表示されます。設定の上部には、APIキーの確認結果と、APIキーがない、料金が未設定、選択した国が Packeta のネットワーク外であるなどの問題に関する警告が表示されます。
すべての料金と上限値は、小数点としてカンマまたはピリオドを使えます（4,99 または 4.99）。無効な数値は、メッセージとともに拒否され、以前の値が保持されます。
一般
Enable/Disable: すべてのゾーンでこの方法を一括で有効化または無効化します。
Name: 購入者に表示される配送方法の名前です。ゾーンごとに独自の Title で上書きできます。既定値: Packeta pickup point。
API key: client.packeta.com > Client support で確認できる Packeta の APIキーです。32 文字の API パスワードを貼り付けることもできます。保存されるのは先頭 16 文字、つまり APIキーだけです。APIキーは公開情報であり、ウィジェットを開くために購入者のブラウザに送信されます。新しいキーを保存すると、Packeta の配送業者フィードで確認され、ページに Packeta API key verified が表示されるか、Packeta が拒否したことが表示されます。確認を実行できない場合でも、キーは保存され、次回保存時に再度確認されます。
Widget language: 受け取りポイントのウィジェットの言語です。Store / visitor language（既定）はページの言語に従います。チェコ語、スロバキア語、ハンガリー語、ルーマニア語、英語、ドイツ語、ポーランド語、ウクライナ語に固定することもできます。
Pickup point types: ウィジェットに表示する Packeta のポイントです。
Tax status: Taxable は WooCommerce の税金を送料に加算し、None は加算しません。
料金
Packeta には公開された料金 API がありません。料金はこの表から取得され、ストアの通貨で入力します。
Calculation type: Per order は料金を 1 回だけ請求します。Per item (price x quantity) は、料金にカート内の配送可能な商品数を掛けます。
Country prices: 配送先の国と荷物の重量ごとの料金です。+ Add country をクリックすると行を追加し、× をクリックすると行を削除できます。各行には Price と重量の列があります。XS は 1 kg まで、S は 1–2 kg、M は 2–3 kg、L は 3–5 kg、XL は 5 kg を超える場合です。重量の列が 0 のままの場合は Price の列が使われます。* Default の行は、専用の行がない国に使われます。新しい行は * Default として作成され、すべての料金は 0 に設定されます。これは送料無料を意味します。保存する前に国を選び、料金を入力するか、行を削除してください。同じ国が 2 つの行にある場合、保存時には最初の行だけが残ります。
Fallback cost: 国の表に配送先の行がなく、* Default の行もない場合に使われます。空欄のままにすると、その地域ではこの方法を提供しません。
Free shipping from: Packeta 配送が無料になるカートの小計（割引後、税抜き）です。料金が設定されている場合にのみ適用されます。国の行、* Default の行、またはフォールバック料金です。空欄のままにすると、送料無料は提供されません。
提供条件
Minimum weight (kg): カートの重量がこの値より軽い場合、この方法を非表示にします。カートの重量はストアの重量単位から換算されます。空欄または 0 は上限なしを意味します。
Maximum weight (kg): カートの重量がこの値より重い場合、この方法を非表示にします。既定値: 15。Packeta の受け取りポイントと Z-BOX は通常、15 kg までの荷物を受け付けます。Packeta との契約を確認してください。空欄または 0 は上限なしを意味します。
Minimum cart subtotal: カートの小計（割引後、税抜き）がこの金額に達した場合にのみ、この方法を提供します。
Excluded shipping classes: カートに、これらの WooCommerce の配送クラスのいずれかに属する商品が含まれる場合、この方法を非表示にします。
Ignore shipping zones: 有効にすると、対応する配送ゾーンに追加されていなくても、下で選択した国に対してこの方法を提供します。無効にすると、追加されたゾーンでのみ提供されます。
Countries (ignore zones mode): このモードの配送先の国です。空欄にすると、Packeta のすべての国を使用します。Packeta の受け取りポイントネットワーク外の国はスキップされます。このフィールドは Ignore shipping zones が有効な場合にのみ使われます。
詳細設定
Debug log: 料金の計算と受け取りポイントの選択を、WooCommerce > Status > Logs（ソースは "vfd-packeta"）に記録します。購入者の個人データと APIキーは記録されません。APIキーの確認に失敗した場合は、常に記録されます。作業が終わったらログを無効にしてください。
Remove data on uninstall: 有効にすると、プラグインを削除したときに、この方法の設定とゾーンのインスタンスが削除されます。プラグインを無効化しても、何も削除されません。注文に保存された受け取りポイントは、常に保持されます。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは、配送先の国が Packeta のネットワーク内にあるか、APIキーがあるか、カートの重量、カートの最低小計、除外される配送クラスを確認します。料金は国の表から取得され、次にフォールバック料金から取得されます。料金がなければ、この方法は非表示になります。送料無料が適用される場合、購入者は無料でこの方法を見ることができます。
購入者が Packeta の方法を選ぶと、その下に Choose pickup point ボタンが表示されます。ボタンを押すと、購入者のブラウザで Packeta の公式ウィジェットが開き、配送先の国、カートの重量、選択したポイントの種類、ウィジェットの言語が渡されます。購入者がポイントを選ぶと、その名前と住所が方法の下に表示され、ボタンは Change pickup point に変わります。選択内容は、チェックアウトが更新されたりページが再読み込みされたりしても、購入者のセッションに保存されます。
チェックアウト時に、貴店のサーバーが Packeta に問い合わせることはありません。ウィジェットのスクリプトは widget.packeta.com から読み込まれます。広告やプライバシーのブロッカー、コンテンツセキュリティポリシー、Packeta の障害によってブロックされた場合、購入者には次のメッセージが表示されます。「The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.」
この方法は、クラシックチェックアウトと、カートブロックおよびチェックアウトブロックの両方で動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。
Packeta の料金はリアルタイムでは取得されません。料金は貴店の料金表から取得されます。本プラグインは Packeta への発送データの作成、送り状の印刷、荷物の追跡は行いません。また、宅配サービスや、標準では提携配送業者の受け取りポイントも提供しません。注文の受け取りポイント ID は、通常の方法で Packeta に渡してください。たとえば client.packeta.com でのインポートなどです。
受け取りポイント
受け取りポイントは必須です。購入者がポイントを選ばずに注文した場合、チェックアウトは「Please choose a Packeta pickup point.」というメッセージで停止します。選んだポイントが配送先住所と異なる国にある場合、チェックアウトは「The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.」というメッセージで停止します。どちらの確認もサーバー側で行われ、クラシックチェックアウトとブロックチェックアウトの両方に適用されます。プラグインは、ポイント ID を Packeta で検証することはありません。ポイントが選ばれていること、およびその国が一致することのみを確認します。
ポイントは、注文の作成時に注文と一緒に保存されます。
管理画面の注文画面: 配送先住所の下に、Packeta pickup point として、名前、住所、Pickup point ID、国が表示されます。Packeta の注文にポイントがない場合は、「No pickup point was selected for this order.」と表示されます。
注文完了ページと注文詳細: Packeta pickup point: として、名前と住所が表示されます。
注文メール: HTML メールとプレーンテキストメールに、ポイントの名前と住所が含まれます。管理者向けのメールには、Pickup point ID も含まれます。
データベースでは、ポイントは注文メタデータの _vfd_pckt_point_id、_vfd_pckt_point_name（名前と住所）、_vfd_pckt_point_country に保存されます。
ライセンスキー
本プラグインは、vibefox.net で購入した VibeFox ライセンスキーで動作します。ライセンスのブロックは、WooCommerce > Settings > Shipping > VibeFox Packeta のページ上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日や貴社のドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者に Packeta は表示されません。ログイン中のショップマネージャーには、(unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前に本プラグインを設定してテストできます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスの期限が切れても、プラグインは動作を続けます。ただし、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Packeta が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、API key が入力されていること、配送先の国が CZ、SK、HU、RO のいずれかであることを確認してください。その国の料金が設定されていること（国の行、* Default の行、または Fallback cost）、重量と小計の上限、Excluded shipping classes、そして方法が対応する配送ゾーンに追加されていること（または Ignore shipping zones が有効であること）を確認してください。設定ページの上部には設定の問題が表示されます。原因を確認するには、Debug log を有効にして、WooCommerce > Status > Logs を見てください。
Packeta が APIキーを拒否した: client.packeta.com > Client support から APIキーをもう一度コピーして保存してください。それまでは、チェックアウトでウィジェットを開くことができません。
ウィジェットが開かない: Packeta のスクリプトが、広告やプライバシーのブロッカー、コンテンツセキュリティポリシー、または Packeta の障害によってブロックされています。コンテンツセキュリティポリシーで widget.packeta.com を許可してください。開発者は vfd_pckt_widget_url フィルターでスクリプトの URL を変更できます。
誤って送料が無料になっている: Country prices で Price が 0 の行を確認してください。特に、+ Add country で追加して未入力のままになっている * Default の行に注意してください。
他の国や配送業者: 標準では、この方法は CZ、SK、HU、RO に対応しています。開発者は vfd_pckt_countries フィルターで国を追加し、vfd_pckt_widget_options フィルターで配送業者の ID をウィジェットに渡すことができます。
ライセンスのブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、そのキーが別のドメインで使用されている場合は、vibefox.net のアカウントで枠を解放してから Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、無効化してから Plugins ページで削除してください。本プラグインのライセンスキーとライセンスステータスは、保存された APIキーの確認結果とともに、常に削除されます。設定とゾーンの方法は、Remove data on uninstall が有効な場合にのみ削除されます。それ以外の場合は、後で再インストールするために残されます。既存の注文は、配送の行と保存された受け取りポイントを保持します。
Packeta は、その各所有者の商標です。本プラグインは Packeta と提携しておらず、Packeta による承認も受けていません。