Egyéni beállítások

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:

[
    '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:

[
    '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:

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

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

"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:

'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:

"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:

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

A kulcs ilyenkor query_args.tax_query.