Xodera Plugins · Bubble Native

Xodera B2 Files Native

Speichern Sie Anhangdateien der App in Ihrem eigenen Backblaze B2‑Speicher. Erlauben Sie berechtigten Nutzern, Dateien hochzuladen, zu durchsuchen und herunterzuladen, und wählen Sie ausdrücklich, wann eine Datei öffentlich geteilt werden darf.

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.

Workflow erstellen ↓Plugin-Einstellungen ↗Native Lab

Dokumentation geprüft 6 November 2026

Praktische Beispiele

Speichern Sie einen Job-Anhang im privaten Bucket des Entwicklers

Ein Bubble-Job benötigt eine dauerhafte Speicherreferenz, ohne eine ablaufende Download-URL als Dateidentität zu behandeln.

`bucket_binding_id = an allowed binding to your own private bucket`; dynamische `local_uri`, `display_name`, `mime_type` und `expected_size` beschreiben die ausgewählte lokale Datei.

Geplant: Check local source → Upload file → warten auf `upload_verified`. Ihr Workflow speichert dann `asset_ref` und Metadaten im eigenen Job-Datensatz.

Verwenden Sie `asset_ref`, `size_bytes`, `mime_type` und `upload_status`. Später kann Resolve private read eine temporäre URL für eine autorisierte Nutzung bereitstellen.

Falls das Datenbankspeichern nach `upload_verified` fehlschlägt, wiederholen Sie das DB-Update mit derselben Asset-Referenz statt eines anderen Uploads. Prüfen Sie das Ergebnis von `upload_pending` mit Check or recover upload status und derselben Upload-ID.

Geplant. Ihr B2-Konto übernimmt Speicher- und Downloadkosten.

Erstellen Sie eine eigene Anhangsgalerie mit dauerhaften Dateidatensätzen

Eine Dateigalerie benötigt Namen, Typen und Seitennavigation sowie eine Möglichkeit, das ausgewählte Asset später zu öffnen.

Der Dateidatensatz Ihrer App speichert ein akzeptiertes `asset_ref`, den Anzeigenamen, MIME und die Eigentümer‑/Job‑Beziehung nach einem verifizierten Upload; verwenden Sie keine lokale URI als Cloud‑Identität.

Geplant: Verwenden Sie List my B2 files, um die Anhangsliste zu erstellen. asset_refs identifiziert die Dateien; Werte am gleichen Index liefern deren Namen und Typen. Das Auswählen einer Datei übergibt ihr asset_ref an Get asset metadata oder Download accepted version.

`has_more` und `next_cursor` gehören zur aktuellen Abfrage. Ein abgeschlossener Download liefert `local_output_uri` zurück; es ist eine geräteinterne Kopie, kein permanenter öffentlicher Link.

Setzen Sie die Seitennavigation nach Änderungen von Bindung/Konto/Abfrage zurück. Bei `transfer_error` bewahren Sie das bestehende File Thing und zeigen `error_code`; ersetzen Sie es nicht stillschweigend durch eine andere Anbieter-Version.

Geplant. Ihr B2-Konto übernimmt Speicher- und Downloadkosten.

Machen Sie Veröffentlichung und Löschung einer genauen Version bewusst

Mitarbeiter sollten nicht versehentlich einen privaten Anhang freigeben oder jede Version löschen, wenn ein Bild ersetzt wird.

`asset_ref = the selected accepted version`; Bucket-Bindung und die Dateiberechtigungen der App müssen die angeforderte Operation zulassen.

Zeigen Sie die aktuelle Sichtbarkeit, fragen Sie nach einer ausdrücklichen Bestätigung, dann Change public sharing. Für die Entfernung rufen Sie Delete accepted version mit Bestätigung auf; behalten Sie die App‑Metadaten, bis das bestätigte Ergebnis bekannt ist.

Nach `share_changed` verwenden Sie `visibility` und `public_url` nur, wenn das öffentliche Teilen ausdrücklich autorisiert wurde. Nach `delete_completed` aktualisieren Sie den eigenen Dateidatensatz; `delete_pending` ist keine endgültige Löschung.

Überprüfen Sie das Ergebnis einer unsicheren Operation, anstatt Erfolg anzunehmen. Zuvor ausgegebene Provider‑Lese‑URLs können bis zum Ablauf gültig bleiben; das Entfernen einer DB‑Zeile oder das Deaktivieren von Freigaben ruft bereits heruntergeladene Bytes nicht zurück.

