⚡XoderaPlugins
Interfaċċa tal-iskanner QR. L-azzjonijiet għal passes ta’ użu wieħed huma ppjanati.
Interfaċċa tal-iskanner QR. L-azzjonijiet għal passes ta’ użu wieħed huma ppjanati.
← Il-gwidi nattivi kollha

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Ibni biljetti għal użu wieħed, konfermi tal-ġbir ta’ oġġetti jew kupuni. Il-persunal jiskannja l-kodiċi, jiċċekkja r-riżultat, jirrevedi l-ordni u jikkonferma l-użu biss meta jkun lest.

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.

Ibni l-fluss tax-xogħol ↓Konfigurazzjonijiet tal-Plugin ↗Native Lab

Dokumentazzjoni riveduta 6 Novembru 2026

Eżempji prattiċi

Aċċess wieħed għal avveniment ta’ l-istess ġurnata

Screenshot ta’ valur QR ordinarju jista’ inkella jerġa’ jintuża f’aktar minn daħla waħda.

L-app tiegħek taħżen rekord Admission u `request_id` stabbli għat-talba tal-ħruġ; uża l-valur stabbilit `label=event` u valur ta’ `ttl_seconds` bejn 1–86400 sekonda.

Min hu awtorizzat joħroġ il-pass iħaddem Issue QR pass u jgħaddi l-QR mogħti b’mod privat. Il-persunal jiskannja → Check QR pass → jikkonferma biss jekk `ok=yes` u `status=available` → Confirm QR redemption b’ID stabbli tat-talba li jkun diġà maħżun.

`status=redeemed` flimkien ma’ `receipt_id` biss jawtorizza l-app tiegħek toħroġ irċevuta tad-dħul. Aħżen ir-referenza tal-pass u tal-irċevuta fir-rekord Admission; tibgħatx il-kontenut tal-QR lil sistemi tal-analitika.

Għal `outcome_unknown`, irkupra r-riżultat tal-istess talba bl-istess utent, ambjent u pass; qatt toħloq ID ġdid ta’ konferma. Ittratta expired, revoked u l-istati diġà użati bħala riżultati distinti.

Ippjanat. L-iskannjar u l-kontroll ma jimmarkawx il-pass bħala użat; konferma espliċita biss tagħmel dan.

Uża benefiċċju ta’ validità qasira darba waħda mal-bank tas-servizz tas-sieħeb

Partnar għandu bżonn riżultat użat/ mhux użat ikkonfermat minflok jiddependi fuq immaġni QR jew animazzjoni tal-iskrin.

`label=coupon`; ir-rekord Benefit tal-app jiddefinixxi min għandu dritt għall-benefiċċju u perjodu qasir ta’ validità qabel azzjoni awtorizzata tal-ħruġ.

Oħroġ pass biss wara li l-app tiegħek tkun ivverifikat id-dritt għall-benefiċċju. Mal-bank tas-servizz, Check QR pass juri jekk il-pass huwiex disponibbli mingħajr ma jimmarkah bħala użat. Wara li l-impjegat jikkonferma li ngħata l-benefiċċju, ħaddem Confirm QR redemption.

Ir-rekord Benefit tiegħek jista’ jaħżen `receipt_id` u l-ħin ikkonfermat tal-użu tal-pass wara `status=redeemed`. Il-plugin jimmaniġġja l-istat tal-pass; l-app tiegħek timmaniġġja l-benefiċċju u r-relazzjoni mal-klijent.

Jekk il-benefiċċju jiġi kkanċellat qabel l-użu, l-istess persuna awtorizzata li ħarġet il-pass tista’ tħaddem Revoke QR pass bil-`pass_id` ta’ dak il-pass. Tħabbarx rifużjoni ta’ flus jew użu tal-pass b’suċċess fuq il-bażi ta’ `ok=yes` waħdu.

Ippjanat. L-iskannjar u l-kontroll ma jimmarkawx il-pass bħala użat; konferma espliċita biss tagħmel dan.

