# Egyéni beállítások

> Extra beállítások hozzáadása a mezőkhöz és a mezőcsoportokhoz kulcs-érték párokkal, pont- és JSON-jelöléssel.

Az egyéni beállítások (**Custom settings**) mind a mezőknél, mind a mezőcsoportoknál elérhetők. Arra valók, hogy olyan beállítást is megadhass, amelyet a szerkesztő nem kínál: a sajátodat, vagy olyat, amelyet még nem adtak hozzá.

Az itt leírt kulcs-érték működés a hasonló listáknál is érvényes: a választómezők opcióinál, a JavaScript-beállításoknál (dátum, dátumválasztó, csúszka stb.), a lekérdezési paramétereknél (bejegyzés, taxonómia, haladó taxonómia, felhasználó) és az egyéni HTML5-attribútumoknál.

## Egyszerű beállítás

1. Nyisd meg a mező vagy a mezőcsoport **Advanced** szakaszát.
2. Görgess az **Egyéni beállítások** (**Custom settings**) részhez.
3. Kattints a **+ Add New** gombra.
4. Add meg a kulcsot és az értéket.

Például egy `mask` és egy `enable` kulcs ezt az eredményt adja:

```php
[
    'id'     => 'new-your-phone',
    'name'   => 'New Your phone',
    'type'   => 'text',
    'mask'   => '012-345-6789',
    'enable' => false,
]
```

A `true` és a `false` értéket a szerkesztő logikai értékként kezeli.

## Összetett beállítások

Ha többszintű tömb kell, például egy bejegyzésmező lekérdezése:

```php
[
    'type'       => 'post',
    'id'         => 'field_id',
    'query_args' => [
        'tax_query' => [
            [
                'taxonomy' => 'category',
                'field'    => 'slug',
                'terms'    => 'technology',
            ],
        ],
    ],
]
```

akkor két módszer közül választhatsz: a pontjelölés (dot notation) vagy a JSON.

### Pontjelölés

A pontjelöléssel hierarchikus adatot írsz le: minden pont egy szintet jelent. Ez a tömb:

```php
'my_prop' => [
    'param1' => 'Érték 1',
    'param2' => 'Érték 2',
    'param3' => 'Érték 3',
]
```

így adható meg kulcs-érték párokként:

```json
"my_prop.param1": "Érték 1",
"my_prop.param2": "Érték 2",
"my_prop.param3": "Érték 3"
```

A `param1`, `param2` és `param3` a `my_prop` alparaméterei, a pont jelzi, hogy alatta vannak.

Ha az adatnak nincs kulcsa:

```php
'my_prop' => [
    'Érték 1',
    'Érték 2',
    'Érték 3',
]
```

akkor a PHP számozott kulcsokat használ (0, 1, 2), ezért így írható le:

```json
"my_prop.0": "Érték 1",
"my_prop.1": "Érték 2",
"my_prop.2": "Érték 3"
```

A két módszert kombinálva a fenti összetett `tax_query` is felépíthető: a kulcsok a `query_args.tax_query.0.taxonomy`, `query_args.tax_query.0.field` és `query_args.tax_query.0.terms` lesznek, az értékek pedig `category`, `slug` és `technology`.

### JSON-jelölés

A beágyazott tömböt JSON-szövegként is megadhatod: illeszd be a JSON-t az érték mezőbe, és a bővítmény PHP-tömbbé alakítja. A fenti `tax_query` például JSON-ban így néz ki:

```json
[
    {
        "taxonomy": "category",
        "field": "slug",
        "terms": "technology"
    }
]
```

A kulcs ilyenkor `query_args.tax_query`.