# A csonkító visszahívás használata

> Hogyan vágd karakterekre vagy szavakra a Dinamikus mező szövegét a csonkító visszahívással.

A visszahívás a **Dinamikus mező** elem **Mező kimenetének szűrése** funkciójának része. Csak akkor látszik, ha a bővítmény aktív, és a szűrő be van kapcsolva.

## Beállítás

1. Nyisd meg a szerkesztőben azt az oldalt vagy listasablont, ahol a rövidített szöveget szeretnéd.
2. Húzz be egy **Dinamikus mező** elemet, és válaszd ki a forrását (például egy meta mezőt vagy a bejegyzés kivonatát).
3. Kapcsold be a **Mező kimenetének szűrése** kapcsolót.
4. A **Visszahívás** legördülő listából válaszd a „Trim string by chars or words” elemet. (Ennek a feliratnak jelenleg nincs magyar fordítása.)
5. Állítsd be a lenti mezőket.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| Trimmed Type | A csonkolás módja: **Chars** (karakterek) vagy **Words** (szavak). | Chars |
| String length | A megtartott karakterek vagy szavak száma. | 20 |

A beállítások ezen a két mezőn kívül nincsenek. A „Trimmed Type” és a „String length” felirat egyelőre angolul jelenik meg.

## Karakterekre csonkolás

Ha a típus **Chars**, a visszahívás először eltávolítja a szövegből a HTML-címkéket, aztán az első megadott számú karaktert tartja meg, és három pontot (`...`) tesz a végére. Ha a szöveg nem hosszabb a megadott értéknél, változatlanul jelenik meg, három pont nélkül.

A hossz mérésénél a széles karakterek (például a keleti írásjelek) kettőnek számítanak. Magyar szövegnél egy betű egy karakter.

Példa: a hossz 60, a kivonat szövege a tihanyi apátságról szól.

![A karakterekre csonkolt szöveg a frontenden](./kepek/trim-callback-karakter-eredmeny.webp)

*A karakterekre csonkolt szöveg a frontenden* (https://minta-bolt.hu/trim-karakterekre/)

A kép a 60 karakterre vágott szöveget mutatja: a szó közepén is megszakadhat, és három pont jelzi a csonkolást.

## Szavakra csonkolás

Ha a típus **Words**, a visszahívás az első megadott számú szót tartja meg, a végére három pontot tesz. Szó közben nem vág, ezért jobban olvasható kivonatot ad.

Példa: a hossz 8.

![A szavakra csonkolt szöveg a frontenden](./kepek/trim-callback-szo-eredmeny.webp)

*A szavakra csonkolt szöveg a frontenden* (https://minta-bolt.hu/trim-szavakra/)

A kép 8 szót mutat, a megszakítás szóhatáron van.

## Tudnivalók

- A **String length** mezőbe pozitív egész számot írj. A negatív számot a bővítmény pozitívként kezeli, a nem szám nullának számít, és a csonkolt szöveg ilyenkor csak három pont lesz.
- Mindkét módban a HTML-címkék kikerülnek a szövegből, a formázás (félkövér, link) tehát elvész.
- A visszahívás ugyanúgy működik a Gutenbergben és a Bricksben, mint az Elementorban.
- Ha a szöveg a megadott hossznál rövidebb, nem változik.