Ikkonferma l-ġbir ta’ tagħmir jew ordni fl-istess jum

Fluss tax-xogħol tal-persunal irid jiddistingwi l-iskannjar ta’ referenza għall-ġbir minn meta oġġett fil-fatt jingħata lil min jiġi jiġbru.

Ir-rekord Collection li jappartjeni lill-app tiegħek iżomm l-awtorizzazzjoni tal-ġbir, l-oġġett maħsub u IDs stabbli separati għat-talbiet tal-ħruġ u tal-konferma tal-użu; uża pass ta’ validità qasira b’`label=access`.

Wara li l-app tiegħek tawtorizza l-ġbir, ħaddem Issue QR pass. Il-persunal jiskannja u juża Check, jirrevedi r-rekord Collection korrispondenti fl-app tiegħek, imbagħad jikkonferma espliċitament l-għoti tal-oġġett u jħaddem Confirm QR redemption.

Il-fluss tax-xogħol tiegħek għandu jimmarka r-rekord Collection bħala mgħoddi biss wara irċevuta kkonfermata `redeemed`. Żomm `receipt_id` bħala r-referenza għar-riżultat tal-pass.

Skann ripetut jista’ jagħti already_used; uri r-rekord eżistenti tal-app minflok tagħti oġġett ieħor. Irkupra r-riżultat ta’ konferma mhux ċerta bl-istess ID u inputs.

Ippjanat. L-iskannjar u l-kontroll ma jimmarkawx il-pass bħala użat; konferma espliċita biss tagħmel dan.

X'jaħdem issa

Beta privata. L‑scanner attwali għandu kontrolli tal‑kamera u permessi. Il‑ħolqien, il‑verifika u l‑konferma ta’ passijiet għal użu wieħed huma ppjanati u għadhom mhux lesti għall‑użu fl‑app tiegħek.

Ibni l-fluss tax-xogħol

Pjanifikat

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Dawn l-eżempji jużaw reġistri tal-app bħal Lesson, Message u Order. Ibdelhom bi tipi ta' data u ismijiet ta' elementi tiegħek. Indirizzi tal-midja tal-eżempju għandhom jiġu mibdula b'fajls tiegħek.

  1. Ippjanat: impjegat awtorizzat juża Issue QR pass għal rekord Admission jew Order. Eżempju: label=event, ttl_seconds=900, environment=development. Żomm request_id stabbli għal dik it-talba tal-ħruġ u ssejvja pass_id mar-rekord.

  2. Uri l-QR rritornat lill-detentur mixtieq tiegħu. Il-personal jiskana l-istess. Fil-workflow tal-pass ppjanat, uża workflow_mode=yes u aqra scanned_pass_token wara pass_scanned. Dawn is-settings tal-workflow tal-pass mhumiex disponibbli fl-iskanner kurrenti.

  3. Ħaddem Check QR pass b’pass_token = QR Scanner's scanned_pass_token. Jivverifika mingħajr ma juża l-pass. Għal status=available, uri d-dettalji tal-ordni jew tal-entrata li jaqblu sabiex il-personal jista’ jirrevedihom.

  4. Buttuna Confirm separata biss tħaddem Confirm QR redemption bl-istess pass_token, request_id stabbli u confirm=yes. Meta status=redeemed, issejvja receipt_id u mmarka dik l-ordni jew entrata bħala kompluta.

  5. already_used, expired, revoked jew invalid ifissru li m’għandekx tippermetti d-dħul jew tgħaddi l-ordni. Skann jew Check b’suċċess waħdu qatt ma jlesti t-tranżazzjoni.

Dijagramma tal-fluss tax-xogħol — mhux screenshot tal-app

Ikkonfigura darba waħda

Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f’BestPlugins → Dashboard → Plugins. Agħżel Xodera QR Passes Native, ikkopja l-key tiegħu, imbagħad iftaħ Bubble → Plugins → Xodera QR Passes Native u poġġiha f’project_api_key. Issejvja darba; imbagħad uża l-azzjonijiet hawn taħt. Kull plugin f’kull proġett għandu l-key tiegħu.

