Xodera Plugins · Bubble Native

Xodera B2 Files Native

שמור את הקבצים המצורפים של האפליקציה באחסון Backblaze B2 שלך. אפשר למשתמשים מורשים להעלות, לעיין ולהוריד קבצים, ולבחור במפורש מתי קובץ יכול להיות משותף לציבור.

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.

בנה את זרימת העבודה ↓הגדרות תוסף ↗Native Lab

תיעוד נבדק 6 נובמבר 2026

דוגמאות מעשיות

אחסן קובץ מצורף של משימה בדלי הפרטי של המפתח

עבודה Bubble דורשת הפנייה אחסון עמידה מבלי להתייחס לכתובת הורדה שתוקפה מוגבל כמזהה הקובץ.

`bucket_binding_id = an allowed binding to your own private bucket`; דינמי `local_uri`, `display_name`, `mime_type` ו‑`expected_size` מתארים את הקובץ המקומי שנבחר.

מתוכנן: Check local source → Upload file → המתן ל‑`upload_verified`. לאחר מכן זרימת העבודה שלך מאחסנת `asset_ref` ונתוני מטא על רשומת העבודה שבבעלותך.

השתמש ב‑`asset_ref`, `size_bytes`, `mime_type` ו‑`upload_status`. מאוחר יותר, Resolve private read יכול לספק כתובת URL זמנית לשימוש מורשה.

אם שמירת מסד הנתונים נכשלת לאחר `upload_verified`, נסה שוב את עדכון ה‑DB עם אותה הפנייה לנכס במקום העלאה נוספת. בדוק את תוצאת `upload_pending` באמצעות Check or recover upload status ו‑ID ההעלאה זהה.

מתוכנן. חשבון B2 שלך משלם על אחסון ועלויות הורדה.

בנה גלריית קבצים מצורפים בבעלותך עם רשומות קבצים עמידות

גלריית קבצים דורשת שמות, סוגים ועימוד וכן דרך לפתוח את הנכס שנבחר מאוחר יותר.

רשומת הקובץ של האפליקציה שלך מאחסנת `asset_ref` מאושר, שם תצוגה, MIME וקשר בעלים/עבודה לאחר העלאה מאומתת; אל תשתמש ב‑URI מקומי כמזהה בענן.

מתוכנן: השתמש ב‑List my B2 files לבניית רשימת הקבצים המצורפים. asset_refs מזהה את הקבצים; ערכים באותו אינדקס מספקים את שמותיהם וסוגיהם. בחירת קובץ מעבירה את asset_ref ל‑Get asset metadata או Download accepted version.

`has_more` ו‑`next_cursor` שייכים לשאילתה הנוכחית. הורדה שהושלמה מחזירה `local_output_uri`; זו עותק מקומי למכשיר, לא קישור ציבורי קבוע.

אפס את העימוד לאחר שינויי קישור/חשבון/שאילתה. ב‑`transfer_error`, שמור את פריט הקובץ הקיים והצג `error_code`; אל תחליף אותו בשקט בגרסה אחרת אצל הספק.

מתוכנן. חשבון B2 שלך משלם על אחסון ועלויות הורדה.

הפוך פרסום ומחיקת גרסה מדויקת למודעים

הצוות לא צריך לחשוף בטעות קובץ מצורף פרטי או למחוק את כל הגרסאות בעת החלפת תמונה.

`asset_ref = the selected accepted version`; קישור לדלי והרשאות הקבצים של האפליקציה חייבים לאפשר את הפעולה המבוקשת.

הצג את הנראות הנוכחית, בקש אישור מפורש, ואז Change public sharing. להסרה, קרא ל‑Delete accepted version עם אישור; שמור את מטא‑נתוני האפליקציה עד שהתוצאה המאושרת ידועה.

לאחר `share_changed`, השתמש ב‑`visibility` וב‑`public_url` רק כאשר שיתוף ציבורי אושר במפורש. לאחר `delete_completed`, עדכן את רשומת הקובץ בבעלותך; `delete_pending` אינו מחיקה סופית.

בדוק את התוצאה של פעולה שתוצאתה אינה ודאית במקום להניח שהצליחה. כתובות URL של קריאת ספק שהונפקו בעבר עשויות להישאר תקפות עד לתקופת התפוגה; הסרת שורת DB או השבתת שיתוף אינה מחזירה את הבייטים שכבר הורדו.

