Coverwick
- Strona wtyczki: https://plogins.com/pl/coverwick/
- Dokumentacja: https://plogins.com/pl/coverwick/docs/
- Autor: WPPoland.com
- Kontrybutor WordPress.org: motylanogha
- Kod źródłowy: https://github.com/wppoland/coverwick
Coverwick jest dla sklepów WooCommerce, które sprzedają deski, panele albo płytki na sztuki, a klienci liczą w metrach kwadratowych. Klient wpisuje powierzchnię, wtyczka liczy sztuki, a powierzchnia idzie razem z pozycją do koszyka, kasy i zamówienia. Płatne próbki pozwalają najpierw zobaczyć kolor.
Ekrany wtyczki są na razie po angielsku, dlatego nazwy pól podajemy w oryginale.
Pokrycie na produkcie
Dział zatytułowany „Pokrycie na produkcie”Na ekranie edycji produktu, w zakładce Ogólne, wypełnij pole Coverage per unit: powierzchnię, którą pokrywa jedna sprzedawana sztuka, na przykład 0,76 dla deski albo 0,72 dla paczki płytek. Separatorem dziesiętnym może być przecinek albo kropka. Puste pole wyłącza kalkulator dla tego produktu.
Warianty mają własne pole Coverage per unit. Wariant bez własnej wartości bierze wartość z zakładki Ogólne.
Kalkulator na karcie produktu
Dział zatytułowany „Kalkulator na karcie produktu”Produkt z pokryciem dostaje pole Area nad polem ilości. Oba pola są połączone:
- Klient wpisuje metry kwadratowe, a liczba sztuk liczy się sama, zaokrąglona w górę do całej sztuki. Gdy pole straci fokus, powierzchnia zmienia się na tę, którą te sztuki naprawdę pokrywają.
- Klient zmienia liczbę sztuk, a powierzchnia się przelicza.
- W produkcie z wariantami pole powierzchni jest puste, dopóki klient nie wybierze wariantu. Potem liczy według pokrycia tego wariantu. Wpisana powierzchnia zostaje i jest przeliczana po zmianie wariantu.
Zaokrąglenie jest zawsze w górę: 7,6 m2 przy 0,76 m2 na deskę to dokładnie 10 desek, a 7,7 m2 to 11. Wtyczka nie dolicza zapasu na docinki. Jeśli sklep go stosuje, uwzględnij go w wartości pokrycia.
Cena za jednostkę powierzchni
Dział zatytułowany „Cena za jednostkę powierzchni”Cena za jednostkę powierzchni pokazuje się pod ceną produktu, zgodnie z ustawieniem wyświetlania podatku w sklepie. Produkt z wariantami pokazuje najniższą cenę z dopiskiem “from”.
Najniższa cena za jednostkę powierzchni każdego produktu trafia też do pola produktu _coverage_price_per_m2 (kropka jako separator), żeby filtry katalogu mogły z niej korzystać. Wtyczka aktualizuje ją przy zapisie, usunięciu, przeniesieniu do kosza i przywróceniu produktu lub wariantu, a także wtedy, gdy zaplanowana promocja się zaczyna lub kończy.
Koszyk, kasa i zamówienia
Dział zatytułowany „Koszyk, kasa i zamówienia”Powierzchnia widnieje przy pozycji w koszyku i w kasie, na klasycznych stronach koszyka i kasy oraz w blokach koszyka i kasy. Zawsze wynika z ilości, więc zmiana ilości w koszyku ją aktualizuje. Pozycje zamówienia zapisują powierzchnię i pokazują ją w e-mailach, w Moim koncie i na ekranie zamówienia.
Płatne próbki
Dział zatytułowany „Płatne próbki”Zaznacz na produkcie Sample available, a na jego karcie pojawi się przycisk zamówienia próbki. Przycisk jest widoczny także wtedy, gdy produktu nie ma w magazynie.
- Każda próbka to osobna pozycja koszyka z nazwą produktu (i wariantu) i własną ceną: domyślną z ustawień albo z pola Sample price na produkcie. Przycisk pokazuje cenę z podatkiem albo bez, tak jak sklep wyświetla ceny.
- W produkcie z wariantami klient najpierw wybiera opcje, a potem zamawia próbkę tego wariantu.
- Każdy produkt (i każdy wariant) można zamówić jako próbkę raz na koszyk. W ustawieniach określasz maksymalną liczbę próbek w jednym koszyku.
- Ilości próbki nie da się zmienić, także w bloku koszyka.
- Próbki są sprzedawane przez jeden ukryty produkt wewnętrzny “Sample (internal product used by Coverwick, do not delete)”, więc stan magazynowy i sprzedaż prawdziwego produktu się nie zmieniają. Tego produktu nie da się dodać do koszyka bezpośrednio i nie pojawia się w sklepie, wyszukiwarce, kanale RSS produktów, mapie witryny WordPress ani w publicznym REST API produktów. Jeśli zostanie usunięty, wtyczka utworzy go ponownie przy następnym zamówieniu próbki. Wcześniejsze zamówienia zachowują swoje pozycje z próbkami.
Ustawienia
Dział zatytułowany „Ustawienia”WooCommerce > Coverwick:
| Ustawienie | Co robi |
|---|---|
| Area unit | Jednostka przy wartościach powierzchni, domyślnie m2. Końcowa cyfra 2 lub 3 wyświetla się jako indeks górny. |
| Enable samples | Pokazuje przycisk próbki na produktach z zaznaczonym Sample available. |
| Default sample price | Cena próbki, gdy produkt nie ma własnej. |
| Samples per order | Maksymalna liczba próbek w jednym koszyku. |
| Sample shipping class | Klasa wysyłki dla pozycji z próbkami, na przykład tani list albo paczka. |
Dla programistów
Dział zatytułowany „Dla programistów”- PHP: akcja
coverage/booteduruchamia się po starcie wtyczki. - JavaScript: pole kalkulatora wysyła zdarzenie
coverage:change(z propagacją) z danymi{ area, pieces, perUnit, price, productId, variationId }.
Odinstalowanie
Dział zatytułowany „Odinstalowanie”Usunięcie wtyczki usuwa ukryty produkt próbki i opcje wtyczki (coverage_settings, coverage_db_version, coverage_sample_product_id), na każdej witrynie sieci multisite. Pokrycie zapisane na produktach i powierzchnia na wcześniejszych zamówieniach zostają.
Coverwick Pro
Dział zatytułowany „Coverwick Pro”Coverwick Pro to płatny dodatek w przygotowaniu. Wymaga darmowej wtyczki i dodaje na produkcie pole Complete the set: wiersze z akcesoriami (produkt albo wariant), ilością na jednostkę powierzchni i wielkością opakowania. Na karcie produktu akcesoria pojawiają się pod nagłówkiem “Choose the remaining installation elements”. Ilość w opakowaniach to powierzchnia x ilość na jednostkę / wielkość opakowania, zaokrąglona w górę i przeliczana na żywo ze zdarzenia coverage:change. Przycisk “Add the whole set to cart” dodaje deski i akcesoria jednym żądaniem. Każda pozycja jest sprawdzana przed dodaniem (czy można ją kupić, stan magazynu razem z koszykiem, walidacja dodawania do koszyka WooCommerce), a gdy dodanie mimo to się nie uda, koszyk wraca do poprzedniego stanu.
Wymagania
Dział zatytułowany „Wymagania”WordPress 6.5 lub nowszy, PHP 8.1 lub nowszy, WooCommerce 8.0 lub nowszy.