Local에서 워드프레스 테마 수정하기: 테스트와 복원 순서
Local에서 테마를 수정할 때는 바뀐 화면만 보는 것보다 기존 기능이 유지되는지 확인하는 일이 중요합니다. 이 글은 운영 중인 테마를 사본에서 변경하고, 문제가 생기면 되돌린 뒤 서버에 반영할 범위를 정하는 절차입니다. 새 테스트 사이트가 필요하다면 Local 설치·접속·백업 안내부터 시작하세요.
목차
운영 사이트와 비교할 기준을 만듭니다
작업 전에 WordPress·PHP·테마·주요 플러그인 버전과 활성 테마 폴더를 기록합니다. 로컬과 서버의 웹서버, 캐시, 파일 권한이 다르면 결과도 달라질 수 있습니다. 로컬에서 성공했다고 운영 환경까지 검증된 것은 아닙니다.
홈, 글 상세, 카테고리, 문의폼과 실제 사용하는 도구를 변경 전 상태로 열어 봅니다. 원래 있던 문제를 이번 수정 때문에 생긴 문제로 착각하지 않도록 화면과 재현 순서를 남기세요.
수정할 테마 폴더부터 확인하세요
Local의 사이트 경로에서 app/public/wp-content/themes로 이동합니다. 폴더가 여러 개라면 WordPress 관리자에서 활성 테마를 확인하세요. 폴더 이름과 style.css의 Theme Name·Version은 별개이므로 이름만 보고 판단하지 않습니다.
배포받은 부모 테마를 직접 수정하면 다음 업데이트로 변경분이 덮어써질 수 있습니다. 자식 테마로 분리할 수 있는 변경인지 먼저 확인하세요. 직접 관리하는 자체 테마라면 수정 전 버전과 변경 파일을 보관합니다. WordPress 자식 테마 안내에서 부모 테마와의 관계를 확인할 수 있습니다.
백업 후 한 가지 변경부터 시험합니다
- Local 사이트를 내보내거나 복구 가능한 파일·DB 백업을 만듭니다. 이전 상태로 돌아갈 수 있는지 확인합니다.
- 변경 목적을 한 문장으로 적습니다. 예: 모바일에서 메뉴 버튼이 본문과 겹치는 문제를 고친다.
- 관련 파일을 수정하고 같은 조건으로 다시 확인합니다. 서로 무관한 기능을 한꺼번에 바꾸지 않습니다.
- 해결됐으면 변경 파일, 테스트한 화면, 남은 환경 차이를 기록합니다.
- 문제가 생기면 직전 변경을 되돌려 비교합니다. 저장된 설정도 바꿨다면 파일만 복원해서는 원상복구되지 않을 수 있습니다.
Local 내보내기를 이용한 백업 방법은 공식 백업 안내를 참고하세요. 이 절차는 특정 테마에 대해 실제 테스트를 수행했다는 결과 보고서가 아니라 작업할 때 사용할 점검 순서입니다.
화면과 기능을 함께 확인하세요
- 화면: 좁은 화면에서 가로 넘침, 잘린 버튼, 읽기 어려운 글자가 없는지 봅니다.
- 이동: 메뉴·푸터·관련 글 링크가 의도한 주소로 열리는지 확인합니다.
- 입력: 도구에 정상값·빈값·잘못된 값을 넣고 결과와 오류 안내를 확인합니다.
- 권한: 로그인 상태에서만 정상인 기능이 아닌지 로그아웃 상태도 확인합니다.
- 오류: PHP 로그와 브라우저 콘솔에서 변경 후 새 오류가 발생했는지 봅니다.
바뀐 코드가 보이지 않을 때
먼저 활성 테마와 수정 파일의 위치가 맞는지 확인하세요. 브라우저 개발자 도구에서 실제 불러온 CSS·JS 주소가 작업한 파일인지 비교합니다. 파일이 맞다면 브라우저와 WordPress 캐시를 필요한 범위에서 비우고 다시 확인합니다. 사이트 재시작은 파일 경로나 활성 테마가 틀린 문제를 해결하지 못합니다.
외부 연결과 공유 기능은 별도로 관리합니다
운영 데이터 사본에 남은 메일 발송, 결제, 웹훅과 외부 API 설정을 테스트용으로 분리하세요. 폼 전송이나 예약 작업이 실제 서비스로 요청을 보내지 않는지 확인합니다.
Live Links는 로컬 사이트를 다른 사람에게 보여주는 기능입니다. 단순히 컴퓨터 안에서만 작업하는 상태와 구분하고 공유할 데이터와 접근 설정을 확인하세요. 필요한 동안만 사용하고 끝나면 끕니다. Live Links 공식 안내를 참고하세요.
서버에는 검증한 변경 범위만 반영하세요
Local Connect의 직접 연결 대상은 WP Engine과 Flywheel입니다. 모든 호스팅에서 같은 배포 버튼을 사용할 수 있는 것은 아닙니다. 지원 환경과 파일·DB 전송 범위는 Local Connect 안내에서 확인하세요.
테마 파일만 고쳤다면 운영 DB까지 통째로 덮어쓰지 않도록 배포 범위를 구분합니다. 로컬 작업 중 운영 사이트에 새 글이나 문의가 들어왔을 수 있습니다. 서버 백업과 복원 방법을 준비한 뒤 반영하고, 공개 URL의 메뉴·폼·도구·robots·사이트맵을 다시 확인하세요.
전체 작업 흐름은 워드프레스 운영 가이드에서 정리할 수 있습니다. 로컬 설치 자체가 막혔다면 Local 설치·접속·백업 안내로 돌아가 실행과 접속 상태부터 확인하세요.