Xodera Plugins · Bubble Native

Xodera Offline Files Native

Mantni l-attachments tar-rapport u l-fajls magħżula fuq it-tagħmir, irrestaurahom aktar tard u ħalli l-utent jaqsam kopja magħżula.

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.

Ibni l-fluss tax-xogħol ↓Konfigurazzjonijiet tal-Plugin ↗Native Lab

Dokumentazzjoni riveduta 6 Novembru 2026

Eżempji prattiċi

Poġġi diversi attachimenti lokali qabel tibgħat rapport

Formola għandha turi liema fajls ġew magħżula u ħalli l-utent iżomm kopja mmaniġġjata qabel kwalunkwe sottomissjoni fil-cloud.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; issettja `max_files`, `max_file_bytes` u kont/rapport `document_context`.

Pick files → ivverifika l-ismijiet/daqsijiet magħżula → Save selection locally. Il-formola tiegħek iżomm l-ID tal-fajls riżultanti sakemm il-workflow separat ta’ Submit jtella’ l-fajls approvati.

Uża `selection_count`, `file_names`, `file_sizes` u `saved_file_ids` biex turi l-lista għar-reviżjoni. Kopja mmaniġġjata ssejvjata tħalli l-fajl oriġinali ta’ min sejjaħ l-operazzjoni intatt.

Picker ikkanċellat mhuwiex rapport sottomess. Fuq `files_error`, żomm l-ID lokali diġà aċċettati u wiri `error_code`; qatt ma toħloq attachment fil-cloud minn URI lokali biss.

Il-fajls jibqgħu fuq dan l-apparat sakemm jiġu maqsuma jew ittella’ separatament.

Żomm il-prodott tal-editur tal-fotografiji jew ir-rekordatur għall-użu futur.

Fajl lokali ġġenerat jista’ jkun f’lok temporanju; l-app teħtieġ kopja mmaniġġjata esplicita.

`source_uri = the local output of a separately accepted editor/recorder`; għaqad `display_name` u `mime_type` veru; uża `document_context` tal-istess sid.

Load local source → ivverifika metadata → Save selection locally. Ħażen l-ID tal-fajl irritornat biss fil‑apparat/kuntest li jaqbel, imbagħad Restore saved file bl‑ID eżatt dak meta jkun meħtieġ.

Uża `file_id`, `local_uri`, `size_bytes` u `is_saved_locally`; uża `file_restored` biex tiddistingwi restawr li tlesta minn sempliċi talba għal restawr.

Irrifjuta URL HTTP remot bħala sors lokali. Jekk is-sors sparixxa jew ir-restawr ifalli, uri `error_code` u żomm ir-rekord oriġinali tal-app għall-irkupru.

Il-fajls jibqgħu fuq dan l-apparat sakemm jiġu maqsuma jew ittella’ separatament.

Ħalli l-utent jaqsam irċevuta lokali ġġenerata mill‑app jew esportazzjoni

L‑app għandha tgħaddi fajl lokali magħżul għas‑sheet tal‑qsim tal‑apparat minflok toħloq URL pubbliku.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; ismu u MIME jiddeskrivu l-fajl lokali veru.

List saved files → Restore saved file → Share selected file wara li l-utent jikklikkja Share. Żomm il-kopja salvata sakemm jagħżel esplicitament Delete saved copy.

Uża `share_status` u `share_sheet_closed` biex taġġorna l‑UI wara li s‑sheet jingħalaq. Żomm l‑ID tal‑fajl għal qsim intenzjonat ieħor.

Menu tal-qsim magħluq mhuwiex prova li email jew messaġġ wasal għand ir-riċevitur. Immaniġġja l-kanċellazzjoni u `files_error` mingħajr ma tirrapporta kunsinna b’suċċess lir-riċevitur.

Il-fajls jibqgħu fuq dan l-apparat sakemm jiġu maqsuma jew ittella’ separatament.

X'jaħdem issa

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.

Ibni l-fluss tax-xogħol

Uża l-azzjonijiet beta disponibbli hawn taħt u ittestja r-riżultat fuq l-apparati fil-mira tiegħek.

