Xodera Plugins · Bubble Native

Xodera B2 Files Native

Conserva ils annexes da l'app en tia propria archivaziun Backblaze B2. Permetta a l'utents autorisads da cargar, navigar e telecargar datotecas, e da tscherner expressamaint cura ina datoteca po vegnir partgada publicamain.

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.

Crear il flus da lavur ↓Configuraziun dal plugin ↗Native Lab

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Memorisescha in annex da lavur en il container privat dal sviluppader

In Bubble Job dovra ina referenza d'arcun durabla, senza tractar in URL da telechargiar che scada sco identitad da la datoteca.

`bucket_binding_id = an allowed binding to your own private bucket`; `local_uri`, `display_name`, `mime_type` e `expected_size` dinamic descrivan il file local selecziunà.

Planisà: Check local source → Upload file → spetga `upload_verified`. Tes flus da lavur memorisescha lura `asset_ref` e las metadatas en l'endataziun Job che tutga a tia app.

Utilisescha `asset_ref`, `size_bytes`, `mime_type` e `upload_status`. Pli tard, Resolve private read po furnir ina URL temporara per in usadi autorisà.

Sche il memorisar en la banca da datas faila suenter `upload_verified`, repeta l'actualisaziun DB cun la medema referenza d'asset enstagl dad in auter upload. Controlla il resultat da `upload_pending` cun Check or recover upload status e il medem ID d'upload.

Planà. Il cont da B2 paga las taxas da memor e download.

Creescha ina galeria d'annexas che tutga a tia app cun endataziuns da datotecas durablas

Ina galeria da datotecas dovra nums, tips e paginaziun, sco era ina pussaivladad d'avrir pli tard la datoteca tschernida.

Suenter in chargiar verifitgà, memorisescha l'endataziun File da tia app in `asset_ref` acceptà, il num mussà, MIME e la relaziun cun il possessur/Job; na dovra betg in URI local sco sia identitad en il cloud.

Planisà: dovra List my B2 files per crear la glista d'annexas. asset_refs identifitgescha las datotecas; las valurs al medem index dattan lur nums e tips. Tscherner ina datoteca transmetta ses asset_ref a Get asset metadata u Download accepted version.

`has_more` e `next_cursor` apartenen a la dumonda actuala. In download cumpletà returna `local_output_uri`; è ina copia local al dispositiv, betg in colliaziun publica permanenta.

Reinizialisescha la paginaziun suenter midadas da colliaziun, conto u dumonda. Sin `transfer_error`, conserva il File Thing existent e mussa `error_code`; na remplazza betg el senza avis cun in'autra versiun dal furnitur.

Planà. Il cont da B2 paga las taxas da memor e download.

Renda la publicaziun e la stizzada da la versiun exacta deliberadas

Il persunal na duai betg revelar per sbagl in'annexa privata u stizzar tut las versiuns cun remplazzar in maletg.

`asset_ref = the selected accepted version`; il binding dal bucket e las permissiuns da datoteca da l'app ston permetter l'operaziun dumandada.

Mussa la visibilitad actuala, dumonda ina conferma explicita, suenter Change public sharing. Per la remossiun, cloma Delete accepted version cun conferma; conserva las metadata da l'app enfin che l'esitu confermà è enconuschent.

Suenter `share_changed`, dovra `visibility` e `public_url` mo sche la cundivisiun publica è vegnida autorisada explicitamain. Suenter `delete_completed`, actualisescha l'endataziun File che tutga a tia app; `delete_pending` n'è betg ina stizzada definitiva.

Controlla il resultat d'ina operaziun incerta enstagl da supponer success. URLs da lectura dal furnitur emess precedentamain pon restar valids enfin la scadenza; la stizzada d'ina lingia DB u la deactivaziun da la partiziun na recuperegia betg ils bytes gia telecargads.

Planà. Il cont da B2 paga las taxas da memor e download.

Tge che funcziuna ussa

Plugin planà. Na è anc installà ni disponibel per l'utilisaziun. La guida sutvart mussa il flus da lavur da datotecas previst.

Crear il flus da lavur

Previst

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

Planisà: tscherna tes arcun B2 ed il bucket permess en las configuraziuns dal project. Definiescha sia protecziun da datas, il prefix da l'ordinatur ed ils tips e las grondezzas da datotecas acceptads.
Utilisescha List B2 bindings per mussar las opziuns da memoraziun permessas. Utilisescha List my B2 files per mussar las datotecas dal current utilisader e Get my B2 file info per detagls.
Tscherna ina datoteca. Definischa bucket_binding_id, local_uri, display_name, mime_type e expected_size, suenter exequa Upload file. Mussar il progress, ma spetga upload_verified avant da considerar la datoteca sco memorisada.
Memorisescha asset_ref en il registr da tia app. Utilisescha el per Get asset metadata, Resolve private read u Download accepted version. Change public sharing e Delete accepted version pretendan ina conferma separada.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

