WP Simple Pay ドキュメント

WP Simple Pay のドキュメント、参考資料、チュートリアル

キャッシュおよび最適化プラグインによって引き起こされる問題の解決方法

読む時間: 4分 | 難易度: 初級

概要

キャッシュプラグインとウェブホストのキャッシュは、各ページのコピーを保存し、後続の訪問者にそのコピーを提供することで、サイトを高速化します。最適化プラグインはさらに進んで、サイトのJavaScriptを最小化、結合、または遅延させます。どちらもパフォーマンスには良いですが、積極的に設定されていると支払いフォームに干渉する可能性があります。

WP Simple Pay 4.17.5以降、支払いフォームは完全にキャッシュされたページでも動作します。各フォームは、ページが開かれるときにサイトのREST APIから設定と新しいセキュリティトークンを読み込むため、キャッシュされたページのコピーには期限切れになるものは含まれなくなりました。支払いフォームページをキャッシュから除外する必要はもうありません。

このガイドでは、まだ注意が必要な2つのこと、つまり支払い確認ページをキャッシュから除外し、WP Simple PayのスクリプトをJavaScript最適化から除外することについて説明します。

前提条件

  • WP Simple Pay 4.17.5以降。古いバージョンでは、支払いフォームページもキャッシュから除外するか、12時間以内にキャッシュする必要があります。
  • キャッシュまたは最適化プラグインの設定へのアクセス、またはキャッシュがサーバーで実行されている場合はウェブホストのサポートチームへのアクセス。

キャッシング

支払いフォームページ

WP Simple Pay 4.17.5以降では、支払いフォームを含むページは他のページと同様にキャッシュできます。訪問者がページを開くと、各フォームはサイトのREST APIから独自のデータを取得します。フォームが準備できるまで支払いボタンは無効のままなので、早いクリックで不完全なフォームを送信することはできません。

以前のバージョンで支払いフォームページをキャッシュから除外していた場合は、除外をそのままにするか削除することができます。どちらでも機能します。

更新したばかりですか? 4.17.5に更新した後、サイトのキャッシュを一度クリアしてください。更新前にキャッシュされたページには、更新されるまで古いフォームコードが含まれています。

支払い確認ページ

あなたの支払い成功および失敗ページをキャッシュから除外してください。これらのページは特定の支払いの詳細を表示するため、各顧客は新しく生成されたページを取得する必要があります。

一部のウェブホストでは、キャッシュはサーバーで実行され、WordPressから変更できません。その場合は、ホストに連絡して、確認ページURLをキャッシュから除外するように依頼してください。

特定のプラグインの設定

JavaScriptの最適化

最適化プラグインによって引き起こされるJavaScriptの問題は、通常、次の機能から発生します。

  • 最小化
    空白文字などをコードから削除し、ファイルを小さくします。
  • 結合
    個別のJavaScriptファイルを1つに結合し、サーバーへのリクエスト数を減らします。
  • 遅延/非同期読み込み
    ページが待機しないように、JavaScriptファイルの読み込みまたは実行を遅延させます。

使用しているプラグインに関係なく、すべてのJavaScript最適化設定から以下のファイルを 1 つ除外してください。

js.stripe.com/v3/
simpay-public-shared.js
simpay-public-upe.js
accounting.min.js
simpay-public-pro-upe.js

最適化でそのままにしておく必要があるもの

支払いフォームを読み込むには、サイトのREST APIアドレス、通貨形式、フォームが読み込めないときに表示されるメッセージなど、少数のサイト設定が必要です。WP Simple Pay はこれらの設定を 2 つの場所に表示します。

  • 各支払いフォームのHTML内、フォームのdata-simpay-general属性に。このコピーはフォーム自体の一部であるため、ページと一緒にキャッシュされます。
  • ページの末尾近くの小さなスクリプト、<script id="simpay-shared-js-extra"> にてspGeneralを定義します。

WP Simple Pay 4.17.6 以降、フォームはどちらかのコピーがページ上にあれば読み込まれます。一部の最適化プラグインは、後者のような小さなインラインスクリプトを削除または遅延させますが、その場合フォームは独自のコピーを使用するようになります。

支払いフォームが機能し続けるように、最適化プラグインが次のことを行わないようにしてください。

  • 支払いフォームの<form>タグからHTML属性、特にdata-simpay-form-idおよびdata-simpay-generalを削除する。
  • data-simpay-general属性とsimpay-shared-js-extraスクリプトの両方を削除する。両方が削除されると、フォームは読み込めなくなります。

特定のプラグインの設定

トラブルシューティング

「この支払いフォームを読み込めませんでした」

訪問者にこの支払いフォームを読み込めませんでした。ページを更新して、もう一度お試しください。と支払いボタンの下に表示される場合、フォームはサイトからデータを取得できませんでした。これは通常、サイトのREST APIをブロックしている何かが原因です。

セキュリティトークンエラー

クーポンセキュリティチェックに失敗しましたまたはCookieのノンスが無効ですのようなエラーは、以前は期限切れのセキュリティトークンを保持しているキャッシュされたページが原因でした。4.17.5以降、フォームは読み込まれるたびに新しいトークンを取得し、ゲストリクエストでの期限切れトークンは自動的に回復されます。更新後もこれらのエラーが表示される場合は、サイトのキャッシュをクリアしてください。「クーポンセキュリティチェックに失敗しました」というエラーを解決する方法を参照してください。

よくある質問

支払いフォームのページをキャッシュから除外する必要がありますか?

いいえ、WP Simple Pay 4.17.5 以降では必要ありません。支払い確認ページを除外する必要があります。

window.spGeneral を読み取るカスタムコードがあります。まだ機能しますか?

はい。フッタースクリプトが存在する場合、window.spGeneral は以前と同様に設定されます。最適化プラグインがそのスクリプトを削除した場合、WP Simple Pay はスクリプトがロードされるとすぐに、支払いフォームの data-simpay-general 属性から window.spGeneral を設定するため、コードは同じ値を確認します。

window.simplePayForms を読み取るカスタムコードがあります。まだ機能しますか?

はい。オブジェクトは引き続き利用可能であり、各フォームのエントリは、そのフォームのデータが到着すると追加されます。コードがページロード時にすぐに実行される場合、フォームのロードが完了するまで待機する必要がある場合があります。

次にやること

まだ質問がありますか?私たちが喜んでお手伝いします!

最終更新日:

今日から決済を受け付けましょう

WordPressウェブサイトで、単発および定期的な支払いまたは寄付の受け付けを開始しましょう。