Geplant. Ihr B2-Konto übernimmt Speicher- und Downloadkosten.

Was jetzt funktioniert

Geplantes Plugin. Es ist noch nicht installiert oder zur Nutzung verfügbar. Die nachstehende Anleitung zeigt den vorgesehenen Dateiablauf.

Workflow erstellen

Geplant

Geplanter Workflow. In der aktuellen Beta noch nicht verfügbar.

Diese Beispiele verwenden App‑Datensätze wie Lesson, Message und Order. Ersetzen Sie sie durch Ihre eigenen Datentypen und Elementnamen. Beispiel‑Medienadressen müssen durch Ihre eigenen Dateien ersetzt werden.

Geplant: Wählen Sie in den Projekteinstellungen Ihren B2‑Speicher und das erlaubte Bucket. Legen Sie dessen Datenschutz, Ordnerpräfix sowie zulässige Dateitypen und -größen fest.
Verwenden Sie List B2 bindings, um zulässige Speicheroptionen anzuzeigen. Verwenden Sie List my B2 files, um die Dateien des aktuellen Benutzers anzuzeigen, und Get my B2 file info für Details.
Datei auswählen. bucket_binding_id, local_uri, display_name, mime_type und expected_size festlegen, dann Upload file ausführen. Fortschritt anzeigen, aber auf upload_verified warten, bevor die Datei als gespeichert gilt.
Speichern Sie asset_ref in Ihrem App‑Datensatz. Verwenden Sie es für Get asset metadata, Resolve private read oder Download accepted version. Change public sharing und Delete accepted version erfordern eine separate Bestätigung.

Workflow‑Diagramm — kein App‑Screenshot

Einmal konfigurieren

Die Schlüsselaktivierung ist für dieses Plugin geplant. Erstellen oder wählen Sie Ihr Bubble‑App‑Projekt in BestPlugins → Dashboard → Plugins. Wählen Sie Xodera B2 Files Native, kopieren Sie dessen Schlüssel und öffnen Sie anschließend Bubble → Plugins → Xodera B2 Files Native, um ihn in project_api_key einzufügen. Einmal speichern; anschließend die untenstehenden Aktionen nutzen. Jedes Plugin in jedem Projekt hat einen eigenen Schlüssel.

Verwenden Sie Ihr eigenes Backblaze B2‑Konto und wählen Sie den Bucket für diese App. Entscheiden Sie, wer Dateien lesen und hochladen darf. Speichern Sie die Namen der relevanten Benutzer‑Ja/Nein‑Felder in b2_reader_permission_field und b2_writer_permission_field; Vorgaben sind b2_files_reader und b2_files_writer. Nur ein autorisierter Administrator sollte diese Benutzerberechtigungen ändern.

Einmal konfigurieren

Erstellen oder wählen Sie Ihr Bubble‑App‑Projekt bei BestPlugins → Dashboard → Plugins.
Wählen Sie dieses Plugin aus und kopieren Sie dessen Projektschlüssel.
Geplant: Öffnen Sie Bubble → Plugins → Xodera B2 Files Native; fügen Sie den Schlüssel in project_api_key ein und speichern Sie.
Fügen Sie das Element hinzu, wählen Sie Ihre App‑Daten und erstellen Sie den untenstehenden Workflow.
Privater Beta‑Zugang nur vorerst. Öffentliche Installation und kostenpflichtige Aktivierung sind noch nicht verfügbar.

Installation und Abonnement

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.

Speichern Sie das Ergebnis in Ihrer App

Beispielanhang: asset_ref, zugehöriger Bericht/Bestellung, Eigentümer, display_name, mime_type und size_bytes. Nach upload_verified speichern. Verwenden Sie asset_ref, um eine Datei später erneut zu öffnen; eine temporäre Leseadresse oder ein Pfad auf einem Gerät ist kein permanenter Dateiverweis. Wenn das Speichern des Datenbankeintrags fehlschlägt, versuchen Sie den Eintrag erneut zu speichern, anstatt die Datei erneut hochzuladen.

Fehler, Abbruch und Wiederherstellung

Wenn das Upload‑Ergebnis unbekannt ist, behalten Sie upload_id und verwenden Sie Check or recover upload status. Laden Sie nicht automatisch eine weitere Kopie hoch. Abbrechen betrifft die unvollständige Übertragung, nicht eine bereits gespeicherte Datei. Wenn der Zugriff abläuft, fordern Sie die Datei erneut an, anstatt eine alte temporäre Adresse wiederzuverwenden.

