TTSWP를 설치하거나 활성화하려다 문제가 발생했습니다. 설치가 실패하거나, 플러그인이 치명적 오류를 표시하거나, 활성화 후 메뉴가 나타나지 않을 수 있습니다. 이 페이지에서는 가장 흔한 원인을 가능성이 높은 순서대로 다룹니다.
원인 1: PHP 버전이 너무 오래됨
증상: WordPress가 "The plugin requires PHP 7.2 or higher" 오류와 함께 플러그인 활성화를 거부하거나, 활성화 직후 흰 화면이 표시됩니다.
이유: TTSWP는 PHP 7.2 이상이 필요합니다. 많은 호스트가 오래된 계정에서 여전히 PHP 7.0 또는 7.1을 기본으로 실행합니다.
해결 방법:
- 호스팅 제어판(cPanel, Plesk, SiteGround, Kinsta, WP Engine 등)을 엽니다.
- PHP 버전 선택기를 찾습니다(보통 "PHP Selector" 또는 "Site Tools → PHP Manager" 아래에 있습니다).
- PHP 8.0 이상으로 전환합니다. PHP 8.2가 현재 권장 버전입니다.
- 플러그인을 다시 활성화해 보세요.
제어판에서 PHP를 변경할 수 없다면 호스트에 문의하세요. 2026년 기준으로 거의 모든 호스트가 PHP 8.x를 지원합니다.
원인 2: 파일 권한이 업로드를 차단함
증상: zip 파일을 업로드하거나 디렉터리에서 설치할 때 "Plugin install failed" 또는 "Could not create directory"가 표시됩니다.
이유: wp-content/plugins/ 디렉터리에 웹 서버 쓰기 권한이 없습니다.
해결 방법:
- SFTP 또는 호스트의 파일 관리자를 통해 사이트에 연결합니다.
wp-content/plugins/의 권한을 755(일부 호스트에서는 775)로 설정합니다.- 내부 파일은 644로 설정합니다.
- 설치를 다시 시도합니다.
많은 관리형 호스트(Kinsta, WP Engine, Pressable)는 파일 관리자가 이를 자동으로 처리합니다. 문제가 지속되면 호스트에 플러그인 디렉터리 권한 수정을 요청하세요.
원인 3: 활성화 시 플러그인 충돌
증상: 활성화 시 함수 이름, 클래스 이름 또는 "Cannot redeclare"를 언급하는 치명적 오류가 발생합니다. 플러그인이 비활성화될 때까지 사이트가 다운될 수 있습니다.
이유: 다른 활성 플러그인이 동일한 이름의 함수나 클래스를 정의하거나(드물지만 가능), 보안 플러그인이 활성화를 차단하고 있습니다.
해결 방법:
- SFTP로
wp-content/plugins/text-to-speech-tts/의 이름을text-to-speech-tts.off로 변경합니다. 사이트가 복구됩니다. - Plugins → Installed Plugins에서 다른 모든 플러그인을 비활성화합니다.
- TTSWP 폴더 이름을 원래 이름으로 되돌립니다.
- 먼저 TTSWP를 활성화한 다음 다른 플러그인을 하나씩 재활성화합니다. TTSWP가 활성화된 상태에서 실패하는 플러그인이 충돌 원인입니다.
- 충돌하는 플러그인 이름과 함께 지원팀에 문의하세요. 해결 방법을 찾는 데 도움을 드립니다.
원인 4: 활성화 후 텍스트 음성 변환 메뉴가 없음
증상: Plugins → Installed Plugins에서 플러그인이 활성화로 표시되지만, 관리 사이드바에 텍스트 음성 변환 항목이 없습니다.
이유: 사용자 역할에 manage_options 권한이 없거나 보안 플러그인이 메뉴를 제거했습니다.
해결 방법:
- 관리자 계정으로 로그인하세요. 편집자 이하 역할은 기본적으로 TTSWP 메뉴를 볼 수 없습니다.
- 이미 관리자로 로그인한 경우 Users → Profile에서 역할이 관리자인지 확인하세요.
- iThemes Security, Wordfence 관리자 메뉴 숨기기, Hide My WP 등의 보안 플러그인을 하나씩 비활성화하고 관리자 페이지를 새로 고침합니다. 메뉴가 다시 나타나면 해당 플러그인이
text-to-speech-tts-settings를 허용하도록 설정하세요.
원인 5: 게시물 목록에서 TTS 열이 없음
증상: 플러그인은 작동하지만 Posts → All Posts에 TTS 열이 표시되지 않습니다.
해결 방법:
- Posts → All Posts를 엽니다.
- 화면 오른쪽 상단의 화면 옵션을 클릭합니다.
- TTS 체크박스를 선택합니다.
- 열이 나타납니다.
체크박스 자체가 없다면 테마나 다른 플러그인이 이를 필터링하는 것입니다. 기본 테마(Twenty Twenty-Five)로 전환하여 확인하세요.
원인 6: WordPress 버전이 너무 오래됨
증상: "Your site does not meet the minimum requirements"와 함께 플러그인 설치가 실패합니다.
이유: TTSWP는 WordPress 6.0 이상이 필요합니다.
해결 방법: Dashboard → Updates에서 WordPress를 업데이트하세요. 업데이트할 수 없다면 호스트가 오래된 버전을 유지하고 있을 수 있으니 호스트에 업데이트를 요청하세요.
원인 7: 외부 HTTPS 연결 차단
증상: 플러그인 설치 및 활성화는 정상이지만, 개요 페이지에 "Could not reach TTSWP servers"가 표시되거나 연결 버튼이 반응하지 않습니다.
이유: 호스트가 PHP에서 외부 도메인으로의 HTTPS 요청을 차단하고 있습니다. 실제 호스트에서는 드물지만 로컬 개발 환경에서는 흔합니다.
해결 방법:
- 로컬호스트에서는 방화벽 또는 VPN을 확인하세요.
- 실제 호스트에서는 아웃바운드 HTTPS 허용 목록에
app.ttswp.com과*.ttswp.com을 추가하세요. - 더 심층적인 네트워크 점검은 연결 문제 해결을 참조하세요.
그래도 해결되지 않나요?
위 방법으로도 해결되지 않는다면 다음 정보를 수집한 후 지원팀에 문의하세요.
- WordPress 버전(Dashboard → At a Glance에서 확인)
- PHP 버전(Tools → Site Health → Info → Server에서 확인)
- 활성 테마 이름과 버전
- 다른 활성 플러그인 목록
- 발생한 정확한 오류 메시지(가능하다면 스크린샷 포함)