Od wersji 1.1.0 wtyczka nie wstawia automatycznie przycisku „Return this order” do e-maili WooCommerce ani do strony /returns/. Sam decydujesz, gdzie ma się pojawić — przez gotowe shortcody i placeholder. Dzięki temu klient zobaczy CTA tylko tam, gdzie świadomie go umieścisz, a nie zobaczy „martwego” przycisku do zamówienia poza oknem zwrotu.
Przyciski w Moje konto → Zamówienia oraz Moje konto → Pojedyncze zamówienie nadal pojawiają się automatycznie — przełączasz je w Returns Manager → Ogólne.
Strona /returns/ — atomic shortcody
Wtyczka rejestruje cztery niezależne shortcody do strony zwrotów. Każdy renderuje tylko swoją sekcję — możesz użyć wszystkich na jednej stronie albo wybrać podzbiór.
[wpnest_rfw_wizard]— kreator zwrotu (3 kroki). Renderuje się tylko gdy w URL jest?order=ID(klient zalogowany) lub?token=GUEST_TOKEN(gość po weryfikacji). W innych przypadkach pokazuje pustkę.[wpnest_rfw_orders_list]— lista zamówień zalogowanego klienta, kwalifikujących się do zwrotu. Niewidoczne dla niezalogowanych i gdy URL prowadzi już do kreatora.[wpnest_rfw_guest_form]— formularz weryfikacji dla gościa (e-mail + numer zamówienia). Niewidoczne dla zalogowanych.[wpnest_rfw_resources]— karta z pobieraniem modelowego formularza odstąpienia (PDF, EN + PL).
Aby odtworzyć układ sprzed 1.1.0, wstaw wszystkie cztery shortcody jeden pod drugim na stronie /returns/. Stary „master” shortcode [wpnest_rfw_returns_page] nadal działa dla istniejących instalacji — nic Ci się nie zepsuje po aktualizacji.
E-maile WooCommerce — dwa sposoby
Aby klient widział przycisk „Return this order” w wybranym e-mailu (np. potwierdzenie zamówienia, status „Zrealizowane”), wybierz jeden z dwóch sposobów. Edytujesz każdy szablon osobno w WooCommerce → Ustawienia → E-maile → [typ e-maila] → Manage.
Sposób A — shortcode w „Additional content”
W polu Additional content wpisz:
[wpnest_rfw_return_button]
Shortcode sam wykryje, do jakiego zamówienia leci e-mail, i wygeneruje przycisk z bezpiecznym linkiem (HMAC token). Jeśli zamówienie nie kwalifikuje się do zwrotu — wyświetli pustkę, a nie martwy link.
Dostępne atrybuty:
order_id="123"— wymuszenie konkretnego zamówienia (przydatne tylko poza e-mailem).label="Zwróć zamówienie"— własna etykieta zamiast domyślnej.plain="1"— wersja tekstowa (etykieta + URL) zamiast HTML — dla plain-text e-maili.
Sposób B — placeholder w temacie lub nagłówku
W polach Subject lub Email heading wpisz placeholder:
{return_button}
Placeholder działa wszędzie tam, gdzie WooCommerce przepuszcza pole przez WC_Email::format_string() — czyli w temacie i nagłówku. Ten sam mechanizm co natywne {site_title} czy {order_number}.
{return_button} nie działa w „Additional content” (WooCommerce nie przepuszcza tego pola przez format_string). W „Additional content” używaj shortcoda [wpnest_rfw_return_button].
Gdzie znaleźć gotowe snippety w panelu
Wszystkie shortcody i placeholder mają również listę z opisem w WooCommerce → Returns Manager → Ogólne, w karcie „Shortcodes & email placeholders”. Możesz je tam skopiować bezpośrednio.
Migracja z wersji 1.0.x
- Po aktualizacji do 1.1.0 przycisk znika z transakcyjnych e-maili WooCommerce. Edytuj każdy typ e-maila (potwierdzenie, w trakcie realizacji, zrealizowane…) i wstaw
[wpnest_rfw_return_button]w polu Additional content. - Strona
/returns/nadal działa — jeśli używałeś master shortcoda[wpnest_rfw_returns_page], nic się nie zmienia. Możesz opcjonalnie podzielić jego treść na atomic shortcody i ułożyć layout jak chcesz. - Linki w mailach (HMAC token, redirect na kreator dla gościa) działają identycznie jak w 1.0.x — zmieniło się tylko miejsce wstawiania przycisku.