Kalkulator ilości według powierzchni i objętości: instalacja i konfiguracja

Instalacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, przesyłając plik ZIP, albo skopiuj folder dfsurfacecalculator do katalogu /modules/ sklepu i kliknij Zainstaluj.

Podczas instalacji moduł tworzy trzy tabele (ustawienia produktów, wartości dla kombinacji, obliczenia zapisane w koszykach), rejestruje swoje hooki i dodaje zakładkę Kalkulator ilości w menu Katalog. Przycisk Konfiguruj w menedżerze modułów otwiera tę samą stronę.

Dopóki żaden produkt nie jest skonfigurowany, kalkulator nie pojawia się na żadnej stronie produktu. Możesz więc zainstalować moduł w działającym sklepie bez natychmiastowej widocznej zmiany.

Pięć typów obliczeń

• Płytki i podłogi (m²): długość × szerokość każdego pomieszczenia lub znana powierzchnia. Zawartość jednostki to powierzchnia pokrywana przez jedną paczkę.
• Farba (litry): długość × wysokość każdej ściany, liczba warstw, wydajność w m² na litr, odjęcie drzwi i okien. Zawartość jednostki to pojemność puszki.
• Tapeta (rolki): szerokość i wysokość każdej ściany. Moduł liczy pasy, zaokrągla długość każdego pasa do raportu wzoru i oblicza liczbę pełnych pasów z rolki.
• Objętość: beton, żwir, ziemia (m³): długość × szerokość × grubość w centymetrach lub znana objętość. Wynik jest podawany w m³ na jednostkę albo w workach, jeśli podasz gęstość materiału i wagę worka.
• Długość: listwy przypodłogowe, profile (m): długość każdej ściany lub odcinka. Zawartość jednostki to długość jednej sztuki.

Konfiguracja produktu

Otwórz stronę produktu, zakładka Moduły, blok Kalkulator ilości.

1. Zaznacz Pokaż kalkulator dla tego produktu.
2. Wybierz Typ obliczenia i jednostkę sprzedaży w polu Sprzedawany jako (paczka, opakowanie, puszka, wiadro, rolka, worek, sztuka, paleta lub jednostka). To jednostka widoczna dla klienta: „Potrzebujesz 12 paczek”.
3. Wpisz zawartość jednej jednostki. Etykieta pola zmienia się zależnie od typu: powierzchnia pokrywana przez jedną jednostkę, pojemność jednej puszki, rolki w jednostce, objętość jednej jednostki lub długość jednej sztuki.
4. Uzupełnij pola właściwe dla typu obliczenia (patrz niżej).
5. Kliknij Zapisz ustawienia kalkulatora. Ustawienia zapisują się też przyciskiem zapisu całej strony produktu.

Farba

Podaj Wydajność w m² na litr, tak jak na puszce, oraz Domyślnie proponowana liczba warstw. Opcja Pozwól klientowi odjąć drzwi i okna dodaje dwa pola do kalkulatora; powierzchnię odejmowaną za drzwi i okno ustawia się w konfiguracji modułu (domyślnie 1,7 m² i 1,5 m²).

Tapeta

Podaj Szerokość rolki w centymetrach, Długość rolki w metrach i Raport wzoru w centymetrach (0 lub puste dla tapety bez wzoru). Jeśli produkt jest sprzedawany na rolki, zostaw pole „Rolki w jednostce” puste. Każdy pas to wysokość ściany plus 10 cm na docięcie, zaokrąglona w górę do następnego raportu.

Objętość sprzedawana w workach

Dla produktu sprzedawanego na wagę zostaw objętość jednostki pustą i podaj Gęstość materiału w kg/m³ oraz Waga jednej jednostki w kg. Moduł przelicza wtedy objętość na wagę, a następnie na liczbę worków. Wartości orientacyjne: żwir 1500 do 1700, piasek 1600, sucha mieszanka betonowa 2000.

Własny zapas na docinki dla produktu

Pole Domyślny zapas na docinki dla tego produktu zastępuje wstępnie wybrany zapas tylko dla tego produktu. Zostaw je puste, aby użyć wartości modułu. Jeśli wpisana wartość nie należy do proponowanych opcji, zostaje dodana do opcji tego produktu.

