Sylius 2.3 przynosi zmiany, które odczujesz zarówno podczas zarządzania sklepem, jak i planowania jego dalszego rozwoju. Możesz wygodniej przygotowywać promocje dla różnych rynków, osobno kontrolować dostęp do panelu i API oraz korzystać z ciemnego motywu administracji. Zespół programistyczny otrzymuje natomiast obsługę Symfony 8, konfigurację list w PHP i stabilny mechanizm Payment Request do budowania integracji płatniczych.
Wersja 2.3 została wydana 28 września 2026 roku. Przyglądamy się najważniejszym nowościom i wyjaśniamy, co warto sprawdzić przed aktualizacją istniejącego sklepu.
Promocje dopasowane do każdego kanału sprzedaży
Jeśli prowadzisz sprzedaż na kilku rynkach, jedna kampania może wymagać różnych warunków. W jednym kraju rabat uruchamiasz przy zakupie dwóch produktów, w innym dopiero przy zakupie czterech. Podobnie może wyglądać różnicowanie sposobu naliczania zniżki.
W Sylius 2.3 reguły i działania promocji można konfigurować osobno dla poszczególnych kanałów w ramach jednej promocji. Reguła określa, kiedy klient kwalifikuje się do oferty, a działanie definiuje efekt, na przykład naliczenie rabatu. Kanał pozwala rozdzielać konteksty sprzedaży obsługiwane przez sklep.
Dla zespołu marketingowego oznacza to możliwość utrzymania wspólnej kampanii w jednym miejscu, z warunkami dopasowanymi do wybranych kanałów. Ograniczasz potrzebę tworzenia osobnych promocji tylko po to, aby zmienić jeden warunek na konkretnym rynku.
Przed uruchomieniem takiej kampanii warto rozpisać przykładowe koszyki dla każdego kanału. Sprawdź, kiedy rabat powinien się pojawić, kiedy zniknąć i jak ma współdziałać z pozostałymi ofertami. Nowa konfiguracja ułatwia zarządzanie kampanią, ale jej zgodność z Twoją polityką cenową nadal wymaga weryfikacji.
Oddzielny dostęp do panelu administracyjnego i API
Integracja z zewnętrznym systemem i pracownik obsługujący zamówienia korzystają ze sklepu w inny sposób. Integracja komunikuje się przez API, czyli interfejs do wymiany danych pomiędzy aplikacjami. Pracownik może potrzebować wyłącznie panelu administracyjnego.
Sylius 2.3 wprowadza osobne ustawienia dostępu do tych dwóch obszarów. Możesz utworzyć konto administratora z dostępem tylko do API dla integracji albo udostępnić pracownikowi panel bez włączania dostępu przez API. System chroni również przed przypadkowym odebraniem sobie dostępu do panelu.
To przydatne rozdzielenie przy porządkowaniu kont technicznych. Podczas przeglądu integracji możesz ustalić, do czego służy dane konto i kto odpowiada za jego utrzymanie. Same przełączniki dostępu nie zastępują jednak kontroli zakresu uprawnień do konkretnych danych i operacji. Te elementy również należy dopasować do zastosowania konta.
Ciemny motyw panelu administracyjnego
Nowy przełącznik w górnym pasku panelu pozwala wybrać jasny lub ciemny motyw. Początkowe ustawienie uwzględnia preferencje systemu operacyjnego, a ręczny wybór zostaje zapamiętany na kolejne wizyty.
Zmiana dotyczy panelu administracyjnego. Nie zmienia wyglądu sklepu widzianego przez kupujących. Jeśli Twój zespół spędza dużo czasu przy zamówieniach, produktach i promocjach, może dopasować wygląd narzędzia do własnych preferencji.
Przy sklepie z rozbudowanym panelem warto obejrzeć również własne widoki i dodatki. Tabele, wykresy czy oznaczenia statusów przygotowane indywidualnie powinny pozostać czytelne w obu wariantach kolorystycznych.
Symfony 8: rozwój środowiska można zaplanować etapami
Sylius 2.3 dodaje obsługę Symfony 8, zachowując zgodność z Symfony 6.4 i 7.4. To istotne dla projektów, w których aktualizacja frameworka wymaga wcześniejszego dostosowania wtyczek lub własnego kodu. Możesz rozdzielić aktualizację Syliusa od późniejszego przejścia na Symfony 8.
Wymaganie samego Syliusa 2.3 to PHP 8.3 lub nowsze. Nie oznacza to, że każda kombinacja nowszych zależności będzie działać na tej minimalnej wersji. Docelowe środowisko trzeba dobrać do całego zestawu bibliotek, z których korzysta sklep.
Z biznesowego punktu widzenia najważniejsza jest możliwość uporządkowania prac. Najpierw zespół ustala zgodność obecnych rozszerzeń z Syliusem 2.3, a następnie planuje dalszą modernizację. Pozwala to oddzielić zakresy zmian i łatwiej ustalić przyczynę ewentualnego problemu podczas testów.
Listy produktów i zamówień konfigurowane w PHP
Pod nazwą „grids” kryją się konfigurowalne listy danych, na przykład zestawienia produktów czy zamówień. Ich definicje określają kolumny, filtry i dostępne działania. To właśnie te elementy często dostosowuje się do codziennej pracy konkretnego sklepu.
Około 35 list w rdzeniu Syliusa otrzymało definicje w PHP. Dla programisty oznacza to lepsze podpowiedzi w edytorze, możliwość wykorzystania analizy statycznej i łatwiejszą przebudowę kodu. Kiedy trzeba dodać kolumnę z informacją przydatną działowi obsługi, konfiguracja może być sprawdzana narzędziami używanymi także w pozostałej części aplikacji.
YAML nadal jest obsługiwany. Format konfiguracji można wybrać globalnie lub oddzielnie dla konkretnej listy, więc migrację da się przeprowadzać stopniowo. Trzeba jednak pamiętać o ważnej zasadzie: definicje PHP i YAML tej samej listy nie są łączone. Przy przenoszeniu listy do PHP należy uwzględnić całą konfigurację, którą chcesz zachować.
Jeśli masz własne filtry, kolumny lub akcje, ich inwentaryzacja powinna znaleźć się w planie aktualizacji. Samo wyświetlenie standardowej listy po wdrożeniu nie potwierdza jeszcze, że wszystkie indywidualne usprawnienia są dostępne.
Payment Request jako stabilna podstawa integracji płatniczych
Mechanizm Payment Request przestaje być eksperymentalny i zostaje objęty zasadami kompatybilności wstecznej Syliusa. To ważna informacja dla zespołów tworzących integracje płatnicze oraz autorów wtyczek: mogą oprzeć rozwój na interfejsie objętym standardowymi regułami utrzymania projektu.
W praktyce zmniejsza się niepewność wynikająca ze statusu eksperymentalnego. Gdy planujesz nową integrację, zespół może ocenić Payment Request jako stabilną podstawę jej implementacji.
Ta zmiana nie oznacza automatycznego dodania dowolnego operatora płatności ani potwierdzenia zgodności każdej istniejącej wtyczki. Nadal trzeba sprawdzić konkretny moduł i przetestować cały przebieg transakcji: rozpoczęcie płatności, odpowiedź operatora, powrót do sklepu oraz aktualizację statusu zamówienia. Osobne scenariusze powinny obejmować przerwanie płatności i ponowienie próby.
Jak przygotować aktualizację sklepu do Syliusa 2.3
Zakres prac zależy przede wszystkim od obecnej wersji, używanych rozszerzeń i liczby indywidualnych modyfikacji. Oficjalny przewodnik przejścia z 2.2 do 2.3 jest dobrym punktem wyjścia do oceny technicznej. Przy starszym sklepie trzeba uwzględnić także zmiany z wcześniejszych wydań.
- Sprawdź środowisko i zależności. Zweryfikuj wersję PHP, Symfony oraz zgodność wtyczek. Uwzględnij środowisko produkcyjne, testowe i proces budowania aplikacji.
- Zbierz własne modyfikacje. Szczególną uwagę poświęć płatnościom, promocjom, kontom administratorów i konfiguracji list. Przewodnik aktualizacji wskazuje między innymi nowe metody w interfejsach, które mogą wymagać zmian we własnych implementacjach.
- Przygotuj środowisko testowe. Odtwórz na nim najważniejsze scenariusze sprzedaży i integracji, używając odpowiednich kont oraz danych testowych.
- Przetestuj proces zakupu. Przejdź od dodania produktu do koszyka przez promocję i wybór dostawy aż do płatności i przekazania zamówienia do systemów zewnętrznych.
- Sprawdź pracę zespołu. Zweryfikuj uprawnienia, listy danych i własne elementy panelu. Przy kilku kanałach powtórz testy dla warunków obowiązujących w każdym z nich.
- Zaplanuj wdrożenie i obserwację. Ustal okno aktualizacji, sposób odtworzenia wcześniejszego stanu oraz kontrolę błędów i zamówień po uruchomieniu nowej wersji.
Kiedy nowe funkcje będą szczególnie przydatne
Sylius 2.3 warto przeanalizować zwłaszcza wtedy, gdy rozwijasz sprzedaż na kilku rynkach, rozbudowujesz integracje albo często zmieniasz narzędzia dostępne w panelu. Promocje konfigurowane per kanał odpowiadają na potrzeby zespołu handlowego, a rozdzielenie dostępu do panelu i API pomaga uporządkować sposób korzystania z systemu.
Dla zespołu technicznego znaczenie mają również stabilizacja Payment Request i kierunek rozwoju konfiguracji w PHP. W połączeniu z obsługą kolejnych wersji Symfony dają podstawę do planowania dalszych prac nad sklepem.
Termin aktualizacji najlepiej ustalić po sprawdzeniu zależności i zakresu zmian. Jeśli chcesz ocenić, co Sylius 2.3 wniesie do Twojego sklepu, porozmawiajmy o aktualizacji i dalszym rozwoju. Zaczniemy od obecnej konfiguracji, integracji i procesów, które mają największe znaczenie dla Twojego zespołu.
Źródła
https://sylius.com/blog/news/sylius-2-3-is-here
https://github.com/Sylius/Sylius/releases/tag/v2.3.0
https://github.com/Sylius/Sylius/blob/v2.3.0/UPGRADE-2.3.md
