Beállítások

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:

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

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

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.

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

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).

[
    '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',
    ],
],

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.