Wartości dla kombinacji i połączenie opakowań

Jeśli produkt ma kombinacje, pojawia się tabela Wartości dla kombinacji. Uzupełnij tylko kombinacje, których zawartość różni się od wartości produktu, na przykład puszkę 2,5 L i 10 L. Dla produktu sprzedawanego na wagę wartość to waga jednej jednostki w kg.

Jeśli kombinacje są wielkościami opakowań, zaznacz Kombinacje to wielkości opakowań: proponuj najtańsze połączenie rozmiarów. Pod wynikiem kalkulator pokazuje wtedy połączenie rozmiarów pokrywające zapotrzebowanie najniższą ceną, oszczędność względem wybranego rozmiaru oraz przycisk dodający wszystkie pozycje do koszyka. Wyszukiwanie obejmuje pięć rozmiarów z najlepszą ceną za jednostkę zawartości.

Użycie cechy produktu

Jeśli katalog podaje już zawartość jednostki w cesze (na przykład „Powierzchnia paczki: 1,44”), wybierz ją w konfiguracji w polu Cecha z zawartością jednostki. Służy jako wartość domyślna, gdy pole produktu jest puste. Tak samo działa wydajność farby z Cecha z wydajnością farby. Moduł odczytuje pierwszą liczbę z wartości, z przecinkiem lub kropką.

Masowa aktywacja według kategorii

Na stronie modułu blok Masowe przypisanie według kategorii włącza lub wyłącza kalkulator dla wszystkich produktów wybranych kategorii, z podkategoriami, jeśli pole jest zaznaczone. Wybierz typ obliczenia i jednostkę sprzedaży. Domyślnie produkty już skonfigurowane zachowują swoje ustawienia; zaznacz Zmień także typ i jednostkę produktów już skonfigurowanych, aby je nadpisać. Wpisane już wartości opakowań nigdy nie są usuwane.

Ustawienia modułu

Wyświetlanie

• Pozycja na stronie produktu: pod przyciskiem Dodaj do koszyka (hook displayProductAdditionalInfo), obok akcji produktu (displayProductActions) lub własny hook.
• Kolor akcentu: kolor przycisków, wyboru zapasu i wyniku.
• Cena za m², litr, metr lub m³: wyświetla „czyli 22,85 zł / m²” pod ceną, na stronie produktu i na listach produktów.
• Zapisz obliczenie z pozycją koszyka: zachowuje wymiary klienta dla koszyka i strony zamówienia w panelu.
• Odejmowana powierzchnia drzwi i Odejmowana powierzchnia okna w m².

Zapasy na docinki

Dla każdego typu obliczeń wpisz opcje proponowane klientowi, w procentach, oddzielone przecinkami (na przykład 5,10,15), oraz wstępnie wybrany zapas. Wartości po instalacji: płytki 5, 10 i 15 % (domyślnie 10), farba 0 do 15 % (10), tapeta 0 do 10 % (5), objętość 0 do 10 % (5), listwy 5 do 15 % (10).

Własny hook

Aby umieścić kalkulator w innym miejscu strony produktu, wybierz pozycję „Własny hook” i dodaj ten wiersz do szablonu produktu w motywie:

{hook h='displayDfSurfaceCalculator' product=$product}

Strony SEO kalkulatora

Każdy typ obliczeń może mieć własną publiczną stronę z kalkulatorem, Twoimi produktami tego samego typu z ilością i ceną obliczoną dla wymiarów odwiedzającego, wyjaśnieniem metody i linkami do innych kalkulatorów. Adresy mają postać /kalkulator/plytki-podlogi, /kalkulator/farba, /kalkulator/tapeta. Lista opublikowanych stron i ich linki znajdują się na górze strony modułu.

• Włącz strony kalkulatora i Strony do opublikowania: publikuj tylko typy pasujące do Twojego katalogu.
• Prefiks URL: wspólny dla wszystkich języków, ustalany przy instalacji według domyślnego języka sklepu.
• Liczba produktów na stronie: domyślnie 12, 0 ukrywa listę.
• Dla każdej strony i każdego języka: Przyjazny URL, Tytuł (H1 i znacznik title), Meta opis i Tekst wprowadzający. Tytuły i adresy przygotowane pod popularne wyszukiwania są wstępnie wypełnione w 8 językach.

