WPML

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

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

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

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

    패널에 플래그가 지정된 항목이 있으면 먼저 수정하세요. “WPML이 고장 났다”는 증상 중 상당수는 실제로는 “서버 리소스가 부족하다”는 의미입니다.

  2. 모든 항목 업데이트

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

    • WPML 및 해당 애드온. WPML > Activate & Update를 열고 업데이트 확인을 클릭한 후 사용 가능한 업데이트가 있으면 설치하세요. WPML 업데이트를 참조하세요.
    • WordPress 코어. 대시보드 > 업데이트를 통해 업데이트하세요.
    • 테마 및 기타 플러그인. 플러그인 > 설치된 플러그인 및 테마 디자인 > 테마를 통해 업데이트하세요.

    각 업데이트 일괄 처리 후 증상을 다시 테스트하세요.

  3. 충돌 확인

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

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

    원인을 찾았다면 해당 정보는 WPML 지원팀에 필요한 정보입니다.

  4. 관련 관리 화면 도구 시도

    대부분의 증상에는 WPML > 지원에 전용 도구가 있습니다. 해당 페이지 상단의 검색창을 사용하여 “stuck translation”, “language data”, “cache”, “duplicate”, “comments”와 같이 증상을 입력하세요. 올바른 도구가 표시됩니다.

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

  5. 관련 로그 확인

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

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

  6. 디버그 정보 수집

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

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

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

  7. 질문하기

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

    • 증상을 설명하세요. 표시되는 내용, 예상한 내용, 증상이 시작된 시기를 포함합니다.
    • 이미 시도한 방법을 나열하세요. 위의 단계와 기타 모든 조치를 포함합니다.
    • 6단계에서 수집한 디버그 정보와 설치된 플러그인 목록을 붙여넣으세요.
    • 지원팀이 사이트에서 직접 실시간 디버그 정보를 읽을 수 있도록 하려면 WPML > 지원 페이지에서 Share diagnostic information with WPML Support를 선택하세요. 이 확인란은 선택 사항이며 언제든지 끌 수 있습니다.

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