# JetEngine - Get attachment file link by ID

> Új visszahívás a JetEngine Dynamic Field elemhez, amely a csatolmány azonosítójából kattintható fájlhivatkozást készít.

A bővítmény egy új **Callback** (visszahívás) lehetőséget ad a JetEngine **Dynamic Field** elemének. A visszahívás egy csatolmány azonosítóját (ID) alakítja kattintható hivatkozássá. Így egy bejegyzés meta mezőjében tárolt fájl, például egy PDF vagy egy árlista, letölthető linkként jelenik meg a listingben.

## Követelmények

- Aktív JetEngine bővítmény.
- Elementor vagy blokkszerkesztő (Blocks) a listingsablon szerkesztéséhez. A Dynamic Field mindkettőben ugyanígy működik.
- A mező értéke csatolmány azonosító (ID) legyen.

## Telepítés és bekapcsolás

1. Telepítsd és aktiváld a bővítményt (**Bővítmények → Telepített bővítmények**).
2. Külön beállítóoldala nincs, aktiválás után azonnal elérhető a visszahívás.

## Használat

1. Nyisd meg a listingsablont (**JetEngine → Listázások/komponensek**), és szerkeszd.
2. Add hozzá a **Dynamic Field** elemet, vagy jelöld ki a meglévőt.
3. Állítsd a mező forrását arra a meta mezőre, amely a csatolmány azonosítóját tárolja.
4. Kapcsold be a **Filter field output** kapcsolót.
5. A **Callback** legördülőben válaszd ki a **Get attachment file link by ID** tételt.
6. Állítsd be a megjelenő beállításokat (lásd lent), majd mentsd a sablont.

![A blokkszerkesztő Dynamic Field blokkjának oldalsávja a kiválasztott visszahívással és a három új beállítással](./kepek/szerkeszto-visszahivas.webp)

*A blokkszerkesztő Dynamic Field blokkjának oldalsávja a kiválasztott visszahívással és a három új beállítással* (https://minta-bolt.hu/wp-admin/post.php?post=9&action=edit)

A kép alján a **Callback** választó és alatta a visszahívás saját beállításai láthatók. Ezek csak akkor jelennek meg, ha a **Filter field output** be van kapcsolva, és ez a visszahívás van kiválasztva.

### Beállítások

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| **Display name** | A hivatkozás szövegét adja meg. | File name |
| **Custom label** | Egyéni hivatkozásszöveg. Csak akkor látszik, ha a **Display name** értéke Custom. | üres |
| **Megnyitás új ablakban** | A hivatkozás új ablakban (`target="_blank"`) nyílik meg. | ki |

A **Display name** lehetőségei:

| Érték | A hivatkozás szövege |
| --- | --- |
| **File name** | A fájl neve kiterjesztéssel, például `arlista-2026.pdf`. |
| **Attachment post title** | A csatolmány címe a médiatárban. |
| **Current post title** | Annak a bejegyzésnek a címe, amelyiknél a listing eleme éppen áll. |
| **Parent post title** | A csatolmány szülőbejegyzésének címe. Ha a csatolmánynak nincs szülője, az aktuális bejegyzés címét használja. |
| **Custom** | Az általad megadott **Custom label** szöveg. |

![A Dynamic Field beállításai Custom megjelenítési névvel és egyéni felirattal, az előnézetben a Letöltés szöveggel](./kepek/szerkeszto-egyedi-felirat.webp)

*A Dynamic Field beállításai Custom megjelenítési névvel és egyéni felirattal, az előnézetben a Letöltés szöveggel* (https://minta-bolt.hu/wp-admin/post.php?post=9&action=edit)

Itt a **Display name** értéke Custom, a **Custom label** mezőbe a „Letöltés” került, a szerkesztő előnézete pedig már ezt a szöveget mutatja.

## Az eredmény

A visszahívás egy sima HTML-hivatkozást ad vissza: a hivatkozás címe a csatolmány URL-je, a szövege a **Display name** szerint alakul. Bekapcsolt **Megnyitás új ablakban** esetén a hivatkozás új lapon nyílik meg.

![Az oldal, amelyen a listing két bejegyzésénél a csatolt PDF-ek címe kattintható hivatkozásként jelenik meg](./kepek/dokumentumok-oldal.webp)

*Az oldal, amelyen a listing két bejegyzésénél a csatolt PDF-ek címe kattintható hivatkozásként jelenik meg* (https://minta-bolt.hu/dokumentumok/)

A képen a listing két eleme látszik: mindegyiknél a bejegyzéshez tartozó csatolmány címe lett a link szövege.

## Tudnivalók

- A visszahívás csak a **Dynamic Field** elemnél érhető el.
- Ha csak a fájl URL-jére van szükséged, például egy űrlap e-mailjébe vagy egy szövegbe, a JetEngine `%media-field|file_url_by_id%` makrója a csatolmány linkjét adja meg, hivatkozás nélkül.
- A bővítmény a beállítások feliratait angolul jeleníti meg, a **Megnyitás új ablakban** felirat kivételével.

## Hibaelhárítás

| Tünet | Teendő |
| --- | --- |
| A **Callback** listában nincs **Get attachment file link by ID** | Ellenőrizd, hogy a bővítmény és a JetEngine is aktív, és a **Filter field output** be van kapcsolva. |
| A hivatkozás helyett üres hely látszik | A mező nem csatolmány azonosítót tartalmaz, vagy üres. Ellenőrizd a meta mező értékét. |
| A **Display name** és a **Custom label** nem látszik | Válaszd ki a **Get attachment file link by ID** visszahívást. A beállítások csak ennél jelennek meg. |
| A **Custom label** nem látszik | A **Display name** értékét állítsd Custom-ra. |