# Dinamikus naptár

> A Dynamic Calendar widget beállításai, események naptárba rendezése dátummező szerint, többnapos események, és a naptár Bricksben.

A **Dynamic Calendar** widget bejegyzéseket, felhasználókat, hozzászólásokat, kifejezéseket és egyéni tartalomtípus-elemeket jelenít meg naptárban, kattintható listázási elemként. A naptárban a hely az elem létrehozási dátumától vagy egy egyéni mező dátumától függ.

## Előkészítés

1. Kapcsold be a **Dinamikus naptár** modult a **JetEngine → JetEngine → Modulok → Alapértelmezett modulok** fülön, és mentsd.
2. Hozz létre egy bejegyzéstípust az eseményeknek (például „Események”), és vegyél fel **Dátum** típusú metamezőt.
3. A **Dátum** mezőnél kapcsold be az **Save as timestamp** (mentés időbélyegként) kapcsolót. Nélküle az események nem jelennek meg helyesen a naptárban.
4. Többnapos eseményekhez vegyél fel egy második, „Befejezés dátuma” **Dátum** mezőt is, szintén időbélyeg mentéssel.
5. Ha képet is szeretnél, vegyél fel **Média** mezőt.
6. Mentsd a bejegyzéstípust, és hozz létre néhány eseményt. A többnapos eseménynél töltsd ki a kezdő és a záró dátumot is.

Bricksben ezen kívül a **Bricks → Beállítások** oldalon az **Oldalak** kapcsolónak is bekapcsoltnak kell lennie a bejegyzéstípusoknál.

## Listázási sablon a naptárcellához

1. A **JetEngine → Listázások/komponensek** oldalon kattints az **Új elem hozzáadása** gombra.
2. A forrás **Bejegyzések**, a bejegyzéstípus az eseményeké, add meg a nevet, a nézet legyen az, amelyiket használod (a Bricks példában **Bricks**).
3. Építsd fel a cellát dinamikus elemekkel: **Dynamic Field** a címhez, **Dynamic Image** a képhez, **Dynamic Link** a **Permalink** forrással az esemény oldalára.
4. Mentsd.

## A widget az oldalon

Elementorban a **Dynamic Calendar** widgetet húzd az oldalra (a modulnak bekapcsoltnak kell lennie). Bricksben a **Calendar** elemet add egy szakaszhoz.

### Általános beállítások

| Beállítás | Mit csinál |
|---|---|
| **Listing** | A naptárban megjelenő listázási sablon. Az **Edit Listing** gomb új lapon megnyitja a szerkesztőt. |
| **Group posts by** | A naptárba rendezés alapja, lásd lent. |
| **Allow multi-day events** | Csak a „Date from custom field” esetén. Bekapcsolva megjelenik az **End Date Field Name**, így a naptár az eseményt a kezdő és a záró dátum között is megjeleníti. |
| **Use Custom Post Types** | Több bejegyzéstípus megjelenítése. A típusok metamezőinek nevei egyezzenek, a legjobb egy közös metabox. |
| **Week days format** | A napok neve: **Full** (Hétfő), **Short** (Hét), **Initial letter** (H). |
| **Start from custom month** | A naptár egy általad választott hónappal és évvel nyílik meg, nem a mostanival. |
| **Show posts from nearby month** | A hónap első és utolsó hetében a szomszédos hónapok átlógó napjainak eseményeit is mutatja. |
| **Hide past events** | Csak a jövőbeli eseményeket mutatja. |
| **Allow date select** | Hónap- és évválasztó. A **Min select year** és **Max select year** mezőben fix évet (például 1970), szöveget (például `+3years`, `-1year`, `this year`) vagy JetEngine-makrót is megadhatsz. |
| **Cache Calendar** | Gyorsítótár. A **Cache Timeout** másodpercben (például 60; a -1 korlátlan), a **Maximum Cache Size** a tárolt hónapok maximális száma (például 12): ha több lenne, a legrégebbi hónap törlődik. |

