Jednostki sprzedaży i przeliczanie cen dla Magento 2
- Compatibilità
- 2.4.9
- Hyva Theme
- Hyva Theme Redy
- Gestione tramite IA (MCP)
- No
Descrizione / Jednostki sprzedaży i przeliczanie cen dla Magento 2
MAGENTO 2 · OPAKOWANIA · CENY JEDNOSTKOWE
Cena opakowania i sztuki. Czytelnie dla klienta.
Jednostki sprzedaży i przeliczanie cen
Sprzedajesz kartonami, ale klient porównuje cenę jednej sztuki? Oferujesz rolki, metry, kilogramy albo palety? Moduł Jednostki sprzedaży i przeliczanie cen pokazuje relację między jednostkami oraz cenę pomocniczą obliczoną z aktualnej ceny Magento. Klient może łatwiej porównać ofertę i zrozumieć, jakiej jednostki dotyczy zakup.
18 jednostek · 4 tryby prezentacji · Luma i Hyvä
JAK TO DZIAŁA W PRAKTYCE
96 zł za opakowanie
8 zł za sztukę
Jeżeli opakowanie zawiera 12 sztuk i kosztuje 96 zł, moduł pokaże także 8 zł za sztukę. Możesz wyeksponować cenę opakowania, cenę jednostkową albo obie kwoty. Przy cenie katalogowej za opakowanie ilość 1 nadal oznacza jedno opakowanie — również wtedy, gdy jako główna widoczna jest cena 8 zł za sztukę. Przykładowe kwoty mają ten sam kontekst podatkowy.
1 opakowanie = 12 sztuk
Ilość zakupu: 1 opakowanie.
Dopasuj prezentację ceny do sposobu sprzedaży
Pokaż kupującemu, jakiej jednostki dotyczy cena i ile kosztuje druga jednostka. Wybierz układ dla widoku sklepu, a w razie potrzeby zmień go na pojedynczym produkcie.
Cztery sposoby prezentacji
- Tylko jednostki: natywna cena i jej jednostka oraz jednostka przy polu ilości, bez przeliczeń.
- Cena opakowania jako główna: cena drugiej jednostki w szczegółach pod ikoną informacji.
- Cena jednostkowa jako główna: cena opakowania w szczegółach pod ikoną informacji.
- Obie ceny widoczne: cena katalogowa, relacja jednostek i druga cena bez tooltipu.
Tryb ustawisz dla widoku sklepu. Wybrany produkt może mieć własne ustawienie. Przy relacjach takich jak kilogram–gram tooltip zachowuje cenę katalogową jako główną, bez przypisywania jednostkom znaczenia opakowania.
Jednostki i konfiguracja produktu
Moduł udostępnia 18 jednostek: sztuka, moduł, opakowanie, karton, paleta, zestaw, para, rolka, godzina, dzień, metr, metr kwadratowy, metr sześcienny, litr, mililitr, kilogram, gram i tona. Na produkcie określasz jednostkę ceny i ilości, jednostki A i B, dodatni współczynnik, podstawę ceny, włączenie przeliczania i opcjonalnie tryb prezentacji.
Instalacja tworzy angielskie etykiety domyślne. Etykiety jednostek można tłumaczyć w widokach sklepu; polskie tłumaczenie interfejsu jest dołączone. Istniejące tłumaczenia i wartości produktów nie są nadpisywane.
Prezentacja w sklepie
- Karta produktu oraz listy kategorii i wyszukiwania.
- Page Builder: lista i siatka produktów oraz slider i karuzela.
- Produkty powiązane i upsell z osobnymi przełącznikami.
- Opcjonalne jednostki katalogowe w obsługiwanych obszarach koszyka, edycji pozycji, minikoszyka i podsumowania zamówienia.
Adaptery Luma i Hyvä korzystają ze wspólnego mechanizmu danych i przeliczeń. Ceny pochodzą z liczbowego modelu Magento, także przy zmianie ceny specjalnej lub progu ilościowego. Moduł nie odczytuje kwot z tekstu HTML i nie prowadzi własnych kursów walut.
Zasady ilości i pełnych opakowań
Jedna natywna jednostka ilości Magento odpowiada jednostce ceny katalogowej. Moduł nie zmienia ilości zamawianej, ceny transakcyjnej ani stanów magazynowych. Pod polem ilości pokazuje jednostkę katalogową, bez przeliczeń ilości i bez tooltipu.
Jeśli cena katalogowa dotyczy sztuki, a prezentacja ma obejmować opakowanie po 12 sztuk, potrzebne są zgodne natywne reguły Magento: zarządzanie stanem, włączona krotność, właściwe minimum i krok. Przykładowo minimum 12 i krok 12 pozwalają pokazać przeliczenie opakowania. Przy minimum 1 i wyłączonej krotności moduł pozostawi same jednostki. Ustawienia magazynowe konfigurujesz w Magento; moduł ich nie zapisuje.
Od konfiguracji do efektu
01 · Określ jednostki
Ustaw jednostkę ceny i ilości, jednostki A i B oraz podstawę ceny katalogowej.
02 · Dodaj współczynnik
Przykładowo: jedno opakowanie zawiera 12 sztuk. Włącz przeliczanie dla produktu.
03 · Wybierz sposób prezentacji
Pokaż drugą cenę w tooltipie albo wyświetl obie ceny obok siebie.
Ilość zakupu pozostaje jednoznaczna
Przy cenie katalogowej za opakowanie ilość 1 oznacza jedno opakowanie. Ta zasada obowiązuje także wtedy, gdy jako główną prezentujesz przeliczoną cenę za sztukę.
Jeśli cena katalogowa dotyczy sztuki, pełne opakowania muszą wynikać z natywnych ustawień minimum i krotności Magento.
Instalacja i utrzymanie
Pakiet Composer: kowal/module-unit-pricing. Zawiera moduł główny Kowal_UnitPricing oraz adapter Kowal_UnitPricingHyva. Wymaga PHP z rozszerzeniem bcmath. Prezentacja modułu, bramka Hyvä i opcjonalne obszary koszyka są domyślnie wyłączone. Po instalacji należy skonfigurować produkty i włączyć odpowiednie obszary w wybranym widoku sklepu.
Sprawdzony zakres i status wersji
Wersja testowa 0.1.0-beta.8. Instalację i wybrane scenariusze sprawdzono na Magento 2.4.9, PHP 8.3.36, Hyvä 1.5.3 i Page Builder 2.2.7, z adapterami Luma i Hyvä. Raport projektu obejmuje kontrole backendu, walidacji, importu, przeliczeń i prezentacji. Nie oznacza to pełnego odbioru produkcyjnego ani potwierdzenia całej macierzy wersji.
Przeliczanie obejmuje produkty proste i wirtualne bez opcji niestandardowych. Produkty konfigurowalne, grupowane, bundle, MSRP i niestandardowe typy pozostają w natywnym przepływie bez deklarowanej obsługi przeliczeń. Brak bezpośredniego adaptera Hyvä Checkout; niestandardowy checkout może wymagać dodatkowego miejsca integracji.
Otwarte pozostają m.in. pełna macierz VAT, walut i cache, końcowy zakup z płatnością, czysta instalacja bez Hyvä i Page Buildera oraz pełny odbiór mobilny. Pakiet testowano przez prywatny artefakt Composer; publikacja wydania w repozytorium dystrybucyjnym pozostaje otwarta.
Dopasuj jednostki sprzedaży do swojego sklepu
Zapytaj o wdrożenie modułu Jednostki sprzedaży i omów jednostki, reguły ilości oraz motyw używany w Twoim sklepie.
Maggiori Informazioni
| Addtocart Description |
Wersja beta. Przed wdrożeniem ustal jednostkę ceny katalogowej, reguły ilości i zgodność motywu. Dołączony adapter Hyvä; bez bezpośredniej integracji z Hyvä Checkout. |
|---|---|
| Hyva Theme | Hyva Theme Redy |
| Conformità al modello | Buono, Luma / Vuoto, Fabbro |
Change Log
0.1.0-beta.8 — wersja testowa
- Cztery tryby prezentacji ceny i nadpisanie na produkcie.
- Jednostka katalogowa pod polem ilości; bez przeliczeń i tooltipów ilości.
- Sprawdzanie minimum i krotności przy przeliczaniu opakowań z ceny za inną jednostkę.
- Zbiorczy odczyt reguł ilości Magento.
Wcześniejsze wersje beta
- Adaptery Luma i Hyvä, Page Builder, related i upsell.
- Tooltipy obsługujące fokus, kliknięcie i Escape.
- Ograniczenie tooltipów do obszaru ekranu i przeniesienie poza przycinające kontenery.
- Słownik 18 jednostek, walidacja i diagnostyka.
Testy demo nie stanowią pełnego odbioru produkcyjnego. Wydanie dystrybucyjne pozostaje do publikacji.
Configurazione dell'integrazione
Moduł nie wymaga zewnętrznego API ani konta w dodatkowej usłudze. Korzysta z cen, podatków, walut i reguł ilości Magento.
Luma ma własny adapter price-box, a Hyvä dołączony adapter Alpine. Dla niestandardowego koszyka lub checkoutu może być potrzebna integracja oparta na identyfikatorze pozycji koszyka. Nie ma bezpośredniego adaptera Hyvä Checkout.
Wymagane rozszerzenie PHP: bcmath. Zweryfikowane środowisko demo: Magento 2.4.9 / PHP 8.3.36 / Hyvä 1.5.3 / Page Builder 2.2.7. Szersze ograniczenia Composer nie są potwierdzoną macierzą zgodności.
Konfiguracja widoku sklepu
Przejdź do Sklepy → Konfiguracja → Katalog → Jednostki sprzedaży i przeliczanie cen. Włącz prezentację dla wybranego widoku, ustaw tryb i obszary. Bramkę Hyvä włącz tylko w widokach używających Hyvä. Koszyk i podsumowanie uruchamiaj osobno po sprawdzeniu integracji.
Przykład produktu: opakowanie po 12 sztuk
- W grupie Jednostki sprzedaży ustaw jednostkę ceny i ilości na opakowanie.
- Jednostka A: opakowanie. Jednostka B: sztuka. Współczynnik: 12. Podstawa ceny katalogowej: A.
- Włącz przeliczanie. Ustaw rzeczywistą cenę opakowania w natywnych polach Magento.
- Wybierz tryb lub pozostaw dziedziczenie z konfiguracji sklepu. Przy cenie 96 zł za opakowanie cena pomocnicza wyniesie 8 zł za sztukę, a ilość 1 oznacza opakowanie.
Gdy cena katalogowa dotyczy sztuki
Jednostka ceny i ilości musi wtedy oznaczać sztukę, a podstawa odpowiadać tej jednostce. Dla relacji 1 opakowanie = 12 sztuk ustaw zgodne natywne minimum i krotność, np. minimum 12 i krok 12, z aktywnym zarządzaniem stanem i przyrostami. Moduł sprawdza te reguły, lecz sam ich nie ustawia.
Tłumaczenia i odbiór
Przetłumacz etykiety jednostek dla używanych widoków sklepu. Sprawdź kartę, kategorię, wyszukiwanie, Page Builder, related i upsell, zmiany ceny, progi ilościowe i właściwe podatki. Potwierdź, że ilość i kwoty zamówienia pozostają zgodne z natywną sprzedażą. Nowy zestaw atrybutów utworzony po instalacji musi zawierać osiem pól modułu — dodaj je do zestawu, jeśli ich brakuje.
Istruzioni per l'installazione del modulo
Instalacja przez Composer
Polecenia wykonaj w katalogu głównym Magento. Przed instalacją przygotuj kopię zapasową i sprawdź moduł w środowisku testowym.
Instalacja poniżej wymaga udostępnienia zatwierdzonego wydania pakietu w repozytorium Composer Kowal. Obecnie dokumentacja projektu potwierdza instalację wersji 0.1.0-beta.8 z prywatnego artefaktu; publikacja pakietu w repozytorium dystrybucyjnym pozostaje do potwierdzenia.
1. Dodaj repozytorium Composer Kowal
composer config repositories.kowal composer https://repo.kowal.store2. Skonfiguruj dostęp do repozytorium
Dane dostępowe — adres e-mail klienta i token licencyjny — otrzymasz po zakupie e-mailem. Są również dostępne w panelu klienta po zalogowaniu na kowal.store. Zastąp TWOJ_EMAIL_KLIENTA adresem swojego konta, a TWOJ_TOKEN otrzymanym tokenem.
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"3. Zainstaluj moduł za pomocą Composer
composer require kowal/module-unit-pricingPolecenie instaluje dostępne stabilne wydanie. Jeżeli otrzymasz dostęp do wersji beta, wskaż udostępnioną wersję zgodnie z informacją od Kowal. Nie zmieniaj globalnego minimum-stability całego sklepu.
4. Włącz moduł
php bin/magento module:enable Kowal_UnitPricingJeśli sklep korzysta z Hyvä, zamiast powyższego polecenia włącz także adapter dołączony do tego samego pakietu:
php bin/magento module:enable Kowal_UnitPricing Kowal_UnitPricingHyva5. Zastosuj aktualizacje bazy danych
php bin/magento setup:upgradeJeżeli procedura wdrożenia zachowuje wcześniej zbudowane pliki generowane, można użyć opcji --keep-generated. Opcja nie zastępuje wymaganej kompilacji ani budowania zasobów.
6. Przygotuj zasoby środowiska produkcyjnego
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy pl_PL en_USDostosuj listę języków do sklepu. W Hyvä uwzględnij również proces budowania zasobów używanego motywu. Wdrożenie produkcyjne wykonaj zgodnie z procedurą sklepu, w trybie konserwacji lub przez przygotowane wydanie.
7. Odśwież indeksy i pamięć podręczną
php bin/magento indexer:reindex
php bin/magento cache:clean8. Sprawdź instalację i słowniki jednostek
php bin/magento module:status Kowal_UnitPricing
php bin/magento unitpricing:checkKomenda diagnostyczna tylko odczytuje dane. Ustawienia widoku sklepu, jednostek produktów i przykłady znajdziesz w zakładce konfiguracji modułu.