# Gyakori kérdések és hibaelhárítás

> Válaszok a CrocoBuilder használatával kapcsolatos gyakori kérdésekre, és megoldások a tipikus problémákra.

## Általános kérdések

**Mi a CrocoBuilder?**
Vizuális WordPress-oldalszerkesztő, amely egy felületen egyesíti az oldalépítést, a tervezőrendszer kezelését, a komponensek létrehozását (AI-támogatással is) és a dinamikus tartalmi eszközöket. Tiszta jelölést állít elő, és az újrahasználható darabokra épít.

**Mi a különbség a CrocoBuilder és a hagyományos oldalszerkesztők között?**
Atomi felépítést használ: minimális burkolóelemekkel dolgozik, és minden elemen azonos stílusvezérlőket kínál. Sok, hasonló feladatra szolgáló widget helyett újrahasználható elemeket (Block, Grid, Heading, Text, Link, Image, Collection, Query Loop) kombinálhatsz.

**Mi a különbség az atomi elem és a komponens között?**
Az atomi elem egyetlen építőkocka (például Text, Image, Link). A komponens ezeknek az elemeknek egy előre elkészített kombinációja saját beállításokkal. A komponens építési munkát spórol, az atomi elemek teljes kontrollt adnak.

**Kell kódolni a komponensek építéséhez?**
Nem feltétlenül. Az alapvető HTML- és CSS-ismeret segít a jelölés kézi módosításánál, de az AI-asszisztens a tulajdonságokat, a jelölést, a stílust és a logikát szöveges utasításból is előállítja.

**Mikor használjak Repeater tulajdonságot külön tulajdonságok helyett?**
Amikor a tartalom mennyisége nem rögzített: közösségi hivatkozásoknál, GYIK-nél, véleményeknél, árazási lehetőségeknél. Kis, rögzített számú mezőhöz (név, beosztás) külön tulajdonságok is jók.

**Használhatok egyedi CSS-t az elemeken?**
Igen. Minden elemnek van **Raw CSS** szakasza, amely a vizuális vezérlőkkel kétirányú szinkronban működik.

**Átvihető a tervezőrendszer másik projektbe?**
Igen, az **Export design system** és az **Import design system** eszközökkel.

**Az egyedi CSS-osztályok és a közös stílusok közt mi a különbség?**
A CSS-osztályok az elemekhez rendelhető, újrahasználható CSS-definíciók, a közös stílusok egy szelektorra szóló, egységességet segítő beállítások.

**Szabályozható, hogy ki szerkeszthet a builderben?**
Igen: a **CrocoBuilder → Vezérlőpult → Settings** oldal **Role access** részében szerepkörönként külön megadható az **Editor access** és a **Component Builder access**.

## Hibaelhárítás

**A téma felülírja a builder stílusait.**
A **CrocoBuilder → Vezérlőpult → Settings** oldalon a **Selector specificity** mezőt állítsd **High** értékre. Ez megnöveli a generált szelektorok specificitását.

**A felület egyes feliratai angolul látszanak.**
A bővítmény szerkesztőjének és beállítóoldalának a címkéi és gombjai angol nyelvűek maradnak, mert a bővítmény felületi szövegei nincsenek lefordítva. A legördülők és a Sablonépítő nagy része magyar. A dokumentáció a felületi feliratokat szó szerint, ahogy a képernyőn állnak, félkövéren adja meg.

**Az MCP-kapcsolat nem jön létre, pedig a token helyes.**
Ellenőrizd az `Authorization` fejléc formátumát: `Bearer cbmcp[token]` kell, nem `Basic`. Részletek az [MCP-integráció](https://hub.hellowp.io/hu/plugins/crocobuilder/integraciok-mcp-integracio/) fejezetben.

**Az SVG-elem nem jelenik meg.**
Az SVG-tartalom megjelenítés előtt megtisztul (szkriptek, eseménykezelők és nem biztonságos hivatkozások nélkül). Ha a tisztítás után az SVG érvénytelen vagy üres, az elem nem jelenik meg, és a szerkesztő figyelmeztetést mutat. Ellenőrizd az **SVG Markup** tartalmát.

**Az SVG-fájl feltöltése nem megy.**
Kapcsold be az **Allow SVG uploads** beállítást a **Settings** oldalon. A feltöltött fájl legfeljebb 1 MiB lehet.

**A Link elem nem jelenik meg.**
Az üres Link elem nem kerül ki a nyilvános oldalra. Adj neki tartalmat vagy beágyazott elemet.

**Üres blokk nem látszik az oldalon.**
Ez a normál működés: a gyermekelem nélküli **Block** nem jelenik meg a nyilvános oldalon.

**A lekérdezés nem a várt eredményt adja.**
Kapcsold ki az **Enable cache** beállítást a lekérdezésen, és a **Preview** gombbal ellenőrizd az eredményt, mielőtt az oldalon használod. Az `IN`, `NOT IN`, `BETWEEN` és `NOT BETWEEN` összehasonlításnál az értékeket vesszővel tagolva kell megadni, és be kell kapcsolni a **Treat value as a comma-separated list** kapcsolót.

**A shortcode kimenetéből hiányzik a HTML, CSS vagy JavaScript.**
A **Settings** oldal **Sanitize content** beállítása szerint a shortcode kimenete megtisztulhat. Ha a shortcode HTML-jét, CSS-ét és JavaScriptjét meg kell tartani, válaszd a **Before shortcode execution** lehetőséget. Ez csak akkor érvényes, ha a Text vagy Heading elemen be van kapcsolva a **Process shortcodes on frontend**.

**A kisebb kijelzőn nem a várt a megjelenés.**
Váltsd a szerkesztőt a **≤ 1024px** vagy **≤ 767px** nézetre, és ott add meg az eltéréseket.

**A komponens nem jelenik meg a blokkszerkesztőben.**
Ellenőrizd, hogy be van kapcsolva a **Register as Block**, mentetted a komponenst, és újratöltötted a blokkszerkesztőt. A komponens a blokkbeszúró **CROCOBUILDER COMPONENTS** szakaszában keresendő.

**Az AI Assistant nem működik.**
Az asszisztens használatához előbb be kell állítani egy AI-szolgáltatót a WordPress csatlakozóin keresztül. Kattints az **Open Connectors** gombra, vagy lépj a **Beállítások → Csatlakozók** oldalra, telepíts és aktiválj egy AI-bővítményt (például Anthropic, Google, OpenAI), és add meg az API-kulcsot. Ha a szolgáltató már csatlakozik, de az üzenet marad, kattints a **Refresh** gombra.
