
Xodera Plugins · Bubble Native
Xodera QR Passes Native
Készítsen egyszeri jegyeket, átvételi visszaigazolásokat vagy kuponokat. A személyzet beolvassa a kódot, ellenőrzi az eredményt, megtekinti a megrendelést, és csak készen állva erősíti meg a felhasználást.
Public beta guides · Haptics instructions are in its Bubble listing
Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.
Dokumentáció felülvizsgált 6 november 2026
Gyakorlati példák
Egyszeri belépő ugyanazon napra szóló eseményhez
Egy szokásos QR érték képernyőképe egyébként több bejáratnál is felhasználható.
Az alkalmazásod tárol egy Admission rekordot és egy stabil kiadást `request_id`; használjon kurált `label=event` és egy `ttl_seconds` a 1–86400 másodperces szerződésen belül.
Egy jogosult kibocsátó futtatja a Issue QR pass-t és privát módon kézbesíti a visszakapott QR-t. A személyzet beolvas → Check QR pass → megerősít csak ha `ok=yes` és `status=available` → Confirm QR redemption egy tárolt stabil kérésazonosítóval.
Csak a `status=redeemed` és a `receipt_id` jogosítja fel az alkalmazásod admission nyugtáját. Tárold a passz/nyugta hivatkozást az Admissionon; ne tedd hozzáférhetővé a QR tartalmát az elemzések számára.
A `outcome_unknown` esetén állítsd helyre ugyanazt a kérést azonos felhasználóval/környezettel/passzal; soha ne generálj új megerősítő azonosítót. Kezeld a expired, revoked és a már felhasznált állapotokat különálló eredményekként.
Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.
Használd fel egyszer a rövid élettartamú előnyt egy partner pultnál
A partnernek egy megerősített felhasznált/nem felhasznált eredményre van szüksége a QR kép vagy képernyőanimáció helyett.
`label=coupon`; az alkalmazás Benefit rekordja meghatározza a jogosultságot és egy rövid érvényességi időablakot egy jogosult kiadási művelet előtt.
Adj ki egy passzt csak az alkalmazásod jogosultság-ellenőrzése után. A pultnál a Check QR pass mutatja a rendelkezésre állást anélkül, hogy felhasználná. Miután a személyzet megerősíti az előny átadását, futtasd a Confirm QR redemption-t.
A Benefit rekordod tárolhatja a `receipt_id`-t és a megerősített beváltási időt a `status=redeemed` után. A plugin kezeli a passz állapotát; az alkalmazásod kezeli az előnyt és az ügyfélkapcsolatot.
Ha egy előnyt a használat előtt visszavonnak, ugyanaz a jogosult kibocsátó képes Revoke QR pass-t végrehajtani a saját `pass_id`-jével. Ne hirdess visszatérítést vagy sikeres beváltást csak a `ok=yes` alapján.
Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.
Erősítsd meg a napazonos berendezés vagy rendelés átvételét
A személyzet munkafolyamatának meg kell különböztetnie az átvételi hivatkozás beolvasását a tényleges tárgy átadásától.
Az alkalmazásod által birtokolt Collection rekord megőrzi a jogosultságot, a célzott elemet és a különálló stabil kiadás/beváltás kérésazonosítókat; használj egy rövid élettartamú `label=access` passzt.
Miután az alkalmazásod engedélyezi az átvételt, Issue QR pass. A személyzet beolvas és ellenőriz, megvizsgálja a megfelelő Collection-t az alkalmazásodban, majd kifejezetten megerősíti az átadást és a Confirm QR redemption-t.
Csak egy megerősített `redeemed` nyugta után állítsa be a munkafolyamat a Collection-t átadottnak. Tartsd meg a `receipt_id`-t a passz eredményének hivatkozásaként.
Egy ismételt beolvasás visszaadhatja a already_used-t; jelenítsd meg a meglévő alkalmazás rekordot ahelyett, hogy egy másik tárgyat adnál át. Hozd vissza a bizonytalan megerősítést ugyanazzal az azonosítóval és bemenetekkel.
Tervezett. A beolvasás és ellenőrzés nem használja a passzt; csak a kifejezett megerősítés használja.
Mi működik most
Privát béta. A jelenlegi szkenner kamera- és jogosultságvezérléssel rendelkezik. Az egyszeri belépők létrehozása, ellenőrzése és megerősítése tervezett, és még nem áll készen a használatra az alkalmazásában.
A munkafolyamat felépítése
Tervezett
Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.
Ezek a példák olyan alkalmazásrekordokat használnak, mint a Lesson, Message és Order. Cserélje ki őket saját adat típusokra és elemnevekre. A példaként megadott média címeket saját fájljaival kell helyettesíteni.
Tervezett: egy jogosult alkalmazott Issue QR pass-t használ belépéshez vagy Order-hez. Példa: label=event, ttl_seconds=900, environment=development. Tartson egy stabil request_id-t az adott kibocsátáshoz, és mentse a pass_id-t a rekordhoz.
Mutassa a visszakapott QR-t a címzettnek. A személyzet beolvassa. A tervezett passz munkafolyamatban használja a workflow_mode=yes-t, és olvassa a scanned_pass_token-t a pass_scanned után. Ezek a passz-munkafolyamat beállítások nem érhetők el a jelenlegi szkennerben.
Futtassa a Check QR pass-t a pass_token = QR Scanner's scanned_pass_token-vel. Ellenőrzés passz használata nélkül. status=available esetén jelenítse meg a megfelelő rendelés vagy bejegyzés részleteit, hogy a személyzet áttekintse őket.
Csak egy külön Megerősítés gomb futtatja a Confirm QR redemption-t ugyanazzal a pass_token-szel, egy stabil request_id-szel és confirm=yes-szel. status=redeemed esetén mentse a receipt_id-t, és jelölje be a rendelést vagy bejegyzést befejezettként.
already_used, expired, revoked vagy invalid azt jelenti, hogy ne engedélyezze a belépést, és ne adja át a rendelést. Egy beolvasás vagy egy sikeres ellenőrzés önmagában soha nem fejezi be a tranzakciót.
Egyszeri beállítás
Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera QR Passes Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera QR Passes Native-t, és illessze be a project_api_key-be. Mentse el egyszer; ezután használja az alábbi műveleteket. Minden bővítmény minden projektben saját kulccsal rendelkezik.
A beolvasáshoz kameraengedély szükséges. Egyszeri belépőkártyák esetén határozza meg, ki hozhat létre kártyákat, és ki ellenőrizheti azokat az ajtónál vagy átvételi pontnál. A hétköznapi vásárlóknak nincs szükségük semmilyen személyzeti szerepkörre.
qr_issuer_permission_field
qr_pass_issuer · A felhasználó igen/nem mező neve, amely jelöli a jogosult alkalmazottakat a bérletek létrehozására vagy visszavonására. Példa/alapértelmezett: qr_pass_issuer. Ide a mező nevét írja, nem az igen vagy nem értéket. Csak egy jogosult adminisztrátor módosíthatja ezt a felhasználói jogosultságot.
qr_staff_permission_field
qr_staff · A felhasználó igen/nem mező neve, amely jelöli a személyzetet, akik ellenőrizhetik és megerősíthetik a használatot. Példa/alapértelmezett: qr_staff. A jegytulajdonosnak nincs szüksége erre a jogosultságra. Tartsa távol a nyilvános regisztrációs és profil űrlapoktól.
Egyszeri beállítás
- Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
- Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
- Nyissa meg a Bubble → Plugins → Xodera QR Passes Native-t; illessze be a kulcsot a project_api_key-be, majd mentse.
- Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
- Jelenleg csak privát béta hozzáférés. A nyilvános telepítés és a fizetős aktiválás még nem elérhető.
Telepítés és előfizetés
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
Eredmény mentése az alkalmazásodba
Példa belépés vagy átvétel: mentse a kapcsolódó rendelést/eseményt, pass_id, expires_at és issue_request_id. A megerősített használat után adja hozzá a receipt_id, redeemed_at és a megerősítést végző alkalmazottat. Ne jelölje a rekordot befejezettként, ha a kód csak beolvasásra vagy ellenőrzésre került. A QR kód nem igazolja a személyazonosságot.
Hiba, megszakítás és helyreállítás
Ha outcome_unknown=yes, tartsa meg ugyanazt a passes, request_id és a bemeneteket az eredmény újbóli ellenőrzésekor. Ne hozzon létre új megerősítést. already_used, expired és revoked végleges üzleti eredmények. Ha a jogosultság megtagadva, kérjen egy jogosult rendszergazdát, hogy ellenőrizze az alkalmazott szerepkörét. Clear session visszaállítja a szkennert; nem tudja visszavonni a befejezett használatot.
Képességek és korlátok
A tervezett passzok egyszeri használatúak, élettartamuk 1–86400 másodperc; alapértelmezett 900. Passz típusok: access, event, coupon és membership. Az ellenőrzés nem foglal le passzt. Internetkapcsolat szükséges a passz használatához. Nincs fizetési feldolgozás, személyazonosság-ellenőrzés vagy újrahasználható hosszú távú tagsági kártya. Egy általános QR érték olvasása különálló a passz ellenőrzésétől.
Beállítások, műveletek és eredmények
Használja ezeket a neveket a Bubble-ben. A tervezett funkciók külön vannak jelölve.
Elérhető béta beállítások
Elem beállítások
disabled · yes/nois_active · yes/noui_text_json · textlanguage · textÁllapotok
scanner_status · textserver_status · textpass_id · textpass_label · textreceipt_id · texterror_code · textis_busy · yes/nois_scanning · yes/notorch_enabled · yes/noscan_source · textpending_redemption · yes/noEsemények
scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_errorMűveletek és azok bemenetei
Clear sessionElem beállítások · 5
Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.
disabledyes/no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
GuideHost's is_busy (your yes/no custom state) - Tiltja le az elemet, amíg az alkalmazás foglalt vagy a művelet nem érhető el.
is_activeyes/no · Alapértelmezett: true- Példaérték
yes - Példa Bubble kifejezés
GuideHost's view_is_active (your yes/no custom state) - Állítsa igent, amíg ez a nézet nyitva van. Állítsa nemet a kilépéskor, hogy a lejátszás vagy a jelenlegi munka leállhasson.
ui_text_jsontext · Alapértelmezett: "{}"- Példaérték
{} - Példa Bubble kifejezés
App Settings' player_labels_json (supported keys only) - Választható JSON a támogatott gombcímkékkel. Hagyja üresen a beépített szöveg használatához.
languagetext · Alapértelmezett: "auto"- Példaérték
uk - Példa Bubble kifejezés
Current User's preferred_language - Állítsa be a language=auto-t, hogy egy támogatott eszköz vagy böngésző nyelvét kövesse. Adjon meg egy támogatott nyelvkódot a kifejezett kiválasztáshoz.
workflow_modeyes/no · Alapértelmezett: false- Példaérték
yes - Példa Bubble kifejezés
App Settings' use_qr_business_actions - Tervezett: engedélyezni, hogy a beolvasott QR értéket a Check QR pass használja. A beolvasás önmagában nem erősíti meg a belépést vagy átvételt.
Műveletek és azok bemenetei · 5
Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.
Clear session
Nincsenek műveletparaméterek
Issue QR pass
environmenttext · Alapértelmezett: "development"- Példaérték
development - Példa Bubble kifejezés
App Settings' selected_environment - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
request_idtext · Alapértelmezett: —- Példaérték
pickup-123-issue-v1 - Példa Bubble kifejezés
Current Admission's stable_request_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
labeltext · Alapértelmezett: "access"- Példaérték
event - Példa Bubble kifejezés
Selected Admission's pass_label - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
ttl_secondsnumber · Alapértelmezett: 900- Példaérték
900 - Példa Bubble kifejezés
Event Settings' pass_ttl_seconds - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Visszatérések
pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/noCheck QR pass
environmenttext · Alapértelmezett: "development"- Példaérték
development - Példa Bubble kifejezés
App Settings' selected_environment - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_tokentext · Alapértelmezett: —- Példaérték
<opaque token returned by Issue / camera scan> - Példa Bubble kifejezés
QR Pass Scanner's scanned_pass_token (capture before Check) - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Visszatérések
pass_label · textexpires_at · textConfirm QR redemption
environmenttext · Alapértelmezett: "development"- Példaérték
development - Példa Bubble kifejezés
App Settings' selected_environment - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_tokentext · Alapértelmezett: —- Példaérték
<opaque token returned by Issue / camera scan> - Példa Bubble kifejezés
QR Pass Scanner's scanned_pass_token (capture before Check) - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
request_idtext · Alapértelmezett: —- Példaérték
pickup-123-redeem-v1 - Példa Bubble kifejezés
Current Admission's stable_redemption_request_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
confirmyes/no · Alapértelmezett: false- Példaérték
yes — explicit confirmation only - Példa Bubble kifejezés
Confirm Checkbox is checked - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Visszatérések
pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/noRevoke QR pass
environmenttext · Alapértelmezett: "development"- Példaérték
development - Példa Bubble kifejezés
App Settings' selected_environment - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
pass_idtext · Alapértelmezett: —- Példaérték
<pass_id returned by Issue> - Példa Bubble kifejezés
Selected Admission's pass_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Visszatérések
pass_id · textrevoked · yes/noÁllapotok és események
Tervezett munkafolyamat. Jelenleg még nem érhető el az aktuális béta verzióban.
Állapotok
scanner_status · textAz akció jelenlegi eredménye. Használd a megfelelő befejezési eseményt a siker mentése előtt. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded
server_status · textAz akció jelenlegi eredménye. Használd a megfelelő befejezési eseményt a siker mentése előtt. empty,available,redeemed,already_used,expired,revoked
pass_id · textAz elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.
pass_label · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után. empty,access,event,coupon,membership
receipt_id · textAz elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.
error_code · textHibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.
is_busy · yes/noA munka még folyamatban van. Várjon, mielőtt újabb műveletet indítana.
is_scanning · yes/noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
torch_enabled · yes/noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
scan_source · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után. empty,camera,fixture
pending_redemption · yes/noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
scanned_pass_token · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
Események
scanner_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
scanner_pausedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
scanner_cancelledAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
permission_deniedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
pass_scannedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
validation_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
validation_completedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
redemption_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
pass_redeemedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
redemption_rejectedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
redemption_pendingAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
fixture_decodedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
qr_errorAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
Fejlesztők által feltett kérdések
Mit jelentenek a két jogosultsági beállítás?
A felhasználó igen/nem mező neve, amely jelöli azokat az alkalmazottakat, akik jogosultak passzokat létrehozni vagy visszavonni. Példa/alapértelmezett: qr_pass_issuer. Ide a mező nevét írja, nem az igen vagy nem értéket. Csak egy jogosult rendszergazda módosíthatja ezt a jogosultságot egy felhasználón. A felhasználó igen/nem mező neve, amely jelöli a személyzetet, akik jogosultak a használat ellenőrzésére és megerősítésére. Példa/alapértelmezett: qr_staff. A jegytulajdonosnak nincs szüksége erre a jogosultságra. Tartsa távol a nyilvános regisztrációs és profil űrlapoktól.
Ugyanaz az alkalmazott létrehozhatja és ellenőrizheti a belépőket?
Igen, ha egy jogosult adminisztrátor mindkét jogosultságot megadja az alkalmazottnak. Ehhez nem szükséges másik projektkulcs. Az ügyfelek általában egyik jogosultságra sem van szükségük. Ne engedje, hogy a felhasználók maguknak adjanak ilyen jogosultságokat.
Miért használja az Ellenőrzést a Szkennelés után?
A Szkennelés beolvassa a kódot. Az Ellenőrzés megkérdezi, hogy a belépő elérhető-e anélkül, hogy felhasználná. A személyzet először áttekintheti a rendelést. Csak a különálló Confirm QR redemption művelet használja fel a belépőt egyszer.
Hogyan működik az előfizetés?
Tervezett árazás: a plugin telepítése a Bubble-ben ingyenes. A BestPlugins hozzáférés külön előfizetés minden pluginra minden Bubble alkalmazásprojektben: 7 nap ingyenes, majd US$1.50 havonta. A Development és Live benne van. Nincs fix korlát a műveletek számában; a fájlméret- és funkciókorlátok továbbra is érvényesek. A fizetés még nem nyitott. Az aktiválási képernyő megjeleníti az első számlázási dátumot és a lemondási feltételeket.
Kapcsolódó útmutatók
Marketplace kiadás függőben
Fórum útmutató nincs közzétéve
Segítségért mondja el, melyik plugint és eszközt használja, milyen műveletet próbált és mi történt. Használjon személyes adatokat nem tartalmazó példát. Soha ne ossza meg a kulcsát vagy privát fájljait.