Przejdź do głównej zawartości

Konfiguracja Botelix

Ten poradnik opisuje konfigurację globalną wtyczki Botelix, edycję szablonów komunikatów, parametry 16 systemów krajowych oraz shortcode do integracji z szablonami stron.

Dostęp do opcji globalnych uzyskasz, przechodząc do WooCommerce > Deposit Return (DRS) w panelu administracyjnym WordPressa. Strona jest dostępna dla użytkowników z uprawnieniem manage_woocommerce.

Wszystkie opcje zapisywane są w rekordzie opcji botelix_settings.

Ustawienie Domyślnie Opis
Enable Deposit Scheme on (włączone) Główny włącznik. Gdy aktywny, wtyczka nalicza kaucję w koszyku, wyświetla komunikaty pod cenami i udostępnia pola w edycji produktów. Wyłączenie wstrzymuje naliczanie bez usuwania wpisów w produktach.
Default Scheme Poland Podstawowy system stosowany przy wyłączonym dopasowaniu transgranicznym, przed podaniem adresu przez klienta oraz dla wysyłek zagranicznych bez zwolnienia w eksporcie.
Cross-Border Destination Matching on (włączone) Automatycznie dopasowuje system kaucyjny do kraju dostawy zamówienia (lub adresu rozliczeniowego, gdy brak adresu dostawy) w 16 obsługiwanych krajach UE.
Export Exemption on (włączone) Przy aktywnym dopasowaniu transgranicznym zamówienia z dostawą poza 16 obsługiwanych krajów są całkowicie zwolnione z kaucji.

Poniżej ustawień głównych Botelix wyświetla karty dla 16 systemów krajowych oraz Custom Scheme (system własny). Każda karta podaje podstawę prawną, status podatkowy oraz trzy pola konfiguracyjne:

  1. Fee Label: Nazwa pozycji w koszyku, kasie i na zamówieniu (np. Kaucja zwrotna, Deposit (Pfand), Garantie SGR).
  2. Product Notice Template: Wzór komunikatu pod ceną produktu. Możesz użyć {amount} lub %s jako znacznika kwoty (np. + {amount} kaucji, w tym {amount} kaucji). Puste pole przywraca domyślny tekst dla danego kraju.
  3. Statutory Rates: Pola stawek dla poszczególnych rodzajów opakowań ujętych w przepisach danego kraju:
    • Jednorazowa butelka plastikowa (PET)
    • Metalowa puszka po napojach
    • Jednorazowa butelka szklana
    • Wielorazowa butelka szklana

Jeśli prawo w danym państwie nie obejmuje określonego typu opakowania, odpowiednie pole stawki jest ukryte.

W panelu Produkty > Wszystkie produkty > Edytuj produkt > zakładka Ogólne:

  • Scheme override: Pozwala wymusić określony system dla danego produktu zamiast domyślnego systemu sklepu.
  • Packaging container: Wybór fizycznego opakowania. Opakowania nieobjęte wybranym systemem są oznaczone ostrzeżeniem i nie generują opłaty.
  • Container units: Liczba opakowań objętych kaucją w sprzedawanej jednostce towaru (np. zgrzewka 24 puszek z wartością 24 nalicza 24 kaucje jednostkowe).
  • Deposit per container: Opcjonalna własna stawka kaucji zastępująca tabelę globalną dla tego produktu.
  • Crate / outer packaging deposit: Kaucja za opakowanie zbiorcze (np. niemiecki Kastenpfand za skrzynkę na piwo), doliczana jednorazowo do sztuki produktu.

W produktach z wariantami:

  • Wariant bez wybranego opakowania przejmuje opakowanie, liczbę jednostek i kaucję za skrzynkę z produktu nadrzędnego.
  • Wariant z własnym opakowaniem nadpisuje wartości nadrzędne.
  • Wszystkie warianty bezwzględnie podlegają wymuszonemu systemowi kaucyjnemu z produktu nadrzędnego.

Do budowy niestandardowych szablonów kart produktów w builderach (Elementor, Divi) wtyczka udostępnia dwa kody:

Wyświetla sformatowany komunikat o kaucji dla danego produktu na podstawie szablonu i kraju klienta.

<!-- Przykładowy wynik -->
<span class="botelix-deposit-notice">+ 0,50 zł kaucji</span>

Wyświetla etykietę rodzaju opakowania (np. EINWEG lub MEHRWEG w systemie niemieckim).

<!-- Przykładowy wynik -->
<span class="botelix-packaging-badge botelix-packaging-badge--single-use">EINWEG</span>