Aktualizacja Shoper 5.26.54: ocena produktu w JSON-LD, rynki i koszyk — jak sprawdzić sklep krok po kroku

25 września 2026 Shoper opublikował komunikat Aktualizacja oprogramowania sklepu 5.26.52, 5.26.53 i 5.26.54. W treści są dwa punkty i jeden plik ze zmianami w szablonie Storefront. Wygląda skromnie, ale plik zmian obejmuje 43 pliki szablonu, a dwie z tych zmian dotyczą rzeczy, które sprzedawca widzi: danych strukturalnych oceny produktu i wyboru kraju, języka i waluty. Źródło: Shoper Learn — Aktualizacja oprogramowania sklepu 5.26.52, 5.26.53 i 5.26.54.

Poniżej: co dokładnie się zmieniło, kogo to dotyczy i jak w 15 minut sprawdzić swój sklep. Jeśli nie edytujesz plików szablonu, większość pracy zrobił za Ciebie Shoper — zostaje kontrola.

Co mówi komunikat Shopera

• Storefront — koszyk w nagłówku. Usunięto problem z komunikatem „Czy na pewno chcesz usunąć wszystkie produkty z koszyka” przy ikonie koszyka, który sporadycznie pojawiał się podczas odświeżania strony.
• Przelewy24 przy Shoper One. Wdrożono zmianę dla ustawiania domyślnego kanału płatności P24 (dostarczoną w aktualizacji 5.26.41).
• Zmiany w stylach graficznych: jeden plik dla Storefront (5.26.53 → 5.26.54). RWD: brak zmian.

Co jest w pliku zmian szablonu Storefront

Pobraliśmy i przeczytaliśmy plik „RevisionsDiff_storefront_shoper_5.26.53_5.26.54” (link „Pobierz” w artykule Learn). To 18 stron i 43 pliki — moduły i makra Storefront. Trzy grupy zmian:

1. Ocena produktu w danych strukturalnych — jeden wpis na produkt

W module product_rating.twig usunięto przełącznik funkcji dev_product_rating_jsonld_fix. Logika, która wcześniej działała tylko po jego włączeniu, jest teraz stała: dane strukturalne oceny (JSON-LD) dla danego produktu renderują się raz, nawet jeśli moduł oceny pojawia się na stronie kilka razy. Szablon zapamiętuje, że ocena produktu już została wypisana, i nie dubluje jej.

Dlaczego to ważne: zduplikowane dane oceny w kodzie strony to typowy powód ostrzeżeń w narzędziach Google. Podstawy danych strukturalnych w Shoperze opisaliśmy w hubie: dane strukturalne produktu w Shoperze.

2. Rynki: wybór kraju, języka i waluty bez przełącznika

W module language_and_currency.twig i makrze language_and_currency_indicator.twig usunięto warunek dev_markets. Teraz o działaniu decyduje wyłącznie to, czy w sklepie są włączone ustawienia rynków (getMarketsSettings().isEnabled). Gdy są — wskaźnik w nagłówku może pokazać flagę bieżącego kraju dostawy. To techniczny ślad Kreatora rynków, który Shoper pokazuje w nowościach 2026 jako zarządzanie krajami, językami, walutami i VAT z jednego panelu.

3. Sprawdzanie list: hasAtLeast() zamiast liczenia

W blogu, okruszkach, filtrach, listach produktów, wariantach, zestawach, galerii, opiniach i przycisku powiadomienia o dostępności warunki typu article.tags|length > 0 albo product.options.count > 0 zastąpiono metodą hasAtLeast(1). Dokumentacja Storefront tłumaczy, że hasAtLeast nie musi liczyć wszystkich elementów listy, więc przy dużych listach jest wyraźnie tańsza niż count. Klient tego nie zobaczy, ale jeśli masz własne modyfikacje szablonu, warto pisać je tak samo.

Kogo to dotyczy

Jak sprawdzić sklep po aktualizacji — krok po kroku

