Opisy opcji atrybutów w Magento 2: UX i warianty

Dlaczego domyślne Magento 2 zostawia klienta bez kontekstu?

Domyślna karta produktu konfigurowalnego w Magento 2 zakłada, że nazwa wariantu mówi sama za siebie. Klient klika kafelek z rozmiarem „M” lub kolorem „Antracyt” i musi wierzyć na słowo, że producent myśli o tych pojęciach dokładnie tak samo jak on. W praktyce brak dodatkowych informacji o specyfice konkretnej opcji wywołuje paraliż decyzyjny, lawinę powtarzalnych pytań do supportu i niepotrzebne zwroty towaru. Aby rozwiązać ten problem na poziomie architektury sklepu, wdrożyliśmy bezpłatny moduł Attribute Description, który pozwala przypisać dedykowany opis do każdej pojedynczej wartości atrybutu.

Standardowo silnik Adobe Commerce pozwala na dodawanie opisów do samego produktu prostego lub konfigurowalnego, ewentualnie do całego atrybutu (np. etykieta „Kolor”). Nie ma jednak wbudowanego, natywnego pola tekstowego dla pojedynczej wartości (ang. attribute option value) wyświetlanego wprost przy przełączaniu wariantów. Jeśli sprzedajesz odzież, meble na wymiar, sprzęt specjalistyczny czy kosmetyki, brak możliwości dopisania dwóch zdań wyjaśnienia pod konkretnym suwakiem lub próbnikiem barw uderza bezpośrednio w konwersję.

Jak brak kontekstu przy wariancie drenuje Twój budżet?

Kiedy użytkownik waha się między dwoma rozmiarami albo zastanawia się, czym różni się wykończenie „Dąb Olejowany” od „Dąb Lakierowany”, ma do wyboru trzy ścieżki: poszukać tabeli na innej podstronie, napisać na czacie do konsultanta albo zaryzykować zamówienie dwóch sztuk z zamiarem odesłania jednej. Każdy z tych scenariuszy generuje dla sklepu realny koszt.

• Porzucenia koszyka przez tarcie poznawcze: Klient zmuszony do szukania tabeli rozmiarów w zakładkach CMS często po prostu zamyka kartę przeglądarki.
• Przeciążenie Biura Obsługi Klienta: Pytania o to, czy „Slim Fit” w danej marce wypada mniejszy niż standardowo, to klasyk każdego e-commerce fashion. Konsultanci marnują czas na odpisywanie na wiadomości, które powinny być załatwione jednym zdaniem w interfejsie.
• Koszt logistyki zwrotnej: Zamawianie dwóch rozmiarów „na przymiarkę” to zmora finansowa, szczególnie przy darmowej dostawie i darmowych zwrotach. Precyzyjny opis korygujący rozmiarówkę bezpośrednio pod opcją drastycznie zmniejsza ten nawyk.

Doświadczenie zakupowe nie polega na zmuszaniu klienta do domyślania się, co autor miał na myśli. Jeśli wariant wymaga dopowiedzenia, ta informacja musi pojawić się w ułamku sekundy dokładnie pod palcem lub kursorem użytkownika.

Co potrafi moduł Attribute Description w praktyce?

Nasz moduł rozwiązuje problem w najbardziej elegancki sposób z perspektywy Magento: rozszerza panel administracyjny o pole opisu dla każdej wartości atrybutu słownikowego (dropdown, visual swatch, text swatch). Działa to w pełnej zgodności z architekturą wielojęzyczną i wielosklepową.

• Zarządzanie per Store View: Możesz zdefiniować inny opis dla polskiego widoku sklepu, a inny dla wersji angielskiej czy niemieckiej.
• Wsparcie dla edytora WYSIWYG / HTML: W opisie możesz umieścić czysty tekst, link do poradnika, miniaturową ikonę certyfikatu czy prostą tabelę parametrów technicznych.
• Dostępność w danych JSON wariantu: Informacje o opisach są dołączane do konfiguracji wariantów (spConfig), dzięki czemu frontend (motywy Luma, Hyvä, Hyvä UI czy dedykowane PWA) może w czasie rzeczywistym podmieniać treść pod kafelkami bez wysyłania zbędnych zapytań AJAX.

