WPML 사이트 키 – 작동 방식, 필요한 경우 및 재설정 방법

사이트 키의 작동 방식

WPML에 등록된 모든 사이트에는 WPML 계정에 연결된 고유한 사이트 키가 부여됩니다. 이 키는 사이트에서 계정의 번역 메모리, 용어집 및 단어 제공량을 사용할 수 있도록 권한을 부여합니다.

현재 사이트의 키는 두 곳에서 확인할 수 있습니다.

• WPML > 활성화 및 업데이트. 등록 배너에는 전체 키를 노출하지 않고도 사이트에서 사용 중인 키를 식별할 수 있도록 마스킹된 접미사(예: ******abcd)가 표시됩니다.
• WPML.org 계정 페이지. 등록한 모든 사이트와 전체 키를 나열합니다.

수동으로 새 사이트를 등록하려면 계정 페이지에서 키를 생성한 다음, 메시지가 표시될 때(온보딩 중 Setup Wizard에서 또는 WPML이 요청할 때 통합 마이그레이션 알림에 포함된 사이트 키 양식에서) WPML 관리 화면에 붙여넣으세요.

사이트를 등록 해제하려면(예: 사이트 폐기 등) WPML > 활성화 및 업데이트 등록 배너에서 이 사이트에서 WPML 등록 해제를 클릭하세요. 이 화면은 WPML이 플러그인을 설치하고 업데이트하는 곳이기도 하며, 이곳의 사이트 키는 해당 다운로드가 속한 계정을 관리합니다.

“이 사이트는 개발 사이트로 등록되어 있습니다” 알림 제거

WPML 계정은 운영 사이트당 하나의 개발 사이트를 등록할 수 있습니다. 개발 복제본이 운영 사이트로 취급되지 않도록 하기 위해 개발 사이트의 알림(“이 사이트는 WPML.org에 개발 사이트로 등록되어 있습니다”)이 개발 사이트의 모든 WPML 관리 화면 페이지에 의도적으로 표시됩니다.

사이트를 개발에서 운영으로 전환할 준비가 되면 다음을 수행하세요.

1. WPML 계정을 열고 등록된 사이트 목록에서 해당 사이트를 찾습니다.
2. 유형을 개발에서 운영으로 변경합니다.
3. 저장합니다.
4. 사이트 자체에서 WPML > 활성화 및 업데이트를 열고 업데이트 확인을 클릭합니다. 계정 측 변경 사항이 동기화되면 개발 사이트 알림이 사라집니다.

동기화 후에도 알림이 계속 표시되면 WPML > 지원 > 시스템 확인 > 라이선스 데이터 새로 고침을 실행하세요. 그러면 로컬 라이선스 캐시가 지워지고 계정 상태를 다시 가져옵니다.

PHP 상수를 통한 사이트 자동 등록

자동화된 개발/스테이징/운영 워크플로(CI 파이프라인에 의해 사이트가 배포되고 사람이 직접 키를 붙여넣을 수 없는 경우)의 경우, PHP 상수를 사용하여 wp-config.php에 사이트 키를 하드코딩할 수 있습니다. WPML은 활성화 중에 이를 읽고 메시지 표시 없이 사이트를 등록합니다.

wp-config.php의 “That’s all, stop editing!” 줄 앞에 다음을 추가합니다.

define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );

WPML은 활성화 시 이 상수를 읽어 등록 메시지 표시를 건너뜁니다. 개발, 스테이징 및 운영 환경에 동일한 키 값을 설정할 수 있습니다. WPML은 도메인별로 이를 구분합니다.

이는 다음과 같은 환경에 적합한 접근 방식입니다.

• 사이트가 Docker / Composer / WP-CLI 스크립트에 의해 프로비저닝되며 수동 설정 단계가 없는 경우.
• 많은 사이트를 관리하고 있으며 등록이 클릭 방식이 아닌 선언적이기를 원하는 경우.
• 새로 배포된 환경에서 통합 마이그레이션 알림이 키를 묻는 경우.