# Beállítások

> A group mezőtípus paraméterei, beágyazott és összecsukható csoportok.

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](https://hub.hellowp.io/hu/plugins/meta-box-group/alapertekek/) 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:

```php
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.

```php
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:

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

```php
'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

```php
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;
} );
```

![Összecsukható telephely-csoportok, bennük összecsukható kapcsolattartó-csoport](./kepek/csoport-osszecsukhato.webp)

*Összecsukható telephely-csoportok, bennük összecsukható kapcsolattartó-csoport* (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.

![Az első telephely összecsukva, a második nyitva](./kepek/csoport-osszecsukva.webp)

*Az első telephely összecsukva, a második nyitva* (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.