Dawn l-eżempji jużaw reġistri tal-app bħal Lesson, Message u Order. Ibdelhom bi tipi ta' data u ismijiet ta' elementi tiegħek. Indirizzi tal-midja tal-eżempju għandhom jiġu mibdula b'fajls tiegħek.

Issettja document_context = Current User's unique id, jew valur stabbli għall-kont u r-rapport. Agħżel accepted_mime_types_json, max_files u max_file_bytes.
Ħaddem Pick files, jew uża Load local source għal fajl li jista' jinqara' improduż minn Photo Editor jew Recorder. Wara selection_changed, aqra l‑listi tal‑fajls li jaqblu; Select picked file jagħżel indeks.
Ħaddem Save selection locally. Wara files_saved, żomm saved_file_ids fir-rekord tal-attachments lokali tal-app tiegħek. List saved files juri l-kopji ssejvjati; Restore saved file jiftaħ l-ID issejvjat magħżul.
Share selected file jiftaħ il-menu ta’ qsim tas-sistema. share_sheet_closed tfisser biss li l-menu għalaq. Delete saved copy jeħtieġ l-ID magħżul u confirm=yes.

Dijagramma tal-fluss tax-xogħol — mhux screenshot tal-app

Ikkonfigura darba waħda

Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f’BestPlugins → Dashboard → Plugins. Agħżel Xodera Offline Files Native, ikkopja l-key tiegħu, imbagħad iftaħ Bubble → Plugins → Xodera Offline Files Native u poġġiha f’licensing_api_key. Issejvja darba; imbagħad uża l-azzjonijiet hawn taħt. Kull plugin f’kull proġett għandu l-key tiegħu.

Uża app nattiva b’aċċess għall-fajls magħżula. Issettja document_context stabbli għall-kont jew ir-rapport sabiex il-fajls issejvjati tiegħu jibqgħu raggruppati sew.

Ikkonfigura darba waħda

Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f'BestPlugins → Dashboard → Plugins.
Agħżel din il-plugin u ikkopja l-key tal-proġett tagħha.
Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
Żid l-element, agħżel id-data tal-app tiegħek u ibni l-fluss tax-xogħol hawn taħt.
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.

Installazzjoni u abbonament

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.

Issejvja r-riżultat fl-app tiegħek

Eżempju LocalAttachment: owner, document_context, ID tal-fajl issejvjat, display_name, mime_type u size_bytes. Dan l-ID jaħdem biss fuq l-istess apparat u għall-istess kont jew rapport. Għal attachment online, ittella’ l-fajl bi fluss tax-xogħol separat u ssejvja r-referenza online mogħtija.

Falliment, ikkanċellament u rkupru

Picker ikkanċellat jirritorna operation_cancelled; ma jissottomettix il-formola. Waqt native_pending=yes, stenna s-sistema tal-picker tal-fajls jew il-menu ta’ qsim jingħalaq qabel tiftaħ ieħor. Clear session jħassar l-għażla kurrenti iżda jibqa’ iżomm il-kopji salvati. Jekk fajl huwa nieqes, ħalli l-utent jagħżlu mill-ġdid.

Kapabbiltajiet u limiti

Agħżel 1–20 fajl f’daqqa. Limitu għal kull fajl: 1 byte–256 MiB, jew limitu aktar baxx li tagħżel int. Il-filtri tat-tip tal-fajl ma jiċċekkjawx il-fajls għal viruses. L-ID u l-mogħdijiet tal-fajls fuq l-apparat ma jaħdmux bħala links għat-tniżżil mill-cloud. Il-kopji lokali mhumiex ħażna kriptata u jistgħu jintilfu jekk titneħħa d-data tal-app.

Konfigurazzjonijiet, azzjonijiet u riżultati

Uża dawn l-ismijiet f'Bubble. Il-karatteristiċi pjanati huma mmarkati separatament.

Settings beta disponibbli

Konfigurazzjonijiet tal-element

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 · text

Stati

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 (lista)file_uris · text (lista)file_names · text (lista)file_mime_types · text (lista)file_sizes · number (lista)files_json · textsaved_count · numbersaved_file_ids · text (lista)saved_file_uris · text (lista)saved_file_names · text (lista)saved_file_mime_types · text (lista)saved_file_sizes · number (lista)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · text

