Xodera Plugins · Bubble Native

Xodera B2 Files Native

Behåll appbilagor i din egen Backblaze B2‑lagring. Låt behöriga användare ladda upp, bläddra och ladda ner filer, och välj uttryckligen när en fil får delas offentligt.

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.

Bygg arbetsflödet ↓Plugin‑inställningar ↗Native Lab

Dokumentation granskad 6 november 2026

Praktiska exempel

Lagra en jobbbilaga i utvecklarens egna privata bucket

Ett Bubble-jobb behöver en hållbar lagringsreferens utan att behandla en utgående nedladdnings‑URL som filens identitet.

`bucket_binding_id = an allowed binding to your own private bucket`; dynamiska `local_uri`, `display_name`, `mime_type` och `expected_size` beskriver den valda lokala filen.

Planerat: Check local source → Upload file → vänta på `upload_verified`. Ditt arbetsflöde lagrar sedan `asset_ref` och metadata på det ägda jobb‑posten.

Använd `asset_ref`, `size_bytes`, `mime_type` och `upload_status`. Senare kan Resolve private read tillhandahålla en tillfällig URL för auktoriserad användning.

Om databassparning misslyckas efter `upload_verified`, försök uppdatera databasen igen med samma tillgångsreferens istället för en ny uppladdning. Kontrollera resultatet av `upload_pending` med Check or recover upload status och samma uppladdnings‑ID.

Planerat. Ditt B2‑konto betalar lagrings‑ och nedladdningsavgifter.

Bygg ett eget bilagagalleri med hållbara filposter

Ett filgalleri behöver namn, typer och paginering samt ett sätt att öppna den valda tillgången senare.

Din apps filpost lagrar en accepterad `asset_ref`, visningsnamn, MIME och ägare/job‑relation efter en verifierad uppladdning; använd inte en lokal URI som dess molnidentitet.

Planerat: använd List my B2 files för att bygga bilagelistan. asset_refs identifierar filerna; värden på samma index ger deras namn och typer. Att välja en fil skickar dess asset_ref till Get asset metadata eller Download accepted version.

`has_more` och `next_cursor` tillhör den aktuella frågan. En slutförd nedladdning returnerar `local_output_uri`; det är en enhetslokal kopia, inte en permanent offentlig länk.

Återställ paginering efter bindnings-/konto-/frågeändringar. På `transfer_error`, bevara den befintliga File Thing och visa `error_code`; ersätt den inte tyst med en annan leverantörsversion.

Planerat. Ditt B2‑konto betalar lagrings‑ och nedladdningsavgifter.

Gör publicering och exakt versionsborttagning avsiktlig

Personal bör inte av misstag exponera en privat bilaga eller radera varje version när en bild ersätts.

`asset_ref = the selected accepted version`; bucket‑bindning och appens filbehörigheter måste tillåta den begärda åtgärden.

Visa den aktuella synligheten, be om uttrycklig bekräftelse, sedan Change public sharing. För borttagning, anropa Delete accepted version med bekräftelse; behåll appmetadata tills det bekräftade resultatet är känt.

Efter `share_changed`, använd `visibility` och `public_url` endast när offentlig delning uttryckligen har godkänts. Efter `delete_completed`, uppdatera den ägda filposten; `delete_pending` är inte en slutgiltig radering.

Kontrollera resultatet av en osäker operation istället för att anta framgång. Tidigare utfärdade leverantörsläs-URL:er kan förbli giltiga tills de löper ut; att ta bort en DB-rad eller inaktivera delning återkallar inte redan nedladdade bytes.

Planerat. Ditt B2‑konto betalar lagrings‑ och nedladdningsavgifter.

Vad som fungerar nu

Planerat plugin. Det är ännu inte installerat eller tillgängligt för användning. Guiden nedan visar det avsedda filarbetsflödet.

Bygg arbetsflödet

Planerad

Planerat arbetsflöde. Finns ännu inte i den aktuella betaversionen.

Dessa exempel använder app‑poster såsom Lesson, Message och Order. Ersätt dem med dina egna datatyper och elementnamn. Exempel på mediadresser måste ersättas med dina egna filer.

Planerat: i dina projektinställningar, välj din B2‑lagring och tillåten bucket. Ställ in dess sekretess, mapp‑prefix samt godkända filtyper och storlekar.
Använd List B2 bindings för att visa tillåtna lagringsalternativ. Använd List my B2 files för att visa den aktuella användarens filer och Get my B2 file info för detaljer.
Välj en fil. Ställ in bucket_binding_id, local_uri, display_name, mime_type och expected_size, kör sedan Upload file. Visa framsteg, men vänta på upload_verified innan filen betraktas som sparad.
Spara asset_ref i din apppost. Använd den för Get asset metadata, Resolve private read eller Download accepted version. Change public sharing och Delete accepted version kräver en separat bekräftelse.

Arbetsflödesdiagram — inte en appskärmbild

Konfigurera en gång

