WordPress 플러그인 디버깅을 돕는 방법

JoomUnited의 개발자들은 항상 귀하의 플러그인이 가능한 한 최적의 방식으로 작동하도록 노력하고 있습니다. 물론 일부 경우에는 특정 유형의 오류가 발생할 수 있습니다. 예를 들어, 제3의 플러그인으로 인해 발생하는 비호환성 문제가 그렇습니다. 이러한 유형의 오류가 발생할 때 우리가 원하는 것은 무엇일까요? 물론 신속하게 해결되는 것입니다 ...    

이 글에서는 개발자가 오류를 신속하게 이해하고 해결할 수 있도록 올바른 정보를 제공하는 방법을 알려드리겠습니다. 이 글은 문제가 발생했을 때 개발자에게 올바른 정보를 제공하기 위해 따라야 할 3단계로 나누어 설명합니다:

• 디버그 로그를 켜세요
• 문제 해결 플러그인을 설치하세요
• 자바스크립트 오류를 ​​확인하세요

WordPress 디버그 및 로그 시스템 켜기

우선, 우리는 WP_DEBUG 가 무엇인지 알아야 합니다. 위키백과에서 볼 수 있듯이, “ WP_DEBUG 는 PHP 상수(영구 전역 변수)로, WordPress 전체에서 "디버그" 모드를 작동시키는 데 사용할 수 있습니다. 기본적으로 false로 간주되며, 일반적으로 WordPress 개발 복사본의 wp-config.php 파일에서 true로 설정됩니다.”

보시다시피 WP_DEBUG 는 기본적으로 꺼져 있는 상수이지만, 임시 디버깅 목적으로 켤 수 있습니다. 

그 외에도 WP_DEBUG_LOG 라는 또 다른 PHP 상수가 있는데, 이 상수는 플러그인의 모든 오류를 자동으로 텍스트 파일로 생성하는 데 도움이 되며, 이것이 바로 우리가 개발자에게 보낼 내용입니다.  

플러그인을 활성화하는 정확한 방법과 플러그인에 오류가 있을 때 어떻게 표시되는지 알려드리겠습니다. WP Meta SEO 를 이 예시로 사용하지만, 모든 플러그인에 동일한 단계를 따르실 수 있습니다. 이 경우 WP Meta SEO에 문제가 있는데, 어떤 문제든 상관없으므로 선호하는 텍스트 편집기 소프트웨어(예: Notepad, Visual Studio Code, Brackets)로 wp-config.php 파일을 열면 됩니다. wp-config.php를 열어보세요.

이 파일은 WordPress 웹사이트가 설치된 서버의 루트에 위치합니다.

텍스트 편집기로 파일을 연 다음 CTRL + F 를 누르거나 편집 > 찾기… 를 클릭하면 찾으려는 단어를 입력할 수 있는 상자가 나타납니다. 이 경우 “WP_DEBUG” 를 입력하고 다음을 찾을 때까지 Enter를 누릅니다:
“define( 'WP_DEBUG', false )”

이제 해당 줄에서 “false”를 제거하고 true를 입력한 다음 Enter를 누르고, 다음 줄에 define( 'WP_DEBUG_LOG', true );를 복사하여 파일을 저장하세요. 그러면 다음 이미지와 같이 표시되어야 합니다.

이 두 줄을 변경하면 /wp-content/에 “debug.php”라는 파일이 생성됩니다

그리고 완료… 첫 번째 단계를 마쳤습니다. 이는 개발자가 문제 해결 과정을 빠르게 진행하는 데 필요한 파일 중 하나입니다. 모든 오류는 모니터링되어 바로 이 텍스트 파일에 기록됩니다.

WordPress 문제 해결 플러그인을 설치하세요

Health Check & Troubleshooting 플러그인은 사이트의 일반 방문자에게 영향을 주지 않고 충돌 검사를 실행할 수 있게 해주는 플러그인입니다. 사용 및 설치가 정말 쉽습니다. 이 예제에서는 여전히 WP Meta SEO 를 사용하겠습니다. Health Check & Troubleshooting으로 충돌 검사를 설치하고 실행하려면 다음 단계를 따르세요:  

• WordPress 사이트에 로그인하면 사이트의 대시보드가 표시됩니다
• 페이지 왼쪽 섹션에서 “플러그인”을 클릭하세요
• “새로 추가”를 클릭하세요
• 아래와 같이 검색창에 “Health Check & Troubleshooting”을 입력하세요

• 클릭하세요 “지금 설치”, 플러그인 목록이 자동으로 로드되면 올바른 항목을 찾아 “지금 설치”를 클릭한 다음 “활성화”를 클릭하세요

• 클릭하세요 “사이트 건강”, 왼쪽 메뉴에 “도구” 라는 섹션이 있습니다. 클릭한 다음 “사이트 건강”

• 클릭 “문제 해결” 탭에서 경고 정보를 읽고, “문제 해결 모드 진입” 

