WPML Troubleshooting 도구

3가지 도구 계층

직접 실행해도 안전함

WPML 지원팀의 개입 없이 직접 실행할 수 있는 셀프 서비스 도구입니다.

로그 – 읽기 전용

WPML이 수행한 작업을 보여주는 읽기 전용 보기입니다. 간헐적인 문제를 진단하는 데 유용하며, 상황을 악화시키지 않습니다. 로그를 참조하세요.

고급 – WPML 지원팀이 요청할 때만

파괴적이거나 되돌리기 어려운 도구입니다. 직접 실행하지 마세요. 고급 도구를 참조하세요.

이 페이지에서는 안전(Safe) 계층을 다룹니다.

올바른 도구 찾기 – 검색

WPML → 지원 상단의 검색 상자는 3가지 계층의 모든 도구와 하위 작업을 스캔합니다. 발생한 증상, 고장 난 항목의 이름 또는 실행하려는 작업(“stuck”(멈춤), “cache”(캐시), “taxonomy”(분류 체계), “duplicate”(복제), “sitekey”(사이트 키))을 입력하면 일치하는 도구가 계층 배지와 함께 나타납니다.

도구가 어느 계층에 있는지 기억할 필요가 없습니다.

직접 실행해도 안전함

시스템 확인

기능:

WPML 지원팀이 가장 먼저 요청하는 디버그 정보를 표시하고, WPML 서버에 대한 연결 테스트를 실행하며, WPML에 필요한 PHP 확장 모듈을 나열하고, 로컬 라이선스 데이터 캐시를 새로 고칠 수 있습니다.

사용 시기:

• 지원 문의를 하려는 경우입니다. 디버그 정보 블록을 복사하세요. 포함해야 할 다른 항목은 지원팀과 디버그 정보 공유를 참조하세요.
• WPML이 wpml.org에 연결할 수 없어 연결 문제인지 확인하려고 합니다.
• 구독 변경 사항이 WPML에 반영되지 않았습니다. 라이선스 데이터 새로 고침을 사용하면 계정 상태를 다시 가져옵니다.
• 서버에 WPML에 필요한 PHP 확장 모듈(SimpleXML 등)이 있는지 확인하려고 합니다.

대부분의 상황에서 가장 먼저 사용해야 하는 도구입니다.

언어 데이터 수정

기능:

WPML이 각 글과 용어에 대해 저장하는 언어 할당을 복구합니다. 5가지 하위 작업에는 언어 정보 설정(언어가 없는 콘텐츠에 언어 할당), 글 분류 체계 동기화(분류 체계 번역을 해당 글에 다시 연결), 콘텐츠의 언어와 일치하지 않는 댓글 제거, 용어 수 수정(언어별 용어 수 다시 계산), 글 유형 할당 수정이 포함됩니다.

사용 시기:

• 글이나 용어가 번역 대시보드의 잘못된 언어 열에 표시됩니다.
• WPML에서 기본 언어가 번역이라고 보고합니다.
• 분류 체계 번역이 해당 글에서 연결이 끊어진 것처럼 보입니다.
• 언어 코드를 변경하여(예: en-gb에서 en로) 기존 콘텐츠를 다시 할당해야 합니다. 아래의 기존 콘텐츠의 언어 코드 변경을 참조하세요.
• 댓글이 언어 간에 올바르게 필터링되지 않습니다.

번역 수정

기능:

번역 상태를 복구합니다. 8가지 하위 작업: WPML 캐시 지우기, 멈춘 자동 번역 다시 시도, 번역 서비스 연결 새로 고침, 언어 전환기의 도메인 이름 업데이트(이동 후), 복제본에 번역 상태 할당, 진행 중인 자동 작업 취소, 선호하는 번역 서비스 재설정, 전문 번역 상태 재설정이 있습니다.

캐시 지우기는 WPML 자체에 유지됩니다. 플러그인이 없으면 직접 실행해도 안전함 아래에 독립적인 타일로 표시되며, 플러그인이 있으면 이전과 같이 번역 수정의 첫 번째 섹션으로 표시됩니다.

