WordPress 멤버십 플러그인 번역하기: MemberPress & PMPro

수익성 있는 멤버십 사이트를 구축했습니다. 콘텐츠는 잠겨 있고, 반복 수익은 증가하고 있으며, 결제 흐름은 빈틈없습니다. 그러다 해외로 확장하기로 결정하자 모든 것이 망가집니다.

독일의 회원이 구독을 업그레이드하려고 할 때 "%s로 멤버십 레벨이 변경되었습니다."라는 문구가 나타납니다. 그런데 %s가 번역 중에 손상되어 새로운 플랜 이름 대신 원시 PHP 오류가 표시됩니다. 회원은 당황하여 PayPal 분쟁을 열고 고객과 차지백 수수료를 모두 잃게 됩니다.

WordPress 멤버십 플러그인을 번역하는 것은 블로그 테마를 번역하는 것과는 다릅니다. MemberPress, Paid Memberships Pro (PMPro), Restrict Content Pro와 같은 플러그인은 결제 게이트웨이, 점진적 콘텐츠 일정, 액세스 제어 로직과 깊이 얽혀 있습니다. 문자열 하나만 손상되어도 결제 실패, 멤버 잠금, 이해할 수 없는 언어로 된 지원 티켓이 발생할 수 있습니다.

멤버십 플러그인 번역이 유독 위험한 이유와 수익을 위험에 빠뜨리지 않고 번역하는 방법을 소개합니다.

멤버십 플러그인 번역이 위험한 이유

멤버십 플러그인은 콘텐츠 관리와 금융 거래의 교차점에 있습니다. 이 조합은 번역 파일을 매우 취약하게 만듭니다.

결제 관련 중요 문자열

모든 멤버십 플러그인에는 결제, 구독 관리, 결제 확인 중에 나타나는 문자열이 포함되어 있습니다. 일반적인 MemberPress .po 파일의 다음 항목을 고려해 보세요.

#: app/controllers/MeprTransactionsCtrl.php:142
msgid "Your payment of %1$s for %2$s has been received. Transaction ID: %3$s"
msgstr ""

이 단일 문자열에는 세 개의 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 회원이어야 합니다."와 같은 문자열은 변수를 사용하여 런타임에 개인화된 데이터를 삽입합니다.

엉망으로 번역된 내용은 단순히 전문적이지 않게 보일 뿐만 아니라 회원이 액세스할 수 있는 내용에 대해 오해를 불러일으켜 혼란을 야기하고 신뢰를 떨어뜨릴 수 있습니다.

일반적인 접근 방식(그리고 실패하는 이유)

자동화된 솔루션을 사용하기 전에 대부분의 사이트 소유자는 다음 세 가지 방법 중 하나를 시도합니다.

Poedit을 사용한 수동 번역

Poedit은 .po 파일을 위한 최고의 데스크톱 편집기입니다. 형식을 기본적으로 처리하고 모든 문자열을 완벽하게 제어할 수 있습니다. 문제는 규모입니다. 3,000개의 MemberPress 문자열을 단일 언어로 번역하는 데 며칠이 걸립니다. 5개 언어를 지원하는 경우 지루하고 반복적인 작업에 몇 주가 걸리며 각 대상 언어에 대한 원어민이 여전히 필요합니다.

Loco Translate와 같은 사이트 내 플러그인

Loco Translate는 WordPress 대시보드 내에서 실행되기 때문에 편리합니다. 그러나 멤버십 사이트는 이미 리소스 집약적입니다. 세션 토큰을 관리하고, 모든 페이지 로드에서 액세스 규칙을 확인하고, Stripe 및 PayPal에서 웹훅 콜백을 처리합니다. 그 위에 데이터베이스 기반 번역 레이어를 추가하면 눈에 띄는 오버헤드가 발생합니다.

더욱 중요한 것은 Loco Translate가 코드 변수를 보호하지 않는다는 것입니다. 커서를 잘못 놓으면 결제 확인 문자열에서 %1$s 토큰이 손상될 수 있습니다.

일반 AI 번역