מתוכנן. חשבון B2 שלך משלם על אחסון ועלויות הורדה.

מה עובד כעת

תוסף מתוכנן. הוא עדיין לא מותקן או זמין לשימוש. המדריך למטה מציג את זרימת הקבצים המתוכננת.

בנה את זרימת העבודה

מתוכנן

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

דוגמאות אלו משתמשות ברשומות אפליקציה כגון Lesson, Message ו‑Order. החליפו אותן בסוגי הנתונים ובשמות האלמנטים שלכם. כתובות מדיה לדוגמה חייבות להיות מוחלפות בקבצים שלכם.

מתוכנן: בהגדרות הפרויקט שלך, בחר את אחסון B2 והדלי המותר. הגדר את פרטיותו, קידומת התיקייה וסוגי הקבצים והגדלים המותרים.
השתמש ב‑List B2 bindings כדי להציג אפשרויות אחסון מותרות. השתמש ב‑List my B2 files כדי להציג את הקבצים של המשתמש הנוכחי ו‑Get my B2 file info לפרטים.
בחר קובץ. הגדר את bucket_binding_id, local_uri, display_name, mime_type ו‑expected_size, ואז הפעל את Upload file. הצג התקדמות, אך המתן ל‑upload_verified לפני שמחשיבים את הקובץ כשמור.
שמור את asset_ref ברשומת האפליקציה שלך. השתמש בו עבור Get asset metadata, Resolve private read או Download accepted version. Change public sharing ו‑Delete accepted version דורשים אישור נפרד.

תרשים זרימת עבודה — לא צילום מסך של אפליקציה

הגדר פעם אחת

הפעלת המפתח מתוכננת לתוסף זה. צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins. בחר ב‑Xodera B2 Files Native, העתק את המפתח שלו, ואז פתח Bubble → Plugins → Xodera B2 Files Native והדבק אותו ב‑project_api_key. שמור פעם אחת; לאחר מכן השתמש בפעולות למטה. לכל תוסף בכל פרויקט יש מפתח משלו.

השתמש בחשבון Backblaze B2 שלך ובחר את הדלי עבור אפליקציה זו. החלט מי יכול לקרוא ולהעלות קבצים. שמור את שמות השדות רלוונטיים של משתמש כן/לא ב‑b2_reader_permission_field וב‑b2_writer_permission_field; ברירות המחדל הן b2_files_reader ו‑b2_files_writer. רק מנהל מורשה צריך לשנות את ההרשאות של משתמשים אלה.

הגדר פעם אחת

צור או בחר את פרויקט האפליקציה Bubble שלך ב‑BestPlugins → Dashboard → Plugins.
בחר בתוסף זה והעתק את מפתח הפרויקט שלו.
מתוכנן: פתח Bubble → Plugins → Xodera B2 Files Native; הדבק את המפתח ב‑project_api_key ושמור.
הוסף את הרכיב, בחר את נתוני האפליקציה שלך ובנה את זרימת העבודה למטה.
גישה לבטא פרטית רק לעת עתה. התקנה ציבורית והפעלה בתשלום עדיין אינן פתוחות.

התקנה ומנוי

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.

שמור את התוצאה באפליקציה שלך

קובץ מצורף לדוגמה: asset_ref, דוח/הזמנה קשורים, בעלים, display_name, mime_type ו‑size_bytes. שמור אותם לאחר upload_verified. השתמש ב‑asset_ref כדי לפתוח קובץ מאוחר יותר; כתובת קריאה זמנית או נתיב במכשיר אחד אינם הפנייה קבועה לקובץ. אם שמירת רשומת מסד הנתונים נכשלת, נסה לשמור את הרשומה שוב במקום להעלות את הקובץ מחדש.

כשל, ביטול ושחזור

אם תוצאת ההעלאה אינה ידועה, שמור את upload_id והשתמש ב‑Check or recover upload status. אל תעלה עותק נוסף באופן אוטומטי. ביטול משפיע על ההעברה שטרם הושלמה, ולא על קובץ שכבר נשמר. אם הגישה פגה, בקש את הקובץ שוב במקום להשתמש בכתובת זמנית ישנה.

