Błąd podczas instalacji motywu WordPress najczęściej wynika ze źle przygotowanego archiwum ZIP albo zbyt niskich limitów serwera. Sprawdź najpierw komunikat, a następnie wybierz właściwą ścieżkę naprawy.
Co oznacza komunikat błędu?
| Komunikat błędu | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| W motywie brakuje arkusza stylów style.css | Przesłano całą paczkę z dokumentacją albo ZIP zawiera dodatkowy folder lub inne archiwum. | Znajdź właściwy plik ZIP motywu i prześlij go ponownie. |
| Przekroczony limit rozmiaru pliku | Archiwum motywu jest większe niż wartość ustawiona w PHP. | Zwiększ parametry upload_max_filesize i post_max_size. |
| Instalacja nie powiodła się | Problem z archiwum, serwerem albo zgodnością motywu z wersją WordPress. | Sprawdź ZIP, limity serwera i wymagania motywu. |
Brak arkusza stylów style.css – jak naprawić?
WordPress rozpoznaje motyw między innymi po pliku style.css. Plik powinien znajdować się w folderze motywu, razem z pozostałymi plikami, a nie w przypadkowym katalogu z dokumentacją.
Przed zmianą plików wykonaj kopię zapasową plików strony i bazy danych. Jeśli pracujesz na istniejącej witrynie, zachowaj także kopię oryginalnego archiwum.
- Otwórz pobrany plik ZIP w programie do obsługi archiwów, na przykład 7-Zip lub WinRAR.
- Sprawdź, czy w środku znajduje się folder motywu albo kolejne archiwum ZIP zawierające pliki motywu.
- Jeśli pobrałeś z ThemeForest paczkę „All files & documentation”, rozpakuj ją i odszukaj osobny plik ZIP przeznaczony do instalacji motywu.
- Otwórz właściwe archiwum i sprawdź, czy folder motywu zawiera plik style.css.
- W kokpicie WordPress przejdź do „Wygląd”, „Motywy”, „Dodaj nowy”, a następnie wybierz „Wyślij motyw na serwer” i prześlij znaleziony plik ZIP.
Nie pakuj ponownie całej paczki z dokumentacją. Jeśli właściwy folder motywu nie jest archiwum, możesz spakować właśnie ten folder do ZIP-a. Jego struktura powinna prowadzić bezpośrednio do plików motywu, w tym do style.css.
Błędy limitów serwera – upload_max_filesize i post_max_size
Jeżeli WordPress odrzuca większy plik, przyczyną może być konfiguracja PHP. Parametr upload_max_filesize określa maksymalny rozmiar przesyłanego pliku, a post_max_size ogranicza rozmiar całego żądania formularza. Oba limity muszą uwzględniać wielkość archiwum motywu.
Wartość 64–128 MB zwykle wystarcza dla typowych motywów. Przy większych paczkach można ustawić limit do 512 MB, jeśli pozwala na to hosting i rzeczywiście jest to potrzebne.
- Zaloguj się do panelu hostingu i znajdź ustawienia wersji lub konfiguracji PHP dla domeny z WordPressem.
- Odszukaj parametry upload_max_filesize oraz post_max_size.
- Ustaw wartości większe niż rozmiar instalowanego archiwum, na przykład 128 MB lub 512 MB, zależnie od oferty hostingu.
- Zapisz zmiany i spróbuj ponownie przesłać motyw w menu „Wygląd” → „Motywy” → „Dodaj nowy”.
Układ panelu zależy od dostawcy hostingu. Jeśli nie widzisz tych ustawień albo zmiana nie działa, skontaktuj się z pomocą techniczną. Nie edytuj plików konfiguracyjnych serwera bez kopii zapasowej i wiedzy, które wartości możesz zmienić.
Instalacja motywu przez FTP
FTP pozwala ominąć formularz przesyłania w kokpicie WordPress. Metoda przydaje się wtedy, gdy archiwum jest zbyt duże, ale masz dostęp do serwera.
Przygotuj właściwy folder motywu, czyli ten, w którym znajduje się style.css, a następnie:
- Zainstaluj klienta FTP, na przykład FileZilla, i połącz się z serwerem.
- Otwórz katalog /wp-content/themes/ po stronie serwera.
- Prześlij do niego rozpakowany folder motywu.
- Wejdź w WordPressie do „Wygląd” → „Motywy” i aktywuj przesłany motyw.
Jeśli motyw nadal nie pojawia się na liście, sprawdź, czy nie został przesłany o jeden poziom za głęboko. WordPress powinien znaleźć plik w ścieżce podobnej do /wp-content/themes/nazwa-motywu/style.css. Gdy problem występuje mimo poprawnej struktury i zwiększonych limitów, sprawdź wymagania motywu oraz jego zgodność z używaną wersją WordPress.
