# Beállítások

> A tooltip és a tooltip_input paraméter: az ikon, a pozíció, a tartalom és a HTML engedélyezése.

A súgót a mező beállításában adod meg. Két paraméter van: a `tooltip` a mező címkéjéhez, a `tooltip_input` a beviteli mezőhöz tesz ikont.

## A `tooltip` paraméter

A `tooltip` kétféle formában adható meg:

```php
'tooltip' => 'A súgó szövege',
```

```php
'tooltip' => [
    'icon'       => 'info',
    'position'   => 'top',
    'content'    => 'A súgó szövege',
    'allow_html' => true,
],
```

Ha szöveget adsz meg, a bővítmény az **info** ikont használja, és a megadott szöveg lesz a buborék tartalma. Tömb esetén az alábbi értékeket adhatod meg:

| Érték | Mit csinál | Alapérték |
|---|---|---|
| `icon` | A súgóikon. Lehet `info`, `help`, egy Dashicons ikon neve (például `dashicons-email`), vagy egy egyedi ikonkép URL-je. | `info` |
| `position` | A buborék helye az ikonhoz képest: `top` (felül), `bottom` (alul), `left` (balra) vagy `right` (jobbra). Nem kötelező. | `top` |
| `content` | A buborék szövege. | |
| `allow_html` | Megjelenjen-e a szövegben megadott HTML formázottan: `true` vagy `false`. | `true` |

### Az ikon

- `info`: kis „i” betűs kör, ez az alapértelmezett.
- `help`: kérdőjeles kör.
- Dashicons: bármelyik WordPress Dashicons ikon a nevével, például `dashicons-email`. Az ikonok listáját a WordPress fejlesztői oldalán találod.
- Egyedi kép: a kép teljes URL-je, például `https://pelda.hu/ikon.png`.

![A Beosztás mező kérdőjeles ikonja fölött jobbra megjelenő súgóbuborék](./kepek/sugo-jobbra.webp)

*A Beosztás mező kérdőjeles ikonja fölött jobbra megjelenő súgóbuborék* (https://minta-bolt.hu/wp-admin/post.php?post=8&action=edit)

A **Beosztás** mező `help` ikonja fölé víve a buborék jobbra nyílik, ahogy a `position` értéke megadja.

### HTML a súgóban

A `content` értékébe HTML-elemeket is írhatsz, például félkövér szöveget. Ha nem szeretnéd, hogy a bővítmény HTML-ként értelmezze, állítsd az `allow_html` értékét `false`-ra.

```php
'tooltip' => [
    'content'    => 'Súgó <strong>HTML</strong> tartalommal',
    'position'   => 'bottom',
    'allow_html' => true,
],
```

![A Weboldal mező ikonja alatt megjelenő súgóbuborék](./kepek/sugo-html-alul.webp)

*A Weboldal mező ikonja alatt megjelenő súgóbuborék* (https://minta-bolt.hu/wp-admin/post.php?post=8&action=edit)

A **Weboldal** mezőnél a buborék az ikon alatt jelenik meg (`position` értéke `bottom`).

## A `tooltip_input` paraméter

Alapértelmezés szerint a súgóikon a mező címkéje mellé kerül. A `tooltip_input` paraméterrel a beviteli mezőhöz is tehetsz súgót. Értéke ugyanúgy szöveg vagy tömb lehet, mint a `tooltip`-nál, és ugyanazokat az értékeket (`icon`, `position`, `content`, `allow_html`) fogadja.

A beviteli mezők kinézete mezőtípusonként eltér, ezért a `tooltip_input` csak ezeken a mezőtípusokon működik:

- dátum és idő mezők,
- szöveges beviteli mezők: `text`, `url`, `email`, `number`, `password`,
- választómezők (`select`).

```php
[
    'name'          => 'Város',
    'id'            => 'varos',
    'type'          => 'select',
    'options'       => [ 'bp' => 'Budapest', 'db' => 'Debrecen' ],
    'tooltip_input' => [
        'icon'     => 'help',
        'content'  => 'Válaszd ki a várost',
        'position' => 'left',
    ],
],
```

![A Város mező alatti kérdőjeles ikonhoz tartozó súgóbuborék](./kepek/sugo-beviteli-mezon.webp)

*A Város mező alatti kérdőjeles ikonhoz tartozó súgóbuborék* (https://minta-bolt.hu/wp-admin/post.php?post=8&action=edit)

A beviteli mezőhöz tett ikon a mező alatt jelenik meg, a buborék pedig a `position` szerint nyílik.

A két paramétert egyszerre is használhatod ugyanazon a mezőn: ekkor a címke mellett és a mező alatt is lesz súgóikon.