יכולות ומגבלות

גודל קובץ מקסימלי מתוכנן: 256 MiB, או מגבלת דלי נמוכה יותר שתבחר. עלויות האחסון וההורדה ב‑Backblaze שייכות לחשבון B2 שלך. קבצים בדלי ציבורי הם ציבוריים גם כאשר רשומת האפליקציה הקשורה פרטית. אין הבטחת סריקת וירוסים, העלאה מרובת חלקים, השהייה או שחזור לאחר סיום האפליקציה.

הגדרות, פעולות ותוצאות

השתמשו בשמות אלה ב‑Bubble. תכונות מתוכננות מסומנות בנפרד.

הגדרות בטא זמינות

הגדרות אלמנט

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

מצבים

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

אירועים

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

פעולות והקלטים שלהן

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

הגדרות אלמנט · 14

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

bucket_binding_idtext · ברירת מחדל: "": ערך לדוגמה<binding returned by List B2 bindings>; דוגמה לביטוי BubbleSelected Binding's binding_id; בחירת האחסון שהוחזרה על ידי List B2 bindings. השתמש במזהה שלה עבור קובץ זה.

local_uritext · ברירת מחדל: "": ערך לדוגמהfile:///app-cache/attachment.jpg; דוגמה לביטוי BubbleOffline Files' local_uri; מיקום קובץ קריא במכשיר זה. הוא אינו קישור הורדה מקוון.

display_nametext · ברירת מחדל: "": ערך לדוגמהreport-photo.jpg; דוגמה לביטוי BubbleSelected Attachment's display_name; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

mime_typetext · ברירת מחדל: "": ערך לדוגמהimage/jpeg; דוגמה לביטוי BubblePhoto Editor's output_mime; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

expected_sizenumber · ברירת מחדל: 0: ערך לדוגמה246975; דוגמה לביטוי BubbleOffline Files' size_bytes; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

metadata_jsontext · ברירת מחדל: "": ערך לדוגמה{"label":"field-report"}; דוגמה לביטוי BubbleSelected Attachment's safe_metadata_json; אופציונלי JSON עם מידע אפליקציה כגון תווית דוח. שמור אותו קטן והימנע מנתונים אישיים.

asset_reftext · ברירת מחדל: "": ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

is_activeyes_no · ברירת מחדל: true: ערך לדוגמהyes; דוגמה לביטוי BubbleGuideHost's view_is_active (your yes/no custom state); הגדר yes כל עוד התצוגה פתוחה. בעת היציאה הגדר no, כדי לאפשר את עצירת ההשמעה או העבודה הנוכחית.

disabledyes_no · ברירת מחדל: false: ערך לדוגמהno; דוגמה לביטוי BubbleGuideHost's is_busy (your yes/no custom state); השבת את הרכיב כאשר האפליקציה שלך עסוקה או שהפעולה אינה זמינה.

languagetext · ברירת מחדל: "auto": ערך לדוגמהuk; דוגמה לביטוי BubbleCurrent User's preferred_language; הגדר language=auto כדי להשתמש בשפת המכשיר או הדפדפן, אם היא נתמכת. הזן קוד שפה נתמך כדי לבחור שפה במפורש.

ui_text_jsontext · ברירת מחדל: "": ערך לדוגמה{}; דוגמה לביטוי BubbleApp Settings' player_labels_json (supported keys only); JSON אופציונלי עם תוויות כפתורים נתמכות. השאר ריק כדי להשתמש בטקסט המובנה.

titletext · ברירת מחדל: "": ערך לדוגמהLesson 4 — review; דוגמה לביטוי BubbleSelected Lesson's name; טקסט שמוצג באפליקציה; כאשר השדה ריק, נעשה שימוש בטקסט המובנה המתורגם, היכן שנתמך. אין לכלול פרטי גישה.

show_previewyes_no · ברירת מחדל: false: ערך לדוגמהyes; דוגמה לביטוי BubbleApp Settings' b2_preview; הצג או הסתר את תצוגת הקובץ.

show_provider_browseyes_no · ברירת מחדל: false: ערך לדוגמהno; דוגמה לביטוי BubbleCurrent User's authorized_browse_UI (presentation only); הצג או הסתר את פקדי דפדוף האחסון למשתמשים מורשים.

