Xodera Plugins · Bubble Native
Xodera Offline Files Native
Behold rapportvedlegg og valgte filer på enheten, gjenopprett dem senere og la brukeren dele en valgt kopi.
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.
Dokumentasjon gjennomgått 6 november 2026
Praktiske eksempler
Forbered flere lokale vedlegg før du sender inn en rapport
Et skjema må vise hvilke filer som ble valgt og la brukeren beholde en administrert kopi før noen sky‑innsending.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; angi `max_files`, `max_file_bytes` og en konto/rapport `document_context`.
Pick files → inspiser de valgte navnene/størrelsene → Save selection locally. Skjemaet ditt beholder de resulterende fil‑ID‑ene til den separate Send‑arbeidsflyten laster opp godkjente filer.
Bruk `selection_count`, `file_names`, `file_sizes` og `saved_file_ids` for å gjengi gjennomgangslisten. En lagret administrert kopi bevarer originalfilen til den som kaller handlingen.
En avbrutt velger er ikke en innsendt rapport. På `files_error`, behold allerede aksepterte lokale ID-er og vis `error_code`; opprett aldri et skyvedlegg kun fra en lokal URI.
Filer forblir på denne enheten til de deles eller lastes opp separat.
Behold et foto‑redigerings‑ eller opptaksutdata for senere bruk
En generert lokal fil kan ligge i en midlertidig plassering; appen trenger en eksplisitt administrert kopi.
`source_uri = the local output of a separately accepted editor/recorder`; bind dens faktiske `display_name` og `mime_type`; bruk samme eiers `document_context`.
Load local source → inspiser metadata → Save selection locally. Lagre den returnerte fil‑ID‑en kun i den tilsvarende enheten/konteksten, og deretter Restore saved file med den eksakte ID‑en ved behov.
Bruk `file_id`, `local_uri`, `size_bytes` og `is_saved_locally`; bruk `file_restored` for å skille en fullført gjenoppretting fra kun en forespørsel om en.
Avvis en ekstern HTTP‑URL som en lokal kilde. Hvis en kilde forsvinner eller gjenoppretting mislykkes, vis `error_code` og bevar den opprinnelige app‑posten for gjenoppretting.
Filer forblir på denne enheten til de deles eller lastes opp separat.
La en bruker dele en app‑generert lokal kvittering eller eksport
Appen bør overlevere en valgt lokal fil til enhetens delingsarkblad i stedet for å lage en offentlig URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; navnet og MIME beskriver den ekte lokale filen.
List saved files → Restore saved file → Share selected file etter at brukeren trykker Del. Behold den lagrede kopien til de eksplisitt velger Delete saved copy.
Bruk `share_status` og `share_sheet_closed` for å oppdatere UI-et etter at arket lukkes. Behold fil‑ID-en for en annen bevisst deling.
Et lukket delingsark er ikke bevis på at en e‑post/melding ble levert. Håndter avbrytelse og `files_error` uten å rapportere suksess til mottakeren.
Filer forblir på denne enheten til de deles eller lastes opp separat.
Hva fungerer nå
Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.
Bygg arbeidsflyten
Bruk de tilgjengelige beta‑handlingene nedenfor og test resultatet på dine mål‑enheter.
Disse eksemplene bruker app‑poster som Lesson, Message og Order. Erstatt dem med dine egne datatyper og elementnavn. Eksempel‑medieadresser må erstattes med dine egne filer.
Angi document_context = Current User's unique id, eller en stabil verdi for kontoen og rapporten. Velg accepted_mime_types_json, max_files og max_file_bytes.
Kjør Pick files, eller bruk Load local source for en lesbar fil laget av Foto‑editor eller Opptaker. Etter selection_changed, les de tilsvarende fillistene; Select picked file velger et indeks.
Kjør Save selection locally. Etter files_saved, behold saved_file_ids i appens lokale vedleggsregister. List saved files viser lagrede kopier; Restore saved file åpner den valgte lagrede ID‑en.
Share selected file åpner systemets delingsmeny. share_sheet_closed betyr kun at menyen ble lukket. Delete saved copy trenger den valgte ID‑en og confirm=yes.
Konfigurer én gang
Opprett eller velg ditt Bubble‑app‑prosjekt i BestPlugins → Dashboard → Plugins. Velg Xodera Offline Files Native, kopier nøkkelen, åpne deretter Bubble → Plugins → Xodera Offline Files Native og lim den inn i licensing_api_key. Lagre én gang; bruk deretter handlingene nedenfor. Hver plugin i hvert prosjekt har sin egen nøkkel.
Bruk en native‑app med tilgang til de valgte filene. Angi en stabil document_context for kontoen eller rapporten slik at lagrede filer holdes gruppert riktig.
Konfigurer én gang
- Opprett eller velg ditt Bubble‑app‑prosjekt på BestPlugins → Dashboard → Plugins.
- Velg denne plugin‑en og kopier prosjekt‑nøkkelen.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Legg til elementet, velg app‑dataene dine og bygg arbeidsflyten nedenfor.
- In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Installasjon og 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.
Lagre resultatet i appen din
Eksempel LocalAttachment: eier, document_context, lagret fil‑ID, display_name, mime_type og size_bytes. Denne ID‑en fungerer kun på samme enhet og for samme konto eller rapport. For et nettvedlegg, last opp filen med en separat arbeidsflyt og lagre den returnerte nettfilreferansen.
Feil, avbryt og gjenoppretting
En avbrutt velger returnerer operation_cancelled; den sender ikke inn skjemaet. Mens native_pending=yes, vent på at filvelgeren eller delingsmenyen lukkes før du åpner en ny. Clear session tømmer gjeldende valg men beholder lagrede kopier. Hvis en fil mangler, la brukeren velge den igjen.
Funksjoner og begrensninger
Velg 1–20 filer på én gang. Per‑filgrense: 1 byte–256 MiB, med lavere grense hvis du ønsker det. Filtypefiltre sjekker ikke filer for virus. Enhetens fil‑ID‑er og stier fungerer ikke som sky‑nedlastingslenker. Lokale kopier er ikke kryptert lagring og kan gå tapt hvis appdata fjernes.
Innstillinger, handlinger og resultater
Bruk disse navnene i Bubble. Planlagte funksjoner er merket separat.
Tilgjengelige beta‑innstillinger
Elementinnstillinger
source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · textTilstander
status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (liste)file_uris · text (liste)file_names · text (liste)file_mime_types · text (liste)file_sizes · number (liste)files_json · textsaved_count · numbersaved_file_ids · text (liste)saved_file_uris · text (liste)saved_file_names · text (liste)saved_file_mime_types · text (liste)saved_file_sizes · number (liste)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textHendelser
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorHandlinger og deres innganger
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElementinnstillinger · 16
source_uritext · Standard: ""- Eksempelverdi
file:///app-cache/report.pdf - Eksempel Bubble uttrykk
Photo Editor's output_uri - Lesbar filplassering på denne enheten, returnert av din velger eller et annet programtillegg.
display_nametext · Standard: ""- Eksempelverdi
report-photo.jpg - Eksempel Bubble uttrykk
Selected Attachment's display_name - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
mime_typetext · Standard: ""- Eksempelverdi
image/jpeg - Eksempel Bubble uttrykk
Photo Editor's output_mime - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
document_contexttext · Standard: "default"- Eksempelverdi
<current-user-id> - Eksempel Bubble uttrykk
Current User's unique id - Stabil verdi for denne kontoen eller posten. Bruk samme verdi når du gjenoppretter lagrede filer eller utkast.
selected_file_idtext · Standard: ""- Eksempelverdi
<returned saved file ID> - Eksempel Bubble uttrykk
Selected LocalAttachment's local_file_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
accepted_mime_types_jsontext · Standard: "[\"*/*\"]"- Eksempelverdi
["image/*","application/pdf"] - Eksempel Bubble uttrykk
Report Settings' accepted_mime_types_json - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
multipleyes_no · Standard: false- Eksempelverdi
yes - Eksempel Bubble uttrykk
Report Settings' allow_multiple_attachments - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
copy_to_cacheyes_no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
Report Settings' copy_to_cache - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
max_filesnumber · Standard: 20- Eksempelverdi
5 - Eksempel Bubble uttrykk
Report Settings' attachment_limit - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
max_file_bytesnumber · Standard: 268435456- Eksempelverdi
10485760 - Eksempel Bubble uttrykk
Report Settings' max_attachment_bytes - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
is_activeyes_no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
GuideHost's view_is_active (your yes/no custom state) - Sett ja mens denne visningen er åpen. Sett nei ved avslutning, slik at avspilling eller pågående arbeid kan stoppes.
disabledyes_no · Standard: false- Eksempelverdi
no - Eksempel Bubble uttrykk
GuideHost's is_busy (your yes/no custom state) - Deaktiver elementet mens appen din er opptatt eller handlingen er utilgjengelig.
show_controlsyes_no · Standard: true- Eksempelverdi
yes - Eksempel Bubble uttrykk
App Settings' show_editor_controls - Vis eller skjul de innebygde kontrollene.
languagetext · Standard: "auto"- Eksempelverdi
uk - Eksempel Bubble uttrykk
Current User's preferred_language - Sett language=auto til å følge en støttet enhet eller nettleserspråk. Skriv inn en støttet språkkode for å velge den eksplisitt.
ui_text_jsontext · Standard: ""- Eksempelverdi
{} - Eksempel Bubble uttrykk
App Settings' player_labels_json (supported keys only) - Valgfri JSON med støttede knappetiketter. La stå tomt for å bruke den innebygde teksten.
titletext · Standard: ""- Eksempelverdi
Lesson 4 — review - Eksempel Bubble uttrykk
Selected Lesson's name - Synlig app‑tekst; tomt bruker innebygd lokalisert kopi der det støttes. Ingen legitimasjon.
Handlinger og deres innganger · 10
Pick files
Ingen handlingsparametere
Load local source
source_uritext · Standard: —- Eksempelverdi
file:///app-cache/report.pdf - Eksempel Bubble uttrykk
Photo Editor's output_uri - Lesbar filplassering på denne enheten, returnert av din velger eller et annet programtillegg.
display_nametext · Standard: —- Eksempelverdi
report-photo.jpg - Eksempel Bubble uttrykk
Selected Attachment's display_name - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
mime_typetext · Standard: —- Eksempelverdi
image/jpeg - Eksempel Bubble uttrykk
Photo Editor's output_mime - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Select picked file
indexnumber · Standard: —- Eksempelverdi
0 - Eksempel Bubble uttrykk
Selected row's current_source_index - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Save selection locally
Ingen handlingsparametere
List saved files
Ingen handlingsparametere
Restore saved file
file_idtext · Standard: —- Eksempelverdi
<returned saved file ID> - Eksempel Bubble uttrykk
Selected LocalAttachment's local_file_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Delete saved copy
file_idtext · Standard: —- Eksempelverdi
<returned saved file ID> - Eksempel Bubble uttrykk
Selected LocalAttachment's local_file_id - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
confirmyes_no · Standard: —- Eksempelverdi
yes — explicit confirmation only - Eksempel Bubble uttrykk
Confirm Checkbox is checked - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Share selected file
dialog_titletext · Standard: —- Eksempelverdi
Share attachment - Eksempel Bubble uttrykk
Selected Report's share_title - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
utitext · Standard: —- Eksempelverdi
"" - Eksempel Bubble uttrykk
Empty unless your iOS integration supplies a proven UTI - Bruk den nåværende forretningspostens verdi; valider den mot grensene nedenfor.
Cancel operation
Ingen handlingsparametere
Clear session
Ingen handlingsparametere
Tilstander og hendelser
Tilstander
status · textNåværende resultat av denne handlingen. Bruk den tilsvarende fullførings‑hendelsen før du lagrer suksess.
is_busy · yes_noArbeidet pågår fortsatt. Vent før du starter en ny handling.
native_pending · yes_noArbeidet pågår fortsatt. Vent før du starter en ny handling.
operation · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
selection_count · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
selected_index · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
file_id · textIdentifikator for dette elementet eller handlingen. Behold den sammen med den tilsvarende app‑posten. Bruk samme forespørsels‑identifikator ved gjentakelse av et usikkert resultat.
local_uri · textFilplassering på denne enheten. Lagre eller last opp filen separat hvis den må holdes på nettet.
display_name · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
mime_type · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
mime_source · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
size_bytes · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
is_saved_locally · yes_noNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
file_ids · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
file_uris · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
file_names · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
file_mime_types · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
file_sizes · number (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
files_json · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
saved_count · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
saved_file_ids · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
saved_file_uris · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
saved_file_names · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
saved_file_mime_types · text (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
saved_file_sizes · number (liste)En liste for de valgte filene. Elementer med samme indeks i de andre fillistene refererer til den samme filen.
saved_files_json · textNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
invalid_saved_count · numberNåværende verdi for det valgte elementet. Les den etter den relaterte hendelsen.
share_status · textNåværende resultat av denne handlingen. Bruk den tilsvarende fullførings‑hendelsen før du lagrer suksess.
error_code · textFeilinformasjon for den siste handlingen. Vis en hjelpsom melding og tilby relevant gjenforsøk.
Hendelser
selection_changedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
files_savedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
list_loadedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
file_restoredNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
file_deletedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
share_sheet_closedNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
operation_cancelledNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
files_errorNår denne hendelsen oppstår, les de relaterte tilstandene fra samme element.
Spørsmål utviklere stiller
Betyr Deling “sendt”?
Nei. OS‑en gir ikke en pålitelig mottaker‑suksess‑kvittering her. Vis “delingsark lukket”.
Hvordan fungerer abonnementet?
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.
Relaterte veiledninger
For hjelp, fortell oss hvilken plugin og enhet du bruker, handlingen du prøvde og hva som skjedde. Bruk et eksempel uten personlige data. Del aldri nøkkelen din eller private filer.