ブログ一覧に戻る

公開日:

Donation Platform for WooCommerceでDonations設定だけCritical Errorになるときの確認方法

WooCommerce > Settings > DonationsでCritical Errorになり、寄付フォームも表示されない状態から、Loco Translateのプレースホルダー誤訳を確認して復旧した事例をご紹介します。

発生したケース

WooCommerceの設定画面で「Donations」タブを開くとCritical Errorになり、寄付フォームのショートコードも表示されないケースがありました。

Donation Platform for WooCommerceは、WooCommerce上で寄付フォームや寄付商品を扱うためのプラグインです。決済導線に関わるため、設定画面が落ちるだけでも寄付受付に影響します。

プラグインをアンインストールして再インストールしても直りません。ログには、Donation Platform for WooCommerceの設定画面で sprintf() に関係するエラーが出ていました。

Fatal error:
sprintf() related error

場所:
wp-content/plugins/wc-donation-platform/includes/class-wcdp-general-settings.php

画面:
WooCommerce > Settings > Donations

このケースでは、プラグイン本体のファイル不足ではなく、翻訳文字列のプレースホルダーが崩れていることが原因でした。Loco Translateなどで翻訳した文字列の中にある %1$s、%2$s、%3$s、%4$s が正しく残っていないと、設定画面でFatal Errorになります。

Donation Platform翻訳プレースホルダー確認フロー

保守現場ではこう判断する

設定画面だけが落ちる場合、まず「その画面でだけ読み込まれる文字列・設定・アドオン」を疑います。

状態判断
Donations設定だけ落ちる寄付プラグインの設定画面を疑う
フォームも表示されない設定読み込み失敗の影響を確認する
再インストールで直らないDB設定や翻訳ファイルを疑う
sprintf() がログに出るプレースホルダー誤訳を疑う
Loco Translateを使っているカスタム翻訳を優先確認する

この症状では、プラグインを何度も入れ直しても直らないことがあります。原因がプラグインファイルではなく、翻訳データ側に残っているからです。

確認手順

Donation Platform翻訳エラー確認

[ ] WooCommerce > Settings > Donationsだけ落ちるか確認する
[ ] 寄付フォームのショートコード表示を確認する
[ ] PHPエラーログでsprintfを確認する
[ ] Loco Translateのカスタム翻訳を確認する
[ ] `%1$s` `%2$s` `%3$s` `%4$s` が残っているか確認する
[ ] 翻訳を一時的に無効化する
[ ] プラグインを同じバージョンで入れ直す
[ ] Donations設定画面を開けるか確認する
[ ] 寄付フォームと決済導線を確認する

sprintf() は、文章内の %1$s のような場所にリンクや文字列を差し込むために使われます。翻訳時にこの記号を消したり順番を壊したりすると、PHP側で必要な差し込み先が足りなくなり、Fatal Errorにつながります。

実際の復旧手順

  1. バックアップを取る
  2. Loco Translateなどのカスタム翻訳を確認する
  3. 対象文字列の %1$s、%2$s、%3$s、%4$s を原文と同じように戻す
  4. 翻訳ファイルを保存する
  5. WooCommerce > Settings > Donations が開けるか確認する
  6. 寄付フォームのショートコード表示を確認する
  7. 寄付金額、カート、決済画面まで確認する

このケースで復旧と判断できるのは、Donations設定画面が開けるだけではありません。寄付フォームが表示され、寄付商品がカートへ入り、チェックアウトまで進めることを確認します。

やってはいけない対応

NG理由
プラグインを何度も再インストールする翻訳データが原因なら直らない
%1$s などを翻訳時に削除するPHPの文字列差し込みが壊れる
設定画面が直っただけで終わるフォームと決済導線の確認が残る
本番で翻訳を直接大きく変更する寄付導線が止まる可能性がある

顧客向け通知例

WooCommerceのDonations設定画面でCritical Errorが出る状態を確認しました。

ログ上では、寄付プラグインの設定画面で使われる翻訳文字列のプレースホルダーが崩れている可能性があります。

プラグイン本体の再インストールではなく、まずカスタム翻訳内の `%1$s` などの記号を確認し、修正後に設定画面、寄付フォーム、カート、チェックアウトまで確認します。

公式情報

Donation Platform for WooCommerceは、WooCommerce上で寄付・ファンドレイジング機能を扱うプラグインです。配布元とWooCommerceの翻訳仕様を確認してから切り分けます。

翻訳プレースホルダー周辺のFatal Errorでは、文言修正だけでなく、翻訳ファイル、置換パラメータ、WooCommerce側のメール・注文表示への副作用を確認します。

復旧確認チェック

復旧確認:
[ ] 寄付フォームまたは商品ページが開ける
[ ] 該当する翻訳文言でFatal Errorが再発しない
[ ] 注文作成、寄付完了メール、管理画面表示を確認した
[ ] 翻訳ファイルの上書き範囲を記録した
[ ] 次回更新で同じ修正が消えない運用にした

NexraOneでできること

NexraOneは翻訳ファイルを修正するツールではありません。ただし、Fatal Errorを検知しておくと、管理画面の特定タブだけが落ちている状態に気付きやすくなります。

寄付や決済に関わるプラグインでは、設定画面のエラーがそのまま売上や寄付導線の停止につながることがあります。フォーム表示と決済導線まで確認することが重要です。

あわせて確認したい記事

WordPress Fatal Errorの原因と確認方法 と、WooCommerce有効時にREST API endpointが400 Bad Requestになるときの確認方法 を確認してください。更新前の確認には、プラグイン更新前の確認チェックリスト が近いです。

まとめ

Donation Platform for WooCommerceでDonations設定だけCritical Errorになる場合、プラグイン本体ではなくカスタム翻訳のプレースホルダー誤りが原因になることがあります。

%1$s のような記号は翻訳してはいけない部品です。設定画面、寄付フォーム、カート、チェックアウトまで確認して復旧と判断してください。

※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。

WordPress Monitoring Service

WordPressサイトの異常に、
早く気づける体制を作りませんか?

死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。

ブログ一覧に戻る

合わせてこんな記事も読まれています

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

最新記事はこちら

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。