문제 해결 모드는 모든 플러그인을 자동으로 비활성화하고 기본 테마로 전환합니다. 문제 해결 모드는 사이트의 일반 방문자에게 영향을 주지 않습니다.  

• 문제를 재현하세요 경험하셨던

활성화된 플러그인이 없고 기본 테마가 적용된 기본 환경에서 문제가 발생한다면, 이는 우리 플러그인이 예기치 않은 동작을 일으키지 않는다는 것을 의미합니다.

• 클릭하세요 “플러그인” > “설치된 플러그인”

  “플러그인” 메뉴가 확장되어 추가 옵션이 표시됩니다. “설치된 플러그인”을 클릭하세요

• 클릭 “문제 해결 중 활성화” 옆에 WP Meta SEO

• 경험하신 문제를 재현해 보세요 WP Meta SEO 만 활성화하고 기본 테마를 사용한 상태에서, 문제가 발생한다면 그 문제는 저희 플러그인으로 인해 발생한 것입니다.

이는 어떤 면에서 좋은 소식입니다. 문제의 일부를 이미 파악하셨기 때문입니다. 이제 개발자가 귀하의 웹사이트에 로그인하여 새 버전을 출시하기 전에 문제를 해결해야 합니다! 그렇지 않은 경우, 오류를 재현할 수 있는 다음 비활성화된 플러그인을 활성화하는 단계를 반복하세요.

WordPress 플러그인에서 자바스크립트 오류 확인 및 디버깅

Chrome 또는 Firefox 콘솔을 사용하여 Javascript 오류를 찾아볼 것입니다. 브라우저에 따라 명칭이 조금씩 다르지만, Chrome과 Firefox를 기준으로 “콘솔”이라고 부르겠습니다. 콘솔을 열려면 다음 단계를 따르세요:  

• 마우스 오른쪽 버튼 클릭 후 사이트 프런트엔드의 아무 부분에서나 검사를 선택하세요

• 콘솔 선택, 페이지 오른쪽에 개발자 도구가 열리면 “Console”을 클릭하세요.

오류 확인, 콘솔을 열어 두고 예상했던 오류를 재현한 다음 콘솔을 살펴보세요. 오류는 자바스크립트 충돌이 어디에서 발생했는지 설명하는 빨간색 텍스트입니다

JavaScript 오류를 발견하셨다면, 오류의 확장된 버전을 스크린샷으로 찍어 티켓/게시물에 포함해 주세요.

문제 보고서 보내기 / 공유하기

이제 이 모든 정보를 갖추셨으니, 개발자가 프로세스 속도를 높일 수 있도록 도와주실 수 있습니다. 수집한 모든 정보를 티켓/게시물에 추가하기만 하면 됩니다. 기억해 두세요, 항목은 다음과 같습니다:  

• 디버그 로그
• 플러그인 충돌 시 주의 사항
• 오류가 포함된 자바스크립트 콘솔 캡처

이 단계를 따르고 올바른 정보를 보내주시면 개발자가 더 빠르게 디버깅 작업을 수행할 수 있습니다. 미리 감사드립니다 :)    

지원 목적으로 새 WordPress 사용자 계정 생성 및 공유

새 관리자 사용자를 만드는 것은 지원 팀에게 문제가 무엇인지 보여주는 빠른 방법 중 하나입니다. 그 과정을 시작하기 전에, 간단히 알려드리자면:

• 보안상의 이유로 문제가 해결된 후에는 이전 자격 증명을 저장하지 않습니다
• 지원 목적으로 생성한 관리자 사용자 계정은 삭제하는 것을 권장합니다
• 우리 팀과 공유된 모든 정보는 안전하게 보호되며 비공개로 유지됩니다

새 사용자를 생성하려면 먼저 관리자 사이트에 로그인하세요. 성공적으로 로그인하면 WordPress 대시보드에 있게 됩니다.

그런 다음 왼쪽 메뉴 > 사용자로 이동해야 합니다.

그 후, 상단 화면으로 이동하여 '새로 추가 ' 버튼을 클릭 하거나 왼쪽 메뉴에서 '새로 추가 ' 버튼을 선택하세요

다음으로 화면에 새 사용자 추가 양식이 나타납니다. 정보를 입력하기 위해 필수로 작성해야 하는 2개의 필드가 있습니다: 사용자명, 이메일.

비밀번호 필드에서는 무작위 비밀번호 생성기를 사용하거나 직접 설정할 수 있습니다. 그리고 사용자에게 알림 보내기 옵션을 체크하면 새 사용자에게 계정에 관한 이메일을 보낼 수 있습니다.

그런 다음 드롭다운 상자에서 사용자의 역할 을 선택합니다. 이는 사이트에서 사용자의 권한을 설정하는 중요한 단계입니다. "관리자" 는 가장 높은 수준이며 사용자에게 웹사이트의 모든 기능에 대한 액세스 권한을 부여합니다. 사용자 액세스를 제한하려면 다른 역할을 설정할 수 있습니다.

마지막으로 하단의 새 사용자 추가 버튼을 클릭하세요. 이미 완료되었습니다, 행운을 빕니다!