Konfiguracja Propono
Ten poradnik szczegółowo omawia wszystkie opcje konfiguracyjne Propono, zasady działania cen promocyjnych oraz techniczne oznaczanie pozycji w koszyku.
Przegląd opcji w panelu administracyjnym
Dział zatytułowany „Przegląd opcji w panelu administracyjnym”Ekran ustawień wtyczki znajduje się w menu WooCommerce > Order Bump (dostęp wymaga uprawnienia manage_woocommerce).
Wszystkie dane są przechowywane w pojedynczym rekordzie opcji bump_settings:
| Ustawienie | Klucz | Domyślnie | Opis |
|---|---|---|---|
| Enable order bump | enabled |
0 (wyłączone) |
Główny przełącznik. Gdy wyłączony, wtyczka nie dołącza skryptów, stylów ani kodu HTML na kasie. |
| Bump product | product_id |
0 (brak) |
Wybór produktu oferowanego przy kasie. Lista zawiera do 200 opublikowanych, prostych i dostępnych produktów. |
| Heading | heading |
“One-time offer” | Nagłówek przyciągający uwagę, wyświetlany u góry boksu oferty. |
| Checkbox label | checkbox_label |
“Yes, add this to my order!” | Tekst wezwania do działania umieszczony bezpośrednio przy polu checkboxa. |
| Description | description |
puste | Treść wyjaśniająca zalety produktu lub powód obniżki ceny. |
| Override price | bump_price |
puste | Stała kwota naliczana za pozycję bumpa (np. 15.00). Jeśli puste, stosowana jest regularna cena katalogowa. |
| Accent colour | accent_color |
#d97706 |
Kod koloru w formacie heksadecymalnym, definiujący obramowanie, odznakę i akcent pola wyboru. |
Mechanizm nadpisywania ceny
Dział zatytułowany „Mechanizm nadpisywania ceny”Gdy klient zaznaczy pole wyboru oferty, Propono dynamicznie modyfikuje cenę jednostkową w pamięci podręcznej koszyka za pomocą akcji woocommerce_before_calculate_totals z priorytetem 20:
- Obsługa separatora dziesiętnego: Kwotę możesz wpisać zarówno z kropką, jak i z przecinkiem (np.
19.99lub19,99). Wtyczka automatycznie standaryzuje wartość i zaokrągla ją do ustawionej w WooCommerce liczby miejsc po przecinku. - Podatek VAT: Kwota nadpisana podlega standardowym regułom podatkowym Twojego sklepu (jako cena brutto lub netto zależnie od konfiguracji WooCommerce). Box oferty pokazuje ją tak samo jak linia koszyka, zgodnie z ustawieniem wyświetlania cen z podatkiem lub bez, więc cena w ofercie to cena, którą nalicza koszyk.
- Izolacja pozycji: Jeśli kupujący dodał wcześniej ten sam produkt z poziomu zwykłego katalogu sklepu, specjalna cena promocyjna obejmie wyłącznie sztukę dodaną przez checkbox przy kasie. Cenę specjalną dostaje tylko produkt ustawiony obecnie jako bump: po zmianie produktu bumpa pozycja poprzedniego produktu, która została w koszyku, ma zwykłą cenę.
Prywatna flaga w koszyku (_plogins_bump)
Dział zatytułowany „Prywatna flaga w koszyku (_plogins_bump)”Aby zapobiec konfliktom i niekontrolowanemu sumowaniu sztuk, Propono przypisuje do dodawanej pozycji koszyka prywatną flagę metadanych:
$cart_item_data['_plogins_bump'] = true;Dzięki temu:
- Niezależny rekord: Pozycja bumpa ma swój unikalny skrót w koszyku (cart item hash). Klient może mieć w koszyku 1 sztukę w regularnej cenie i 1 sztukę w cenie promocyjnej bez ich scalania.
- Precyzyjne usuwanie: Po odznaczeniu checkboxa Propono przeszukuje koszyk w poszukiwaniu pozycji z flagą
_plogins_bumpi usuwa tylko tę jedną linię, pozostawiając pozostałe zakupy w stanie nienaruszonym. - Czyste zamówienie: Flaga ma charakter wyłącznie wewnętrzny i nie pojawia się w podsumowaniach ani w wiadomościach e-mail z potwierdzeniem zakupu.
Automatyczne zabezpieczenia dostępności
Dział zatytułowany „Automatyczne zabezpieczenia dostępności”Propono weryfikuje stan wybranego produktu przy każdym załadowaniu strony kasy:
- Jeśli produkt zostanie przeniesiony do kosza, zmieniony na szkic lub straci cenę, oferta jest automatycznie ukrywana.
- Jeśli produkt wyprzeda się w magazynie do zera (
! $product->is_in_stock()), boks oferty nie pojawia się na kasie. - W panelu administracyjnym niedostępny produkt pozostaje zaznaczony, ale zostaje oznaczony ostrzeżeniem: “Produkt jest obecnie niedostępny przy kasie”, co zapobiega pomyłkom administratora.