L’activaziun da clav è planificada per quest plugin. Crees u tscherna tes project Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera B2 Files Native, copia sia clav, suenter avra Bubble → Plugins → Xodera B2 Files Native e incolla ella en project_api_key. Memorisescha ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia clav propia.

Dovra tes agen conto Backblaze B2 e tscherna il bucket per questa app. Decida tgi po leger e chargiar datotecas. Memorisescha ils nums dals champs User da tip yes/no correspundents en b2_reader_permission_field e b2_writer_permission_field; ils standards èn b2_files_reader e b2_files_writer. Mo in administratur autorisà duai midar questas permissiuns d'utilisader.

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
Tscherna quest plugin e copia sia clav dal project.
Planà: Avra Bubble → Plugins → Xodera B2 Files Native; incolla la clav en project_api_key e memorisescha.
Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
Accès beta privat per ussa mo. Installaziun publica e activaziun cun pajament n'èn anc betg avertas.

Installaziun e abonnament

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.

Memorisar il resultat en tia app

Exempel da allegà: asset_ref, rapport/ordin relatà, proprietari, display_name, mime_type e size_bytes. Memorisescha quels suenter upload_verified. Utilisescha asset_ref per avrir anc ina giada ina datoteca pli tard; ina adressa temporara da lectura u in percurs sin in apparat n'è betg ina referenza permanenta da datoteca. Sche il memorisar dal registr da la banca da datas falla, proba anc ina giada da memorisar quel registr empè da cargar la datoteca anc ina giada.

Falliment, annullar e restaurar

Sche il resultat da l'upload è nunenconuschent, mantgna upload_id e utilisescha Check or recover upload status. Na chargiar betg automaticamain ina copia supplementara. Annullar influenzescha il transfer betg terminà, betg ina datoteca gia memorisada. Sche l'access scada, dumonda la datoteca anc ina giada empè da reutilisar ina veglia adressa temporara.

Capacitads e lims

Dimension maximala da datoteca prevista: 256 MiB, u in limit pli bass dal bucket che ti tschernas. Las custas da memorisar e da telecargar da Backblaze apartenen al tes conto B2. Las datotecas en in bucket public èn publicas er sch'il registr da l'app relatà è privat. Nia promesa da scannar per virus, chargiar en pliras parts, pausa ni recupereir suenter la terminaziun da l'app.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

bucket_binding_id · textlocal_uri · textdisplay_name · textmime_type · textexpected_size · numbermetadata_json · textasset_ref · textis_active · yes_nodisabled · yes_nolanguage · textui_text_json · texttitle · textshow_preview · yes_noshow_provider_browse · yes_no

Stadis

status · textis_busy · yes_noupload_id · textupload_status · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numberbytes_sent · numberprogress · numberprogress_indeterminate · yes_notemporary_read_url · textread_expires_at · textlocal_output_uri · textpublic_url · textvisibility · textnext_cursor · texthas_more · yes_noquery_revision · textfiles_json · textbuckets_json · textremote_files_json · textremote_next_cursor · textremote_has_more · yes_noremote_query_revision · textbucket_binding_id · textcleanup_pending · yes_noerror_code · texterror_message · text

Eveniments

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Acziuns e lur inputs

List allowed bucketsSelect bucket bindingCheck local sourceUpload fileCheck or recover upload statusCancel owned transferClear local sessionList application filesRefresh application filesLoad more application filesSelect asset referenceGet asset metadataResolve private readDownload accepted versionBrowse provider filesChange public sharingDelete accepted version

Configuraziun da l'element · 14

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

bucket_binding_idtext · Standard: "": Valur d'exempel<binding returned by List B2 bindings>; Exempel Bubble expressiunSelected Binding's binding_id; Scelta da memor restituida da List B2 bindings. Dovra il sia ID per questa datoteca.

local_uritext · Standard: "": Valur d'exempelfile:///app-cache/attachment.jpg; Exempel Bubble expressiunOffline Files' local_uri; Posiziun da datoteca legibla sin quest dispositiv. Na è betg in colliaziun da download online.

display_nametext · Standard: "": Valur d'exempelreport-photo.jpg; Exempel Bubble expressiunSelected Attachment's display_name; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

mime_typetext · Standard: "": Valur d'exempelimage/jpeg; Exempel Bubble expressiunPhoto Editor's output_mime; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

expected_sizenumber · Standard: 0: Valur d'exempel246975; Exempel Bubble expressiunOffline Files' size_bytes; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

metadata_jsontext · Standard: "": Valur d'exempel{"label":"field-report"}; Exempel Bubble expressiunSelected Attachment's safe_metadata_json; Opziunala JSON cun infurmaziuns da l’app sco p.ex. ina etiqueta dal rapport. Maintgna ella pitschna ed evita datas persunalas.

asset_reftext · Standard: "": Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

