Instalacja wtyczki

Wymagania wstępne

Sprawdź, czy Twój serwer spełnia wymagania. Wtyczka Polski for WooCommerce 1.3.2 wymaga:

Komponent	Minimalna wersja	Zalecana wersja
WordPress	6.4+	6.7+
WooCommerce	8.0+	9.x
PHP	8.1+	8.2+
MySQL	5.7+	8.0+
MariaDB	10.3+	10.11+

Sprawdzenie wersji PHP

Nie wiesz, jaką masz wersję PHP? Sprawdź w panelu WordPress:

Przejdź do Narzędzia > Zdrowie witryny
Kliknij zakładkę Informacje
Rozwiń sekcję Serwer
Znajdź pole Wersja PHP

Wersję PHP znajdziesz też w panelu hostingu (cPanel, DirectAdmin) w ustawieniach domeny.

Sprawdzenie wersji WooCommerce

Przejdź do Wtyczki > Zainstalowane wtyczki
Znajdź WooCommerce na liście
Wersja jest wyświetlana pod nazwą wtyczki

Metoda 1: Instalacja z panelu WordPress (zalecana)

To najprostsza i zalecana metoda instalacji.

Krok 1 - otwórz panel wtyczek

Zaloguj się do panelu administracyjnego WordPress i przejdź do Wtyczki > Dodaj nową wtyczkę.

Krok 2 - wyszukaj wtyczkę

W polu wyszukiwania wpisz:

Polski for WooCommerce

Wtyczka powinna pojawić się jako pierwszy wynik. Autorem jest wppoland.com.

Krok 3 - zainstaluj wtyczkę

Kliknij przycisk Zainstaluj teraz przy wtyczce “Polski for WooCommerce”. Poczekaj, aż WordPress pobierze i rozpakuje pliki.

Krok 4 - aktywuj wtyczkę

Po zakończeniu instalacji przycisk zmieni się na Aktywuj. Kliknij go, aby aktywować wtyczkę.

Krok 5 - przejdź do konfiguracji

Po aktywacji pojawi się powiadomienie z linkiem do kreatora konfiguracji. Kliknij Skonfiguruj wtyczkę lub przejdź ręcznie do WooCommerce > Polski.

Metoda 2: Instalacja ręczna z pliku ZIP

Użyj tej metody, gdy chcesz zainstalować konkretną wersję lub serwer nie łączy się z WordPress.org.

Krok 1 - pobierz paczkę ZIP

Pobierz najnowszą wersję wtyczki z jednego z poniższych źródeł:

WordPress.org: https://wordpress.org/plugins/polski-for-woocommerce/
GitHub Releases: https://github.com/wppoland/polski/releases

Krok 2 - prześlij plik ZIP

Przejdź do Wtyczki > Dodaj nową wtyczkę
Kliknij przycisk Prześlij wtyczkę u góry strony
Kliknij Wybierz plik i wskaż pobrany plik ZIP
Kliknij Zainstaluj teraz

Krok 3 - aktywuj wtyczkę

Po przesłaniu i rozpakowaniu plików kliknij Aktywuj wtyczkę.

Metoda 3: Instalacja przez FTP/SFTP

Użyj tej metody, gdy panel WordPress nie pozwala przesyłać plików (np. przez limit rozmiaru).

Krok 1 - rozpakuj archiwum

Rozpakuj pobrany plik ZIP na swoim komputerze. Otrzymasz folder polski-for-woocommerce.

Krok 2 - prześlij na serwer

Połącz się z serwerem przez FTP/SFTP i prześlij cały folder polski-for-woocommerce do katalogu:

/wp-content/plugins/

Struktura po przesłaniu powinna wyglądać tak:

wp-content/
  plugins/
    polski-for-woocommerce/
      polski-for-woocommerce.php
      includes/
      assets/
      ...

Krok 3 - aktywuj w panelu

Przejdź do Wtyczki > Zainstalowane wtyczki w panelu WordPress i kliknij Aktywuj przy “Polski for WooCommerce”.

Instalacja przez WP-CLI

Jeśli masz dostęp do terminala serwera, możesz zainstalować wtyczkę jedną komendą:

wp plugin install polski-for-woocommerce --activate

Aby zaktualizować wtyczkę do najnowszej wersji:

wp plugin update polski-for-woocommerce

Sprawdzenie aktualnej wersji:

wp plugin get polski-for-woocommerce --fields=name,version,status

Weryfikacja instalacji

Po aktywacji wtyczki sprawdź, czy wszystko działa poprawnie:

Nowa pozycja w menu - w menu WooCommerce powinien pojawić się element Polski
Dashboard zgodności - przejdź do WooCommerce > Polski, aby zobaczyć panel główny
Brak błędów - sprawdź, czy na stronie nie pojawiły się komunikaty o błędach PHP

Sprawdzenie za pomocą shortcode

Aby sprawdzić, czy wtyczka jest aktywna, wstaw shortcode na dowolnej stronie:

[polski_version]

Shortcode pokaże wersję wtyczki (np. “1.3.2”) - to znaczy, że instalacja działa.

Rozwiązywanie problemów

Wtyczka nie pojawia się w wyszukiwarce

Sprawdź, czy Twój WordPress ma połączenie z repozytorium WordPress.org
Upewnij się, że szukasz dokładnie “Polski for WooCommerce”
Spróbuj instalacji ręcznej z pliku ZIP

Błąd “Wtyczka wymaga nowszej wersji PHP”

Twój serwer używa nieobsługiwanej wersji PHP. Rozwiązanie:

Zaloguj się do panelu hostingowego
Znajdź ustawienia PHP (zazwyczaj w sekcji “Domeny” lub “Hosting”)
Zmień wersję PHP na 8.1 lub nowszą
Poczekaj kilka minut na zastosowanie zmian
Spróbuj ponownie aktywować wtyczkę

Błąd “WooCommerce jest wymagane”

Wtyczka wymaga aktywnego WooCommerce w wersji 8.0 lub nowszej:

Upewnij się, że WooCommerce jest zainstalowany i aktywny
Zaktualizuj WooCommerce do najnowszej wersji
Ponownie aktywuj wtyczkę Polski for WooCommerce

Biały ekran po aktywacji

Jeśli po aktywacji widzisz biały ekran:

Włącz tryb debugowania WordPress - dodaj do wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Sprawdź plik logów: wp-content/debug.log
Jeśli problem dotyczy konfliktu z inną wtyczką, dezaktywuj pozostałe wtyczki i aktywuj je pojedynczo

Problemy z uprawnieniami plików

Jeśli instalacja ręczna nie działa, sprawdź uprawnienia:

# Zalecane uprawnienia dla katalogów
chmod 755 wp-content/plugins/polski-for-woocommerce/

# Zalecane uprawnienia dla plików
chmod 644 wp-content/plugins/polski-for-woocommerce/*.php

Aktualizacja wtyczki

Wtyczka aktualizuje się przez standardowy mechanizm WordPress. Gdy pojawi się nowa wersja:

Zobaczysz powiadomienie w Wtyczki > Zainstalowane wtyczki
Kliknij Zaktualizuj teraz lub użyj masowej aktualizacji
Po aktualizacji sprawdź, czy sklep działa poprawnie

Następne kroki

Po instalacji przejdź do konfiguracji wtyczki, aby włączyć moduły i dostosować ustawienia.

Masz problem, którego tu nie ma? Zgłoś go na GitHub Issues lub zapytaj na GitHub Discussions.

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Przed wdrożeniem skonsultuj się z prawnikiem. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.