Funktionen und Grenzen

Geplante maximale Dateigröße: 256 MiB oder ein von Ihnen gewähltes niedrigeres Bucket‑Limit. Backblaze‑Speicher‑ und Download‑Kosten gehen zu Ihrem B2‑Konto. Dateien in einem öffentlichen Bucket sind öffentlich, selbst wenn der zugehörige App‑Datensatz privat ist. Keine Virus‑Scan‑Garantie, kein Mehrfach‑Upload, keine Pause oder Wiederherstellung nach Beendigung der App.

Einstellungen, Aktionen und Ergebnisse

Verwenden Sie diese Namen in Bubble. Geplante Funktionen sind separat gekennzeichnet.

Verfügbare Beta‑Einstellungen

Elementeinstellungen

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

Zustände

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

Ereignisse

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Aktionen und deren Eingaben

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

Elementeinstellungen · 14

Geplanter Workflow. In der aktuellen Beta noch nicht verfügbar.

bucket_binding_idtext · Standard: "": Beispielwert<binding returned by List B2 bindings>; Beispiel Bubble AusdruckSelected Binding's binding_id; Speicherwahl, die von List B2 bindings zurückgegeben wurde. Verwenden Sie deren ID für diese Datei.

local_uritext · Standard: "": Beispielwertfile:///app-cache/attachment.jpg; Beispiel Bubble AusdruckOffline Files' local_uri; Lesbarer Dateipfad auf diesem Gerät. Es handelt sich nicht um einen Online‑Download‑Link.

display_nametext · Standard: "": Beispielwertreport-photo.jpg; Beispiel Bubble AusdruckSelected Attachment's display_name; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

mime_typetext · Standard: "": Beispielwertimage/jpeg; Beispiel Bubble AusdruckPhoto Editor's output_mime; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

expected_sizenumber · Standard: 0: Beispielwert246975; Beispiel Bubble AusdruckOffline Files' size_bytes; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

metadata_jsontext · Standard: "": Beispielwert{"label":"field-report"}; Beispiel Bubble AusdruckSelected Attachment's safe_metadata_json; Optionales JSON mit App‑Informationen wie einem Berichtsetikett. Halten Sie es klein und vermeiden Sie personenbezogene Daten.

asset_reftext · Standard: "": Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

is_activeyes_no · Standard: true: Beispielwertyes; Beispiel Bubble AusdruckGuideHost's view_is_active (your yes/no custom state); Setzen Sie ja, solange diese Ansicht geöffnet ist. Setzen Sie nein beim Verlassen, damit die Wiedergabe oder die aktuelle Arbeit gestoppt werden kann.

disabledyes_no · Standard: false: Beispielwertno; Beispiel Bubble AusdruckGuideHost's is_busy (your yes/no custom state); Deaktivieren Sie das Element, solange Ihre App beschäftigt ist oder diese Aktion nicht verfügbar ist.

languagetext · Standard: "auto": Beispielwertuk; Beispiel Bubble AusdruckCurrent User's preferred_language; Setzen Sie language=auto, um einer unterstützten Geräte‑ oder Browsersprache zu folgen. Geben Sie einen unterstützten Sprachcode ein, um ihn ausdrücklich auszuwählen.

ui_text_jsontext · Standard: "": Beispielwert{}; Beispiel Bubble AusdruckApp Settings' player_labels_json (supported keys only); Optionales JSON mit unterstützten Schaltflächenbeschriftungen. Leer lassen, um den integrierten Text zu verwenden.

titletext · Standard: "": BeispielwertLesson 4 — review; Beispiel Bubble AusdruckSelected Lesson's name; Sichtbarer App-Text; leer verwendet die integrierte lokalisierte Kopie, wo unterstützt. Keine Anmeldedaten.

show_previewyes_no · Standard: false: Beispielwertyes; Beispiel Bubble AusdruckApp Settings' b2_preview; Dateivorschau anzeigen oder ausblenden.

show_provider_browseyes_no · Standard: false: Beispielwertno; Beispiel Bubble AusdruckCurrent User's authorized_browse_UI (presentation only); Steuerelemente zur Speichernavigation für berechtigte Benutzer anzeigen oder ausblenden.

Aktionen und deren Eingaben · 20

Geplanter Workflow. In der aktuellen Beta noch nicht verfügbar.

List allowed buckets

Keine Aktionsparameter

Select bucket binding

binding_idtext · Standard: —: Beispielwert<returned allowed binding ID>; Beispiel Bubble AusdruckSelected Binding's binding_id; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Check local source

Keine Aktionsparameter

Upload file

acknowledge_public_bytesyes_no · Standard: —: Beispielwertno; Beispiel Bubble AusdruckPublic bucket disclosure Checkbox is checked (private bucket: no); Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

confirm_retryyes_no · Standard: —: Beispielwertno; Beispiel Bubble AusdruckRetry Checkbox is checked after confirmed clean pending status; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Check or recover upload status

upload_idtext · Standard: —: Beispielwert<original returned upload_id>; Beispiel Bubble AusdruckCurrent UploadIntent's upload_id; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Cancel owned transfer

Keine Aktionsparameter

Clear local session

Keine Aktionsparameter

List application files

Keine Aktionsparameter

Refresh application files

Keine Aktionsparameter

Load more application files

Keine Aktionsparameter

Select asset reference

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

Get asset metadata

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

Resolve private read

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

Download accepted version

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

Browse provider files

prefixtext · Standard: —: Beispielwert""; Beispiel Bubble AusdruckAuthorized Browse Settings' prefix; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

load_moreyes_no · Standard: —: Beispielwertno; Beispiel Bubble AusdruckLoad More button only, for unchanged query; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Change public sharing

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

enabledyes_no · Standard: —: Beispielwertno; Beispiel Bubble AusdruckPublic Share Checkbox is checked after separate confirmation; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

confirmyes_no · Standard: —: Beispielwertyes — explicit confirmation only; Beispiel Bubble AusdruckConfirm Checkbox is checked; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Delete accepted version

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

confirmyes_no · Standard: —: Beispielwertyes — explicit confirmation only; Beispiel Bubble AusdruckConfirm Checkbox is checked; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

List B2 bindings

environmenttext · Standard: —: Beispielwertdevelopment; Beispiel Bubble AusdruckApp Settings' selected_environment; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Rückgaben

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

List my B2 files

environmenttext · Standard: —: Beispielwertdevelopment; Beispiel Bubble AusdruckApp Settings' selected_environment; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

binding_idtext · Standard: —: Beispielwert<returned allowed binding ID>; Beispiel Bubble AusdruckSelected Binding's binding_id; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

limitnumber · Standard: —: Beispielwert50; Beispiel Bubble AusdruckGallery Settings' page_size; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

cursortext · Standard: —: Beispielwert""; Beispiel Bubble AusdruckPrevious List my B2 files result's next_cursor; empty on first page; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

Rückgaben

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: —: Beispielwertdevelopment; Beispiel Bubble AusdruckApp Settings' selected_environment; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

binding_idtext · Standard: —: Beispielwert<returned allowed binding ID>; Beispiel Bubble AusdruckSelected Binding's binding_id; Verwenden Sie den Wert des aktuellen Geschäftsdatensatzes; prüfen Sie ihn anhand der untenstehenden Grenzen.

asset_reftext · Standard: —: Beispielwert<returned asset_ref>; Beispiel Bubble AusdruckSelected B2Asset's asset_ref; Stabile und undurchsichtige akzeptierte Asset‑Identität vom Dienst. Die Auswahl umgeht niemals die Benutzerautorisierung.

Rückgaben

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

Zustände und Ereignisse

Geplanter Workflow. In der aktuellen Beta noch nicht verfügbar.

Zustände

status · text

Aktuelles Ergebnis dieser Aktion. Verwenden Sie das passende Abschlussereignis, bevor Sie den Erfolg speichern.

is_busy · yes_no

Die Arbeit ist noch im Gange. Bitte warten Sie, bevor Sie eine weitere Aktion starten.

upload_id · text

Kennzeichen für dieses Element oder diese Aktion. Bewahren Sie es zusammen mit dem zugehörigen App‑Datensatz auf. Verwenden Sie dieselbe Anforderungs‑Kennung, wenn Sie ein unsicheres Ergebnis erneut versuchen.

upload_status · text

Aktuelles Ergebnis dieser Aktion. Verwenden Sie das passende Abschlussereignis, bevor Sie den Erfolg speichern.

asset_ref · text

display_name · text