Nyckelaktivering är planerad för detta plugin. Skapa eller välj ditt Bubble‑appprojekt i BestPlugins → Dashboard → Plugins. Välj Xodera B2 Files Native, kopiera dess nyckel, öppna sedan Bubble → Plugins → Xodera B2 Files Native och klistra in den i project_api_key. Spara en gång; använd sedan åtgärderna nedan. Varje plugin i varje projekt har sin egen nyckel.

Använd ditt eget Backblaze B2‑konto och välj bucket för den här appen. Bestäm vem som får läsa och ladda upp filer. Spara namnen på de relevanta användar‑ja/nej‑fälten i b2_reader_permission_field och b2_writer_permission_field; standardvärdena är b2_files_reader och b2_files_writer. Endast en behörig administratör bör ändra dessa användarbehörigheter.

Konfigurera en gång

Skapa eller välj ditt Bubble‑appprojekt på BestPlugins → Dashboard → Plugins.
Välj detta plugin och kopiera dess projektnyckel.
Planerat: Öppna Bubble → Plugins → Xodera B2 Files Native; klistra in nyckeln i project_api_key och spara.
Lägg till elementet, välj dina appdata och bygg arbetsflödet nedan.
Privat beta‑åtkomst endast för tillfället. Offentlig installation och betald aktivering är ännu inte öppna.

Installation och prenumeration

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.

Spara resultatet i din app

Exempelbilaga: asset_ref, relaterad rapport/beställning, ägare, display_name, mime_type och size_bytes. Spara dessa efter upload_verified. Använd asset_ref för att öppna en fil igen senare; en tillfällig läsadress eller en sökväg på en enhet är inte en permanent filreferens. Om sparandet av databasposten misslyckas, försök spara den posten igen istället för att ladda upp filen på nytt.

Fel, avbryt och återställning

Om ett uppladdningsresultat är okänt, behåll upload_id och använd Check or recover upload status. Ladda inte upp en annan kopia automatiskt. Avbryt påverkar den ofullständiga överföringen, inte en redan sparad fil. Om åtkomsten löper ut, begär filen igen istället för att återanvända en gammal tillfällig adress.

Kapaciteter och begränsningar

Planerad maximal filstorlek: 256 MiB, eller en lägre bucket‑gräns du väljer. Backblaze‑lagring och nedladdningsavgifter tillhör ditt B2‑konto. Filer i en offentlig bucket är offentliga även när den relaterade appposten är privat. Ingen virus‑skanningsgaranti, multipart‑uppladdning, paus eller återställning efter att appen avslutats.

Inställningar, åtgärder och resultat

Använd dessa namn i Bubble. Planerade funktioner markeras separat.

Tillgängliga beta-inställningar

Elementinställningar

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

Tillstånd

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

Händelser

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Åtgärder och deras indata

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

Elementinställningar · 14

Planerat arbetsflöde. Finns ännu inte i den aktuella betaversionen.

bucket_binding_idtext · Standard: "": Exempelvärde<binding returned by List B2 bindings>; Exempel Bubble uttryckSelected Binding's binding_id; Lagringsval returnerat av List B2 bindings. Använd dess ID för den här filen.

local_uritext · Standard: "": Exempelvärdefile:///app-cache/attachment.jpg; Exempel Bubble uttryckOffline Files' local_uri; Läsbar filplats på den här enheten. Det är inte en nedladdningslänk online.

display_nametext · Standard: "": Exempelvärdereport-photo.jpg; Exempel Bubble uttryckSelected Attachment's display_name; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

mime_typetext · Standard: "": Exempelvärdeimage/jpeg; Exempel Bubble uttryckPhoto Editor's output_mime; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

expected_sizenumber · Standard: 0: Exempelvärde246975; Exempel Bubble uttryckOffline Files' size_bytes; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

metadata_jsontext · Standard: "": Exempelvärde{"label":"field-report"}; Exempel Bubble uttryckSelected Attachment's safe_metadata_json; Valfri JSON med appinformation såsom en rapportetikett. Håll den liten och undvik personuppgifter.

asset_reftext · Standard: "": Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

is_activeyes_no · Standard: true: Exempelvärdeyes; Exempel Bubble uttryckGuideHost's view_is_active (your yes/no custom state); Sätt ja medan denna vy är öppen. Sätt nej vid lämning, så uppspelning eller pågående arbete kan stoppas.

disabledyes_no · Standard: false: Exempelvärdeno; Exempel Bubble uttryckGuideHost's is_busy (your yes/no custom state); Inaktivera elementet medan din app är upptagen eller åtgärden är otillgänglig.

languagetext · Standard: "auto": Exempelvärdeuk; Exempel Bubble uttryckCurrent User's preferred_language; Ställ in language=auto för att följa en stödjande enhet eller webbläsarspråk. Ange en stödjande språkkod för att välja den explicit.

ui_text_jsontext · Standard: "": Exempelvärde{}; Exempel Bubble uttryckApp Settings' player_labels_json (supported keys only); Valfri JSON med stöd för knappetiketter. Lämna tomt för att använda den inbyggda texten.

