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.
Ekran ustawień wtyczki
Dział zatytułowany „Ekran ustawień wtyczki”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.
Ustawienia główne
Dział zatytułowany „Ustawienia główne”| 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. |
Karty systemów krajowych
Dział zatytułowany „Karty systemów krajowych”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:
- Fee Label: Nazwa pozycji w koszyku, kasie i na zamówieniu (np.
Kaucja zwrotna,Deposit (Pfand),Garantie SGR). - Product Notice Template: Wzór komunikatu pod ceną produktu. Możesz użyć
{amount}lub%sjako znacznika kwoty (np.+ {amount} kaucji,w tym {amount} kaucji). Puste pole przywraca domyślny tekst dla danego kraju. - 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.
Pola w edytorze produktu
Dział zatytułowany „Pola w edytorze produktu”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ą
24nalicza 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.
Produkty z wariantami
Dział zatytułowany „Produkty z wariantami”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.
Kody shortcode
Dział zatytułowany „Kody shortcode”Do budowy niestandardowych szablonów kart produktów w builderach (Elementor, Divi) wtyczka udostępnia dwa kody:
1. [botelix_deposit]
Dział zatytułowany „1. [botelix_deposit]”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>2. [botelix_packaging_type]
Dział zatytułowany „2. [botelix_packaging_type]”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>