A **Group posts by** lehetőségei:

- **Post publication date**: a közzététel dátuma.
- **Post modification date**: az utolsó módosítás dátuma.
- **Date from custom field**: egy **Dátum** metamező értéke (bejegyzések, felhasználók, hozzászólások, kifejezések, tartalomtípus-elemek). Megjelenik a **Meta field name** mező, ide kell a mező neve.
- **Query Item creation date (depends on used query)**: felhasználók, hozzászólások, tartalomtípus-elemek létrehozási dátuma.
- **Appointment date**: JetAppointment szolgáltatások foglalási dátuma.
- **Booking date**: JetBooking foglalások dátuma, ha a bővítmény aktív.

### Egyéni lekérdezés és régi lekérdezés

A **Custom Query** szakaszban a **Use Custom Query** kapcsolóval és a **Custom Query** listával Lekérdezéskészítő-lekérdezést alkalmazhatsz. A **Posts Query (Legacy)** ugyanúgy működik, mint a Listing Gridnél, de régi megoldás, helyette is lekérdezést érdemes használni.

### Láthatóság és stílus

A **Widget Visibility** szakaszban a **Hide widget if** értéke **Always show** vagy **Query is empty**. A **Style** fülön a felirat, a navigációs nyilak, a napnevek, a napok és a mobilnézet stílusa állítható.

## Az eredmény

A frontenden az események a **Dátum** mező értéke szerint jelennek meg. A többnapos esemény mindkét napon látszik (a példában a hétvégi borkóstoló a kezdő és a záró napon is).

## Naptár a blokkszerkesztőben

A blokkszerkesztőben a **Listing Calendar** blokk használható. A menet ugyanaz: a **JetEngine → JetEngine → Modulok** fülön kapcsold be a **Dinamikus naptár** modult, hozz létre egy bejegyzéstípust az eseményeknek **Dátum** metamezővel (az **Save as timestamp** kapcsoló legyen bekapcsolva), majd készíts hozzá listázási sablont a **Blokkok (Gutenberg)** nézettel.

Az oldalon add hozzá a **Listing Calendar** blokkot. A **General** szakaszban a **Listing** listából válaszd ki az események sablonját, a **Group posts by** értéke legyen **Date from custom field**, a **Meta field name** mezőbe pedig írd a dátum metamező nevét. Az események a naptár megfelelő celláiban jelennek meg.

A blokk beállításai megegyeznek a fenti widgetével: **Allow multi-day events**, **Week days format**, **Start from custom month**, **Show posts from the nearby month**, **Hide past events** és a **Caption Layout** (a „Back” és „Forward” gombok, valamint a hónap és az év elrendezése, négy változatból). A **Post Query** szakaszban a megjelenő bejegyzéseket szűkítheted, a **Block Visibility** szakaszban a **Hide block if** listából a **Query is empty** lehetőséggel elrejtheted a blokkot, ha a lekérdezésnek nincs eredménye.

## Egy bejegyzés több napon

A többnapos esemény (például egy nyolcnapos utazás, tábor, konferencia vagy műhely) a kezdő és a záró dátum között minden napon megjelenik a naptárban. Menete:

1. Az esemény bejegyzésénél töltsd ki a kezdő és a záró dátum metamezőt.
2. Hozz létre listázási sablont az eseményhez, dinamikus widgetekkel.
3. Húzd be az oldalra a **Calendar** widgetet.
4. A **Content → General** szakaszban válaszd ki a sablont, a **Group posts by** legyen **Date from custom field**, és a **Meta field name** mezőbe írd a kezdő dátum mezőjének nevét.
5. Kapcsold be az **Allow multi-day events** kapcsolót, és az **End Date Field Name** mezőbe írd a záró dátum mezőjének nevét.
6. Mentsd az oldalt. A naptárban az esemény a teljes időszakban napról napra látszik.

## Ismétlődő események