titletext · Standard: "": ExempelvärdeLesson 4 — review; Exempel Bubble uttryckSelected Lesson's name; Synlig apptext; tomt använder inbyggd lokaliserad kopia där det stöds. Inga autentiseringsuppgifter.

show_previewyes_no · Standard: false: Exempelvärdeyes; Exempel Bubble uttryckApp Settings' b2_preview; Visa eller dölj filförhandsgranskningen.

show_provider_browseyes_no · Standard: false: Exempelvärdeno; Exempel Bubble uttryckCurrent User's authorized_browse_UI (presentation only); Visa eller dölj lagringsbläddringskontrollerna för behöriga användare.

Åtgärder och deras indata · 20

Planerat arbetsflöde. Finns ännu inte i den aktuella betaversionen.

List allowed buckets

Inga åtgärdsparametrar

Select bucket binding

binding_idtext · Standard: —: Exempelvärde<returned allowed binding ID>; Exempel Bubble uttryckSelected Binding's binding_id; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Check local source

Inga åtgärdsparametrar

Upload file

acknowledge_public_bytesyes_no · Standard: —: Exempelvärdeno; Exempel Bubble uttryckPublic bucket disclosure Checkbox is checked (private bucket: no); Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

confirm_retryyes_no · Standard: —: Exempelvärdeno; Exempel Bubble uttryckRetry Checkbox is checked after confirmed clean pending status; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Check or recover upload status

upload_idtext · Standard: —: Exempelvärde<original returned upload_id>; Exempel Bubble uttryckCurrent UploadIntent's upload_id; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Cancel owned transfer

Inga åtgärdsparametrar

Clear local session

Inga åtgärdsparametrar

List application files

Inga åtgärdsparametrar

Refresh application files

Inga åtgärdsparametrar

Load more application files

Inga åtgärdsparametrar

Select asset reference

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

Get asset metadata

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

Resolve private read

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

Download accepted version

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

Browse provider files

prefixtext · Standard: —: Exempelvärde""; Exempel Bubble uttryckAuthorized Browse Settings' prefix; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

load_moreyes_no · Standard: —: Exempelvärdeno; Exempel Bubble uttryckLoad More button only, for unchanged query; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Change public sharing

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

enabledyes_no · Standard: —: Exempelvärdeno; Exempel Bubble uttryckPublic Share Checkbox is checked after separate confirmation; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

confirmyes_no · Standard: —: Exempelvärdeyes — explicit confirmation only; Exempel Bubble uttryckConfirm Checkbox is checked; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Delete accepted version

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

confirmyes_no · Standard: —: Exempelvärdeyes — explicit confirmation only; Exempel Bubble uttryckConfirm Checkbox is checked; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

List B2 bindings

environmenttext · Standard: —: Exempelvärdedevelopment; Exempel Bubble uttryckApp Settings' selected_environment; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Returer

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

List my B2 files

environmenttext · Standard: —: Exempelvärdedevelopment; Exempel Bubble uttryckApp Settings' selected_environment; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

binding_idtext · Standard: —: Exempelvärde<returned allowed binding ID>; Exempel Bubble uttryckSelected Binding's binding_id; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

limitnumber · Standard: —: Exempelvärde50; Exempel Bubble uttryckGallery Settings' page_size; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

cursortext · Standard: —: Exempelvärde""; Exempel Bubble uttryckPrevious List my B2 files result's next_cursor; empty on first page; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

Returer

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: —: Exempelvärdedevelopment; Exempel Bubble uttryckApp Settings' selected_environment; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

binding_idtext · Standard: —: Exempelvärde<returned allowed binding ID>; Exempel Bubble uttryckSelected Binding's binding_id; Använd det aktuella affärspostens värde; validera det mot gränserna nedan.

asset_reftext · Standard: —: Exempelvärde<returned asset_ref>; Exempel Bubble uttryckSelected B2Asset's asset_ref; Stabil ogenomskinlig accepterad tillgångsidentitet från tjänsten. Att välja den kringgår aldrig användarautentisering.

Returer

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

Tillstånd och händelser

Planerat arbetsflöde. Finns ännu inte i den aktuella betaversionen.

Tillstånd

status · text

Aktuellt resultat av denna åtgärd. Använd motsvarande slutförande‑händelse innan du sparar framgång.

is_busy · yes_no

Arbetet pågår fortfarande. Vänta innan du påbörjar en annan åtgärd.

upload_id · text

Identifierare för detta objekt eller åtgärd. Behåll den med motsvarande app‑post. Använd samma begäranidentifierare vid återförsök av ett osäkert resultat.

upload_status · text

Aktuellt resultat av denna åtgärd. Använd motsvarande slutförande‑händelse innan du sparar framgång.

asset_ref · text

Identifierare för detta objekt eller åtgärd. Behåll den med motsvarande app‑post. Använd samma begäranidentifierare vid återförsök av ett osäkert resultat.

display_name · text