Hogyan működnek az appok
Mi az a Poltura app, hol jelenik meg a boltban, hogyan éri el a bolt adatait, és milyen csomagokkal építheted meg.
Ezen az oldalon
A Poltura app oldalakat, paneleket és webáruházi blokkokat ad minden bolthoz, amelyik telepíti. Az appot
egyetlen manifestben (poltura.app.json) írod le, a release-t pedig a poltura CLI-vel teszed közzé. A platform
egy ellenőre átvizsgálja pontosan azt a release-t, a kereskedő pedig jóváhagyja a kért jogosultságokat, mielőtt az app elérné a boltját.
A kódod soha nem fut a bolt szerverein. A felület egy különálló, biztonságos környezetben fut, amely a Poltura saját komponenseit jeleníti meg, és minden, ami adatot igényel, a te szervereden fut, amely az App API-t hívja a kereskedő jóváhagyásakor kapott tokennel.
Buildeld meg az első appodat
Scaffolding, build, validálás és közzététel, nagyjából tizenöt perc alatt.
Példaapp bemutatása
A teljes Recommendations példa, fájlról fájlra.
Eljuttatás a kereskedőkhöz
Felülvizsgálat, telepítés, frissítések és költségek.
Miért érdemes a Polturán építeni
- Európai kereskedők. A Poltura egy hosztolt e-kereskedelmi platform európai kereskedők számára, elsőként Magyarországra építve. A boltok több nyelven és pénznemben értékesítenek, így egyetlen app több ország boltjait is eléri.
- Az első sortól kezdve natív. A workerek a Poltura saját komponenseit jelenítik meg, így az appod pont úgy néz ki, mint az adminfelület és mint az egyes boltok témája, saját CSS nélkül. Lásd: UI.
- Beépített bizalom. Minden release-t ellenőrzünk, mielőtt a kereskedők látnák, a kereskedők minden jogosultságot jóváhagynak, és a kódod soha nem fut a bolt szerverein.
- Világos feltételek. Az ingyenes appok közzététele semmibe sem kerül. Fizetős appok még nincsenek, így nincs bevételmegosztás és kifizetés sem. Lásd: Eljuttatás a kereskedőkhöz.
- Felkészítve AI-eszközökre. Itt minden oldal Markdown a kódíró AI-ügynököd számára,
llms.txt-vel és szabályfájlokkal a Cursorhoz és más eszközökhöz. Lásd: Build AI-jal.
Hol jelenik meg egy app
| Felület | Deklaráció módja | Ahol a kereskedő látja |
|---|---|---|
| Adminoldal | egy worker admin.page célponttal és egy bejegyzéssel az adminPages listában | Appok az adminfelület navigációjában, /apps/:installationId/:pageId |
| Főoldali kártya | admin.home célpont | Az adminfelület nyitólapja |
| Részletpanel | admin.product, admin.collection, admin.order, admin.customer | Termék-, gyűjtemény-, rendelés- és vásárlói oldalak |
| Hosztolt adminoldal | adminFrame.url és adminFrame.actions | Csatlakoztatott appok, egy általad hosztolt iframe-ben |
| Webáruházi blokk | storefront.<template> | A témaszerkesztő, az adott sablonon |
| Header- vagy lábléczóna | storefront.layout.header, storefront.layout.footer | A téma fejléce és lábléce |
| Webáruházi appoldal | storefront.app-page és egy bejegyzés a storefrontPages listában | /apps/<slug> a webáruházban |
A poltura app build a poltura.app.json fájlban lévő workers mezőjéből állítja elő a release manifestet, és rámásolja az adminPages
és a storefrontPages listát, mindegyikből legfeljebb 8-at. E listák nélkül az Appok menüpont és a /apps/<slug> üres
marad. Részletek: Admin, Webáruház, UI.
Natív vagy hosztolt
- A natív workerek a
@poltura/app-uicsomag Poltura primitive-jeit jelenítik meg, így saját CSS nélkül is úgy néznek ki, mint az adminfelület vagy a bolt témája. Nem tudnak kérést küldeni a szerverednek vagy az App API-nak; egy deklarált műveleten keresztül hívják a backendet, és a kérést a hoszt írja alá. - A hosztolt oldalak olyan HTTPS-oldalak, amelyeket egy adminfelületi iframe-ben szolgálsz ki. Akkor használd őket, ha saját DOM-ra van szükséged. Az oldal egy 60 másodpercig érvényes session token segítségével igazolja, melyik kereskedő nézi – ez nem API token.
Mi marad a te szervereden
- Telepítési hozzáférési tokenek. A szervered kapja meg őket, amikor a kereskedő jóváhagyja az app hozzáférését a Poltura ID-n. A workerek és iframe-ek soha nem kapják meg ezeket. Lásd: Hitelesítés.
- Boltadatok. A szervered a kereskedő által jóváhagyott jogosultságokkal hívja az App API-t, és aláírt webhookokat fogad.
A manifest minden más ellenőrzés előtt elutasítja azokat a mezőket, amelyek magát a platformot érnék el. A hibát eredményező neveket a manifest-referencia sorolja fel.
Csomagok
Még nincs npm-en| Csomag | Mit importálsz |
|---|---|
@poltura/cli | A poltura parancs: app create, dev, build, validate, elements, publish és theme check |
@poltura/cli/ui-styles | compileUiStyles, worker CSS fordításához a CLI-n kívül |
@poltura/app-sdk | PolturaClient az App API-hoz |
@poltura/app-sdk/oauth | createPublicAppOAuthClient (szerver) |
@poltura/app-sdk/session | createAppSessionVerifier (szerver) |
@poltura/app-sdk/webhooks | createWebhookVerifier (szerver) |
@poltura/app-sdk/actions | createActionHandler worker műveletekhez (szerver) |
@poltura/app-sdk/elements | defineBlock és field webáruházi blokkokhoz |
@poltura/app-sdk/frame | connectAppFrame, requestAppSession (hosztolt oldal, böngésző) |
@poltura/app-ui/admin | Adminfelületi primitive-ek és hookok |
@poltura/app-ui/storefront | Webáruházi primitive-ek és hookok |
@poltura/app-ui/worker | Worker bootstrap; ezt importáld először |
@poltura/app-ui/worker-runtime | startUiWorker |
@poltura/app-ui/dom | Primitive-ek hosztolt oldalakhoz |
@poltura/app-contracts | Manifest-elemzés, jogosultságok, API-struktúrák és események |