Ha az esemény rendszeresen ismétlődik (napi, heti, havi vagy éves gyakorisággal), **Advanced Date** mezőt használj a sima **Dátum** helyett. Ez a típus a **Dinamikus naptár** modul bekapcsolása után jelenik meg.

### Az Advanced Date mező felvétele

1. Hozz létre egy bejegyzéstípust (a példában „Filmek”) a szükséges mezőkkel.
2. A **JetEngine → Metaboxok** oldalon hozz létre új metaboxot. A **Visibility Conditions** (láthatósági feltételek) részben az **Enable For Post Types** listában válaszd ki a bejegyzéstípust, a **Meta fields** részben pedig a **Mező típusa** legyen **Advanced Date**. Mentsd.
3. Nyisd meg a bejegyzéseket, és a mezőben (a példában „Dátumok”) állítsd be:
   - **Start date**: az esemény kezdete;
   - **Has end date**: bekapcsolva megadhatsz záró dátumot a többnapos eseményhez;
   - **Is recurring**: bekapcsolva megjelenik a **Repeat** lista **Daily**, **Weekly**, **Monthly**, **Yearly** értékekkel. Mindegyik a hozzá tartozó mezőket mutatja, például a **Weekly** a hét napjait kiválasztó gombokat;
   - **End**: **After** (hány ismétlés után) vagy **On date** (melyik dátumon) ér véget az ismétlődés.
4. Töltsd ki és tedd közzé a bejegyzéseket.

Az ismétlődő eseményt mindig korlátozni kell: az ismétlések számával vagy záró dátummal.

### Sablon és naptár

1. A **JetEngine → Listázások/komponensek** oldalon hozz létre listázási elemet a bejegyzéstípushoz, és a **Dynamic Field** és **Dynamic Image** widgettel jelenítsd meg a szükséges mezőket. Mentsd az **Update** gombbal.
2. Hozz létre oldalt, és húzd be a **Calendar** widgetet (Elementorban, blokkszerkesztőben). Állítsd be:
   - **Listing**: az elkészült sablon;
   - **Group posts by**: **Date from custom field**;
   - **Meta field name**: az **Advanced Date** mező neve (a példában `dates`);
   - **Allow multi-day events**: bekapcsolva, ha a mezőnél a **Has end date** is be van kapcsolva;
   - az **End date field name** mezőt nem kell kitölteni, mert az érték a forrásmezőből jön.
3. Szükség szerint stílusozd a naptárat, és tedd közzé az oldalt.

A frontenden a naptár az ismétlődő eseményeket a beállított gyakorisággal jeleníti meg.

### Ismétlődő események Bricksben

Bricksben a menet hasonló, de néhány dolog más:

1. A **Bricks → Beállítások → Általános** oldalon kapcsold be a **Listing Items** és a bejegyzéstípus kapcsolóját, és mentsd.
2. A listázási elem **Dynamic Field** elemével a kezdő dátumhoz a **Source** legyen **Meta Data**, a **Meta field** az **Advanced Date** mező. Kapcsold be a **Filter field output** kapcsolót, a **Callback** legyen **Format date**, a **Field Format** mezőbe pedig a kiírandó szöveget írd (például „Kezdete: %s”).
3. A záró dátumhoz a **Source** szintén **Meta Data**, de a **Custom Object Field/Meta field/Repeater key** mezőbe a mező nevét kell írnod `__end_date` utótaggal (például `rec_dates__end_date`). Itt is **Filter field output**, **Format date** callback és szöveg kell.
4. A **Calendar** elem **General** beállításainál válaszd ki a listázást, a **Group by** legyen **Date from custom field**, a **Meta field name** és az **End date field name** is az **Advanced Date** mező neve (például `rec_dates`), kapcsold be az **Allow multi-day events** kapcsolót, a **Use custom post types** bekapcsolása után pedig válaszd ki a bejegyzéstípust.
5. Mentsd a sablont. A jobb felső sarokban a szem alakú ikon az előnézeti módot kapcsolja be.