WPML

WPML에 지원을 요청하기 전에 – 문제 해결 체크리스트

대부분의 WPML 문제는 스스로 해결할 수 있습니다. 지원을 요청하기 전에 이 체크리스트를 확인하면 양측의 시간을 절약할 수 있으며, 많은 경우 문제가 완전히 해결됩니다. 체크리스트로 해결되지 않더라도 지원 팀에서 가장 먼저 요청할 정보를 질문에 포함할 수 있도록 준비할 수 있습니다.

  1. 시스템이 WPML의 최소 요구 사항을 충족하는지 확인

    WPML지원을 여세요. 사이트가 WPML의 최소 요구 사항(PHP 버전, 필수 PHP 확장(SimpleXML 등), 메모리 제한)에 미치지 못하는 경우 페이지 상단에 경고 패널이 표시됩니다. 이 패널에는 충족되지 않은 각 요구 사항과 해결 방법이 나열됩니다.

    패널에 경고가 표시된 항목이 있다면 먼저 해결하세요. “WPML이 고장 났다”고 생각되는 많은 증상이 실제로는 “서버 리소스 부족” 때문입니다.

  2. 모든 항목 업데이트

    오래된 버전의 WPML, WordPress, 테마 또는 기타 플러그인은 WPML 문제의 두 번째로 흔한 원인입니다.

    • WPML 및 애드온. WPML활성화 및 업데이트를 열고 업데이트 확인을 클릭한 다음 사용 가능한 업데이트를 설치하세요. WPML 업데이트를 참조하세요.
    • WordPress 코어. 대시보드 > 업데이트를 통해 업데이트하세요.
    • 테마 및 기타 플러그인. 플러그인 > 설치된 플러그인 및 외모 > 테마를 통해 업데이트하세요.

    각 업데이트를 완료할 때마다 증상을 다시 테스트하세요.

  3. 충돌 확인

    새 플러그인을 설치하거나 테마를 전환한 후 증상이 나타났다면 해당 항목이 유력한 원인입니다. 최근에 변경한 사항이 없더라도 플러그인이나 테마 업데이트가 원인일 수 있습니다.

    • 다른 플러그인을 비활성화하면서(하나씩 또는 절반씩) 각 단계 후 다시 테스트하세요.
    • 일시적으로 기본 테마로 전환하세요(예: Twenty Twenty-Four). 증상이 사라지면 테마가 원인입니다.

    문제를 일으키는 원인을 찾았다면 이는 WPML 지원 팀에 필요한 정보입니다.

  4. 관련 관리 화면 도구 사용

    대부분의 증상에는 WPML지원에 전용 도구가 있습니다. WPML 5.0부터 복구 도구는 WPML Troubleshooting 플러그인(WPML활성화 & 업데이트)과 함께 제공되며, 읽기 전용 도구와 캐시 지우기는 WPML 자체에 포함되어 있습니다. 해당 페이지 상단의 검색 상자를 사용하여 “stuck translation”, “language data”, “cache”, “duplicate”, “comments”와 같이 증상을 입력하세요. 적절한 도구가 나타납니다.

    직접 실행해도 안전함 계층은 레이블 그대로 안전합니다. 번역이 멈춘 것 같으면 번역 수정을 실행하고, 언어 할당이 잘못된 것 같으면 언어 데이터 수정을 실행하세요. 도구별 참조는 WPML > 지원의 문제 해결 도구를 확인하세요.

  5. 관련 로그 확인

    증상이 간헐적으로 발생하거나 재현하기 어려운 경우, WPML지원의 읽기 전용 로그 계층에서 해답을 찾을 수 있는 경우가 많습니다. 통신 로그는 사이트와 번역 서비스 업체 간의 API 트래픽을 보여 주고, 고급 번역 에디터 오류 로그는 서버 측 오류를 보여 주며, 번역 관리 작업 로그는 특정 번역 작업에 발생한 상황을 보여 줍니다.

    상황에 따라 어떤 로그를 확인해야 하는지는 로그를 참조하세요.

  6. 디버그 정보 수집

    위의 단계를 수행한 후에도 증상이 계속 나타나면 지금 디버그 정보를 수집하세요. 지원 팀에서 가장 먼저 이 정보를 요청할 것입니다.

    1. WPML지원시스템 확인을 여세요.
    2. 디버그 정보 블록을 클립보드에 복사하세요.
    3. WPML지원 페이지 하단의 설치된 플러그인 섹션으로 스크롤하여 클립보드에 목록 복사를 클릭하세요.
    4. 두 블록을 모두 지원 문의에 붙여넣으세요.

    포함할 내용과 지원 팀에서 사이트의 사본을 필요로 하는 시기에 대해서는 지원 팀과 디버그 정보 공유를 참조하세요.

  7. 질문하기

    위의 체크리스트로 해결되지 않았다면 WPML 지원에 질문하세요. 질문에는 다음 내용을 포함하세요.

    • 증상 설명. 표시되는 내용, 예상한 내용, 발생한 시점.
    • 이미 시도한 내용 나열. 위의 단계와 기타 모든 시도.
    • 6단계에서 수집한 디버그 정보와 설치된 플러그인 목록 붙여넣기.
    • 지원 팀에서 사이트의 실시간 디버그 정보를 직접 읽을 수 있게 하려면 WPML지원 페이지에서 WPML 지원 팀과 진단 정보 공유를 선택하세요. 이 확인란은 선택 사항이며 언제든지 해제할 수 있습니다.

    이 정보가 첨부된 질문은 지원 팀에서 즉시 조치를 취할 수 있습니다.