Theme Upload in WordPress

[워드프레스] 사용자 테마 파일이 설치되지 않는 문제가 발생하는 경우

워드프레스에서 사용자 테마 파일을 직접 설치하려면 대시보드에서 외모 > 테마를 클릭하고 상단에 표시되는 “새로 추가“를 누른 후에 “테마 업로드“를 클릭하여 원하는 테마 파일을 직접 업로드하여 수동으로 설치할 수 있습니다.

Theme Upload in WordPress

또 다른 방법으로 테마 다운로드 사이트에서 테마 파일을 다운로드하고 압축을 해제한 후에 테마 폴더를 FTP를 통해 업로드하는 방법도 가능합니다.

관리자 페이지(대시보드)에서 직접 Zip 파일 형식의 테마 파일을 업로드할 때, 종종 업로드에 실패하고 설치가 안 되는 경우가 발생할 수 있습니다. 가령 다음과 같은 메시지가 표시될 수 있습니다.

Your browser sent a request that this server could not understand.

여러 가지가 원인일 수 있는 데요, 우선 zip 파일이 올바른 테마 파일인지 확인해보시기 바랍니다. 특히 처음 유료 테마를 구입하여 테마 파일을 업로드하는 과정에서 이 문제가 많이 발생합니다. (그리고 구입한 테마가 워드프레스용 테마인지 아니면 HTML 템플릿 등이 아닌지도 확인해보시기 바랍니다.)

유료 테마를 구입하고 다운로드받은 파일에는 테마 설치 파일과 매뉴얼(Documentation), 데모 파일 등이 함께 압축되어 있을 수 있습니다. 이 경우 압축을 푼 다음에 테마 설치 파일만 업로드하면 문제 없이 설치될 것입니다.

예를 들어 현재 가장 인기 있는 유료 워드프레스 테마인 AVADA의 설치 패키지 파일을 보면 아래 그림과 같이 여러 개의 폴더로 이루어져 있습니다.

워드프레스 아바다 테마 설치 파일

패키지 파일의 압축을 해제한 후에 Avada.zip 파일과 차일드 테마 파일인 Avada-Child-Theme.zip 파일을 업로드하여 설치하도록 합니다. (테마 소스 파일을 수정하는 경우 차일드 테마(자식 테마)를 이용하여 수정하면 추후에 원 테마가 업데이트되더라도 수정 사항이 유지됩니다.)

어떤 파일이 설치 파일인지 잘 모르겠다면, 테마포레스트에서 구매한 경우 설치 파일만 다운로드하는 것도 한 방법입니다.

Download Installable WordPress file only

유료 테마/플러그인을 설치하는 방법은 이 글을 참고해보시기 바랍니다.

올바른 테마 파일을 업로드했는데에도 설치에 실패하는 경우 테마 설치 폴더를 FTP를 통해 업로드해보도록 합니다. (FTP 사용법은 여기를 참고하세요.)

올바른 테마 파일 설치/업데이트에 실패할 경우 다음과 같은 원인을 의심해볼 수 있습니다. (참고: 플러그인 설치/업데이트 실패 시에도 마찬가지로 적용됩니다.)

  • 폴더 권한(Permission) 부족
  • 웹호스팅 서버 공간 부족
  • 업로드 파일 크기 제한(참고)
  • 실행 시간 초과(이 글을 참고하여 max_execution_time을 늘려주세요.)
  • PHP 버전 확인. PHP 버전이 7.0에서 오류가 나면 5.6 등으로 하향 조정해보시고, 버전이 너무 낮으면 워드프레스 요구사항에 부합하도록 버전을 높여보시기 바랍니다.

가비아 등 일부 웹호스팅 업체에서는 보안을 이유로 충분한 권한을 주지 않는 경우가 있을 수 있습니다. 이로 인해 특정 플러그인 설치나 테마 설치에 문제가 발생할 수 있습니다. 이런 경우 FTP를 통해 설치를 시도해보고 그래도 되지 않을 경우 웹호스팅 업체에 문의하여 권한을 부여해줄 것을 요청하시기 바랍니다. (파일/폴더 퍼미션 변경을 요청하면 보안이 취약해질 수 있다는 취지의 말을 들을 수도 있습니다. 755로 설정하여 문제가 해결되면 좋겠지만 안 되면 777로 설정해야 올바르게 작동할 것입니다.)

그리고 약정한 웹호스팅 서버 공간(남은 하드 디스크 공간)이 부족하게 되면 테마, 플러그인, 워드프레스 코어 파일을 설치하거나 업데이트할 때 실패하게 됩니다. (이런 경우가 있을까 생각할 수도 있지만 의외로 이런 경우가 종종 있습니다. 특히 저가형 웹호스팅 상품을 이용하는 경우 생각보다 빨리 하드 공간이 부족하게 될 수 있습니다.)

이외에도 업로드하는 파일 크기가 너무 큰 경우 업로드 파일 크기 제한 때문에 테마 설치 파일이 업로드되지 않을 수도 있습니다.  이 경우 다음과 같은 400 Bad Request 오류 메시지가 표시될 수 있습니다.
Bad Request Your browser sent a request that this server could not understand

이 경우 이 글을 참고로 최대 업로드 파일 크기를 변경해보시기 바랍니다. 웹호스팅 서버 자체에서 파일 업로드 크기 제한이 적용되어 있는 경우 웹호스팅 업체에 문의하여 업로드 파일 크기 한도를 높이거나  FTP를 통해 업로드하시기 바랍니다. (참고로 400 Bad Request 문제는 쿠키, 잘못된 파일, 잘못된 SSL 설정 등 다양한 원인으로 발생 가능합니다. 일반적으로 브라우저의 쿠키를 삭제하면 문제가 해결될 수도 있습니다.)

추가 1: HTML 템플릿이나 Sophify 등 워드프레스 테마가 아닌 다른 템플릿을 실수로 구매하는 경우를 어쩌다 한 번씩 봅니다. 테마를 구입하기 전에 반드시 워드프레스용 테마인지 확인한 후에 구매하시기 바랍니다.

추가 2: 무료 웹호스팅을 이용할 경우 테마/플러그인 오류가 자주 발생하는 것 같습니다. 무료 웹호스팅의 경우 사양이 좋지 않은 경우가 많고 이로 인해 워드프레스에 대한 안 좋은 인식을 가질 수가 있으므로 별로 좋은 선택은 아닌 것 같습니다. 저가형을 원하는 경우 카페24에서 1000원 내외의 웹호스팅을 이용해도 괜찮을 것 같습니다. 여러 개의 워드프레스를 설치하여 테스트해보고 싶은 경우 해외 웹호스팅 서비스 중 저가형에 해당하는 iPage를 이용해볼 수 있습니다(참고).

간혹 집에서 컴퓨터에 워드프레스를 설치하여 테스트하는 경우도 있는데, 이 경우도 카페24 등의 저가형 웹호스팅(혹은 iPage같은 해외 저가형 호스팅)을 이용하는 것이 정신 건강에도 좋을 수 있습니다. 그리고 집의 컴퓨터에서 서버를 돌리는 경우 전기료도 무시 못할 것입니다.

참고: 테마나 플러그인을 설치/업데이트할 때 “설치 실패: 디렉터리를 생성할 수 없습니다“라는 오류가 발생하는 경우에도 위에서 설명한 웹호스팅 공간 부족이나 권한 부족을 의심해볼 수 있습니다.

참고:



기부를 통해 이 블로그를 후원하실 수 있습니다.
워드프레스 설치/제작/문제해결이 필요한 경우 서비스(유료)를 요청해주세요.