W wersji 1.5.0 WC Vendors Pro system walidacji został całkowicie zastąpiony nowym systemem. Nowy system zapewnia znacznie czystszy system walidacji do Twojego użytku. Istnieje wbudowany tłumacz dla wszelkich niestandardowych kodów formularzy, które możesz mieć w swoim motywie, aby pomóc w przejściu. Oznacza to, że wszystkie Twoje istniejące niestandardowe reguły walidacji formularzy będą nadal działać. Otrzymasz jednak powiadomienie w dzienniku błędów informujące o konieczności aktualizacji do nowego systemu.
Wszystkie reguły i komunikaty walidacji są obsługiwane za pomocą atrybutów ‘custom_attributes’ pól formularza. Aby nadpisać lub dodać reguły walidacji, musisz znaleźć nazwę filtra pól, znajdującą się w kodzie źródłowym, a następnie dodać wymagane wartości.
Walidacja jest uruchamiana dla każdego pola przed przesłaniem formularza, dzięki czemu użytkownicy natychmiast dowiedzą się, czy wprowadzili nieprawidłową wartość.
Pole wymagane
Aby pole było wymagane, wystarczy ustawić atrybut HTML 5 required na polu, a stanie się ono wymagane. Poniższy przykład pokazuje, jak ustawić pole SKU jako wymagane.
// Add this to your themes functions.php
add_filter( 'wcv_product_sku', 'wcv_product_sku' );
function wcv_product_sku( $field ){
$field[ 'custom_attributes' ] = array( 'required' => "", 'data-parsley-error-message' => 'SKU is required' );
return $field;
}
Niestandardowy komunikat o błędzie
Aby dodać niestandardowy komunikat o błędzie, możesz użyć nowej wartości danych ‘data-parsley-error-message’. Jak widać w powyższym przykładzie SKU, spowoduje to wyświetlenie nowego komunikatu o błędzie. Domyślnie otrzymasz ogólny komunikat o błędzie. Jest to wymagane tylko wtedy, gdy chcesz podać użytkownikom więcej kontekstu dla błędu.
Podsumowanie
Dostępnych jest wiele różnych reguł walidacji w Parsley, które można znaleźć w dokumentacji Parsley poniżej.