Dlaczego oryginalny moduł dmatthew wylądował na cmentarzu?

Wielu programistów Magento kojarzy historyczny moduł dmatthew/magento2-attribute-description. Było to świetne narzędzie, ale jak setki innych projektów open-source padło ofiarą braku utrzymania. Oryginalne repozytorium zostało zarchiwizowane przez autora lata temu. Co gorsza, kod zawierał sztywne powiązania (tight pinning) do archaicznych wersji modułów rdzenia Magento.

Efekt? Próba wdrożenia porzuconego oryginału na Magento 2.4.7, 2.4.8 czy 2.4.9 kończy się konfliktami composera lub błędami fatalnymi na PHP 8.2 i PHP 8.4. Nawet jeśli komuś uda się go wepchnąć na siłę z flagą --ignore-platform-reqs, kolejna aktualizacja do wersji 2.4.10+ całkowicie wyłoży środowisko produkcyjne.

Jako zespół SISL nie lubimy wyrzucać dobrych koncepcji do kosza, dlatego przejęliśmy utrzymanie kodu. Stworzyliśmy aktywny fork, wyczyściliśmy zależności composerowe, dostosowaliśmy deklaracje typów do PHP 8.4 i zapewniliśmy pełną stabilność z najnowszymi wersjami platformy. Kod jest publicznie dostępny na naszym GitHubie: https://github.com/SISL-source/magento2-attribute-description.

Jak zainstalować i skonfigurować rozwiązanie krok po kroku?

Instalacja forka jest w pełni bezinwazyjna i odbywa się standardowo przez menedżera pakietów. Ponieważ repozytorium oryginalnego autora jest martwe, wskazujemy w konfiguracji Composera nasze aktywne źródło VCS.

Wystarczy wykonać w katalogu głównym projektu poniższe polecenia:

composer config repositories.sisl-attrdesc vcs https://github.com/SISL-source/magento2-attribute-description
composer require dmatthew/magento2-attribute-description:dev-main
bin/magento module:enable Dmatthew_AttributeDescription && bin/magento setup:upgrade

Po zakończeniu deploymentu i wyczyszczeniu cache w panelu administracyjnym (Stores > Attributes > Product) przy edycji dowolnego atrybutu zauważysz nową kolumnę z polem opisu obok etykiet wariantów. Wprowadzone dane są od razu zapisywane w dedykowanej tabeli bazy danych bez nadpisywania logiki core.

Jak wykorzystać opisy wartości atrybutów w merchandisingu?

Możliwości wykorzystania tego mechanizmu wykraczają daleko poza zwykłe „wypada mniejszy o pół rozmiaru”. Oto kilka sprawdzonych scenariuszy z naszych wdrożeń:

1. Składy tkanin i certyfikaty materiałowe: Przy wyborze materiału „Wełna Merino” wyświetlasz informację o gramaturze i certyfikacie Mulesing-Free. Klient nie musi szukać specyfikacji na dole długiego opisu produktu.
2. Przeznaczenie i twardość (np. materace, narty, narzędzia): Wybór wariantu „Flex 110” w butach narciarskich natychmiast pokazuje komunikat: „Dla zaawansowanych narciarzy szukających precyzji na twardym stoku”.
3. Czas realizacji dla niestandardowych opcji: Jeśli wariant „Kolor niestandardowy RAL” wydłuża produkcję o 14 dni, informujesz o tym w momencie kliknięcia w próbnik, a nie w podsumowaniu koszyka.
4. Ostrzeżenia techniczne: Informacja, że złącze „Typ C” w danym modelu obsługuje Power Delivery 65W, a wariant „Micro-USB” tylko 10W.

Tego typu mikroskopijne usprawnienia w warstwie prezentacji zdejmują z użytkownika niepewność. Kiedy interfejs odpowiada na pytania zanim te zdążą się w ogóle uformować w głowie klienta, konwersja rośnie w sposób organiczny. Jeśli potrzebujesz wsparcia w dopasowaniu logiki swatchy w swoim motywie lub planujesz migrację platformy, napisz do nas — sprawdzimy, jak zoptymalizować Twój sklep pod kątem technicznym i UX.