Spis treści
Najważniejsze funkcje wtyczki
Wtyczka Kupony PDF WooCommerce Własne Szortkody jest dodatkiem do Kupony PDF WooCommerce PRO. Umożliwia tworzenie własnych szortkodów i umieszczanie danych z WooCommerce na szablonach kuponów PDF.
Za pomocą wtyczki możesz:
-
- wyświetlać dane zamówienia , np. numer i datę zamówienia, wartość brutto lub netto, podatek, metodę płatności oraz wysyłki,
- pobierać informacje o produkcie, m.in. nazwę, cenę, ilość, opis, krótki opis i atrybuty,
- korzystać z metadanych zamówień i produktów oraz wartości zapisanych w opcjach WordPressa,
- dodawać dane z pól rozliczeniowych, wysyłkowych i innych pól checkoutu,
- pobierać wartości pól utworzonych za pomocą Flexible Checkout Fields , Flexible Product Fields oraz Bloków pól zamówienia WooCommerce ,
- używać własnej funkcji PHP jako źródła wartości szortkodu.
Po zapisaniu konfiguracji własny szortkod pojawi się w edytorze szablonu kuponu PDF . Możesz wtedy umieścić go w wybranym miejscu dokumentu.
Wtyczka przyda się, gdy kupon powinien zawierać informacje właściwe dla konkretnego zamówienia lub produktu. Może to być na przykład nazwa uczestnika, wybrany wariant prezentu, termin wydarzenia, dane odbiorcy, atrybut produktu albo informacja podana przez klienta podczas składania zamówienia.
Instalacja
Aktywacja subskrypcji
Aktualizacja
Ustawienia – opis kolumn
Przejdź do zakładki Kupony PDF → Szortkody.
Pierwsza kolumna – nazwa zasobu
Wybierz zasób, z którego chcesz pobierać wartości na szablon kuponu.
Do wyboru masz następujące zasoby:
- Zamówienie,
- Meta dane zamówienia,
- Produkt,
- Meta dane produktu,
- Atrybuty produktu,
- Ustawienia,
- Funkcja.
- Shortcode checkout.
- Block checkout.
- Flexible Product fields.
Jeśli chcesz użyć funkcji, dodaj własny kod do pliku functions.php w aktualnym motywie WordPress. Pamiętaj o dodaniu kodu ponownie po zmianie lub aktualizacji motywu. Przykładowo, aby pobrać krótki opis produktu prostego lub opisu wariantu (dla produktu z wariantami) na kupon PDF, dodaj:
function coupon_get_product_short_description( $shortcode_data ) {
if ($shortcode_data->get_product()->get_parent_id()) {
$product = $shortcode_data->get_product()->get_description();
return $product;
}
else {
$product = $shortcode_data->get_product();
return $product->get_short_description();
}
}
Następnie w Szortkodach wklej nazwę funkcji do pierwszego pola, tu coupon_get_product_short_description. Na końcu wybierz nazwę dla nowego szortkodu, który zobaczysz od teraz w szablonach kuponów PDF.
Druga kolumna – meta nazwa pola
Po wybraniu Zamówienia, Produkt, Atrybuty produktu, Ustawienia w środkowej kolumnie pojawi się lista pól, z których można pobierać wartości prosto do szablonu PDF kuponu obsługiwanego za pomocą Kuponów PDF WooCommerce PRO.
W przypadku zasobów Meta dane zamówienia, Meta dane produktu, trzeba ręcznie wpisać meta nazwę pola, z której wartości mają zostać pobrane.
Na poniższym zrzucie ekranu znajdziesz przykład dla pola Notatki do zakupu znajdującego się w edycji produktu, a zatem należącego do zbioru Meta dane produktu. Otwórz konsolę przeglądarki i kursorem zaznacz pole, którego meta nazwy szukasz. Z konsoli przekopiuj name i wklej je do środkowej kolumny w ustawieniach Własnych Szortkodów.
Trzecia kolumna – nazwa szortkodu
Nazwa szortkodu zostanie automatycznie uzupełniona na podstawie ID pola użytego w drugiej kolumnie. Możesz ją zmienić na dowolną, własną nazwę.
Szablon kuponu PDF
Po zapisie ustawień Własnych Szablonów szortkod pojawi się na liście szortkodów w ustawieniach szablonu PDF:
Integracje
Wtyczka Kupony PDF WooCommerce Własne Szortkody może tworzyć szortkody dla pól utworzonych za pomocą innych wtyczek.
Flexible Product Fields
Kupony PDF WooCommerce Własne Szortkody pobierają do swoich ustawień pola utworzone za pomocą Flexible Product Fields. Szortkod umieszczony na szablonie PDF Kuponu zaimportuje wartość pola Flexible Product Fields tylko jeśli zostało dodane do produktu oznaczonego jako Kupon PDF
Aby dodać szortkod dla pola Flexible Product Fields:
- w pierwszej kolumnie wybierz Flexible Product fields,
- w drugiej kolumnie wybierz pole dodane we Flexible Product Fields do produktu-kuponu PDF,
- w trzeciej kolumnie automatycznie uzupełni się nazwa szortkodu.
Flexible Checkout Fields
We wtyczce Kupony PDF WooCommerce Własne Szortkody można zdefiniować szortkody dla pól utworzonych we Flexible Checkout Fields. Do szablonu PDF kuponu trafią wartości tych pól Flexible Checkout Fields, które zostały wypełnione podczas tworzenia zamówienia.
Bloki pól zamówienia WooCommerce
We wtyczce Kupony PDF WooCommerce – Własne Szortkody można zdefiniować szortkody dla pól utworzonych za pomocą wtyczki Bloki pól zamówienia WooCommerce. Do szablonu PDF kuponu trafią wartości tych pól, które zostały wypełnione podczas składania zamówienia.
Aby dodać szortkod dla pola Checkout Fields for Blocks:
- w pierwszej kolumnie wybierz Block Checkout,
- w drugiej kolumnie wybierz odpowiednie pole (nazwy pól dodanych przez Ciebie będą zaczynały się od ‘Inny:’),
- w trzeciej kolumnie automatycznie uzupełni się nazwa szortkodu.
Kupony PDF WooCommerce PRO – Zaawansowana Wysyłka
Wtyczka pozwala tworzyć szortkody, które można następnie wykorzystać w treści maila wysyłanym przez dodatek Kupony PDF WooCommerce PRO – Zaawansowana Wysyłka