Beállítások

A bővítmény egyetlen új mezőtípust ad, a group típust. A paramétereit a mező regisztrálásakor adod meg, a Meta Box többi mezőjéhez hasonlóan.

A group mező paraméterei

Paraméter	Mit csinál	Alapérték
name	A mező felirata. Nem kötelező.	nincs
id	A mező azonosítója, ezen a kulcson tárolódik a csoport összes értéke (az almezőkkel együtt).	kötelező
type	Értéke group legyen.	kötelező
fields	Az almezők tömbje. Minden almezőt úgy adsz meg, mint egy közönséges mezőt.	kötelező
clone	Ismételhetővé teszi a csoportot (ismétlődő mezőcsoport).	false
sort_clone	A klónok húzással átrendezhetők (true vagy false).	false
collapsible	Összecsukhatóvá teszi a csoportot (true vagy false).	false
save_state	Megjegyzi az összecsukott vagy kinyitott állapotot (true vagy false).	false
default_state	Az oldal betöltésekor milyen állapotú a csoport: collapsed (összecsukott) vagy expanded (kinyitott).	expanded
group_title	Az összecsukható csoport fejlécének szövege.	nincs
add_button	A klón hozzáadó gomb felirata, lásd az Alapértékek és klónozás fejezetet.	+ Továbbiak hozzáadása
clone_default	Új klón létrehozásakor az almezők alapértékkel jelennek meg.	false

A collapsible, save_state, default_state és group_title paramétereknek csak összecsukható csoportnál van értelme.

Egyszerű csoport almezőkkel

Egy csoportot úgy veszel fel, hogy egy mező type értéke group, az almezőket pedig a fields paraméterbe sorolod:

add_filter( 'rwmb_meta_boxes', function ( $meta_boxes ) {
    $meta_boxes[] = [
        'title'  => 'Album számai',
        'fields' => [
            [
                'id'         => 'szamok',
                'type'       => 'group',
                'clone'      => true,
                'sort_clone' => true,
                'fields'     => [
                    [ 'name' => 'Szám címe', 'id' => 'cim' ],
                    [ 'name' => 'Megjelenés dátuma', 'id' => 'datum', 'type' => 'date' ],
                    [
                        'name'    => 'Műfaj',
                        'id'      => 'mufaj',
                        'type'    => 'select_advanced',
                        'options' => [ 'pop' => 'Pop', 'rock' => 'Rock' ],
                    ],
                ],
            ],
        ],
    ];
    return $meta_boxes;
} );

Az almezők a hagyományos mezők minden paraméterét használhatják.

Beágyazott csoportok

Egy csoportba másik csoportot is tehetsz, így többszintű szerkezetet kapsz. A beágyazás mélysége nincs korlátozva.

add_filter( 'rwmb_meta_boxes', function ( $meta_boxes ) {
    $meta_boxes[] = [
        'title'  => 'Többszintű csoport',
        'fields' => [
            [
                'id'     => 'csoport',
                'type'   => 'group',
                'fields' => [
                    [ 'name' => 'Szöveg', 'id' => 'szoveg' ],
                    [
                        'name'   => 'Alcsoport',
                        'id'     => 'alcsoport',
                        'type'   => 'group',
                        'fields' => [
                            [ 'name' => 'Alszöveg', 'id' => 'alszoveg' ],
                        ],
                    ],
                ],
            ],
        ],
    ];
    return $meta_boxes;
} );

Összecsukható csoportok

Az összecsukhatóság bekapcsolása:

'collapsible' => true,

Ilyenkor minden csoportpéldány fejlécére kattintva összecsukhatod vagy kinyithatod a csoport tartalmát.

Dinamikus csoportcím

A group_title paraméterben állandó szöveget, a klón sorszámát és almezők értékét is használhatod:

'group_title' => '{#}. telephely: {nev}',

• {#}: a csoportpéldány sorszáma (ismételhető csoportnál).
• {almezo_azonosito}: az adott almező aktuális értéke.
• A kettőt tetszőlegesen keverheted.

Példa: összecsukható csoport beágyazott csoporttal

add_filter( 'rwmb_meta_boxes', function ( $meta_boxes ) {
    $meta_boxes[] = [
        'title'  => 'Cég telephelyei',
        'fields' => [
            [
                'id'          => 'g1',
                'name'        => 'Telephelyek',
                'type'        => 'group',
                'clone'       => true,
                'collapsible' => true,
                'save_state'  => true,
                'group_title' => '{#}. telephely: {nev}',
                'fields'      => [
                    [ 'name' => 'Név', 'id' => 'nev' ],
                    [ 'name' => 'Cím', 'id' => 'cim' ],
                    [
                        'id'          => 'kapcsolatok',
                        'name'        => 'Kapcsolattartók',
                        'type'        => 'group',
                        'clone'       => true,
                        'collapsible' => true,
                        'group_title' => '{szemely}',
                        'fields'      => [
                            [ 'id' => 'szemely', 'name' => 'Személy' ],
                            [ 'id' => 'telefon', 'name' => 'Telefon' ],
                        ],
                    ],
                ],
            ],
        ],
    ];
    return $meta_boxes;
} );

https://minta-bolt.hu/wp-admin/post-new.php?post_type=page

A képen a két telephely fejlécében a group_title szerint összeállított cím látszik (sorszám és a Név almező értéke), a belső csoport fejléce a Személy mező értékét mutatja.

https://minta-bolt.hu/wp-admin/post-new.php?post_type=page

Összecsukva a csoportból csak a fejléc marad, ezért a jól megválasztott group_title segít eligazodni sok klón között.