# Komponensek

> A Component Builder: tulajdonságok, HTML- és CSS-sablon, logika, AI-asszisztens, blokként regisztrálás és példák.

A komponensek saját, újrahasználható elemek. HTML-lel, CSS-sel és JavaScripttel építed őket, szerkeszthető tulajdonságokat adsz nekik, és a **Components** csoportból bármelyik oldalra, bejegyzésre vagy sablonra elhelyezheted. A komponensek a komponenskönyvtárban tárolódnak.

## Megnyitás

A komponensépítő a CrocoBuilderrel szerkesztett oldalakon, bejegyzéseken és sablonokon érhető el: **Tools → Component Builder**. Ehhez a **Component Builder access** hozzáférés kell (lásd [Beállítások](https://hub.hellowp.io/hu/plugins/crocobuilder/beallitasok/)).

A **Your component library** oldal listázza a meglévő komponenseket. A fenti gombok: **Import component** (komponenscsomag importja) és **Add new HTML/CSS component**. Egy listaelemen a másolás, a letöltés (exportálás) és a törlés ikon érhető el.

![A komponenskönyvtár](./kepek/komponens-lista.webp)

*A komponenskönyvtár* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

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

Új komponens létrehozásakor a felső sávban a komponens nevét adod meg. A bal oldali **Component settings** panelen:

| Beállítás | Mit csinál |
| --- | --- |
| **Allow linking** | Ha be van kapcsolva, a komponens beágyazható egy Link elembe, vagyis az egész komponens hivatkozás része lehet. |
| **Properties** | A komponens szerkeszthető tartalmi beállításai. |
| **Register as Block** | A komponens blokként is megjelenik a WordPress blokkszerkesztőjében. A változás a mentés és a blokkszerkesztő újratöltése után lép életbe. |
| **Allow children slot** | Más elemek is beágyazhatók a komponensbe. A HTML-sablonban a `{{ __slot__ }}` jelöli, hová kerül a beágyazott tartalom. |
| **Web component** | A komponenst egyedi HTML-elemként regisztrálja, amely bármely weboldalon használható, mint a `<button>` vagy az `<input>`. |
| **Component tag** | A webkomponens bekapcsolásakor jelenik meg. Kisbetűket tartalmaz, legalább egy kötőjelet, és alulvonás is lehet benne (például `my-web-component`). |

### Tulajdonságok

A **+ Add property** gombbal vehetsz fel új tulajdonságot. Mezői:

- **Label**: a komponens elemén a beállítópanelen megjelenő felirat.
- **Token**: a HTML-sablonban a tulajdonság értékét beillesztő változónév, `{{ token }}` formában.
- **Type**: **Text**, **Textarea**, **Select**, **Image**, **Color** vagy **Repeater**.
- **Default value**: a kezdeti érték, ez látszik az előnézetben is.
- **Description**: opcionális súgószöveg.
- **Is Styling Property**: jelölőnégyzet, amellyel a tulajdonságot stílusbeállításként jelölheted meg.

![Egy új tulajdonság a komponensszerkesztőben](./kepek/komponens-tulajdonsag.webp)

*Egy új tulajdonság a komponensszerkesztőben* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

A **Select** típusnál legalább egy lehetőséget fel kell venni, címkével és értékkel. Az **Image** típus nem egyszerű szöveget, hanem objektumot ad vissza, ezért a sablonban `photo.url` és `photo.alt` formában hivatkozz rá.

A **Repeater** típus ismétlődő mezőcsoportot kezel olyan adatokhoz, amelyek száma nem rögzített: erényeket, csapattagokat, GYIK-et, véleményeket vagy árazási csomagokat. A mezőit a **Repeater field** résznél veszed fel, legalább egy mező kell. A sablonban `{% for item in tulajdonsag %}...{% endfor %}` ciklussal jelenik meg, a mezőket `item.mezo` formában éred el. A `{% empty %}` ág az üres állapotot kezeli.

## HTML- és CSS-sablon

- **HTML template**: a komponens szerkezete. A tulajdonság-tokenekkel (például `{{ felirat }}`) dinamikus értékeket írhatsz ki. A feltételes részekhez használhatsz `{% if %}` blokkot, hogy üres érték esetén ne jelenjen meg üres címke.
- **Component CSS**: a komponens stílusa. A stílusok a komponensre szűkíthetők, hogy ne hassanak az oldal más elemeire.
- **Component logic**: a komponens betöltésekor lefutó, egyedi JavaScript az interaktív működéshez.
- **Live preview**: a készülő komponens valós idejű megjelenítése. Szín-átfedő kapcsolóval megnézheted, hogyan mutat különböző háttereken.

A **Live preview** és a **Component CSS** fejlécében lévő földgömb ikon a CSS-változókat nyitja. Az előnézetnél globális háttérszín-változókat hozhatsz létre (csak **Color** típus), a CSS-nél a komponensbe fordított saját CSS-tulajdonságokat (**Color**, **Size**, **Font**). Mindkét ablakban megadható a **Label**, a **CSS Variable Name** (kötőjelekkel normalizált, egyedi azonosító), a **Type** és a **Value**.

![Kitöltött komponens: tulajdonság, HTML és CSS](./kepek/komponens-kitoltve.webp)

*Kitöltött komponens: tulajdonság, HTML és CSS* (https://minta-bolt.hu/wp-admin/post.php?post=5&action=crocoblocks)

A képen az **Alcím** komponens tulajdonsága, a HTML-sablon (`<div class="alcim">{{ felirat }}</div>`), a CSS és a **Live preview** látszik.

## Mentés és használat

A komponenst a **Create component** gombbal hozod létre, a későbbi módosításokat a **Save changes** gombbal mented. Ezután a CrocoBuilderrel szerkesztett oldalon a komponens a bal oldali panel **Components** csoportjában jelenik meg. Kattintással beteheted az oldalra, a tulajdonságait pedig a beállítópanelen szerkeszted.

## AI Assistant

A szerkesztő tetején lévő **AI Assistant** gomb ablakot nyit, ahol utasítással (prompt) generálhatod a komponenst, a tulajdonságait, a HTML-t, a CSS-t és a logikát.

Előfeltétel, hogy be legyen állítva egy AI-szolgáltató a WordPress csatlakozóin keresztül:

1. Az asszisztens ablakában kattints az **Open Connectors** gombra.
2. A **Beállítások → Csatlakozók** oldalon telepíthetsz és aktiválhatsz AI-bővítményeket (például Anthropic, Google, OpenAI). Az API-kulcsok és a hitelesítő adatok itt tárolódnak, és más bővítményekkel is megoszthatók.
3. Ha a szolgáltató már csatlakozik, de az üzenet nem tűnik el, a **Refresh** gomb frissíti az asszisztens beállításait.

Az **AI Assistant** gomb mellett üzemmód-váltó van:

- **Dev**: az összes komponensbeállítás elérhető, az asszisztens lebegő panelként nyílik.
- **AI**: egyszerűsített nézet beágyazott csevegéssel, élő előnézettel és a CSS-változók gombbal. A további beállítások rejtettek.

A generált komponens utólag kézzel vagy további utasításokkal is módosítható.

## Komponens blokként

Egy komponenst a WordPress blokkszerkesztőjében is használhatsz:

1. Nyisd meg a komponenst, és a bal oldali beállításpanelen kapcsold be a **Register as Block** mezőt.
2. Kattints a **Save changes** gombra.
3. Nyiss meg egy oldalt a blokkszerkesztőben. A blokkbeszúró **CROCOBUILDER COMPONENTS** szakaszában ott a komponens.
4. A blokk beállításai között a komponens tulajdonságai ugyanúgy szerkeszthetők, mint a CrocoBuilder szerkesztőjében.

## Példák

### Alcím (kézi építés)

1. Adj nevet a komponensnek (**Alcím**), és kattints az **Add property** gombra.
2. A tulajdonság: **Label** `Felirat szövege`, **Token** `felirat`, **Type** **Text**, **Default value** `Írd ide a szöveget`.
3. A HTML-sablonba írd: `<div class="alcim">{{ felirat }}</div>`.
4. A **Component CSS** mezőbe:

```css
.alcim {
  text-transform: uppercase;
  color: #0057ff;
  font-size: 15px;
  font-weight: 600;
}
```

5. Kattints a **Create component** gombra.
6. Az oldalszerkesztőben a **Components** csoportból tedd az oldalra, és írd át a szöveget.

### Árkártya (AI-val)

Hozz létre új komponenst, kattints az **AI Assistant** gombra, és írd be: „Hozz létre egy árazási kártyát, amelyben a csomag lehetőségei ismétlődő mezőként szerepelnek, és van egy Kezdés gomb.” Az asszisztens kitölti a tulajdonságokat (csomagnév, ár, leírás, gomb, lehetőségek ismétlődőként), a HTML-sablont és a CSS-t. Utána kézzel vagy további utasításokkal finomíthatod, és a **Create component** gombbal mentheted.

### Szolgáltatásblokk választható színnel

Kapcsolj **AI** üzemmódba, és kérj egy komponenst ikonnal, címmel, leírással, gombszöveggel és gomb-URL-lel, valamint egy **Accent Color** választómezővel, amely csak az ikon színét módosítja. A generált komponens szerkezetét **Dev** módban nézheted át és állíthatod.

### Vélemény kártya feltételes csillagokkal

Tulajdonságok: **Rating** (**Select**, 1 és 5 közti értékekkel), **Quote** (**Textarea**), **Author Initials**, **Author Name**, **Author Role** (**Text**), **Avatar Color** (**Color**). A csillagok száma `{% if rating == '1' %}...{% elseif %}...{% endif %}` feltétellel jelenik meg, az avatár háttere pedig a `style="background-color: {{ avatar_color }}"` attribútummal.

### Csapattag kártya

A kézi építés menete: **Photo** (**Image**), **Name**, **Role** (**Text**) tulajdonságok, és egy **Social Links** ismétlődő mező **Platform** (**Select**) és **URL** (**Text**) mezőkkel. A HTML-ben minden opcionális mezőt `{% if %}` feltétellel védj, hogy ne maradjon üres címke. Az osztályneveket a BEM-elnevezéssel (`blokk__elem`, `blokk__elem--módosító`) add meg, váltakozó stílusokhoz pedig használd a `:nth-child(odd)` és `:nth-child(even)` szelektort külön osztályok helyett.

## Utasítás külső AI-eszközhöz

Ha a markupot külső AI-eszközben készítenéd el, és kézzel másolnád be a HTML- és CSS-mezőkbe, a strukturált utasítás következetesebb eredményt ad. Fontos elemei:

- HTML-ben minden szövegmezőt `{% if %}` feltétellel és `{% for %}` ciklussal kezelj, hogy üres érték ne írjon ki üres címkét.
- Szigorú BEM-elnevezést használj.
- A komponens egyetlen szülőtárolóból álljon, az elemek ciklussal jelenjenek meg benne.
- A CSS legyen külön a HTML-től, tiszta BEM-szelektorokkal, felesleges beágyazás nélkül, és legyen benne mobilra szóló média-lekérdezés (`@media (max-width: 768px)`).

A kapott kódot illeszd be egy új komponens **HTML template** és **Component CSS** mezőjébe, vegyél fel tulajdonságot minden használt tokenhez, és ellenőrizd az előnézetet.

## Komponens elhelyezése és újrahasználata

Bárhogyan készült a komponens, a használata azonos. Nyisd meg az oldalt a CrocoBuilderben, keresd meg a komponenst a bal oldali panel **Components** csoportjában, és húzd a vászonra. Ha több példányra van szükség (például egy csapatoldalon), tedd egy **Grid** elembe, és a példányok tulajdonságait (fotó, név, beosztás, közösségi hivatkozások) az elem saját beállítópanelén töltsd ki, kódszerkesztés nélkül.

## Gyakori kérdések

**Kell HTML- és CSS-tudás a komponensépítéshez?** Nem feltétlenül. Kézi módosításnál hasznos, de az AI Assistant utasításból is előállítja a tulajdonságokat, a markupot és a stílust.

**Mikor használjak ismétlődő mezőt (Repeater) külön tulajdonságok helyett?** Ha a tartalom mennyisége nem rögzített: közösségi hivatkozások, GYIK-elemek, vélemények, árazási jellemzők. Kis, állandó számú mezőnél (név, beosztás) elég a külön tulajdonság.

**Szerkeszthető utólag az AI által generált komponens?** Igen. A tulajdonságok, a HTML, a CSS és a komponenslogika is módosítható **Dev** módban vagy további utasításokkal.

**Mi a különbség a sima komponens és a webkomponens között?** A sima komponens a CrocoBuilderben használható. A **Web component** bekapcsolásakor egyedi HTML-elemként regisztrálódik, amely szabványos webes elemként újrahasználható.

**Működik a külső AI-eszközös utasítás bármelyik asszisztenssel?** Igen, ChatGPT-vel, Geminivel, Claude-dal vagy más általános asszisztenssel is, mert csak sima HTML/CSS-re és Liquid-szerű sablonozásra épül.
