WordPressメンバーシッププラグインの翻訳：MemberPressとPMPro
収益性の高いメンバーシップサイトを構築しました。コンテンツはゲートで保護され、継続的な収益は増加し、支払いフローは万全です。そして、国際展開を決定した途端、すべてが壊れてしまいます。
ドイツのメンバーがサブスクリプションをアップグレードしようとしたとき、「メンバーシップレベルが%sに変更されました」と表示されます。しかし、翻訳中に%sが破損したため、新しいプラン名ではなく、生のPHPエラーが表示されます。彼らはパニックになり、PayPal紛争を起こし、顧客とチャージバック料金の両方を失います。
WordPressメンバーシッププラグインの翻訳は、ブログテーマの翻訳とは異なります。MemberPress、Paid Memberships Pro (PMPro)、Restrict Content Proなどのプラグインは、決済ゲートウェイ、ドリップコンテンツスケジュール、およびアクセス制御ロジックと深く絡み合っています。1つの壊れた文字列が、支払いの失敗、メンバーのロックアウト、およびあなたが話せない言語でのサポートチケットにつながる可能性があります。
メンバーシッププラグインの翻訳が非常に危険な理由と、収益を危険にさらすことなく翻訳する方法を以下に示します。
メンバーシッププラグインの翻訳がハイリスクな理由
メンバーシッププラグインは、コンテンツ管理と金融取引の交差点に位置します。この組み合わせにより、翻訳ファイルが非常に壊れやすくなります。
支払いに関わる重要な文字列
すべてのメンバーシッププラグインには、チェックアウト、サブスクリプション管理、および支払い確認中に表示される文字列が含まれています。一般的なMemberPressの.poファイルのエントリを考えてみましょう。
#: app/controllers/MeprTransactionsCtrl.php:142
msgid "Your payment of %1$s for %2$s has been received. Transaction ID: %3$s"
msgstr ""
この単一の文字列には、3つのsprintf()変数が含まれています。翻訳者（人間またはAI）が%1$sと%2$sの順序を変更すると、メンバーには価格が表示されるべき場所にプラン名が表示され、プラン名が表示されるべき場所に金額が表示されます。さらに悪いことに、変数に% 1$s（不正なスペースあり）のように変更されると、PHPは支払い確認ページで致命的なエラーをスローします。
これらは表面的なバグではありません。収益に直接影響します。
大規模で複雑なPOファイル
メンバーシッププラグインは、必然的に機能が豊富です。MemberPressには3,000を超える翻訳可能な文字列が付属しています。Paid Memberships Proは、その広範なアドオンエコシステムにより、コアファイルと拡張ファイル全体で簡単に5,000を超える文字列になる可能性があります。Restrict Content Proでさえ、コアの.potファイルだけで1,500以上の文字列を保持しています。
これらのファイルを汎用的な翻訳ツールに貼り付けたり、Loco Translateを使用してWordPressサーバーで処理しようとすると、タイムアウト、メモリ不足、および不完全な翻訳が発生する可能性があります。
アクセス制御とドリップコンテンツロジック
メンバーシッププラグインは、ユーザーのアクセスレベル、サブスクリプションステータス、およびコンテンツスケジュールに基づいて動的なメッセージを表示します。「このコンテンツはメンバーシップの%d日後に利用可能になります」または「このページを表示するには%sメンバーである必要があります」のような文字列は、実行時にパーソナライズされたデータを挿入するために変数に依存しています。
不適切な翻訳は、プロフェッショナルに見えないだけでなく、メンバーがアクセスできるものについて誤解を招き、混乱を生み出し、信頼を損なう可能性があります。
通常のアプローチ（およびその欠点）
自動化されたソリューションに手を伸ばす前に、ほとんどのサイト所有者は次の3つの方法を試します。
Poeditを使用した手動翻訳
Poeditは、.poファイルのゴールドスタンダードのデスクトップエディタです。形式をネイティブに処理し、すべての文字列を完全に制御できます。問題は規模です。3,000のMemberPress文字列を手動で1つの言語に翻訳するだけでも数日かかります。5つの言語をサポートしている場合、数週間の退屈で反復的な作業が必要になります。それでも、ターゲット言語ごとにネイティブスピーカーが必要です。
Loco Translateのようなオンサイトプラグイン
Loco Translateは、WordPressダッシュボード内で実行されるため便利です。ただし、メンバーシップサイトはすでにリソースを大量に消費しています。セッショントークンを管理し、すべてのページロードでアクセスルールを確認し、StripeとPayPalからのwebhookコールバックを処理します。その上にデータベース駆動型の翻訳レイヤーを追加すると、測定可能なオーバーヘッドが発生します。
さらに重要なことに、Loco Translateはコード変数を保護しません。支払い確認文字列で%1$sトークンを壊してしまう可能性があります。
汎用AI翻訳
文字列をChatGPTまたはGoogle翻訳にコピーするのは高速ですが、無謀です。汎用AIツールは、Gettext構文を理解していません。%s変数を「翻訳」し、HTMLタグを再構築し、カジュアルな視覚チェックには合格するものの、本番環境では致命的に失敗する壊れた出力を自信を持って返します。これは、壊れた文字列が支払いページとアカウント管理ページ（信頼が絶対に不可欠な場所）に表示されるメンバーシッププラグインにとって特に危険です。
翻訳中にコード変数が非常に壊れやすい理由の詳細については、コード変数の安全に関する詳細ガイドをご覧ください。
メンバーシッププラグインを安全に翻訳する方法
安全なアプローチには、ネイティブのGettext形式のサポート、コードを認識した処理、およびクラッシュせずに大きなファイルを処理する機能の3つが必要です。
ステップ1：POまたはPOTファイルをエクスポートする
すべての主要なメンバーシッププラグインには、通常、プラグインのlanguages/ディレクトリにある.potテンプレートファイルが付属しています。
- MemberPress:
wp-content/plugins/memberpress/i18n/languages/memberpress.pot - Paid Memberships Pro:
wp-content/plugins/paid-memberships-pro/languages/paid-memberships-pro.pot - Restrict Content Pro:
wp-content/plugins/restrict-content-pro/languages/rcp.pot
FTP、ホスティングファイルマネージャー、またはWP-CLIを介して.potファイルをダウンロードします。
wp-cli eval "echo WP_PLUGIN_DIR;" | xargs -I {} find {} -name "*.pot" -path "*/memberpress/*"
ステップ2：コードセーフな翻訳エンジンにアップロードする
これは、SimplePoTranslateがワークフローに適合する場所です。サーバーでファイルを処理したり、数千の文字列を手動で翻訳したりする代わりに、.potファイルをクラウドベースのプラットフォームにアップロードします。
メンバーシッププラグインの翻訳に特に関連する2つの機能があります。
構文ロック — AIモデルが文字列に触れる前に、パーサーはすべてのsprintf()変数（%s、%1$s、%d）、すべてのHTMLタグ、およびすべてのエスケープシーケンスを識別してロックします。AIはこれらのトークン周辺の自然言語を翻訳しますが、変更、並べ替え、または破損することはできません。これは、単一の壊れた変数がトランザクションページの失敗を意味する支払い文字列にとって重要です。
スマートバッチ処理 — 5,000文字列のPMProファイルが一度にAIに供給されることはありません。エンジンはそれを最適なサイズのチャンクに分割し、並行して翻訳し、結果を1つの有効な.poファイルにマージします。これにより、大規模なメンバーシッププラグインファイルを処理する際に、オンサイト翻訳ツールを悩ませるタイムアウトとメモリの問題が解消されます。
WordPressプラグイン — WordPressダッシュボードから離れたくない場合は、公式のSimplePoTranslate WordPressプラグインが、管理パネルから直接同じクラウドベースの翻訳を提供します。プラグインは、メンバーシッププラグインの.potファイルを自動的に検出します。テンプレートが存在しない場合は、その文字列をスキャンして生成します。APIキーを入力し、ターゲット言語を選択して、ワンクリックで翻訳します。翻訳はあなたのサーバーではなく、私たちのサーバーで行われるため、パフォーマンスへの影響はゼロです。文字列がファジーとしてフラグ付けされた場合（まれですが、高度に技術的なメンバーシップ用語では可能です）、プラグインインターフェイスで直接確認および編集できます。
ステップ3：ダウンロードとデプロイ
SimplePoTranslateは、翻訳された.poファイルとコンパイルされた.moファイルの両方を含むZIPを返します。それらをプラグインのlanguages/ディレクトリにアップロードします。
# For MemberPress translated to German
wp-content/languages/plugins/memberpress-de_DE.po
wp-content/languages/plugins/memberpress-de_DE.mo
.moファイルはコンパイルされたバイナリであるため、WordPressはそれらをほぼゼロのオーバーヘッドでロードします。データベースクエリ、実行時の文字列検索、およびパフォーマンスの低下はありません。これは、メンバーシップサイトのすべてのページロードに遅延を追加するデータベース駆動型の翻訳プラグインとは異なります。
メンバーシッププラグインからの実際のPOの例
複雑さを説明するために、一般的なメンバーシッププラグインからの実際の翻訳可能な文字列と、それらを慎重に処理する必要がある理由を次に示します。
# MemberPress — subscription management
msgid "Your %1$s subscription has been paused. You can resume it from your %2$saccount page%3$s."
msgstr ""
# Paid Memberships Pro — checkout validation
msgid "Your %1$s membership expires on %2$s. %3$sRenew now%4$s to maintain access."
msgstr ""
# Restrict Content Pro — access restriction
msgid "This content is restricted to %s members. Please upgrade your subscription to continue."
msgstr ""
これらの文字列がsprintf()変数とHTMLリンクタグ（%2$sが<a>タグを開き、%3$sがそれを閉じます）をどのように混在させているかに注目してください。人間の翻訳者は、どの変数がリンクラッパーで、どの変数がデータプレースホルダーであるかを理解する必要があります。汎用AI翻訳者はこの区別を行わず、多くの場合、これらのペアのタグを再配置または削除し、メンバーシップページで壊れたHTMLを生成します。
これはまさに、構文ロックが損傷を防ぐシナリオです。周囲の文の構造が翻訳中にどのように変化しても、変数は開発者が配置した場所に正確に留まります。
WooCommerceまたはLMSプラグインも実行するメンバーシップサイト
多くのメンバーシップサイトは、単独で動作するわけではありません。MemberPressは、製品販売のためにWooCommerceと統合されています。Paid Memberships Proは、コースアクセス用にLearnDashおよびLifterLMSと接続されています。Restrict Content Proは、コミュニティ機能のためにBuddyPressと連携しています。
スタックに複数の重いプラグインが含まれている場合、翻訳のワークロードは増加します。もはや1つの.potファイルを翻訳しているのではなく、それぞれに数千の文字列と独自の変数規則を持つ5つまたは6つのファイルを翻訳しています。
メンバーシップサイトにLMSコンポーネントが含まれている場合、LMS翻訳ガイドでは、コース、クイズ、および証明書の文字列を翻訳する際の具体的な課題について説明します。WooCommerceとメンバーシップアクセスをバンドルするサイトの場合、WooCommerceローカリゼーションガイドでは、チェックアウト、カート、および注文確認の文字列を安全に翻訳する方法について説明します。
同じクラウドベースのワークフローが、これらのすべてのプラグインに適用されます。各.potファイルをアップロードし、エンジンにバッチ処理と構文保護を処理させ、コンパイルされた.moファイルをサーバーにデプロイします。
リスクなしでメンバーシップサイトを翻訳する
メンバーシップサイトは、お金を処理し、アクセスを管理し、機密ユーザーデータを保存します。これらの相互作用を強化する文字列は、支払いゲートウェイの構成やSSL証明書と同じレベルの注意を払う必要があります。
手動のコピー＆ペースト翻訳や肥大化したオンサイトプラグインで継続的な収益を危険にさらすのをやめましょう。クラウドでメンバーシッププラグインファイルを翻訳し、構文ロックですべての変数を保護し、サイトを高速に保つ軽量の.moファイルをデプロイします。
コミットする前に、最も重要な支払い文字列でワークフローをテストできるように、寛大な無料枠を提供しています。MemberPressまたはPMProの.potファイルをアップロードし、すべての%1$sが翻訳後も無傷であることを確認してください。
メンバーシッププラグインを安全に翻訳する準備はできましたか？SimplePoTranslateを無料でお試しください — クレジットカードは不要です。