is_activeyes_no · Standard: true: Valur d'exempelyes; Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state); Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.

disabledyes_no · Standard: false: Valur d'exempelno; Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state); Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.

languagetext · Standard: "auto": Valur d'exempeluk; Exempel Bubble expressiunCurrent User's preferred_language; Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.

ui_text_jsontext · Standard: "": Valur d'exempel{}; Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only); JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.

titletext · Standard: "": Valur d'exempelLesson 4 — review; Exempel Bubble expressiunSelected Lesson's name; Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.

show_previewyes_no · Standard: false: Valur d'exempelyes; Exempel Bubble expressiunApp Settings' b2_preview; Mussar u zuppentar l’anteprima dal file.

show_provider_browseyes_no · Standard: false: Valur d'exempelno; Exempel Bubble expressiunCurrent User's authorized_browse_UI (presentation only); Mussa u zuppa ils elements per navigar en l'arcun per utilisaders autorisads.

Acziuns e lur inputs · 20

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

List allowed buckets

Nagins parameters d'acziun

Select bucket binding

binding_idtext · Standard: —: Valur d'exempel<returned allowed binding ID>; Exempel Bubble expressiunSelected Binding's binding_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Check local source

Nagins parameters d'acziun

Upload file

acknowledge_public_bytesyes_no · Standard: —: Valur d'exempelno; Exempel Bubble expressiunPublic bucket disclosure Checkbox is checked (private bucket: no); Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

confirm_retryyes_no · Standard: —: Valur d'exempelno; Exempel Bubble expressiunRetry Checkbox is checked after confirmed clean pending status; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Check or recover upload status

upload_idtext · Standard: —: Valur d'exempel<original returned upload_id>; Exempel Bubble expressiunCurrent UploadIntent's upload_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Cancel owned transfer

Nagins parameters d'acziun

Clear local session

Nagins parameters d'acziun

List application files

Nagins parameters d'acziun

Refresh application files

Nagins parameters d'acziun

Load more application files

Nagins parameters d'acziun

Select asset reference

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

Get asset metadata

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

Resolve private read

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

Download accepted version

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

Browse provider files

prefixtext · Standard: —: Valur d'exempel""; Exempel Bubble expressiunAuthorized Browse Settings' prefix; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

load_moreyes_no · Standard: —: Valur d'exempelno; Exempel Bubble expressiunLoad More button only, for unchanged query; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Change public sharing

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

enabledyes_no · Standard: —: Valur d'exempelno; Exempel Bubble expressiunPublic Share Checkbox is checked after separate confirmation; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

confirmyes_no · Standard: —: Valur d'exempelyes — explicit confirmation only; Exempel Bubble expressiunConfirm Checkbox is checked; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Delete accepted version

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

confirmyes_no · Standard: —: Valur d'exempelyes — explicit confirmation only; Exempel Bubble expressiunConfirm Checkbox is checked; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

List B2 bindings

environmenttext · Standard: —: Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

ok · yes/nostatus · texterror_code · textbinding_ids · text listlabels · text listprivacy · text listmax_size_bytes · number list

List my B2 files

environmenttext · Standard: —: Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

binding_idtext · Standard: —: Valur d'exempel<returned allowed binding ID>; Exempel Bubble expressiunSelected Binding's binding_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

limitnumber · Standard: —: Valur d'exempel50; Exempel Bubble expressiunGallery Settings' page_size; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

cursortext · Standard: —: Valur d'exempel""; Exempel Bubble expressiunPrevious List my B2 files result's next_cursor; empty on first page; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

Valurs returnadas

ok · yes/nostatus · texterror_code · textasset_refs · text listdisplay_names · text listmime_types · text listsize_bytes · number listcreated_ats · text listvisibility · text listpublic_urls · text listprovider_status · text listinspection_status · text listmetadata_labels · text listhas_more · yes/nonext_cursor · textquery_revision · text

Get my B2 file info

environmenttext · Standard: —: Valur d'exempeldevelopment; Exempel Bubble expressiunApp Settings' selected_environment; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

binding_idtext · Standard: —: Valur d'exempel<returned allowed binding ID>; Exempel Bubble expressiunSelected Binding's binding_id; Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.

asset_reftext · Standard: —: Valur d'exempel<returned asset_ref>; Exempel Bubble expressiunSelected B2Asset's asset_ref; Identitad stabla opaca da l’actif acceptà dal servetsch. Seleziunar ella na bypassa mai l’autorisaziun da l’utilisader.

Valurs returnadas

ok · yes/nostatus · texterror_code · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numbercreated_at · textvisibility · textpublic_url · textprovider_status · textinspection_status · textmetadata_label · text

Stadis e eveniments

Flus da lavur planisà. Anc betg disponibel en la beta actuala.

Stadis

status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

is_busy · yes_no

Il lavur è anc en cors. Spetga avant da cumenzar ina nova acziun.

upload_id · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

upload_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

asset_ref · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

display_name · text