🎨 Szablony

Instalacja szablonu w Shopware

Kompletny przewodnik po instalacji i konfiguracji szablonów w platformie Shopware. Poznaj najlepsze praktyki i uniknij typowych błędów.

Co to jest szablon w Shopware?

Szablon (theme) w Shopware to zestaw plików określających wygląd i układ Twojego sklepu internetowego. Zawiera style CSS, szablony Twig, JavaScript oraz zasoby graficzne.

Shopware wykorzystuje system dziedziczenia szablonów, co pozwala na łatwe dostosowanie wyglądu sklepu bez modyfikacji oryginalnych plików.

Metody instalacji szablonu

1. Instalacja przez panel administracyjny

Najprostsza metoda, idealna dla użytkowników bez dostępu do serwera:

  • Zaloguj się do panelu administracyjnego Shopware
  • Przejdź do: Extensions → My extensions
  • Kliknij przycisk "Upload extension"
  • Wybierz plik ZIP z szablonem
  • Po zakończeniu przesyłania, aktywuj szablon
  • Przypisz szablon do kanału sprzedaży w Settings → Sales Channel

2. Instalacja przez SSH/FTP

Dla zaawansowanych użytkowników z dostępem do serwera:

# Rozpakuj szablon do katalogu custom
cd /var/www/html/shopware
unzip nazwa-szablonu.zip -d custom/plugins/

# Wyczyść cache
bin/console cache:clear

# Zainstaluj i aktywuj szablon
bin/console plugin:refresh
bin/console plugin:install --activate NazwaSzablonu
bin/console theme:compile

3. Instalacja przez Composer

Profesjonalna metoda zarządzania zależnościami:

# Dodaj szablon przez Composer
composer require nazwa-producenta/szablon

# Zainstaluj szablon
bin/console plugin:refresh
bin/console plugin:install --activate NazwaSzablonu
bin/console theme:compile

⚠️ Ważne wskazówki

  • Zawsze twórz kopię zapasową przed instalacją nowego szablonu
  • Sprawdź kompatybilność wersji szablonu z Twoją wersją Shopware
  • Po instalacji wykonaj theme:compile aby skompilować zasoby
  • Wyczyść cache przeglądarki i Shopware po aktywacji szablonu
  • Testuj nowy szablon na środowisku testowym przed wdrożeniem produkcyjnym

Konfiguracja szablonu

Po instalacji możesz dostosować szablon:

  1. Przejdź do Content → Themes
  2. Wybierz zainstalowany szablon i kliknij "Configure"
  3. Dostosuj kolory, czcionki, layout i inne ustawienia
  4. Zapisz zmiany i kliknij "Save and compile theme"

✅ Najlepsze praktyki

  • Używaj child theme zamiast modyfikować oryginalny szablon
  • Dokumentuj wszystkie zmiany w szablonie
  • Optymalizuj zasoby graficzne przed dodaniem do szablonu
  • Używaj narzędzi deweloperskich do debugowania CSS/JS
  • Regularnie aktualizuj szablon do najnowszej wersji