L-iskannjar jeħtieġ permess għall-kamera. Għal passes ta’ użu wieħed, iddeċiedi min jista’ joħloqhom u min jista’ jiċċekkjahom fid-daħla jew fil-punt tal-ġbir. Il-klijenti ordinarji ma jeħtieġu l-ebda wieħed miż-żewġ rwoli tal-persunal.

qr_issuer_permission_field

qr_pass_issuer · Isem il-qasam User tat-tip yes/no li jidentifika l-impjegati li jistgħu joħolqu jew jirrevokaw passes. Eżempju/valur predefinit: qr_pass_issuer. Daħħal hawn isem il-qasam, mhux yes jew no. Amministratur awtorizzat biss għandu jibdel dan il-permess fuq utent.

qr_staff_permission_field

qr_staff · Isem il-qasam User tat-tip yes/no li jidentifika l-persunal li jista’ jiċċekkja u jikkonferma l-użu. Eżempju/valur predefinit: qr_staff. Min għandu l-biljett ma jeħtieġx dan il-permess. Tesponihx f’formoli pubbliċi tar-reġistrazzjoni jew tal-profil.

Ikkonfigura darba waħda
  1. Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f'BestPlugins → Dashboard → Plugins.
  2. Agħżel din il-plugin u ikkopja l-key tal-proġett tagħha.
  3. Iftaħ Bubble → Plugins → Xodera QR Passes Native; poġġi l-key f’project_api_key u ssejvja.
  4. Żid l-element, agħżel id-data tal-app tiegħek u ibni l-fluss tax-xogħol hawn taħt.
  5. Għalissa hemm biss aċċess għall-beta privata. L-installazzjoni pubblika u l-attivazzjoni bi ħlas għadhom mhumiex miftuħa.
Installazzjoni u abbonament

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.

Issejvja r-riżultat fl-app tiegħek

Eżempju Admission jew Pickup: issejvja l-ordni jew l-avveniment relatat, pass_id, expires_at u issue_request_id. Wara użu kkonfermat, żid receipt_id, redeemed_at u l-impjegat li kkonferma. Timmarkax ir-rekord bħala komplut meta l-kodiċi jkun ġie biss skannjat jew iċċekkjat. Kodiċi QR ma jivverifikax l-identità ta’ persuna.

Falliment, ikkanċellament u rkupru

Jekk outcome_unknown=yes, żomm l-istess pass, request_id u inputs meta terġa’ tiċċekkja r-riżultat. Toħloqx konferma ġdida. already_used, expired u revoked huma riżultati finali tan-negozju. Jekk il-permess jiġi miċħud, itlob amministratur awtorizzat jirrevedi r-rwol tal-impjegat. Clear session jerġa’ jissettja l-iskanner; ma jistax ireġġa’ lura użu li diġà tlesta.

Kapabbiltajiet u limiti

Il-passes ippjanati jintużaw darba waħda u jdumu 1–86400 sekondi; il-valur predefinit huwa 900. Tipi ta’ pass: access, event, coupon u membership. Il-kontroll ma jirriżervax pass. L-użu tal-pass jeħtieġ aċċess għall-internet. Ebda proċessar ta’ ħlasijiet, verifika tal-identità jew karta ta’ sħubija fit-tul li tista’ terġa’ tintuża. Il-qari ta’ valur QR ordinarju huwa separat mill-kontroll ta’ pass.

Konfigurazzjonijiet, azzjonijiet u riżultati

Uża dawn l-ismijiet f'Bubble. Il-karatteristiċi pjanati huma mmarkati separatament.

Settings beta disponibbli

Konfigurazzjonijiet tal-element

disabled · yes/nois_active · yes/noui_text_json · textlanguage · text

Stati

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/no

Avvenimenti

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Azzjonijiet u l-inputs tagħhom

Clear session
Konfigurazzjonijiet tal-element · 5

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

