# Ellenőrzés

> A pénztármezők beépített ellenőrzési szabályai és saját ellenőrzési szabályok létrehozása.

A mezők ellenőrzését a mező **Advanced** fülén, a **Validation** részen állítod be.

## Beépített szabályok

| Szabály | Mit csinál |
|---|---|
| **Default** | Az alapértelmezett ellenőrzés. Ha a WooCommerce ad ellenőrzést az alapmezőhöz, azt használja, ha nem ad, nincs ellenőrzés. |
| **None** | Kikapcsolja az ellenőrzést. |
| **E-mail** | E-mail-cím ellenőrzése. |
| **Phone** | Telefonszám ellenőrzése. |
| **Postcode** | Irányítószám ellenőrzése. Csak akkor működik, ha az ország mező be van kapcsolva, és az országnak megfelelő szabályt használja. |

Az e-mail, telefonszám és irányítószám ellenőrzéséhez a bővítmény a WooCommerce beépített függvényeit használja. A **Number**, **E-mail**, **URL**, **Date**, **Time** és sok más mezőtípusnál csak az alapértelmezett ellenőrzés érhető el. A számmezőnél a **Min value**, **Max value** és **Step value**, a telefonmezőnél a **Validation regex** és a **Validation error message** alakítja az ellenőrzést, lásd: [Mezőtípusok](../mezotipusok/).

Ha egy kötelező mező hibás vagy üres, a vásárló a pénztáron hibaüzenetet kap, és addig nem tud rendelést leadni, amíg ki nem javítja.

## Saját ellenőrzési szabályok

Ez a rész haladó felhasználóknak szól: ismerned kell a WordPress hookokat és a PHP-t.

Saját szabályt a `flexible_checkout_fields_custom_validation` szűrővel hozhatsz létre. A szabály bekerül a **Validation** lista elemei közé, a beépítettek mellé.

### Hogyan működik

1. Írj egy ellenőrző függvényt (az alábbi példa az URL-ellenőrzés).
2. Add hozzá a függvényt a téma `functions.php` fájljához.
3. Nyisd ki valamelyik mezőt, és az **Advanced** fülön a beépített szabályok mellett megjelennek a saját szabályaid.
4. Válaszd ki a szabályt, mentsd, és próbáld ki a pénztáron: érvénytelen értéknél hibaüzenetet kapsz, és nem tudsz rendelést leadni.

Az URL-példával például így járj el: vegyél fel egy weboldal-mezőt, válaszd hozzá az **URL** ellenőrzést, majd a pénztáron írj be érvénytelen webcímet, és add le a rendelést. Hibaüzenetet kapsz, és addig nem rendelhetsz, amíg érvényes webcímet nem adsz meg. A gyakori példák (szám, URL, hosszúság) azonos módon kerülnek a listába.

### Az URL-ellenőrzés felépítése

1. **Ellenőrző függvény.** Egy `wpdesk_fcf_validate_url` nevű függvény a PHP `FILTER_VALIDATE_URL` szűrőjével ellenőrzi a megadott értéket. Ha az URL érvénytelen, a WooCommerce `wc_add_notice` függvényével jeleníti meg a hibát („[mező felirata] nem érvényes URL”).
2. **Regisztrálás a szűrővel.** A `flexible_checkout_fields_custom_validation` szűrőhöz egy `wpdesk_fcf_custom_validation_url` nevű függvényt kapcsolsz. Ebben három dolgot adsz meg:
   - a szabály egyedi azonosítóját: `$custom_validation['url']` (ha több szabályt is felveszel, mindegyiké különböző legyen),
   - a beállításokban látszó nevet: `'label' => 'URL'`,
   - az ellenőrző függvényt: `'callback' => 'wpdesk_fcf_validate_url'`. A név pontosan egyezzen az 1. lépésben létrehozott függvény nevével.
3. **Kiválasztás.** A bővítmény beállításaiban válaszd ki az új szabályt a mezőhöz.

## Példák saját szabályokra

- **E-mail-cím megerősítése.** Egy extra mezőt vehetsz fel, amelynek értékét a bővítmény egy másik mezőével (például az e-mail-címmel) veti össze. Az összehasonlított mező a `WPDesk_FCF_Validation_Confirm_Field( 'billing_email' )` hívásban cserélhető a saját meződ meta nevére, és a hibaüzenet (`Invalid %1$s value.`) is átírható.
- **Szám ellenőrzése.** Annak vizsgálata, hogy a vásárló érvényes számot adott-e meg.
- **Weboldal (URL) ellenőrzése.** Lásd az előző részt.
- **Karakterkorlát.** Annak vizsgálata, hogy a beírt szöveg például 3 és 20 karakter közötti. A `$min_length` és a `$max_length` értékét átírhatod.
- **EU-s adószám ellenőrzése.** Annak vizsgálata, hogy az EU-s adószám érvényes-e.
- **Házszám ellenőrzése.** Annak vizsgálata, hogy a mezőben (például az utcamezőben, `billing_address_1`) legalább egy számjegy szerepel-e. A hibaüzenet átírható.
