# Egyedi mező, ellenőrzés és űrlapattribútum
> Egyedi mező felvétele a pénztárra, saját ellenőrzés a mezőkhöz, az ellenőrzés indítójának módosítása és egyedi űrlapattribútumok.
Ez a fejezet azt mutatja meg, hogyan vehetsz fel saját mezőt a pénztárra, hogyan ellenőriztetheted a mezők értékét saját szabállyal, és hogyan adhatsz egyedi attribútumot az űrlaphoz. A kódrészleteket a téma (vagy gyermektéma) `functions.php` fájljába, egy kódrészlet-kezelő bővítménybe vagy a **CheckoutWC → Haladó → Szkriptek** fül **PHP kódrészletek** mezőjébe írhatod. A mezőbe írt kódnál ne szerepeljen a nyitó ` 'checkbox',
'value' => 'Yes',
'required' => true,
'label' => __( 'Ez egy kötelező jelölőnégyzet.' ),
'columns' => 12,
),
WC()->checkout()->get_value( 'required_checkbox' )
);
}
// Ellenőrzés: hiba, ha nincs bejelölve
add_action( 'woocommerce_after_checkout_validation', 'example_validate_required_checkbox_field', 10, 2 );
function example_validate_required_checkbox_field( &$data, &$errors ) {
if ( ! isset( $_POST['required_checkbox'] ) ) {
$errors->add( 'terms', 'Be kell jelölnöd a kötelező jelölőnégyzetet!' );
}
}
// Az érték mentése a rendeléshez
add_action( 'woocommerce_checkout_update_order_meta', 'example_required_checkbox_checkout_field_update_order_meta' );
function example_required_checkbox_checkout_field_update_order_meta( $order_id ) {
if ( ! empty( $_POST['required_checkbox'] ) ) {
update_post_meta( $order_id, 'required_checkbox', sanitize_text_field( $_POST['required_checkbox'] ) );
}
}
// Az érték megjelenítése a rendelés szerkesztő oldalán
add_action( 'woocommerce_admin_order_data_after_billing_address', 'example_required_checkbox_display_admin_order_meta', 10, 1 );
function example_required_checkbox_display_admin_order_meta( $order ) {
$value = get_post_meta( $order->get_id(), 'required_checkbox', true );
if ( '1' === $value ) {
$value = 'Igen';
} else {
$value = 'Nem';
}
echo '' . __( 'Kötelező jelölőnégyzet' ) . ':
' . $value . '
';
}
```
Aláírást kérő jelölőnégyzet a megjegyzések mező után (ez nem kötelező mező):
```php
add_action( 'woocommerce_after_order_notes', 'signature_required_checkout_field' );
function signature_required_checkout_field( $checkout ) {
woocommerce_form_field(
'signature_required',
array(
'type' => 'checkbox',
'class' => array( 'my-field-class form-row-wide' ),
'value' => 'Yes',
'label' => __( 'Aláírás szükséges' ),
),
$checkout->get_value( 'signature_required' )
);
}
add_action( 'woocommerce_checkout_update_order_meta', 'signature_required_checkout_field_update_order_meta' );
function signature_required_checkout_field_update_order_meta( $order_id ) {
if ( ! empty( $_POST['signature_required'] ) ) {
update_post_meta( $order_id, 'signature_required', sanitize_text_field( $_POST['signature_required'] ) );
}
}
add_action( 'woocommerce_admin_order_data_after_billing_address', 'signature_required_display_admin_order_meta', 10, 1 );
function signature_required_display_admin_order_meta( $order ) {
$value = get_post_meta( $order->get_id(), 'signature_required', true );
echo '' . __( 'Aláírás szükséges' ) . ':
' . ( '1' === $value ? 'Igen' : 'Nem' ) . '
';
}
```
Üdvözlőkártya szövegmező a CheckoutWC saját horgára kötve, a fizetési mód feltételeinek jelölőnégyzete előtt:
```php
add_action( 'cfw_checkout_before_payment_method_terms_checkbox', 'customise_checkout_field' );
function customise_checkout_field() {
woocommerce_form_field(
'greeting_card',
array(
'type' => 'textarea',
'label' => 'Üdvözlőkártya',
'placeholder' => 'Üdvözlőkártya',
'required' => false,
'class' => array(),
'autofocus' => false,
'priority' => 10,
'columns' => 12,
),
WC()->checkout->get_value( 'greeting_card' )
);
}
add_action( 'woocommerce_checkout_update_order_meta', 'customise_checkout_field_update_order_meta' );
function customise_checkout_field_update_order_meta( $order_id ) {
if ( ! empty( $_POST['greeting_card'] ) ) {
update_post_meta( $order_id, 'greeting_card', sanitize_text_field( $_POST['greeting_card'] ) );
}
}
add_action( 'woocommerce_admin_order_data_after_billing_address', 'greeting_card_checkout_field_display_admin_order_meta', 10, 1 );
function greeting_card_checkout_field_display_admin_order_meta( $order ) {
echo '' . __( 'Üdvözlőkártya' ) . ':
' . get_post_meta( $order->get_id(), 'greeting_card', true ) . '
';
}
```
### 4. lehetőség: Checkout Add-ons
A WooCommerce Checkout Add-ons bővítmény is használható egyedi mezőkhöz. Akkor működik a legjobban, ha a választható opciókért felárat kérsz. Ingyenesen is használható, de ilyenkor minden mező 0 Ft-os sorként megjelenik az összesítésben. A bővítményhez külön licenc kell, a mezőket a saját felületén veheted fel.
### 5. lehetőség: más bővítmények
Más bővítmények is működnek a CheckoutWC-vel. A Cashier bővítményhez részleges támogatás van.
## Saját ellenőrzés a mezőkhöz
A CheckoutWC a mezők ellenőrzéséhez a Parsley JavaScript-könyvtárat használja. A Parsley egyedi ellenőrzői (validator) segítségével a hagyományosnál jóval összetettebb szabályt is megadhatsz egy mezőre. Két részből áll a megoldás: az ellenőrzőből és a mezőből.
1. **Az ellenőrző.** A Parsley saját leírása szerint írd meg a JavaScript-ellenőrzőt, majd add hozzá az oldalhoz: **CheckoutWC → Haladó → Szkriptek → Globális → Fejléc szkriptek**. A szkriptet `