사용 시기:

• 번역이 멈춘 것처럼 보입니다. 번역이 진행 중 상태로 계속 머물러 있거나 WPML → 번역 → 번역 작업에서 진행률이 표시되지 않습니다.
• 새 도메인으로 사이트를 방금 이동했는데 언어 전환기가 여전히 이전 도메인을 가리킵니다.
• 번역 서비스 연결에 문제가 발생하여 깔끔하게 재설정하려고 합니다.
• 번역으로 표시되어야 할 복제된 글이 번역으로 처리되지 않습니다.

내부 링크 업데이트

기능:

WPML 4.7 이전에 생성된 글을 스캔하고 내부 링크를 올바른 번역 버전으로 다시 연결합니다. 최신 글은 링크가 자동으로 조정되며, 이 도구는 이전 WPML 버전에서 콘텐츠를 가져온 사이트에만 적용됩니다.

사용 시기:

글이 WPML 4.7 이전 버전인 오래된 사이트에서 수행하는 일회성 정리 작업입니다. 실행이 완료되면 섹션이 사라지며, 사이트당 한 번만 실행하면 됩니다.

모든 메시지 및 알림 제거

기능:

사이트의 모든 WPML 관리자 알림을 닫고 닫을 수 있는 경고를 재설정하여 문제가 다시 발생할 경우 경고가 다시 표시될 수 있도록 합니다.

사용 시기:

WPML 관리 화면이 더 이상 적용되지 않는 오래된 알림으로 복잡하거나, 오랫동안 지속된 문제를 방금 해결하여 이제 불필요해진 경고를 정리하려고 합니다.

WCML 상태

기능(WooCommerce 사이트 전용):

WooCommerce Multilingual을 위한 읽기 전용 상태 패널입니다. 하위 섹션에는 WooCommerce 상점 페이지 번역 상태, 번역이 누락된 상품, 번역이 누락된 분류 체계, 다중 통화 상태, 사이트의 WPML 호환 플러그인 상태, 상점의 WPML 미디어 상태가 표시됩니다.

사용 시기:

• WooCommerce 상점 페이지가 번역된 언어로 표시되지 않습니다.
• 상점의 특정 언어 버전에서 일부 상품이 누락되었습니다.
• 다중 통화가 구성되어 있지만 가격이 올바르게 전환되지 않습니다.
• WooCommerce 관련 지원 문의를 하기 전에 상태 패널을 복사하여 문의 내용에 포함하세요.

WCML 번역 수정

기능(WooCommerce 사이트 전용):

WooCommerce 전용 번역 상태를 복구합니다. 하위 작업에는 상품 옵션, 상품 이미지 갤러리, 상품 카테고리의 분류 체계, 상품 및 옵션의 재고 동기화, 누락된 상품 리뷰 번역 허용, 상품 속성의 누락된 번역 생성, 상품 유형 분류 체계 번역이 포함됩니다.

사용 시기:

• 상품 옵션이 깔끔하게 번역되지 않습니다.
• 동일한 상품의 언어 버전 간에 재고가 동기화되지 않습니다.
• 한 언어에서 상품 속성이 누락되었습니다.
• 언어 버전에 상품 리뷰가 표시되지 않습니다.

기존 콘텐츠의 언어 코드 변경

해당 언어로 된 콘텐츠가 이미 있는 사이트에서 언어 코드를 전환하는 것(예: en-gb에서 en로)은 서버 이동이 아니라 데이터베이스 내부의 다단계 변경 작업입니다.

절차: 언어 편집 아래의 WPML → 설정 → 언어에서 언어 코드를 변경한 다음, WPML → 지원 → 언어 데이터 수정 → 언어 정보 설정을 사용하여 기존 글과 번역의 언어를 다시 할당합니다. 운영 사이트에서 실행하기 전에 스테이징 사본에서 한 번 연습해 보세요.