VibeFox LP Express for WooCommerce — ヘルプ
要件
WordPress:5.8 以降。
WooCommerce:7.0 以降。インストールされ、有効になっていること。WooCommerce がなければ、プラグインは有効化できません。
PHP:8.0 以降。
LP Express:API アカウントは不要です。LP Express には公開された料金 API がありません。Unisend API は契約顧客のみ利用でき、本プラグインでは使用しないため、ご自身の(契約)料金を入力してください。荷物は Unisend(「Mano siuntos」)アカウントで作成してください。
パーセルターミナルリスト:プラグインは、旧版の LP Express プラグインが使用していたものと同じ、LP Express のオープンなターミナルリストを使用します。バージョン 1.1.0 のリリース時点では、このオンラインリストは利用できませんでした。利用できない間は、ダウンロード済みのコピーがあればそれを使用し、なければ独自のリストを使用します。独自のリストを入力できるよう準備しておいてください(「設定」を参照)。
VibeFox ライセンスキー:vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_lp_express フォルダーを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます。WooCommerce > Settings > Shipping > VibeFox LP Express、またはプラグインのページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. 料金表(少なくとも 1 行)または代替料金を入力します。ページ上部にあるパーセルターミナルの状態表示を確認し、オンラインリストが利用できない場合は独自のターミナルリストを追加します。
6. WooCommerce > Settings > Shipping > Shipping zones で、リトアニアのゾーンに VibeFox LP Express を追加するか、Ignore shipping zones をオンにして国を選択します。
設定
すべての設定は 1 つのページにあります:WooCommerce > Settings > Shipping > VibeFox LP Express。これらはすべての配送ゾーンに適用されます。ゾーンに配送方法を追加すると、ゾーンのウィンドウには項目が 1 つだけ表示されます。
Title (zone):このゾーンで購入者に表示される名前です。空欄にすると、全体設定の Method title が使われます。
ページ上部の通知には、問題とターミナルの状態が表示されます。料金が設定されていない場合、またはパーセルターミナルが 1 つも利用できない場合は、赤い通知が表示されます。その場合、配送方法はチェックアウトに表示されないためです。情報行には、利用可能なパーセルターミナルの数、対象となる都市の数、そして提供元(オンラインリスト、オンラインリストの保存済みコピー(日付付き)、または独自のリスト)が表示されます。
一般
Enable/Disable:すべてのゾーンで LP Express を一度に有効または無効にします。
Method title:購入者に表示される配送方法の名前です。ゾーン内の配送方法のタイトルがこれより優先されます。既定値:LP Express parcel terminal。
Tax status:Taxable を選ぶと WooCommerce の税金が配送料に加算されます。None を選ぶと加算されません。
料金(ストアの通貨で指定します。小数は 2.99 または 2,99 の形式で入力できます)
Price table:目的地の国ごとに 1 行です。+ Add country をクリックすると行を追加し、× をクリックすると行を削除します。独自の行がないすべての国には * Any other country を選びます。各行には Base price と重量列があります:XS (≤1 kg)、S (≤2 kg)、M (≤3 kg)、L (≤5 kg)、XL (>5 kg)。重量はカート全体の重量、または Per item を選んだ場合は 1 商品の重量です。空欄の列は、その行の基本料金を使用します。0 は無料を意味します。数値ではない料金は保存後に通知され、空欄のままになります。
Fallback cost:目的地の国の行が料金表にない場合に使われます。空欄にすると、その国では配送方法が非表示になります。
Calculation:料金の計算方法です。
Free shipping from:LP Express が無料になるカート合計額です(割引後、カートに表示される金額)。送料無料を設けない場合は空欄にします。
提供範囲
Minimum weight (kg):カートがこれより軽い場合、配送方法を非表示にします。空欄または 0 は制限なしを意味します。
Maximum weight (kg):カートがこれより重い場合、配送方法を非表示にします。LP Express のターミナルは最大 30 kg までの荷物を受け付けます。既定値:30。0 は制限なしを意味します。
Minimum cart total:このカート合計額以上の場合にのみ配送方法を表示します。空欄にすると常に表示されます。
Excluded shipping classes:カートに、これらの WooCommerce 配送クラスの商品が含まれる場合、配送方法を非表示にします。
Ignore shipping zones:配送ゾーンに追加せずに、以下の国向けに LP Express を提供します。オフの場合、国は配送方法を追加した配送ゾーンによって決まります。こちらの設定を推奨します。
Countries (without zones):このモードでの配送先の国です。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。空欄にすると、すべての配送先に配送方法が提供されます。
パーセルターミナル
Terminal list:ターミナルの取得元です。
Own terminal list:1 行に 1 つのターミナルを、ID | Name | City | Address | ZIP の形式で入力します(例:1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150)。ID と City は必須です。# で始まる行は無視されます。Unisend アカウントが求めるターミナル ID を使用してください。
設定を保存すると、ターミナルリストが再読み込みされます。
詳細設定
Debug log:料金計算とターミナルリストの詳細を WooCommerce > Status > Logs(ソース vfd-lp-express)に記録します。ターミナルリストが利用できないなどのエラーは、常に記録されます。購入者のデータは記録されません。
Remove data on uninstall:オンにすると、プラグインを削除したときに、設定、ゾーンの配送方法、キャッシュされたターミナルが削除されます。プラグインを無効にしても、設定が削除されることはありません。注文に保存されたターミナルは保持されます。
チェックアウトでの動作
購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは、カートの重量、最低カート合計額、除外する配送クラスを確認します。利用できるパーセルターミナルがなければ、配送方法は非表示になるため、購入者が完了できないチェックアウトを目にすることはありません。送料無料が適用される場合、料金は 0 です。それ以外の場合、料金は国の行(または * の行)から決まります。重量列があればそれを使い、なければ基本料金、それもなければ代替料金を使います。料金がない場合は、配送方法が非表示になります。
オンラインのターミナルリストは 24 時間キャッシュされます。ダウンロードに失敗した場合は 15 分間記憶されるため、チェックアウトは更新のたびにリストを待つことがありません。ダウンロードのタイムアウトは 10 秒です。リスト内の有効なターミナルのみが提供されます。
この配送方法は、クラシックチェックアウトと、カートとチェックアウトのブロックで動作します。WooCommerce の高性能注文ストレージ(HPOS)に対応しています。料金はストアの通貨で表示されます。プラグインは通貨を換算しません。
本プラグインは、LP Express や Unisend の料金を取得せず、配送の作成、ラベルの印刷、宅配便の手配、荷物の追跡も行いません。荷物は Unisend(「Mano siuntos」)アカウントで作成してください。宅配(玄関先への配送)は、この配送方法には含まれません。
受け取りポイント
購入者が LP Express を選択すると、配送方法の下に 2 つのリストが表示されます:-- Select city -- と -- Select parcel terminal --。配送先住所の都市がリスト内の都市と一致する場合、その都市が事前に選択されます。各ターミナルは、名前、住所、郵便番号とともに表示されます。選択内容はチェックアウト中保持されるため、チェックアウトが更新されても失われません。
ターミナルの選択は必須です。クラシックチェックアウトでは、購入者に Please select an LP Express parcel terminal. と表示されます。ブロックチェックアウトでは、ターミナルが選択されるまで Place order がブロックされます。どちらのチェックアウトでも、サーバーはリストに照らしてターミナルを再度確認するため、偽造された、または古いターミナル ID は拒否されます。
ターミナルの ID、名前、都市は注文に保存されます。注文画面では配送先住所の下(ターミナル ID を含む)に表示され、注文完了ページ、My account > Orders、注文メール(HTML とプレーンテキスト)では LP Express parcel terminal として表示されます。
ライセンスキー
本プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox LP Express の上部にあります。キーを License key に貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日や、お使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、LP Express はチェックアウトで購入者に表示されません。ログインしているストアの管理者には、(unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前に、プラグインの設定と動作確認ができます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。
ライセンスが期限切れになっても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスは、バックグラウンドで自動的に再確認されます。
トラブルシューティング
LP Express がチェックアウトに表示されない:ライセンスが有効であること、Enable/Disable がオンであること、配送方法が購入者の国のゾーンに追加されていること(または Ignore shipping zones がオンで、その国が許可されていること)を確認してください。設定ページを開くと、料金が設定されていない場合やパーセルターミナルが利用できない場合の理由が赤い通知で表示されます。重量制限、Minimum cart total、Excluded shipping classes も確認してください。Debug log がオンの場合、WooCommerce > Status > Logs(ソース vfd-lp-express)に、配送方法が非表示になった理由が表示されます。
パーセルターミナルがない:オンラインリストを読み込めず、保存されたコピーも独自のリストもありません。プラグインは 15 分ごとに再試行します。Own terminal list に独自のリストを入力するか、Only my own list を選んでください。
ターミナルリストが古い:設定ページを保存してください。これでターミナルリストが再読み込みされます。独自のリストを使用している場合は、行を自分で更新してください。
購入者が注文できない:パーセルターミナルを選択する必要があります。購入者に "The LP Express parcel terminal list is temporarily unavailable" と表示される場合は、現在利用可能なターミナルがありません。独自のリストを追加してください。
料金の通貨:ストアの通貨です。プラグインは通貨を換算しません。
ライセンスブロックにエラーが表示される:ブロック内のメッセージに従ってください。たとえば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。
アンインストール
プラグインを無効にしてもすべての設定は保持されます。消去されるのは、キャッシュされたターミナルリストだけです。削除するには、無効にしてから Plugins ページで削除してください。本プラグインのライセンスキーとライセンスステータス、およびキャッシュは、常に削除されます。設定、ゾーンの配送方法、保存済みのターミナルリストのコピーは、Remove data on uninstall がオンだった場合にのみ削除されます。それ以外の場合は、後で再インストールできるように残ります。注文に保存されたターミナルが削除されることはなく、既存の注文は配送の行をそのまま保持します。
LP Express は、その所有者の商標です。本プラグインは LP Express と提携しておらず、LP Express による推奨も受けていません。