문자열을 ChatGPT 또는 Google 번역에 복사하는 것은 빠르지만 무모합니다. 일반 AI 도구는 Gettext 구문에 대한 이해가 없습니다. %s 변수를 "번역"하고, HTML 태그를 재구성하고, 대충 보면 괜찮아 보이지만 실제로는 치명적으로 실패하는 손상된 출력을 자신 있게 반환합니다. 이는 손상된 문자열이 결제 및 계정 관리 페이지(신뢰가 필수적인 정확한 위치)에 나타나는 멤버십 플러그인에 특히 위험합니다.

번역 중에 코드 변수가 왜 그렇게 취약한지에 대한 자세한 내용은 코드 변수 안전성에 대한 자세한 가이드를 참조하세요.

멤버십 플러그인을 안전하게 번역하는 방법

안전한 접근 방식에는 네이티브 Gettext 형식 지원, 코드를 인식하는 처리, 충돌 없이 대용량 파일을 처리하는 기능의 세 가지가 필요합니다.

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 파일을 클라우드 기반 플랫폼에 업로드합니다.

멤버십 플러그인 번역과 관련하여 특별히 관련된 두 가지 기능은 다음과 같습니다.

구문 잠금 — AI 모델이 문자열을 건드리기 전에 파서가 모든 sprintf() 변수(%s, %1$s, %d), 모든 HTML 태그, 모든 이스케이프 시퀀스를 식별하고 잠급니다. AI는 이러한 토큰 주위의 자연어를 번역하지만 수정, 재정렬 또는 손상시킬 수 없습니다. 이는 변수 하나가 손상되면 트랜잭션 페이지가 실패하는 결제 문자열에 매우 중요합니다.

스마트 일괄 처리 — 5,000개의 문자열로 구성된 PMPro 파일이 한 번에 AI에 제공되지 않습니다. 당사의 엔진은 파일을 최적의 크기로 분할하고 병렬로 번역한 다음 결과를 단일하고 유효한 .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와 쌍을 이룹니다.

스택에 여러 개의 무거운 플러그인이 포함되어 있으면 번역 작업량이 늘어납니다. 더 이상 하나의 .pot 파일을 번역하는 것이 아니라 각각 수천 개의 문자열과 자체 변수 규칙이 있는 5~6개의 파일을 번역하는 것입니다.

멤버십 사이트에 LMS 구성 요소가 포함된 경우 LMS 번역 가이드에서는 강좌, 퀴즈 및 인증서 문자열 번역의 특정 문제를 다룹니다. WooCommerce와 멤버십 액세스를 함께 사용하는 사이트의 경우 WooCommerce 현지화 가이드에서는 결제, 장바구니 및 주문 확인 문자열을 안전하게 번역하는 방법을 안내합니다.

동일한 클라우드 기반 워크플로가 이러한 모든 플러그인에 적용됩니다. 각 .pot 파일을 업로드하고 엔진이 일괄 처리 및 구문 보호를 처리하도록 한 다음 컴파일된 .mo 파일을 서버에 다시 배포합니다.

위험 없이 멤버십 사이트 번역하기

멤버십 사이트는 돈을 처리하고, 액세스를 관리하고, 민감한 사용자 데이터를 저장합니다. 이러한 상호 작용을 지원하는 문자열은 결제 게이트웨이 구성 또는 SSL 인증서와 동일한 수준의 주의를 기울여야 합니다.

수동 복사-붙여넣기 번역 또는 부풀려진 사이트 내 플러그인으로 반복 수익을 위험에 빠뜨리지 마세요. 클라우드에서 멤버십 플러그인 파일을 번역하고, 구문 잠금으로 모든 변수를 보호하고, 사이트를 빠르게 유지하는 경량 .mo 파일을 배포하세요.

커밋하기 전에 가장 중요한 결제 문자열에서 워크플로를 테스트할 수 있도록 무료 등급을 제공합니다. MemberPress 또는 PMPro .pot 파일을 업로드하고 모든 %1$s가 번역 후에도 그대로 유지되는지 확인하세요.

멤버십 플러그인을 안전하게 번역할 준비가 되셨나요? SimplePoTranslate를 무료로 사용해 보세요. 신용 카드가 필요하지 않습니다.