1. Ustal technologię szablonu. W panelu: Wygląd i treści > Wygląd sklepu. RWD — przejdź od razu do kroku 5. Storefront — idź dalej.
2. Sprawdź ocenę w danych strukturalnych. Weź produkt z opiniami i wklej jego adres do testu wyników z elementami rozszerzonymi Google. W wyniku powinna być jedna ocena zbiorcza produktu, bez ostrzeżeń o duplikacie. Zrób to też dla produktu, na którego karcie moduł oceny występuje dwa razy (np. pod nazwą i w sekcji opinii).
3. Masz zmodyfikowane pliki szablonu? Porównaj je z plikiem zmian. Pobierz PDF z komunikatu i dla każdego pliku, który edytowałeś (lista nagłówków w PDF, np. @modules/product_rating/product_rating.twig): usuń warunek dev_product_rating_jsonld_fix i zostaw logikę z jsonLdKey; usuń getFeatureFlag("dev_markets").isEnabled and z warunku rynków; zamień |length > 0 i count > 0 na .hasAtLeast(1), a |length > 1 na .hasAtLeast(2) — tak jak w okruszkach. Zmiany rób najpierw na kopii szablonu.
4. Sprawdź nagłówek z językiem i walutą. Jeśli korzystasz z rynków (sprzedaż za granicę), otwórz sklep w trybie incognito, zmień kraj dostawy i sprawdź, czy wskaźnik pokazuje właściwy kraj, język i walutę — na komputerze i telefonie. Konfigurację modułu opisuje Learn: moduł zmiany wersji językowej i waluty w nagłówku.
5. Ustaw domyślną bramkę płatności. Jeśli masz w Shoper Płatnościach aktywne Autopay i Przelewy24, w zakładce Ustawienia Shoper Płatności wybierz, która jest domyślna. Domyślna pokazuje kanały płatności „na wierzchu” w koszyku, druga jest pojedynczą formą płatności. Przy P24 jako domyślnej kupujący zaznacza dodatkowo zgodę na warunki serwisu (instrukcja Learn).
6. Przetestuj koszyk w nagłówku. Dodaj produkt, odśwież stronę kilka razy i kliknij ikonę koszyka. Komunikat o usunięciu wszystkich produktów nie powinien pojawiać się sam.
7. Złóż zamówienie testowe z wybraną bramką i potwierdź, że status płatności zmienia się automatycznie.
8. Zapisz datę kontroli. Shoper publikuje pliki zmian przy każdej wersji — przy własnych modyfikacjach szablonu warto przeglądać je na bieżąco.

Opinie i ocena: nie dubluj źródeł

Poprawka Shopera pilnuje, żeby natywny moduł oceny nie wypisywał JSON-LD dwa razy. Drugie typowe źródło duplikatów to dwa systemy opinii naraz: natywny moduł i aplikacja. GrowReview generuje dane strukturalne zbiorczej oceny tylko dla opublikowanych opinii i ostrzega przed równoległym użyciem natywnego modułu opinii. Opinię zbiera jednym mailem po zakupie, ze zdjęciem lub krótkim wideo, a oznaczenie zweryfikowanego zakupu powstaje tylko z linku połączonego z zamówieniem.

Checklista po aktualizacji 5.26.54

• Wiem, czy sklep działa na Storefront czy RWD (RWD: brak zmian w szablonie).
• Test wyników rozszerzonych Google pokazuje jedną ocenę zbiorczą produktu, bez duplikatu.
• W sklepie działa jeden system opinii: natywny moduł albo aplikacja, nie oba naraz.
• Zmodyfikowane pliki szablonu porównane z plikiem zmian 5.26.53 → 5.26.54, poprawki najpierw na kopii.
• Własne warunki w szablonie używają hasAtLeast() zamiast liczenia elementów listy.
• Wskaźnik kraju, języka i waluty w nagłówku pokazuje właściwe wartości po zmianie kraju dostawy.
• Domyślna bramka Shoper Płatności (Autopay albo Przelewy24) ustawiona świadomie.
• Koszyk w nagłówku nie pokazuje komunikatu o usunięciu produktów po odświeżeniu.
• Zamówienie testowe opłacone, status zmienił się automatycznie.

Szablon, który nadąża za aktualizacjami

Im więcej ręcznych zmian w plikach szablonu, tym więcej pracy przy każdej wersji Shopera. Jeśli zaczynasz od nowa albo planujesz zmianę wyglądu, zobacz Modern 3.0 Storefront od GrowCommerce. Gdy sprzedajesz za granicę, przyda się przewodnik sprzedaż zagraniczna i wielojęzyczność w Shoperze, a przy płatnościach — płatności online i BLIK w Shoperze.