# A Stripe Elements megjelenése és létrehozási paraméterei

> A kártyamező osztályainak és stílusának módosítása, valamint a Stripe-objektum létrehozási paramétereinek szűrése a gform_stripe_elements_classes, gform_stripe_elements_style és gform_stripe_object segítségével.

Három PHP-szűrő a Stripe Elements (a bankkártya-mező) kinézetét és a JavaScript oldali Stripe-objektum paramétereit módosítja. A kódot az aktív téma `functions.php` fájljába, saját funkcióbővítő bővítménybe, saját Add-On-ba vagy kódrészlet-kezelő bővítménybe teheted.

## `gform_stripe_elements_classes`: CSS-osztályok a kártyamezőn

A szűrő a Stripe Elements `classes` beállítását adja át, amellyel a kártyamező állapotaihoz (például alap, kész, hibás) saját CSS-osztályokat rendelhetsz. Hogy pontosan mely osztályok adhatók meg, azt a Stripe Elements létrehozási beállításai határozzák meg.

```php
add_filter( 'gform_stripe_elements_classes', 'your_function_name', 10, 2 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$cardClasses` | array | A jelenleg alkalmazott osztályok tömbje. |
| `$formId` | int | Az űrlap azonosítója. |

Példa:

```php
add_filter( 'gform_stripe_elements_classes', 'set_stripe_classes', 10, 2 );
function set_stripe_classes( $cardClasses, $formId ) {
    $cardClasses = array(
        'base'     => 'TestElement',
        'complete' => 'TestComplete',
        'invalid'  => 'TestInvalid',
    );
    return $cardClasses;
}
```

## `gform_stripe_elements_style`: a kártyamező stílusa

A szűrővel a Stripe Elements stílusát módosíthatod. Két külön stílusrendszer van, attól függően, hogy a Stripe-mező beállításai között be van-e kapcsolva a **Stripe Payment Element használata**:

- Kikapcsolt Payment Elementnél a Stripe Card Element stíluskulcsai (`base`, `invalid` stb.) érvényesek.
- Bekapcsolt Payment Elementnél a Stripe Elements megjelenési (Appearance) rendszere érvényes (`variables`, `rules`).

```php
add_filter( 'gform_stripe_elements_style', 'your_function_name', 10, 3 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$styles` | array | A jelenleg alkalmazott stílusok tömbje. |
| `$form_id` | int | Az űrlap azonosítója. |
| `$is_payment_element_enabled` | bool | Be van-e kapcsolva a Payment Element. |

Példa, amely mindkét esetet kezeli:

```php
add_filter( 'gform_stripe_elements_style', function ( $card_styles, $form_id, $is_payment_element_enabled ) {

    if ( $is_payment_element_enabled ) {
        // Payment Element: Appearance API
        $card_styles['variables'] = array(
            'colorPrimary'       => '#e0643b',
            'colorTextSecondary' => '#465459',
            'colorText'          => '#272829',
            'fontSizeBase'       => '14px',
            'tabSpacing'         => '1rem',
        );

        $card_styles['rules'] = array(
            '.Tab:hover' => array(
                'boxShadow' => 'var(--focusBoxShadow)',
            ),
        );
    } else {
        // Card Element: Style objektum
        $card_styles['base'] = array(
            'color'    => '#465459',
            'fontSize' => '16px',
            ':focus'   => array(
                'color' => '#272829',
            ),
        );
    }

    return $card_styles;
}, 10, 3 );
```

## `gform_stripe_object`: a Stripe-objektum létrehozási paraméterei

A szűrő azokat a paramétereket adja át, amelyekből az űrlap JavaScript oldalán a Stripe-objektum létrejön, és lehetővé teszi a módosításukat.

```php
add_filter( 'gform_stripe_object', 'your_function_name', 10, 2 );
```

| Paraméter | Típus | Jelentés |
|---|---|---|
| `$args` | array | A Stripe-objektum létrehozásához használt paraméterek tömbje. |
| `$form_id` | int | Az űrlap azonosítója. |

Példa: a bankkártya-mező azonosítójának kézi megadása:

```php
add_filter( 'gform_stripe_object', 'set_stripe_args', 10, 2 );
function set_stripe_args( $args, $form_id ) {
    $args['ccFieldId'] = 8;
    return $args;
}
```
