[wooCommerce] Dodatkowe pole akceptacji przy zamówieniu

Według przepi­sów handlo­wych, klient e‑sklepu powinien zostać poinfor­mo­wa­ny o swoich prawach i potwier­dzić nam, że zapoznał się z regula­mi­nem. Z reguły robi to pod koniec składa­nia zamówie­nia odhacza­jąc checkbox'a. WooCom­mer­ce zapew­nia nam mecha­nizm do spełnie­nia tego obowiąz­ku. Czasem zacho­dzi potrze­ba, by klient oprócz regula­mi­nu potwier­dził jeszcze inne warun­ki. Może chodzić o polity­kę prywat­no­ści, albo że sam, dobro­wol­nie zrzeka się prawa zwrotu, bo towar jest używa­ny, a on o tym wie i kupuje w ciemno, ale na swoją odpowiedzialność.

Standar­do­wo, z pozio­mu panelu admini­stra­cji na ma takiej możli­wo­ści, by dodać następ­ne pola wyboru. Można poszu­kać wtycz­ki, albo samemu stworzyć kod korzy­sta­jąc z kilku zacze­pów. Najbar­dziej sensow­nym wydaje się 'woocommerce_​checkout_​terms_​and_​conditions', który doda treść do konte­ne­ra w którym znajdu­je się check­box akcep­ta­cji regula­mi­nu. Zaczep jest umieszo­ny nad polem, więc akcep­ta­cja regula­mi­nu zawsze będzie na końcu.

Istnie­je też możli­wość umiesz­cze­nie treści nad lub pod w/​w konte­ne­rem. Do wyboru są: 'woocommerce_​checkout_​before_​terms_​and_​conditions' lub 'woocommerce_​checkout_​after_​terms_​and_​conditions'.

Nowe pole akceptacji warunków

Pole tworzy­my za pomocą funkcji 'woocommerce_​form_​field', specjal­nie utworzo­nej przez twórców WooCommerce.

add_action('woocommerce_checkout_terms_and_conditions', 'igel_woocommerce_checkout_before_terms_and_conditions', 100);

function igel_woocommerce_checkout_before_terms_and_conditions()
{
    woocommerce_form_field('privacy_policy', array(
        'type'        => 'checkbox',
        'required'    => true,
        'label'       => _x('I accept the privacy policy', 'woocommerce', 'igelshop-bs5'),
        'id'        =>  'privacy_policy',
    ), 1);
}

Pierw­szy parametr to ID pola, drugi, to tabli­ca parame­trów, a trzeci, to wartość domyśl­na. W tabli­cy trzeba zwrócić uwagę na 'type' i ustawić go na 'check­box', 'label' czyli opis pola i 'required' czyli określe­nie, czy ten warunek jest koniecz­ny. Do pareme­tru 'label' przypi­sa­łem wartość funkcji _​x(). Pomaga to przy dalszym tłuma­cze­niu strony. W tym przypad­ku tłuma­cze­nie jest kontek­sto­we (drugi parament _​x()) i pobie­ra­ne z szablo­nu tematu. Równie dobrze można tu przypi­sać wartość na stałe lub treść określo­ną w customizerze.

Walidacja pola

Jeżeli pole warun­ku jest określo­ne jako wymaga­ne, to użytkow­nik nie może go nie zazna­czyć. Problem w tym, że musi o tym wiedzieć. Rozwią­za­niem jest komuni­kat o błędzie. Musimy się podcze­pić pod proces obsłu­gi zamówie­nia. Mamy do tego akcję 'woocommerce_​checkout_​process'.

add_action('woocommerce_checkout_process', 'igel_checkbox_checkout_validation');
function igel_checkbox_checkout_validation()
{
    $field_id = 'privacy_policy';

    if (!isset($_POST[$field_id]) || empty($_POST[$field_id]))
        wc_add_notice(_x("Acceptance of the privacy policy is required", 'woocommerce', "igelshop-bs5"), "error");
}

Jeżeli pole nie istnie­je lub wartość pola jest pusta, to oznacza, że użytkow­nik nie zazna­czył tej opcji. Wtedy system dodaje notat­kę poprzez 'wc_​add_​notice' z parame­trem 'error'. W tym przypad­ku formu­larz nie przej­dzie dalej, do czasu aż będzie wypeł­nio­ny bez błędów.

Zapisanie parametrów zamówienia

Jeżeli infor­ma­cja o tym, jakie zgody wyraził klient, jest nam potrzeb­na to możemy je zapisać w meta polach. A potem je odczy­tać na stronie zamówie­nia w panelu admini­stra­cji. Zapis reali­zu­je zaczep 'woocommerce_​checkout_​update_​order_​meta', a odczy­tu możemy dokonać dzięki 'woocommerce_​admin_​order_​data_​after_​billing_​address'.

add_action('woocommerce_checkout_update_order_meta', 'igel_woocommerce_checkout_before_terms_and_conditions_save');

function igel_woocommerce_checkout_before_terms_and_conditions_save($order_id)
{
    if ($_POST['privacy_policy']) update_post_meta($order_id, '_privacy_policy', esc_attr($_POST['privacy_policy']));
    if ($_POST['terms']) update_post_meta($order_id, '_terms', esc_attr($_POST['terms']));
}

// Wyświetlanie statusu zgody w ustawieniach
add_action('woocommerce_admin_order_data_after_billing_address', 'igel_woocommerce_checkout_before_terms_and_conditions_admin');
function igel_woocommerce_checkout_before_terms_and_conditions_admin($order)
{
    if (get_post_meta($order->get_id(), '_terms', true) == 'on') {
        echo '<p><strong>Regulamin: </strong>Zaakceptowany</p>';
    } else echo '<p><strong>BRAK AKCEPTACJI REGULAMINU!</p>';

    if (get_post_meta($order->get_id(), '_privacy_policy', true) == '1') {
        echo '<p><strong>Polityka prywatności: </strong>Zaakceptowana</p>';
    } else echo '<p><strong>BRAK AKCEPTACJI Polityki prywatności!</p>';
}

System jeżeli wykry­je, że pole 'privacy_​policy' lub 'terms' istnie­je, to przypi­sze wartość poprzez 'update_​post_​meta'. Check­box, który nie jest zazna­czo­ny, po przej­ściu formu­la­rza zwyczaj­nie nie istnie­je w tabli­cy warto­ści. Nie musimy zatem spraw­dzać jego warto­ści, a jedynie czy istnieje.

Wartość spraw­dza­my dopie­ro przy odczy­cie. Inaczej zapisa­ne zosta­ło pole '_​terms', które przyję­ło wartość 'on', a inaczej '_​privacy_​policy', które ma wartość '1'. Warto zorien­to­wać się, co jest zapisy­wa­ne do bazy, by potem nie wyświe­tlać złych komuni­ka­tów. Można użyć to tego zwykłe­go var_dump().

Jeżeli oba pola zosta­ły zazna­czo­ne, to wynik powinien wyglą­dać podob­nie jak na poniż­szej grafice: