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
Szekció neve “Á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
Szekció neve “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ó 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.
Készült: