Xodera Plugins · Bubble Native

Xodera B2 Files Native

Păstrează atașamentele aplicației în propriul tău spațiu de stocare Backblaze B2. Permite utilizatorilor autorizați să încarce, să navigheze și să descarce fișiere și să aleagă explicit când un fișier poate fi partajat public.

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.

Construiește fluxul de lucru ↓Setări plugin ↗Native Lab

Documentație revizuită 6 noiembrie 2026

Exemple practice

Stochează un atașament de job în bucket-ul privat al dezvoltatorului

Un job Bubble are nevoie de o referință de stocare durabilă fără a trata un URL de descărcare care expiră ca identitatea fișierului.

`bucket_binding_id = an allowed binding to your own private bucket`; `local_uri` dinamic, `display_name`, `mime_type` și `expected_size` descriu fișierul local selectat.

Planificat: Check local source → Upload file → așteaptă `upload_verified`. Fluxul tău de lucru apoi stochează `asset_ref` și metadatele în înregistrarea Job deținută.

Folosește `asset_ref`, `size_bytes`, `mime_type` și `upload_status`. Mai târziu, Resolve private read poate furniza un URL temporar pentru o utilizare autorizată.

Dacă salvarea în baza de date eșuează după `upload_verified`, reîncearcă actualizarea DB cu aceeași referință de asset în loc de o altă încărcare. Verifică rezultatul `upload_pending` utilizând Check or recover upload status și același ID de încărcare.

Planificat. Contul tău B2 plătește taxele de stocare și descărcare.

Construiește o galerie de atașamente deținută cu înregistrări de fișiere durabile

O galerie de fișiere necesită nume, tipuri și paginare, precum și o modalitate de a deschide assetul selectat mai târziu.

Înregistrarea File a aplicației tale stochează un `asset_ref` acceptat, numele afișat, MIME și relația proprietar/job după o încărcare verificată; nu folosi un URI local ca identitate în cloud.

Planificat: folosește List my B2 files pentru a construi lista de atașamente. asset_refs identifică fișierele; valorile de la același index furnizează numele și tipurile lor. Selectarea unui fișier transmite asset_ref către Get asset metadata sau Download accepted version.

`has_more` și `next_cursor` aparțin interogării curente. O descărcare finalizată returnează `local_output_uri`; este o copie locală pe dispozitiv, nu un link public permanent.

Resetează paginarea după modificări de legare/cont/interogare. La `transfer_error`, păstrează elementul File existent și afișează `error_code`; nu îl înlocui în tăcere cu o altă versiune a furnizorului.

Planificat. Contul tău B2 plătește taxele de stocare și descărcare.

Fă publicarea și ștergerea versiunii exacte deliberată

Personalul nu ar trebui să expună accidental un atașament privat sau să șteargă toate versiunile când înlocuiește o imagine.

`asset_ref = the selected accepted version`; legarea bucket-ului și permisiunile de fișiere ale aplicației trebuie să permită operațiunea solicitată.

Afișează vizibilitatea curentă, solicită confirmare explicită, apoi Change public sharing. Pentru eliminare, apelează Delete accepted version cu confirmare; păstrează metadatele aplicației până când rezultatul confirmat este cunoscut.

După `share_changed`, consumă `visibility` și `public_url` numai când partajarea publică a fost autorizată explicit. După `delete_completed`, actualizează înregistrarea File deținută; `delete_pending` nu reprezintă ștergere finală.

Verifică rezultatul unei operații incertă în loc să presupui succesul. URL-urile de citire ale furnizorului emise anterior pot rămâne valide până la expirare; eliminarea unui rând din DB sau dezactivarea partajării nu recuperează datele deja descărcate.

Planificat. Contul tău B2 plătește taxele de stocare și descărcare.

Ce funcționează acum

Plugin planificat. Nu este încă instalat sau disponibil pentru utilizare. Ghidul de mai jos prezintă fluxul de lucru al fișierelor preconizat.

Construiește fluxul de lucru

Planificat

Flux de lucru planificat. Nu este încă disponibil în beta curentă.

Aceste exemple folosesc înregistrări de aplicație precum Lesson, Message și Order. Înlocuiți-le cu propriile tipuri de date și nume de elemente. Adresele media de exemplu trebuie înlocuite cu fișierele dumneavoastră.

Planificat: în setările proiectului, alege stocarea B2 și bucket-ul permis. Setează-i confidențialitatea, prefixul de folder și tipurile și dimensiunile de fișiere acceptate.
Folosește List B2 bindings pentru a afișa opțiunile de stocare permise. Folosește List my B2 files pentru a afișa fișierele utilizatorului curent și Get my B2 file info pentru detalii.
Alege un fișier. Setează bucket_binding_id, local_uri, display_name, mime_type și expected_size, apoi rulează Upload file. Afișează progresul, dar așteaptă upload_verified înainte de a considera fișierul salvat.
Salvează asset_ref în înregistrarea aplicației tale. Folosește-l pentru Get asset metadata, Resolve private read sau Download accepted version. Change public sharing și Delete accepted version necesită o confirmare separată.

Diagramă de flux de lucru — nu o captură de ecran a aplicației

Configurează o singură dată

Activarea cheii este planificată pentru acest plugin. Creează sau alege proiectul tău de aplicație Bubble în BestPlugins → Dashboard → Plugins. Alege Xodera B2 Files Native, copiază cheia acestuia, apoi deschide Bubble → Plugins → Xodera B2 Files Native și lipește-o în project_api_key. Salvează o singură dată; apoi folosește acțiunile de mai jos. Fiecare plugin din fiecare proiect are propria cheie.

Folosește propriul cont Backblaze B2 și alege bucket-ul pentru această aplicație. Decide cine poate citi și încărca fișiere. Stochează numele câmpurilor utilizator relevante da/nu în b2_reader_permission_field și b2_writer_permission_field; valorile implicite sunt b2_files_reader și b2_files_writer. Doar un administrator autorizat ar trebui să modifice acele permisiuni ale utilizatorilor.

Configurează o singură dată

Creați sau alegeți proiectul de aplicație Bubble la BestPlugins → Dashboard → Plugins.
Selectați acest plugin și copiați cheia proiectului.
Planificat: Deschide Bubble → Plugins → Xodera B2 Files Native; lipește cheia în project_api_key și salvează.
Adăugați elementul, alegeți datele aplicației și construiți fluxul de lucru de mai jos.
Acces beta privat doar pentru moment. Instalarea publică și activarea plătită nu sunt încă deschise.

Instalare și abonament

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.

Salvează rezultatul în aplicația ta

Exemplu de atașament: asset_ref, raport/comandă aferentă, proprietar, display_name, mime_type și size_bytes. Salvează-le după upload_verified. Folosește asset_ref pentru a redeschide un fișier mai târziu; o adresă temporară de citire sau o cale pe un dispozitiv nu reprezintă o referință permanentă a fișierului. Dacă salvarea înregistrării din baza de date eșuează, încearcă din nou să salvezi acea înregistrare în loc să încarci din nou fișierul.

Eșec, anulare și recuperare

Dacă rezultatul încărcării este necunoscut, păstrează upload_id și folosește Check or recover upload status. Nu încărca automat o altă copie. Anularea afectează transferul neterminat, nu un fișier deja salvat. Dacă accesul expiră, solicită din nou fișierul în loc să reutilizezi o adresă temporară veche.

Capacități și limite

Mărime maximă planificată a fișierului: 256 MiB, sau o limită inferioară a bucket-ului pe care o alegi. Taxele de stocare și descărcare Backblaze aparțin contului tău B2. Fișierele dintr-un bucket public sunt publice chiar și când înregistrarea aplicației aferente este privată. Nu există promisiune de scanare antivirus, încărcare multipart, pauză sau recuperare după terminarea aplicației.

Setări, acțiuni și rezultate

Utilizați aceste nume în Bubble. Funcționalitățile planificate sunt marcate separat.

Setări beta disponibile

Setări 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

Stări

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

Evenimente

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Acțiuni și intrările lor

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

Setări element · 14

Flux de lucru planificat. Nu este încă disponibil în beta curentă.

bucket_binding_idtext · Implicit: "": Valoare exemplu<binding returned by List B2 bindings>; Exemplu Bubble expresieSelected Binding's binding_id; Opțiunea de stocare returnată de List B2 bindings. Folosește ID-ul său pentru acest fișier.

local_uritext · Implicit: "": Valoare exemplufile:///app-cache/attachment.jpg; Exemplu Bubble expresieOffline Files' local_uri; Locație de fișier citibilă pe acest dispozitiv. Nu este un link de descărcare online.

display_nametext · Implicit: "": Valoare exemplureport-photo.jpg; Exemplu Bubble expresieSelected Attachment's display_name; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

mime_typetext · Implicit: "": Valoare exempluimage/jpeg; Exemplu Bubble expresiePhoto Editor's output_mime; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

expected_sizenumber · Implicit: 0: Valoare exemplu246975; Exemplu Bubble expresieOffline Files' size_bytes; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

metadata_jsontext · Implicit: "": Valoare exemplu{"label":"field-report"}; Exemplu Bubble expresieSelected Attachment's safe_metadata_json; JSON opțional cu informații despre aplicație, cum ar fi o etichetă de raport. Păstrează-l mic și evită datele personale.

asset_reftext · Implicit: "": Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

is_activeyes_no · Implicit: true: Valoare exempluyes; Exemplu Bubble expresieGuideHost's view_is_active (your yes/no custom state); Setați da în timp ce această vizualizare este deschisă. Setați nu la părăsire, pentru ca redarea sau lucrarea curentă să se oprească.

disabledyes_no · Implicit: false: Valoare exempluno; Exemplu Bubble expresieGuideHost's is_busy (your yes/no custom state); Dezactivați elementul în timp ce aplicația este ocupată sau această acțiune nu este disponibilă.

languagetext · Implicit: "auto": Valoare exempluuk; Exemplu Bubble expresieCurrent User's preferred_language; Setați language=auto să urmeze limba unui dispozitiv sau a unui browser acceptat. Introduceți un cod de limbă acceptat pentru a o selecta explicit.

ui_text_jsontext · Implicit: "": Valoare exemplu{}; Exemplu Bubble expresieApp Settings' player_labels_json (supported keys only); JSON opțional cu etichete de buton acceptate. Lăsați gol pentru a utiliza textul încorporat.

titletext · Implicit: "": Valoare exempluLesson 4 — review; Exemplu Bubble expresieSelected Lesson's name; Text vizibil al aplicației; lăsat gol se folosește copia localizată încorporată acolo unde este suportată. Fără acreditări.

show_previewyes_no · Implicit: false: Valoare exempluyes; Exemplu Bubble expresieApp Settings' b2_preview; Afișează sau ascunde previzualizarea fișierului.

show_provider_browseyes_no · Implicit: false: Valoare exempluno; Exemplu Bubble expresieCurrent User's authorized_browse_UI (presentation only); Afișează sau ascunde controalele de navigare în stocare pentru utilizatorii autorizați.

Acțiuni și intrările lor · 20

Flux de lucru planificat. Nu este încă disponibil în beta curentă.

List allowed buckets

Niciun parametru de acțiune

Select bucket binding

binding_idtext · Implicit: —: Valoare exemplu<returned allowed binding ID>; Exemplu Bubble expresieSelected Binding's binding_id; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Check local source

Niciun parametru de acțiune

Upload file

acknowledge_public_bytesyes_no · Implicit: —: Valoare exempluno; Exemplu Bubble expresiePublic bucket disclosure Checkbox is checked (private bucket: no); Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

confirm_retryyes_no · Implicit: —: Valoare exempluno; Exemplu Bubble expresieRetry Checkbox is checked after confirmed clean pending status; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Check or recover upload status

upload_idtext · Implicit: —: Valoare exemplu<original returned upload_id>; Exemplu Bubble expresieCurrent UploadIntent's upload_id; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Cancel owned transfer

Niciun parametru de acțiune

Clear local session

Niciun parametru de acțiune

List application files

Niciun parametru de acțiune

Refresh application files

Niciun parametru de acțiune

Load more application files

Niciun parametru de acțiune

Select asset reference

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

Get asset metadata

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

Resolve private read

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

Download accepted version

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

Browse provider files

prefixtext · Implicit: —: Valoare exemplu""; Exemplu Bubble expresieAuthorized Browse Settings' prefix; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

load_moreyes_no · Implicit: —: Valoare exempluno; Exemplu Bubble expresieLoad More button only, for unchanged query; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Change public sharing

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

enabledyes_no · Implicit: —: Valoare exempluno; Exemplu Bubble expresiePublic Share Checkbox is checked after separate confirmation; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

confirmyes_no · Implicit: —: Valoare exempluyes — explicit confirmation only; Exemplu Bubble expresieConfirm Checkbox is checked; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Delete accepted version

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

confirmyes_no · Implicit: —: Valoare exempluyes — explicit confirmation only; Exemplu Bubble expresieConfirm Checkbox is checked; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

List B2 bindings

environmenttext · Implicit: —: Valoare exempludevelopment; Exemplu Bubble expresieApp Settings' selected_environment; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Returnări

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

List my B2 files

environmenttext · Implicit: —: Valoare exempludevelopment; Exemplu Bubble expresieApp Settings' selected_environment; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

binding_idtext · Implicit: —: Valoare exemplu<returned allowed binding ID>; Exemplu Bubble expresieSelected Binding's binding_id; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

limitnumber · Implicit: —: Valoare exemplu50; Exemplu Bubble expresieGallery Settings' page_size; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

cursortext · Implicit: —: Valoare exemplu""; Exemplu Bubble expresiePrevious List my B2 files result's next_cursor; empty on first page; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

Returnări

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 · Implicit: —: Valoare exempludevelopment; Exemplu Bubble expresieApp Settings' selected_environment; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

binding_idtext · Implicit: —: Valoare exemplu<returned allowed binding ID>; Exemplu Bubble expresieSelected Binding's binding_id; Folosește valoarea înregistrării de afaceri curente; valideaz-o în raport cu limitele de mai jos.

asset_reftext · Implicit: —: Valoare exemplu<returned asset_ref>; Exemplu Bubble expresieSelected B2Asset's asset_ref; Identitate stabilă, opacă, a activului acceptat de la serviciu. Selectarea ei nu ocolește niciodată autorizarea utilizatorului.

Returnări

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

Stări și evenimente

Flux de lucru planificat. Nu este încă disponibil în beta curentă.

Stări

status · text

Rezultatul curent al acestei acțiuni. Utilizați evenimentul de finalizare corespunzător înainte de a salva cu succes.

is_busy · yes_no

Lucrul este încă în desfășurare. Așteptați înainte de a începe o altă acțiune.

upload_id · text

Identificator pentru acest element sau acțiune. Păstrați-l împreună cu înregistrarea corespunzătoare a aplicației. Utilizați același identificator de cerere când reîncercați un rezultat incert.

upload_status · text

Rezultatul curent al acestei acțiuni. Utilizați evenimentul de finalizare corespunzător înainte de a salva cu succes.

asset_ref · text

display_name · text