disabledyes/no · Valur predefinit: false
Valur eżempjuno
Eżempju ta’ espressjoni BubbleGuideHost's is_busy (your yes/no custom state)
Itfi l‑element waqt li l‑applikazzjoni tiegħek tkun impenjata jew din l‑azzjoni mhux disponibbli.
is_activeyes/no · Valur predefinit: true
Valur eżempjuyes
Eżempju ta’ espressjoni BubbleGuideHost's view_is_active (your yes/no custom state)
Issettja yes waqt li din il-veduta tkun miftuħa. Issettja no meta toħroġ minnha, sabiex id-daqq jew ix-xogħol attwali jkun jista’ jieqaf.
ui_text_jsontext · Valur predefinit: "{}"
Valur eżempju{}
Eżempju ta’ espressjoni BubbleApp Settings' player_labels_json (supported keys only)
JSON opzjonal bil‑tikketti tal‑buttuni appoġġjati. Ħalli vojta biex tuża t-test integrat.
languagetext · Valur predefinit: "auto"
Valur eżempjuuk
Eżempju ta’ espressjoni BubbleCurrent User's preferred_language
Issettja language=auto biex tuża l-lingwa tal-apparat jew tal-browser jekk dik il-lingwa tkun appoġġjata. Daħħal kodiċi ta’ lingwa appoġġjata biex tagħżilha espliċitament.
workflow_modeyes/no · Valur predefinit: false
Valur eżempjuyes
Eżempju ta’ espressjoni BubbleApp Settings' use_qr_business_actions
Ippjanat: ħalli l-valur QR skannjat jintuża minn Check QR pass. L-iskannjar waħdu ma jikkonfermax dħul jew ġbir ta’ oġġett.
Azzjonijiet u l-inputs tagħhom · 5

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Clear session

Ebda parametri ta' azzjoni

Issue QR pass
environmenttext · Valur predefinit: "development"
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
request_idtext · Valur predefinit: —
Valur eżempjupickup-123-issue-v1
Eżempju ta’ espressjoni BubbleCurrent Admission's stable_request_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
labeltext · Valur predefinit: "access"
Valur eżempjuevent
Eżempju ta’ espressjoni BubbleSelected Admission's pass_label
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
ttl_secondsnumber · Valur predefinit: 900
Valur eżempju900
Eżempju ta’ espressjoni BubbleEvent Settings' pass_ttl_seconds
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/no
Check QR pass
environmenttext · Valur predefinit: "development"
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
pass_tokentext · Valur predefinit: —
Valur eżempju<opaque token returned by Issue / camera scan>
Eżempju ta’ espressjoni BubbleQR Pass Scanner's scanned_pass_token (capture before Check)
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

pass_label · textexpires_at · text
Confirm QR redemption
environmenttext · Valur predefinit: "development"
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
pass_tokentext · Valur predefinit: —
Valur eżempju<opaque token returned by Issue / camera scan>
Eżempju ta’ espressjoni BubbleQR Pass Scanner's scanned_pass_token (capture before Check)
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
request_idtext · Valur predefinit: —
Valur eżempjupickup-123-redeem-v1
Eżempju ta’ espressjoni BubbleCurrent Admission's stable_redemption_request_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
confirmyes/no · Valur predefinit: false
Valur eżempjuyes — explicit confirmation only
Eżempju ta’ espressjoni BubbleConfirm Checkbox is checked
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/no
Revoke QR pass
environmenttext · Valur predefinit: "development"
Valur eżempjudevelopment
Eżempju ta’ espressjoni BubbleApp Settings' selected_environment
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
pass_idtext · Valur predefinit: —
Valur eżempju<pass_id returned by Issue>
Eżempju ta’ espressjoni BubbleSelected Admission's pass_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Valuri mogħtija

pass_id · textrevoked · yes/no
Stati u avvenimenti

Fluss tax-xogħol ippjanat. Għadu mhux disponibbli fil-beta attwali.

Stati

scanner_status · text

