사이트 키 작동 방식
WPML에 등록된 모든 사이트는 WPML 계정에 연결된 고유한 사이트 키를 받습니다. 이 키는 사이트가 계정의 번역 메모리, 용어집 및 허용된 단어 수를 사용하도록 권한을 부여합니다.
현재 사이트의 키는 두 곳에서 확인할 수 있습니다.
- WPML활성화 및 업데이트. 등록 배너에는 마스킹된 접미사(예:
******abcd)가 표시되므로 전체 키를 노출하지 않고도 사이트에서 사용하는 키를 식별할 수 있습니다. - WPML.org 계정 페이지. 등록한 모든 사이트와 전체 키를 나열합니다.
새 사이트를 수동으로 등록하려면 계정 페이지에서 키를 생성하고 메시지가 표시될 때 WPML 관리 화면에 붙여넣으세요. 온보딩 중 설정 마법사에서 붙여넣거나, WPML이 요청할 때 통합 마이그레이션 알림의 포함된 사이트 키 양식에 붙여넣을 수 있습니다.
사이트 등록을 취소하려면(예: 사이트 폐기 등의 이유로) WPML활성화 및 업데이트 등록 배너에서 이 사이트에서 WPML 등록 취소를 클릭하세요. 동일한 화면에서 WPML이 플러그인을 설치하고 업데이트합니다. 해당 화면의 사이트 키는 다운로드가 속한 계정을 관리합니다.
“이 사이트는 개발 사이트로 등록되어 있습니다” 알림 제거
WPML 계정은 운영 사이트당 3개의 개발 사이트를 등록할 수 있습니다. 개발 복제본이 운영 사이트로 취급되는 것을 방지하기 위해 개발 사이트의 알림(“이 사이트는 WPML.org에 개발 사이트로 등록되어 있습니다”)이 의도적으로 개발 사이트의 모든 WPML 관리 화면 페이지에 표시됩니다.
사이트를 개발 사이트에서 운영 사이트로 전환할 준비가 되면 다음을 수행하세요.
- WPML 계정을 열고 등록된 사이트 목록에서 해당 사이트를 찾으세요.
- 유형을 개발에서 운영으로 변경하세요.
- 저장하세요.
- 사이트 자체에서 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 스크립트로 프로비저닝되며 수동 설정 단계가 없습니다.
- 많은 사이트를 관리하고 있으며 등록을 클릭 방식이 아닌 선언적 방식으로 수행하려고 합니다.
- 새로 배포된 환경에서 통합 마이그레이션 알림이 키를 묻는 메시지를 표시합니다.