WPML

WPML > 지원의 문제 해결 도구

WPML > 지원 페이지에는 WPML에서 제공하는 모든 문제 해결 도구가 나열되어 있으며, 실행 시의 위험도에 따라 세 가지 계층으로 그룹화되어 있습니다.

  • 직접 실행해도 안전함. 녹색 배지. WPML 지원팀의 개입 없이 실행할 수 있는 셀프 서비스 도구입니다.
  • 로그 – 읽기 전용. 하늘색 배지. WPML이 수행한 작업을 보여주는 읽기 전용 보기입니다. 간헐적인 문제를 진단하는 데 유용하며, 상황을 악화시키지 않습니다.
  • 고급 – WPML 지원팀이 요청할 때만 사용. 빨간색 배지. 파괴적이거나 되돌리기 어려운 도구입니다. 직접 실행하지 마세요. 고급 도구를 참조하세요.

이 페이지에서는 안전(Safe) 계층을 다룹니다. 로그(Logs) 계층에 대한 자체 참조는 로그에 있으며, 고급(Advanced) 계층은 고급 도구에 있습니다.

올바른 도구 찾기 – 검색

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

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

직접 실행해도 안전함

시스템 확인

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

사용 시기:

  • 지원 문의를 하려는 경우. 디버그 정보(Debug information) 블록을 복사하세요. 포함해야 할 기타 사항은 지원팀과 디버그 정보 공유를 참조하세요.
  • WPML이 wpml.org에 연결할 수 없으며 연결 문제인지 확인하려는 경우.
  • 구독 변경 사항이 WPML에 반영되지 않는 경우. 라이선스 데이터 새로 고침(Refresh license data)은 계정 상태를 다시 가져옵니다.
  • 서버에 WPML에 필요한 PHP 확장 프로그램(SimpleXML 등)이 있는지 확인하려는 경우.

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

언어 데이터 수정

기능: WPML이 각 글 및 용어에 대해 저장하는 언어 할당을 복구합니다. 5가지 하위 작업에는 언어 정보 설정(Set language information)(언어가 없는 콘텐츠에 언어 할당), 글 택소노미 동기화(Synchronize posts taxonomies)(택소노미 번역을 해당 글에 다시 연결), 콘텐츠의 언어와 일치하지 않는 댓글 제거(Remove comments that don't match the content's language), 용어 개수 수정(Fix terms count)(언어별 용어 개수 다시 계산), 포스트 유형 할당 수정(Fix post type assignment)이 포함됩니다.

사용 시기:

  • 번역 대시보드의 잘못된 언어 열에 글이나 용어가 표시되는 경우.
  • WPML에서 기본 언어가 번역이라고 보고하는 경우.
  • 택소노미 번역이 글과 연결되지 않은 것처럼 보이는 경우.
  • 언어 코드(예: en-gb → en)를 변경했으며 기존 콘텐츠를 다시 할당해야 하는 경우. 아래의 기존 콘텐츠의 언어 코드 변경을 참조하세요.
  • 언어 간에 댓글이 올바르게 필터링되지 않는 경우.

번역 수정

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

사용 시기:

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

내부 링크 업데이트

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

사용 시기: 글이 WPML 4.7 이전 버전인 오래된 사이트에서 일회성 정리 작업으로 사용합니다. 실행이 완료되면 해당 섹션이 사라지며, 사이트당 한 번만 실행하면 됩니다.

모든 메시지 및 알림 제거

기능: 사이트의 모든 WPML 관리 화면 알림을 닫고 닫을 수 있는(dismissible) 경고를 재설정하여 경고가 다시 발생할 경우 다시 나타날 수 있도록 합니다.

사용 시기: WPML 관리 화면 페이지가 더 이상 적용되지 않는 오래된 알림으로 어수선하거나, 오랫동안 지속된 문제를 방금 해결하여 이제는 불필요해진 경고를 정리하려는 경우입니다.

WCML 상태

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

사용 시기:

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

WCML 번역 수정

기능(WooCommerce 사이트 전용): WooCommerce 전용 번역 상태를 복구합니다. 하위 작업에는 상품 옵션, 상품 이미지 갤러리, 상품 카테고리의 택소노미, 상품 및 옵션의 재고 동기화, 누락된 상품 리뷰 번역 허용, 상품 속성에 대한 누락된 번역 생성, 상품 유형(Product Type) 택소노미 번역이 포함됩니다.

사용 시기:

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

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

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

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