Avvenimenti

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Azzjonijiet u l-inputs tagħhom

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session

Konfigurazzjonijiet tal-element · 16

source_uritext · Valur predefinit: "": Valur eżempjufile:///app-cache/report.pdf; Eżempju ta’ espressjoni BubblePhoto Editor's output_uri; Post tal‑fajl li jista’ jinqara fuq dan l‑apparat, ritornat mill‑picker tiegħek jew plugin ieħor.

display_nametext · Valur predefinit: "": Valur eżempjureport-photo.jpg; Eżempju ta’ espressjoni BubbleSelected Attachment's display_name; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

mime_typetext · Valur predefinit: "": Valur eżempjuimage/jpeg; Eżempju ta’ espressjoni BubblePhoto Editor's output_mime; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

document_contexttext · Valur predefinit: "default": Valur eżempju<current-user-id>; Eżempju ta’ espressjoni BubbleCurrent User's unique id; Valur stabbli għal dan il-kont jew rekord. Uża l-istess valur meta tirrestawra l-fajls jew l-abbozzi ssejvjati tiegħu.

selected_file_idtext · Valur predefinit: "": Valur eżempju<returned saved file ID>; Eżempju ta’ espressjoni BubbleSelected LocalAttachment's local_file_id; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

accepted_mime_types_jsontext · Valur predefinit: "[\"*/*\"]": Valur eżempju["image/*","application/pdf"]; Eżempju ta’ espressjoni BubbleReport Settings' accepted_mime_types_json; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

multipleyes_no · Valur predefinit: false: Valur eżempjuyes; Eżempju ta’ espressjoni BubbleReport Settings' allow_multiple_attachments; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

copy_to_cacheyes_no · Valur predefinit: true: Valur eżempjuyes; Eżempju ta’ espressjoni BubbleReport Settings' copy_to_cache; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

max_filesnumber · Valur predefinit: 20: Valur eżempju5; Eżempju ta’ espressjoni BubbleReport Settings' attachment_limit; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

max_file_bytesnumber · Valur predefinit: 268435456: Valur eżempju10485760; Eżempju ta’ espressjoni BubbleReport Settings' max_attachment_bytes; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

is_activeyes_no · Valur predefinit: true: Valur eżempjuyes; Eżempju ta’ espressjoni BubbleGuideHost's view_is_active (your yes/no custom state); Issettja yes waqt li din il-veduta tkun miftuħa. Issettja no meta toħroġ minnha, sabiex id-daqq jew ix-xogħol attwali jkun jista’ jieqaf.

disabledyes_no · Valur predefinit: false: Valur eżempjuno; Eżempju ta’ espressjoni BubbleGuideHost's is_busy (your yes/no custom state); Itfi l‑element waqt li l‑applikazzjoni tiegħek tkun impenjata jew din l‑azzjoni mhux disponibbli.

show_controlsyes_no · Valur predefinit: true: Valur eżempjuyes; Eżempju ta’ espressjoni BubbleApp Settings' show_editor_controls; Uri jew aħbi l-kontrolli integrati.

languagetext · Valur predefinit: "auto": Valur eżempjuuk; Eżempju ta’ espressjoni BubbleCurrent User's preferred_language; Issettja language=auto biex tuża l-lingwa tal-apparat jew tal-browser jekk dik il-lingwa tkun appoġġjata. Daħħal kodiċi ta’ lingwa appoġġjata biex tagħżilha espliċitament.

ui_text_jsontext · Valur predefinit: "": Valur eżempju{}; Eżempju ta’ espressjoni BubbleApp Settings' player_labels_json (supported keys only); JSON opzjonal bil‑tikketti tal‑buttuni appoġġjati. Ħalli vojta biex tuża t-test integrat.

titletext · Valur predefinit: "": Valur eżempjuLesson 4 — review; Eżempju ta’ espressjoni BubbleSelected Lesson's name; Test tal‑applikazzjoni li jidher; vojta juża kopja lokalizzata integrata fejn hija appoġġjata. Ebda kredenzjali.

Azzjonijiet u l-inputs tagħhom · 10

Pick files

Ebda parametri ta' azzjoni

Load local source

