# Bejegyzés létrehozója, dátumok, fizetési esemény és médiatár

> A {created_by}, a {date_created}, {date_updated}, {payment_date}, a {payment_action} és az {apc_media} összefűző címke módosítóival és példákkal.

## A beküldés létrehozója: {created_by}

A `{created_by:[meta_kulcs]}` címke annak a felhasználónak az adatait írja ki, akinek az azonosítója a beküldés `created_by` tulajdonságában van. Ez általában az a felhasználó, aki a beküldéskor be volt jelentkezve. Használható értesítésekben, megerősítésekben és egyes kiegészítőkben, de **mezőbeállításokban nem**. Ha egy mezőt az éppen bejelentkezett felhasználó adataival akarsz kitölteni, a felhasználói címkét használd.

A `[meta_kulcs]` helyére bármelyik felhasználói meta kulcs kerülhet, az egyedi felhasználói metákat is beleértve.

| Meta kulcs | Mit ír ki | Használat |
|---|---|---|
| `ID` | A létrehozó azonosítóját | `{created_by:ID}` |
| `first_name` | A keresztnevét | `{created_by:first_name}` |
| `last_name` | A vezetéknevét | `{created_by:last_name}` |
| `display_name` | A megjelenített nevét | `{created_by:display_name}` |
| `user_email` | Az e-mail-címét | `{created_by:user_email}` |
| `user_login` | A felhasználónevét | `{created_by:user_login}` |
| saját kulcs | A megadott meta kulcs értékét | `{created_by:preferred_contact_method}` |

## A beküldés dátumai

A `{date_created}`, a `{date_updated}` és a `{payment_date}` címke a beküldés létrehozásának, módosításának és kifizetésének idejét írja ki. Használhatók értesítésekben, megerősítésekben és egyes kiegészítőkben, mezőbeállításokban nem.

Az értékeket a rendszer UTC szerint, `ÉÉÉÉ-HH-NN ÓÓ:PP:MM` formátumban tárolja. Kiíráskor a **Beállítások → Általános** oldalon megadott időzónát, dátum- és időformátumot alkalmazza.

Az alábbi példákban a tárolt érték `2021-04-21 10:30:15` UTC, az időzóna Europe/London, a dátumformátum `F j, Y`, az időformátum `g:i a`. A táblázatok a `{date_created}` címkével szemléltetnek, a másik kettőnél ugyanígy működik.

| Címke | Kimenet |
|---|---|
| `{date_created}` | `April 21, 2021` |
| `{date_created:time}` | `April 21, 2021 at 11:30 am` |
| `{date_created:format:m/d/Y}` | `04/21/2021` |
| `{date_created:format:Y-m-d}` | `2021-04-21` |
| `{date_created:human}` | `15 mins ago` (egy napnál fiatalabb beküldésnél) |
| `{date_created:diff}` | `1 second ago` |
| `{date_created:raw}` | `2021-04-21 10:30:15` |
| `{date_created:timestamp}` | `1619001015` |

### Módosítók

| Módosító | Mit csinál |
|---|---|
| (nincs) | Az alapértelmezett dátumformátum szerint kiírja a dátumot. |
| `:time` | A dátum mögé az időt is kiírja. |
| `:format` | Egyedi formátum a WordPress és a PHP dátumjelölései szerint. A formátum a `:format` után, kettősponttal következik, például `:format:m/d/Y`. Ha kettőspontot akarsz a kimenetbe, vissza kell perjellel védeni: `\:`. Például `{date_created:format:d/m/Y\ \a\t\ H\:i\:s}` kimenete `21/04/2021 at 11:30:15`. |
| `:human` | Ha a beküldés egy napnál fiatalabb, relatív időt ír (`15 mins ago`). Régebbi beküldésnél az alapértelmezett formátumban a dátumot, a `:time` módosítóval együtt a dátumot és az időt (`April 21, 2021 at 11:30 am`). |
| `:diff` | Azt írja ki, mennyi telt el a létrehozás, módosítás vagy fizetés óta (másodperc, perc, óra, nap, hét, hónap vagy év). Alapformátuma `%s ago`, ahol `%s` helyére a különbség kerül. A `:format` módosítóval testre szabható, például `{date_created:diff:format:%s has passed since the form was submitted}`. A `:time` és a `:human` módosítóval nem használható együtt. |
| `:raw` | A beküldésben és az adatbázisban tárolt értéket adja vissza. Más módosítóval nem használható együtt. |
| `:timestamp` | Unix időbélyeget ad (az 1970. január 1-jei UTC óta eltelt másodpercek száma). Más módosítóval nem használható együtt. |

## {payment_action}

A `{payment_action:[módosító]}` címke a fizetési kiegészítők által hozzáadott eseményekhez rendelt értesítésekben írja ki az értesítést kiváltó esemény részleteit. Ilyen kiegészítő például az Authorize.net, a PayPal Standard és a Stripe. Más értesítésben nem használható.

| Módosító | Mit ír ki |
|---|---|
| `:type` | Az esemény típusát: `complete_payment`, `refund_payment`, `fail_payment`, `add_pending_payment`, `void_authorization`, `create_subscription`, `cancel_subscription`, `expire_subscription`, `add_subscription_payment`, `fail_subscription_payment`, vagy a kiegészítő által felvett egyedi típust. |
| `:amount` | A tranzakció összegét pénznem-formázás nélkül. |
| `:amount_formatted` | A tranzakció összegét pénznem-formázással. |
| `:transaction_type` | A tranzakció típusát: `authorization`, `payment` vagy `refund`. |
| `:transaction_id` | A fizetési szolgáltató által visszaadott tranzakcióazonosítót. |
| `:subscription_id` | A fizetési szolgáltató által visszaadott előfizetés-azonosítót. |
| `:entry_id` | A beküldés azonosítóját. |
| `:payment_status` | A beküldés aktuális fizetési állapotát: Authorized, Paid, Processing, Pending, Active, Expired, Failed, Cancelled, Approved, Reversed, Refunded, Voided, vagy a kiegészítő egyedi állapotát. |
| `:note` | A kiegészítő által az eseményhez a beküldéshez fűzött megjegyzést. |

## {apc_media}

A Bejegyzés létrehozása kiegészítő (APC) feedjében használható címke: a médiatárba feltöltött fájlokat illeszti be a létrehozott bejegyzésbe. A kiválasztott mezőt a feed beállítási oldalán a médiakönyvtárra vonatkozó beállításnál is ki kell jelölni.

```
{apc_media:[id]:[visszaadott_típus]}
```

| Rész | Jelentése |
|---|---|
| `id` | A **Fájlfeltöltés** mező azonosítója. |
| `visszaadott_típus` | `ids` (alapértelmezés) a fájlok azonosítóját, `urls` az URL-jét adja vissza. |

Például az `{apc_media:12:urls}` a 12-es mezőbe feltöltött fájlok URL-jét írja ki. Többfájlos feltöltésnél az azonosítók vagy URL-ek vesszővel elválasztott listaként jelennek meg.

Ismert korlát: mivel a Gravity Forms eredeti feltöltési útvonala nem tárolódik a médiatárban a fájllal együtt, ez a címke csak azon a feeden használható, amely a fájlokat a médiatárba teszi.