WPML

지원팀과 WPML 디버그 정보 공유

WPML 지원팀은 대부분의 지원 문의에서 동일한 몇 가지 항목을 요청합니다. WPML > 지원 > 시스템 확인의 디버그 정보 블록, 사이트 또는 데이터베이스 사본, 브라우저 콘솔 출력 등이 이에 해당합니다. 이 페이지에서는 각 항목과 이를 가져오는 방법을 설명하므로, 지원 문의에 필요한 세부 정보를 미리 붙여넣을 수 있습니다. 지원을 요청하기 전에 확인해야 할 모든 사항(최소 요구 사항, 업데이트, 충돌 확인, 셀프 서비스 체크리스트)은 지원 요청 전 확인 사항을 참조하세요.

시스템 확인에서 디버그 정보 블록 복사

WPML > 지원 > 시스템 확인을 엽니다. 이 페이지에는 PHP 버전, WordPress 버전, 모든 WPML 플러그인 및 해당 버전, 서버 환경, 언어 구성, WPML이 wp-config.php에서 읽어오는 구성 값 등 디버그 정보 블록이 표시됩니다. 블록 상단에 있는 Copy system info to clipboard를 클릭한 다음 지원 문의에 붙여넣으세요.

이 블록은 현재 실행 중인 모든 항목의 버전과 사이트의 현재 구성이 어떤지 지원팀에 알려줍니다. 이는 더 깊은 조사를 시작하기 전의 기준선이 됩니다.

설치된 플러그인 목록 복사

WPML > 지원의 맨 아래로 스크롤합니다. 설치된 플러그인 섹션에는 사이트의 모든 플러그인, 해당 버전, 활성화 또는 비활성화 여부가 나열됩니다. Copy list to clipboard를 클릭하고 지원 문의에 붙여넣으세요.

플러그인 충돌은 WPML 증상의 가장 일반적인 원인 중 하나입니다. 지원팀은 이 목록을 사용하여 알려진 비호환성을 파악하고 적절한 후속 질문을 합니다.

관련 로그 복사

번역 서비스와 관련된 증상의 경우, WPML > 지원 > 통신 로그에 사이트와 번역 백엔드 간의 API 트래픽이 캡처됩니다. 번역이 명확하지 않은 이유로 실패하는 경우, 최근 로그 항목을 지원 문의에 복사하면 지원팀이 서버 측의 정확한 응답을 확인할 수 있습니다.

고급 번역 에디터 내부의 증상에 대해서는 고급 번역 에디터 오류 로그에 ATE에서 발생한 서버 측 오류가 캡처됩니다.

번역 작업과 관련된 증상(작업이 시작되지 않음, 작업이 완료되지 않음, 작업이 사라짐)의 경우, 번역 관리 작업 로그에 각 작업의 수명 주기가 표시됩니다.

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

지원팀과 실시간 진단 액세스 공유(선택 사항)

WPML > 지원 페이지 상단에는 Share diagnostic information with WPML Support 확인란이 있습니다. 이 확인란을 선택하면 WPML 지원팀이 사이트의 디버그 정보를 직접 읽을 수 있습니다. 비밀번호나 개인 데이터는 공유되지 않으며 디버그 정보 블록만 공유됩니다.

지원팀이 대화가 진행됨에 따라 최신 데이터를 다시 읽을 수 있으므로 질문에 블록을 붙여넣는 것보다 빠릅니다. 동일한 확인란에서 언제든지 이 기능을 끌 수 있습니다.

지원팀에서 디버그 로그를 요청하는 경우

더 심각한 문제(이상한 ATE 동작, 경쟁 조건, 간헐적 실패)의 경우, 지원팀은 디버그 정보 블록보다 더 자세한 전체 WPML 디버그 로그를 요청하기도 합니다.

디버그 로깅을 활성화하려면 다음을 수행하세요.

  1. “이상입니다. 편집을 중지하세요!” 줄 앞에 define( 'WP_DEBUG', true ); 및 define( 'WP_DEBUG_LOG', true );을 wp-config.php에 추가합니다. WordPress가 PHP 오류 및 경고를 wp-content/debug.log에 쓰기 시작합니다.
  2. 사이트에서 증상을 재현합니다.
  3. wp-content/debug.log을 열거나 다운로드하고 관련 섹션을 복사합니다(증상이 발생한 시점의 타임스탬프로 필터링).
  4. 지원 문의에 붙여넣거나 파일로 첨부합니다.
  5. 작업 후에는 WP_DEBUG을 다시 끕니다. 오류에 경로 정보가 포함되므로 운영 사이트에서 켜두면 보안 위험이 있습니다.

WPML 관련 항목 필터링을 포함한 전체 절차는 WPML 디버깅 참조를 확인하세요.

지원팀에서 사이트 사본을 요청하는 경우

로그만으로는 지원팀이 재현할 수 없는 문제의 경우, 조사를 위해 사이트 사본을 요청할 수 있습니다. 표준적인 방법은 백업 또는 스테이징 도구를 사용하여 전체 사이트를 패키징하고 WPML의 보안 업로드 양식을 통해 공유하는 것입니다(요청 시 지원팀에서 링크를 제공합니다).

패키징 단계에 권장되는 도구는 다음과 같습니다.

  • Duplicator. 데이터베이스와 파일을 설치 스크립트와 함께 단일 아카이브로 패키징합니다.
  • All-in-One WP Migration. 유사한 패키징이지만 형식이 약간 다릅니다.
  • 호스팅 제공업체의 내장 스테이징/복제 도구를 사용할 수도 있습니다(이식 가능한 아카이브를 생성하는 경우).

사본을 공유하기 전에 다음을 확인하세요.

  • 라이브 사이트 자체에 대한 액세스가 아닌 사이트의 사본을 공유하는지 확인하세요.
  • 사이트에 고객 데이터가 있는 경우 데이터베이스에서 개인 데이터를 제거하세요(Duplicator 및 AIOWP에는 이를 위한 내보내기 옵션이 있습니다).
  • 지원팀이 사본에서 발견한 내용을 바탕으로 변경 사항을 적용하기 전에 운영 환경의 백업이 제대로 작동하는지 확인하세요.

WPML은 서버 간 사이트 이동 사례를 자동으로 처리합니다. 지원팀에 사본 보내기 사례는 호스팅 환경 외부에 있는 누군가가 로컬에서 실행할 수 있도록 사이트를 패키징하는 경우입니다.

WPML 계정 자격 증명 찾기

지원팀이 이 사이트가 등록된 WPML 계정을 묻는데 기억나지 않는 경우 다음을 수행하세요.

  • WPML > 활성화 및 업데이트의 마스킹된 사이트 키는 사이트에서 사용하는 키를 식별합니다(예: ******abcd). 이를 내 WPML 계정에 나열된 사이트와 일치시켜 보세요.
  • 계정 이메일에 대한 액세스 권한을 잃은 경우 받은 편지함에서 accounts@wpml.org에서 보낸 메시지를 검색하세요. 원본 계정 생성 이메일에 자격 증명이 포함되어 있습니다.