워드프레스 스니펫 플러그인 코드 오류로 사이트 접속 안될 때

워드프레스를 사용하는 경우 WP Code, Code Snippets 등의 스니펫 코드 삽입 플러그인을 활용해야 되는 경우가 자주 있으실 텐데요. 잘못된 코드를 삽입하면, 스니펫 플러그인 코드 오류로 사이트 및 관리자 페이지에 접속이 안되는 상황이 발생할 수 있습니다.

보통 삽입한 스니펫 코드에 오류가 감지되면, 자동으로 플러그인에서 해당 스니펫을 차단하거나 비활성화하는 기능이 탑재되어 있습니다. 다만, 모든 경우 수를 탐지할 수 없기 때문에, 간혹 잘못된 코드 삽입으로 사이트에 문제가 발생할 수 있습니다. 사이트에 접속이 안된다면, 너무 당황하지 마시고 아래 방법들을 참고해서 문제가 발생한 스니펫을 제거해 보시기를 바랍니다.

1. 스니펫 플러그인 코드 오류 안전모드로 해결하는 방법

안전 모드를 사용하시면 안전하고 간단하게 문제를 해결하실 수 있습니다. 다만 로그인은 가능하지만, 관리자 페이지 및 사이트에 접속이 안되는 경우에만 가능한 방법입니다. 아래에서 WPCode와 Code snippets 플러그인 별로 안전 모드에 진입 방법을 알아보겠습니다.

WPCode 플러그인 안전모드 진입 방법

WPCode 플러그인 안전모드로 진입하는 방법에 대해서 알아보겠습니다. 워드프레스 로그인 페이지로 이동한 후, 계정 정보를 입력하고 로그인합니다.

로그인 완료 후, 브라우저 주소 창에 아래 [도메인/아래 코드] 추가해서 엔터를 눌러서 안전모드로 진입합니다. 관리자 페이지로 이동한 후, WPCode 플러그인 설정 페이지로 이동합니다.

?wpcode-safe-mode=1.

안전모드로 관리자 페이지에 접속하면 주소창에 safe-mode라고 명시되어 있는 것을 확인하실 수 있습니다. 목록에서 오류가 발생한 스니펫을 비활성화하거나 삭제해 주시면 됩니다. 스니펫 삭제 완료 후, 상단의 [Exit safe mode] 버튼을 클릭하시면 안전모드를 나가실 수 있습니다.

Code Snippets 플러그인 안전모드 진입 방법

Code Snippets 플러그인 안전모드로 진입하려면, WPCode와 같이 워드프레스 관리자 로그인을 진행한 후, [도메인/아래 코드]를 입력하시면 안전 모드로 진입하실 수 있습니다.

?snippets-safe-mode=1

Code Snippets 플러그인을 이동해서 스니펫을 비활성화 또는 삭제해 주시면 됩니다. 스니펫 수정 완료 후, 안전 모드를 나가시려면 관리자 계정 로그아웃을 한 후 기존 사이트 주소로 다시 접속해 주시면 됩니다.

2. 파일질라로 코드 스니펫 플러그인 제거하기

파일질라를 사용해서 수동으로 플러그인을 삭제하는 방식은, 로그인 페이지 및 사이트 접속 모두 불가능할 경우 해볼 수 있는 방법입니다. 다만, 이 방법은 Code Snippets을 사용하고 계신 경우에만 추천드리는 방법입니다.

WPCode 플러그인을 사용하고 계시다면 추천 드리지 않습니다. 그 이유로는 스니펫 데이터 또한 삭제를 해야 되는데, 독립된 데이터베이스 테이블에 스니펫이 저장되는 Code Snippets 플러그인과 달리 WPCode 플러그인은 post 데이터베이스 테이블에 추가되기 때문에 개발자 소프트웨어를 사용하지 않는 한 개별 삭제가 어렵습니다. 그래도 임시 방편으로 사이트에 접속하고 싶으신 경우, 파일질라를 사용해서 WPCode 플러그인을 제거하실 수는 있습니다.

파일질라에서 워드프레스 서버로 접속한 후, wp_content > plugins 경로로 이동합니다. 플러그인 폴더에서 설치한 스니펫 플러그인을 찾아서 삭제합니다. 삭제하는 방법은 폴더를 우 클릭하여 삭제를 선택하시면 됩니다.

(2023-09월 기준 폴더 이름)

WPCode 플러그인 폴더: insert-header-and-footers

Code Snippets 플러그인 폴더: code-snippets

Code Snippets 플러그인 스니펫 데이터 삭제하기

파일질라를 통해 플러그인 폴더를 삭제하면, 플러그인을 제거할 수는 있지만 생성한 스니펫 설정 값은 그대로 유지됩니다. 그 이유는 스니펫 데이터는 플러그인 폴더가 아닌 워드프레스 데이터베이스 테이블에 따로 저장되어 있기 때문입니다.

스니펫 데이터를 삭제하지 않을 시, 삭제한 플러그인을 워드프레스에 다시 설치하면 오류가 발생했던 설정 값(스니펫)이 복원되서 사이트에 오류가 다시 발생할 수 있습니다.

스니펫 데이터 삭제하는 방법

플러그인 새로 추가로 들어가서 WP Optimize를 검색해서 설치합니다.

WP-Optimize 플러그인으로 들어가서 테이블 탭으로 들어갑니다. 데이터 베이스 이름 검색란에 wp_snippets를 검색합니다. 아래 code-snippets(설치되지 않음) 링크를 클릭해서 해당 플러그인 상세 페이지로 연결되는지 확인합니다. 정보가 일치하는 경우, 제거하기 버튼을 클릭해서 데이터를 삭제하시면 됩니다.

플러그인을 다시 설치해 보시면, 생성했던 스니펫들이 모두 제거된 것을 확인하실 수 있습니다.

마치며

스니펫 플러그인 코드 오류로 사이트 접속이 안될 때, 해결 가능한 방법들에 대해서 알아봤습니다. PHP 파일들은 워드프레스 구동의 핵심 역할을 하기 때문에, 항상 주의를 기울여서 수정을 하셔야 됩니다. 또한 코드 수정을 하시기전에 항상 백업을 먼저 진행해서 이와 같은 문제가 발생했을 때를 대비하시는 것이 좋습니다.

대부분의 경우 플러그인 안전모드 진입 방식을 통해 해결이 가능합니다. 위 방법으로도 문제 해결에 어려움이 있으신 경우에는, 우선 백업을 하시고 전문가나 플러그인 고개센터에 문의하셔서 더 자세한 안내를 받으시는 것을 추천드립니다.