Problemy z instalacją lub aktywacją

4 min read

Próbowałeś zainstalować lub aktywować TTSWP i coś poszło nie tak. Instalacja nie powiodła się, wtyczka wyświetla błąd krytyczny albo menu nie pojawia się po aktywacji. Ta strona omawia najczęstsze przyczyny, od najbardziej do najmniej prawdopodobnych.

Przyczyna 1: Zbyt stara wersja PHP

Objaw: WordPress odmawia aktywacji wtyczki z błędem takim jak „Wtyczka wymaga PHP 7.2 lub nowszego” albo wyświetla białą stronę zaraz po aktywacji.

Dlaczego: TTSWP wymaga PHP 7.2 lub nowszego. Wielu hostingodawców nadal domyślnie uruchamia PHP 7.0 lub 7.1 na starszych kontach.

Rozwiązanie:

  1. Otwórz panel sterowania hostingu (cPanel, Plesk, SiteGround, Kinsta, WP Engine itp.).
  2. Znajdź selektor wersji PHP (często w sekcji „PHP Selector” lub „Site Tools - PHP Manager”).
  3. Przełącz się na PHP 8.0 lub nowszy. PHP 8.2 to obecnie zalecana wersja.
  4. Spróbuj ponownie aktywować wtyczkę.

Jeśli nie możesz zmienić wersji PHP z poziomu panelu, skontaktuj się z hostingodawcą. Praktycznie każdy hosting obsługuje PHP 8.x w 2026 roku.

Przyczyna 2: Uprawnienia plików blokują przesyłanie

Objaw: „Instalacja wtyczki nie powiodła się” lub „Nie można utworzyć katalogu” podczas przesyłania pliku zip lub instalacji z repozytorium.

Dlaczego: Katalog wp-content/plugins/ nie jest zapisywalny przez serwer WWW.

Rozwiązanie:

  1. Połącz się z witryną przez SFTP lub menedżer plików hostingu.
  2. Ustaw uprawnienia katalogu wp-content/plugins/ na 755 (lub 775 na niektórych hostingach).
  3. Ustaw uprawnienia plików wewnątrz na 644.
  4. Ponów instalację.

Na wielu zarządzanych hostingach (Kinsta, WP Engine, Pressable) menedżer plików robi to automatycznie. Jeśli utknąłeś, poproś hostingodawcę o naprawienie uprawnień katalogu wtyczek.

Przyczyna 3: Konflikt wtyczek podczas aktywacji

Objaw: Aktywacja powoduje błąd krytyczny zawierający nazwę funkcji, nazwę klasy lub komunikat „Cannot redeclare”. Witryna może przestać działać, dopóki wtyczka nie zostanie dezaktywowana.

Dlaczego: Inna aktywna wtyczka definiuje funkcję lub klasę o tej samej nazwie (rzadkie, ale możliwe) albo wtyczka zabezpieczająca blokuje aktywację.

Rozwiązanie:

  1. Zmień nazwę katalogu wp-content/plugins/text-to-speech-tts/ na text-to-speech-tts.off przez SFTP. Witryna wróci do działania.
  2. Dezaktywuj wszystkie pozostałe wtyczki w sekcji Wtyczki - Zainstalowane wtyczki.
  3. Przywróć oryginalną nazwę katalogu TTSWP.
  4. Aktywuj TTSWP jako pierwszą, a następnie reaktywuj pozostałe wtyczki jedna po drugiej. Wtyczka, która powoduje błąd przy aktywnym TTSWP, jest źródłem konfliktu.
  5. Skontaktuj się z pomocą techniczną, podając nazwę kolidującej wtyczki. Pomożemy znaleźć rozwiązanie.

Przyczyna 4: Menu Text to Speech jest niewidoczne po aktywacji

Objaw: Wtyczka jest wyświetlana jako aktywna w sekcji Wtyczki - Zainstalowane wtyczki, ale w pasku bocznym administratora nie ma pozycji Text to Speech.

Dlaczego: Twoja rola użytkownika nie ma uprawnienia manage_options albo wtyczka zabezpieczająca usunęła menu.

Rozwiązanie:

  • Zaloguj się jako Administrator. Rola Redaktora i niższe domyślnie nie widzą menu TTSWP.
  • Jeśli jesteś już Administratorem, sprawdź Użytkownicy - Profil i potwierdź, że Twoja rola to Administrator.
  • Wyłączaj wtyczki zabezpieczające, takie jak iThemes Security, ukrywanie menu administratora Wordfence lub Hide My WP, po jednej na raz i przeładuj panel. Jeśli menu pojawi się po wyłączeniu jednej z nich, skonfiguruj tę wtyczkę tak, aby zezwalała na text-to-speech-tts-settings.

Przyczyna 5: Kolumna TTS jest niewidoczna na liście wpisów

Objaw: Wtyczka działa, ale kolumna TTS nie pojawia się w sekcji Wpisy - Wszystkie wpisy.

Rozwiązanie:

  1. Otwórz Wpisy - Wszystkie wpisy.
  2. Kliknij Opcje ekranu w prawym górnym rogu ekranu.
  3. Zaznacz pole wyboru TTS.
  4. Kolumna pojawi się.

Jeśli pole wyboru w ogóle nie istnieje, Twój motyw lub inna wtyczka filtruje je. Przełącz się na standardowy motyw (Twenty Twenty-Five), aby to potwierdzić.

Przyczyna 6: Zbyt stara wersja WordPressa

Objaw: Instalacja wtyczki kończy się niepowodzeniem z komunikatem „Twoja witryna nie spełnia minimalnych wymagań”.

Dlaczego: TTSWP wymaga WordPressa 6.0 lub nowszego.

Rozwiązanie: Zaktualizuj WordPressa w sekcji Kokpit - Aktualizacje. Jeśli nie możesz zaktualizować, hostingodawca może blokować aktualizację do nowszej wersji - skontaktuj się z nim.

Przyczyna 7: Wychodzące połączenia HTTPS są blokowane

Objaw: Wtyczka instaluje się i aktywuje bez problemu, ale strona Przegląd wyświetla komunikat „Nie można połączyć się z serwerami TTSWP” albo przycisk Połącz nie reaguje.

Dlaczego: Hosting blokuje wychodzące żądania HTTPS z PHP do zewnętrznych domen. Na prawdziwych hostingach jest to rzadkie, ale często zdarza się na lokalnych środowiskach deweloperskich.

Rozwiązanie:

  • Na localhost sprawdź ustawienia zapory sieciowej lub VPN.
  • Na prawdziwym hostingu dodaj app.ttswp.com i *.ttswp.com do listy dozwolonych adresów dla wychodzącego HTTPS.
  • Zobacz Rozwiązywanie problemów z połączeniem, aby przeprowadzić bardziej szczegółowe sprawdzenie sieci.

Nadal utknąłeś?

Jeśli żadne z powyższych rozwiązań nie pomaga, zbierz poniższe informacje i skontaktuj się z pomocą techniczną:

  • Wersja WordPressa (w Kokpit - W skrócie)
  • Wersja PHP (w Narzędzia - Stan witryny - Informacje - Serwer)
  • Nazwa i wersja aktywnego motywu
  • Lista innych aktywnych wtyczek
  • Dokładna treść wyświetlanego błędu, wraz ze zrzutem ekranu, jeśli to możliwe

Powiązane strony