Strony zawierają canonical, znaczniki hreflang aktywnych języków i okruszki. Są automatycznie dodawane do mapy witryny modułu gsitemap PrestaShop przy jej następnym generowaniu. Adres w innym języku przekierowuje kodem 301 na adres w wyświetlanym języku. Jeśli zmienisz przyjazny URL, stary adres przestaje działać: ustaw przekierowanie, jeśli strona była już zaindeksowana.

Co widzi klient

Klient wpisuje jedno lub kilka pomieszczeń, ścian lub obszarów. Każdy blok pokazuje swoją sumę częściową. Od drugiego obszaru pole Odejmij ten obszar pozwala odjąć wyspę, przeszklenie lub szafę. Następnie wybiera zapas spośród Twoich wartości.

Wynik pokazuje powierzchnię lub objętość, zapotrzebowanie z zapasem, liczbę jednostek, łącznie pokrytą powierzchnię z zapasem i szacowaną cenę. Przycisk Dodaj do koszyka: 12 paczek wypełnia pole ilości i uruchamia przycisk koszyka motywu. Link Użyj tej ilości tylko wypełnia pole. Gdy produkt jest niedostępny, proponowany jest wyłącznie ten link.

Wartość nienumeryczna jest oznaczana na czerwono i blokuje wynik. Bardzo duża wartość, na przykład 120 m jako długość pomieszczenia, wyświetla przypomnienie o oczekiwanej jednostce. Wymiary są zachowywane w trakcie sesji: odwiedzający odnajduje je między stroną kalkulatora a stroną produktu.

Koszyk i zamówienia

Gdy klient dodaje produkt do koszyka z kalkulatora, jego wymiary są zapisywane z pozycją. Koszyk wyświetla podsumowanie pod produktem, na przykład „Powierzchnia 14,7 m² + 10% = 16,17 m². Obliczono: 12 paczek”, i sygnalizuje, jeśli ilość została później zmieniona. W panelu strona zamówienia pokazuje blok Obliczenia ilości z tymi samymi informacjami.

Rozwiązywanie problemów

Kalkulator nie pojawia się na stronie produktu

Sprawdź na liście skonfigurowanych produktów, czy produkt jest aktywny i nie ma statusu Niekompletny. Następnie sprawdź, czy hook wybranej pozycji istnieje w motywie; w razie wątpliwości wypróbuj drugą pozycję lub własny hook. Po każdej zmianie wyczyść pamięć podręczną sklepu.

Komunikat „Brak informacji o opakowaniu dla tej opcji”

Wybrana kombinacja nie ma zawartości, produkt również. Podaj wartość produktu lub wartość kombinacji w tabeli wartości dla kombinacji.

Strona kalkulatora zwraca błąd 404

Sprawdź, czy strony są włączone, a typ zaznaczony w Strony do opublikowania. Jeśli przyjazne adresy URL są w sklepie wyłączone, strona pozostaje dostępna pod długim adresem podanym na górze strony modułu.

Połączenie opakowań się nie wyświetla

Opcja musi być zaznaczona, co najmniej dwie kombinacje muszą mieć zawartość i cenę, a połączenie jest proponowane tylko wtedy, gdy kosztuje mniej niż wybrany rozmiar.

Cena za m² nie pojawia się na listach produktów

Wyświetla się przez hook displayProductPriceBlock typu unit_price, którego niektóre motywy nie wywołują w miniaturach produktów. Dodaj wywołanie do szablonu miniatury lub wyłącz opcję.

Zgodność

• PrestaShop od 8.0 do 9.x, ten sam ZIP obsługuje obie wersje.
• Multisklep i wielojęzyczność.
• Architektura ModuleAdminController, bez zależności Composer.
• Interfejs i teksty kalkulatora dostępne po francusku, angielsku, hiszpańsku, niemiecku, włosku, niderlandzku, polsku i portugalsku.