Przejdź do głównej zawartości

Konfiguracja Propono

Ten poradnik szczegółowo omawia wszystkie opcje konfiguracyjne Propono, zasady działania cen promocyjnych oraz techniczne oznaczanie pozycji w koszyku.

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.

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.99 lub 19,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ę.

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:

  1. 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.
  2. Precyzyjne usuwanie: Po odznaczeniu checkboxa Propono przeszukuje koszyk w poszukiwaniu pozycji z flagą _plogins_bump i usuwa tylko tę jedną linię, pozostawiając pozostałe zakupy w stanie nienaruszonym.
  3. 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.

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.