פעולות והקלטים שלהן · 20

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

List allowed buckets

אין פרמטרי פעולה

Select bucket binding

binding_idtext · ברירת מחדל: —: ערך לדוגמה<returned allowed binding ID>; דוגמה לביטוי BubbleSelected Binding's binding_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Check local source

אין פרמטרי פעולה

Upload file

acknowledge_public_bytesyes_no · ברירת מחדל: —: ערך לדוגמהno; דוגמה לביטוי BubblePublic bucket disclosure Checkbox is checked (private bucket: no); השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

confirm_retryyes_no · ברירת מחדל: —: ערך לדוגמהno; דוגמה לביטוי BubbleRetry Checkbox is checked after confirmed clean pending status; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Check or recover upload status

upload_idtext · ברירת מחדל: —: ערך לדוגמה<original returned upload_id>; דוגמה לביטוי BubbleCurrent UploadIntent's upload_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Cancel owned transfer

אין פרמטרי פעולה

Clear local session

אין פרמטרי פעולה

List application files

אין פרמטרי פעולה

Refresh application files

אין פרמטרי פעולה

Load more application files

אין פרמטרי פעולה

Select asset reference

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

Get asset metadata

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

Resolve private read

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

Download accepted version

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

Browse provider files

prefixtext · ברירת מחדל: —: ערך לדוגמה""; דוגמה לביטוי BubbleAuthorized Browse Settings' prefix; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

load_moreyes_no · ברירת מחדל: —: ערך לדוגמהno; דוגמה לביטוי BubbleLoad More button only, for unchanged query; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Change public sharing

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

enabledyes_no · ברירת מחדל: —: ערך לדוגמהno; דוגמה לביטוי BubblePublic Share Checkbox is checked after separate confirmation; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

confirmyes_no · ברירת מחדל: —: ערך לדוגמהyes — explicit confirmation only; דוגמה לביטוי BubbleConfirm Checkbox is checked; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

Delete accepted version

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

confirmyes_no · ברירת מחדל: —: ערך לדוגמהyes — explicit confirmation only; דוגמה לביטוי BubbleConfirm Checkbox is checked; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

List B2 bindings

environmenttext · ברירת מחדל: —: ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

ערכי החזרה

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

List my B2 files

environmenttext · ברירת מחדל: —: ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

binding_idtext · ברירת מחדל: —: ערך לדוגמה<returned allowed binding ID>; דוגמה לביטוי BubbleSelected Binding's binding_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

limitnumber · ברירת מחדל: —: ערך לדוגמה50; דוגמה לביטוי BubbleGallery Settings' page_size; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

cursortext · ברירת מחדל: —: ערך לדוגמה""; דוגמה לביטוי BubblePrevious List my B2 files result's next_cursor; empty on first page; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

ערכי החזרה

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 · ברירת מחדל: —: ערך לדוגמהdevelopment; דוגמה לביטוי BubbleApp Settings' selected_environment; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

binding_idtext · ברירת מחדל: —: ערך לדוגמה<returned allowed binding ID>; דוגמה לביטוי BubbleSelected Binding's binding_id; השתמש בערך של רשומת העסק הנוכחית; אמת אותו מול המגבלות למטה.

asset_reftext · ברירת מחדל: —: ערך לדוגמה<returned asset_ref>; דוגמה לביטוי BubbleSelected B2Asset's asset_ref; מזהה יציב ואטום של נכס שאושר על ידי השירות. בחירתו לעולם אינה עוקפת את הרשאת המשתמש.

ערכי החזרה

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

מצבים ואירועים

תהליך מתוכנן. עדיין אינו זמין בבטא הנוכחי.

מצבים

status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

is_busy · yes_no

העבודה עדיין בתהליך. המתן לפני תחילת פעולה נוספת.

upload_id · text

מזהה לפריט או פעולה זו. שמור אותו עם רשומת האפליקציה המתאימה. השתמש באותו מזהה בקשה בעת ניסיון חוזר של תוצאה שאינה ודאית.

upload_status · text

התוצאה הנוכחית של פעולה זו. השתמש באירוע השלמה המתאים לפני שמירת ההצלחה.

asset_ref · text

display_name · text