Riżultat kurrenti ta' din l-azzjoni. Uża l-avveniment ta' kompletament li jaqbel qabel tissejvja s-suċċess. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Riżultat kurrenti ta' din l-azzjoni. Uża l-avveniment ta' kompletament li jaqbel qabel tissejvja s-suċċess. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikatur għal dan l‑oġġett jew azzjoni. Żommuh mal‑rekord tal‑app li jaqbel. Uża l-istess identifikatur tal‑talba meta terġa' tipprova riżultat mhux ċert.

pass_label · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat. empty,access,event,coupon,membership

receipt_id · text

Identifikatur għal dan l‑oġġett jew azzjoni. Żommuh mal‑rekord tal‑app li jaqbel. Uża l-istess identifikatur tal‑talba meta terġa' tipprova riżultat mhux ċert.

error_code · text

Informazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.

is_busy · yes/no

Il-ħidma għadha għaddejja. Stenna qabel tibda azzjoni oħra.

is_scanning · yes/no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

torch_enabled · yes/no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

scan_source · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat. empty,camera,fixture

pending_redemption · yes/no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

scanned_pass_token · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

Avvenimenti

scanner_started

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

scanner_paused

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

scanner_cancelled

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

permission_denied

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

pass_scanned

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

validation_started

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

validation_completed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

redemption_started

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

pass_redeemed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

redemption_rejected

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

redemption_pending

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

fixture_decoded

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

qr_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

Mistoqsijiet li jistaqsu l-iżviluppaturi

X’jifhmu ż-żewġ settings tal-permessi?

Isem il-qasam User tat-tip yes/no li jidentifika l-impjegati li jistgħu joħolqu jew jirrevokaw passes. Eżempju/valur predefinit: qr_pass_issuer. Daħħal hawn isem il-qasam, mhux yes jew no. Amministratur awtorizzat biss għandu jibdel dak il-permess fuq utent. Isem il-qasam User tat-tip yes/no li jidentifika l-persunal li jista’ jiċċekkja u jikkonferma l-użu. Eżempju/valur predefinit: qr_staff. Min għandu l-biljett ma jeħtieġx dan il-permess. Tesponihx f’formoli pubbliċi tar-reġistrazzjoni jew tal-profil.

Il-istess impjegat jista’ joħloq u jivverifika passijiet?

Iva, jekk amministratur awtorizzat jagħti lil dak l-impjegat iż-żewġ permessi. Dan ma jeħtieġx key oħra tal-proġett. Il-klijenti normalment ma jeħtieġu l-ebda wieħed minn dawn iż-żewġ permessi. Tħallix lill-utenti jagħtu dawn il-permessi lilhom infushom.

Għalfejn tuża Check wara Scan?

Scan jaqra l-kodiċi. Check jistaqsi jekk il-pass huwa disponibbli mingħajr ma jintuża. Il-personal jista’ jirrevedi l-ordni l-ewwel. Biss l-azzjoni separata Confirm QR redemption tuża l-pass darba waħda.

Kif taħdem is-sottoskrizzjoni?

Prezzijiet ippjanati: l-installazzjoni tal-plugin f’Bubble hija b’xejn. L-aċċess għal BestPlugins huwa abbonament separat għal kull plugin f’kull proġett ta’ app Bubble: 7 ijiem b’xejn, imbagħad US$1.50 fix-xahar. Development u Live huma inklużi. M’hemm l-ebda limitu fiss fuq in-numru ta’ operazzjonijiet; il-limiti tad-daqs tal-fajls u tal-karatteristiċi xorta japplikaw. Il-paġna tal-ħlas għadha mhix miftuħa. L-iskrin tal-attivazzjoni juri d-data tal-ewwel kont u t-termini tal-kanċellazzjoni.

Gwidi relatati

audio-playervideo-playerphoto-editoraudio-recorderoffline-filesdocuments-aib2-files

Marketplace ħarġa pendenti

Gwida tal-forum mhux ippubblikata

Għal għajnuna, għidilna liema plugin u apparat qed tuża, l-azzjoni li ppruvajt u x'ġara. Uża eżempju mingħajr data personali. Qatt ma taqsam il-key tiegħek jew fajls privati.