source_uritext · Valur predefinit: —: Valur eżempjufile:///app-cache/report.pdf; Eżempju ta’ espressjoni BubblePhoto Editor's output_uri; Post tal‑fajl li jista’ jinqara fuq dan l‑apparat, ritornat mill‑picker tiegħek jew plugin ieħor.

display_nametext · Valur predefinit: —: Valur eżempjureport-photo.jpg; Eżempju ta’ espressjoni BubbleSelected Attachment's display_name; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

mime_typetext · Valur predefinit: —: Valur eżempjuimage/jpeg; Eżempju ta’ espressjoni BubblePhoto Editor's output_mime; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Select picked file

indexnumber · Valur predefinit: —: Valur eżempju0; Eżempju ta’ espressjoni BubbleSelected row's current_source_index; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Save selection locally

Ebda parametri ta' azzjoni

List saved files

Ebda parametri ta' azzjoni

Restore saved file

file_idtext · Valur predefinit: —: Valur eżempju<returned saved file ID>; Eżempju ta’ espressjoni BubbleSelected LocalAttachment's local_file_id; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Delete saved copy

file_idtext · Valur predefinit: —: Valur eżempju<returned saved file ID>; Eżempju ta’ espressjoni BubbleSelected LocalAttachment's local_file_id; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

confirmyes_no · Valur predefinit: —: Valur eżempjuyes — explicit confirmation only; Eżempju ta’ espressjoni BubbleConfirm Checkbox is checked; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Share selected file

dialog_titletext · Valur predefinit: —: Valur eżempjuShare attachment; Eżempju ta’ espressjoni BubbleSelected Report's share_title; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

utitext · Valur predefinit: —: Valur eżempju""; Eżempju ta’ espressjoni BubbleEmpty unless your iOS integration supplies a proven UTI; Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.

Cancel operation

Ebda parametri ta' azzjoni

Clear session

Ebda parametri ta' azzjoni

Stati u avvenimenti

Stati

status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

is_busy · yes_no

Il-ħidma għadha għaddejja. Stenna qabel tibda azzjoni oħra.

native_pending · yes_no

Il-ħidma għadha għaddejja. Stenna qabel tibda azzjoni oħra.

operation · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

selection_count · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

selected_index · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

file_id · text

Identifikatur għal dan l‑oġġett jew azzjoni. Żommuh mal‑rekord tal‑app li jaqbel. Uża l-istess identifikatur tal‑talba meta terġa' tipprova riżultat mhux ċert.

local_uri · text

Il-post tal-fajl fuq dan l-apparat. Issejvja jew ittella’ l-fajl separatament jekk irid jinżamm online.

display_name · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

mime_type · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

mime_source · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

size_bytes · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

is_saved_locally · yes_no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

file_ids · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

file_uris · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

file_names · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

file_mime_types · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

file_sizes · number (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

files_json · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

saved_count · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

saved_file_ids · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

saved_file_uris · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

saved_file_names · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

saved_file_mime_types · text (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

saved_file_sizes · number (lista)

Lista għall-fajls magħżula. L-oġġetti bl-istess indiċi fil-listi l-oħra tal-fajls jirreferu għall-istess fajl.

saved_files_json · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

invalid_saved_count · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

share_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

error_code · text

Informazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.

Avvenimenti

selection_changed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

files_saved

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

list_loaded

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

file_restored

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

file_deleted

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

share_sheet_closed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

operation_cancelled

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

files_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

Mistoqsijiet li jistaqsu l-iżviluppaturi

Share ifisser “mibgħut”?

Le. Is-sistema operattiva ma tipprovdix hawn konferma affidabbli li r-riċevitur irċieva l-fajl. Uri “share sheet closed”.

Kif taħdem is-sottoskrizzjoni?

Gwidi relatati

audio-player video-player photo-editor audio-recorder qr-passes documents-ai b2-files

Lista verifikata Bubble Marketplace Suġġett tal-forum verifikat

Għal għajnuna, għidilna liema plugin u apparat qed tuża, l-azzjoni li ppruvajt u x'ġara. Uża eżempju mingħajr data personali. Qatt ma taqsam il-key tiegħek jew fajls privati.