Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Ikkonverti r-ritratt magħżul f’avatar konsistenti, immaġni tal-prodott jew attachment tar-rapport. Aqta’, iddur u ibdel id-daqs tiegħu, imbagħad issejvja l-kopja esportata fl-app tiegħek.
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.
Dokumentazzjoni riveduta 6 Novembru 2026
Eżempji prattiċi
Avatarijiet tal-profil konsistenti qabel l-upload
L-utenti għandhom jagħżlu liema parti tal-foto tagħhom tidher f’immaġni profil kwadra minflok jaċċettaw taqtija arbitrarja.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Stenna `source_loaded`; Begin crop → Apply crop, b’Rotate jew Undo kif meħtieġ. Fuq Save esplicitu, Export image.
Biss meta jseħħ `export_completed`, uża `output_uri`, `output_width`, `output_height` u `output_mime` bħala inputs għall-fluss tax-xogħol tal-upload tal-fajl tiegħek. Wara, issejvja r-referenza persistenti tiegħu fir-rekord Profile.
Jekk l-utent jikkanċella jew jseħħ `editor_error`, żomm l-avatar il-qadim. Naddaf is-sessjoni meta jinbidel il-kont sabiex utent ieħor ma jarax l-abbozz.
L-editjar joħloq kopja lokali. L-app tiegħek tagħżel kif taħżen jew ittella’ha.
Ipprepara ritratti konsistenti għal pjattaformi tal-bejgħ jew katalogi
Kadrar differenti u immaġini kbar wisq jagħmlu katalogu mhux uniformi u jżidu d-daqs tal-upload.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` u `export_quality` ġejjin mill-politika tiegħek għall-upload.
Aqta l-oqsma rilevanti, opzjonalment Resize, imbagħad Export image wara li l-utent jikkonferma. Żomm il-fajl/referenza oriġinali separata.
Iċċekkja `output_width`, `output_height`, `output_bytes` u `output_mime` qabel ma l-fluss tax-xogħol tal-upload tiegħek issejvja r-riżultat. Issejvja r-referenza tal-immaġni li tirriżulta fir-rekord Item.
Jekk l-esportazzjoni tfalli jew ir-riżultat jikser il-politika tiegħek tal-upload, uri `error_code` u ħalli l-utent jirrevedih. Tissostitwixxix l-immaġni preċedenti tar-rekord Item qabel il-konferma tal-upload.
L-editjar joħloq kopja lokali. L-app tiegħek tagħżel kif taħżen jew ittella’ha.
Oħloq kopja ta’ immaġni ffokata għal rapport tal-qasam
Tekniku jista’ jkollu bżonn ritratt mill-qrib ta’ parti bil-ħsara filwaqt li jżomm l-immaġni oriġinali tar-rapport.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; ir-ratio tal-qattija jista’ jibqa’ mhux limitat.
Begin crop → Apply crop, imbagħad uża Undo/Redo biex tqabbel il-bidliet. Export image joħloq il-kopja editjata; l-app tiegħek tistaqsi jekk tridx tehmeż dik il-kopja mar-rekord Report.
Uża `has_changes`, `can_undo`, `can_redo` u `output_uri`. Issejvja r-referenzi oriġinali u editjati f’oqsma separati tal-app wara upload li jirnexxi.
Cancel crop jew Reset edits jirrestawra l-istat tal-editjar; il-kanċellazzjoni trid tħalli l-attachment oriġinali tar-rekord Report mingħajr tibdil.
L-editjar joħloq kopja lokali. L-app tiegħek tagħżel kif taħżen jew ittella’ha.
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 source_url għall-immaġni magħżula. Uża document_context biex tidentifika l-kont u r-rekord li qed teditja, sabiex meta jinbidel ir-rekord l-editur jitnaddaf mir-ritratt preċedenti.
Wara source_loaded, ħaddem Begin crop. Agħżel 1:1 għal avatar, aġġusta ż-żona tal-qtugħ u uża Apply crop. Cancel crop jħalli l-immaġni mingħajr tibdil.
Uża Rotate, Flip jew Resize jekk meħtieġ. Undo u Redo jimxu permezz ta' editazzjonijiet lest; Reset edits jirrestawra l-immaġni oriġinali.
Ħaddem Export image. Meta jseħħ export_completed, aqra output_uri, output_width, output_height u output_mime. Issejvja jew ittella’ dik il-kopja bil-fluss tax-xogħol li għażilt għall-fajls, imbagħad aħżen il-fajl issejvjat fir-rekord.
Ikkonfigura darba waħda
L-attivazzjoni tal-key hija ppjanata għal din il-plugin. Oħloq jew agħżel il-proġett app Bubble tiegħek f’BestPlugins → Dashboard → Plugins. Agħżel Xodera Photo Editor Native, ikkopja l-key tiegħu, imbagħad iftaħ Bubble → Plugins → Xodera Photo Editor Native u poġġih 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 stess.
L-ewwel agħżel immaġni jew ħu ritratt bl-app tiegħek. Agħti lill-editur l-indirizz tal-immaġni li jista’ jinqara. Il-permessi tal-kamera u tal-librerija tar-ritratti huma r-responsabbiltà tal-għodda tal-għażla li tuża.
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
Ħażen l-immaġni ttella' jew imħażna permanenti f'Profile.image jew fil-qasam tal-attachment tiegħek. output_uri huwa fajl temporanju fuq it-tagħmir, għalhekk l-ewwel ħażen dak il-fajl bil-flusso ta' xogħol li għażilt. Imbagħad ħażen output_width, output_height u output_mime bħala metadata. Żomm l-immaġni oriġinali jekk għandek bżonn iż-żewġ verżjonijiet.
Falliment, ikkanċellament u rkupru
F'source_load_failed jew editor_error, uri error_code u offri Load source. Cancel operation jieqaf jaċċetta r-riżultat mhux lest; stenna sa is_busy=no qabel tibda editazzjoni oħra. Clear session jħassar l-editur, mhux immaġni diġà maħżuna f'post ieħor.
Kapabbiltajiet u limiti
Esportazzjoni JPEG u PNG; kwalità 0–1; it-tul massimu tal-itwal naħa tal-output: 1–4096 pixels. Input: sa 15 MiB u 20 megapixels. Sa 20 editjar komplut. Għażliet tal-qtugħ: free, 1:1, 4:3, 3:4 u 16:9. Ebda kamera integrata, filtri, test sovrappost, korrezzjoni tal-perspettiva, esportazzjoni WebP jew upload awtomatiku.
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_url · textdocument_context · textis_active · yes_nodisabled · yes_noshow_controls · yes_nocrop_aspect · textexport_format · textexport_quality · numberexport_max_dimension · numberallow_upscale · yes_noui_text_json · textlanguage · textStati
editor_status · textis_busy · yes_nohas_image · yes_nohas_changes · yes_nocan_undo · yes_nocan_redo · yes_noimage_width · numberimage_height · numberoutput_uri · textoutput_width · numberoutput_height · numberoutput_bytes · numberoutput_mime · texterror_code · textcrop_active · yes_nocrop_rect_json · textAvvenimenti
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAzzjonijiet u l-inputs tagħhom
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionKonfigurazzjonijiet tal-element · 12
source_urltext · Valur predefinit: ""- Valur eżempju
https://bestplugins.online/native-samples/avatar.jpg - Eżempju ta’ espressjoni Bubble
Selected Profile's image_url - Indirizz tal-fajl awdjo, video jew immaġni magħżul. Uża tip ta’ fajl li dan il‑plugin jappoġġja.
document_contexttext · Valur predefinit: ""- Valur eżempju
<current-user-id> - Eżempju ta’ espressjoni Bubble
Current 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.
is_activeyes_no · Valur predefinit: true- Valur eżempju
yes - Eżempju ta’ espressjoni Bubble
GuideHost'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żempju
no - Eżempju ta’ espressjoni Bubble
GuideHost'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żempju
yes - Eżempju ta’ espressjoni Bubble
App Settings' show_editor_controls - Uri jew aħbi l-kontrolli integrati.
crop_aspecttext · Valur predefinit: "free"- Valur eżempju
1:1 - Eżempju ta’ espressjoni Bubble
Avatar Settings' crop_ratio - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
export_formattext · Valur predefinit: "jpeg"- Valur eżempju
jpeg - Eżempju ta’ espressjoni Bubble
Format Dropdown's value - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
export_qualitynumber · Valur predefinit: 0.85- Valur eżempju
0.85 - Eżempju ta’ espressjoni Bubble
Image Settings' quality - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
export_max_dimensionnumber · Valur predefinit: 2048- Valur eżempju
2048 - Eżempju ta’ espressjoni Bubble
Image Settings' max_side - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
allow_upscaleyes_no · Valur predefinit: false- Valur eżempju
no - Eżempju ta’ espressjoni Bubble
Allow upscale Checkbox is checked - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
ui_text_jsontext · Valur predefinit: ""- Valur eżempju
{} - Eżempju ta’ espressjoni Bubble
App Settings' player_labels_json (supported keys only) - JSON opzjonal bil‑tikketti tal‑buttuni appoġġjati. Ħalli vojta biex tuża t-test integrat.
languagetext · Valur predefinit: "auto"- Valur eżempju
uk - Eżempju ta’ espressjoni Bubble
Current 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.
Azzjonijiet u l-inputs tagħhom · 13
Load source
Ebda parametri ta' azzjoni
Begin crop
Ebda parametri ta' azzjoni
Apply crop
origin_xnumber · Valur predefinit: —- Valur eżempju
0 - Eżempju ta’ espressjoni Bubble
Crop Settings' x (or omit all rectangle inputs) - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
origin_ynumber · Valur predefinit: —- Valur eżempju
0 - Eżempju ta’ espressjoni Bubble
Crop Settings' y (or omit all rectangle inputs) - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
widthnumber · Valur predefinit: —- Valur eżempju
512 - Eżempju ta’ espressjoni Bubble
Resize Width Input's value:converted to number - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
heightnumber · Valur predefinit: —- Valur eżempju
512 - Eżempju ta’ espressjoni Bubble
Resize Height Input's value:converted to number - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Cancel crop
Ebda parametri ta' azzjoni
Rotate
degreesnumber · Valur predefinit: —- Valur eżempju
90 - Eżempju ta’ espressjoni Bubble
Rotation Dropdown's value - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Flip
axistext · Valur predefinit: —- Valur eżempju
horizontal - Eżempju ta’ espressjoni Bubble
Flip Direction Dropdown's value - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Resize
widthnumber · Valur predefinit: —- Valur eżempju
512 - Eżempju ta’ espressjoni Bubble
Resize Width Input's value:converted to number - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
heightnumber · Valur predefinit: —- Valur eżempju
512 - Eżempju ta’ espressjoni Bubble
Resize Height Input's value:converted to number - Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Undo
Ebda parametri ta' azzjoni
Redo
Ebda parametri ta' azzjoni
Reset edits
Ebda parametri ta' azzjoni
Export image
Ebda parametri ta' azzjoni
Cancel operation
Ebda parametri ta' azzjoni
Clear session
Ebda parametri ta' azzjoni
Stati u avvenimenti
Stati
editor_status · textRiżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.
is_busy · yes_noIl-ħidma għadha għaddejja. Stenna qabel tibda azzjoni oħra.
has_image · yes_noValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
has_changes · yes_noValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
can_undo · yes_noValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
can_redo · yes_noValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
image_width · numberValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
image_height · numberValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
output_uri · textIl-post tal-fajl fuq dan l-apparat. Issejvja jew ittella’ l-fajl separatament jekk irid jinżamm online.
output_width · numberValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
output_height · numberValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
output_bytes · numberValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
output_mime · textValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
error_code · textInformazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.
crop_active · yes_noValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
crop_rect_json · textValur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.
Avvenimenti
source_loadedMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
source_load_failedMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
edit_appliedMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
edit_undoneMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
edit_redoneMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
editor_resetMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
export_startedMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
export_completedMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
operation_cancelledMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
editor_errorMeta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.
Mistoqsijiet li jistaqsu l-iżviluppaturi
output_uri huwa Bubble File?
Le. Hija mogħdija fil-cache lokali. Agħmel il-fajl persistenti permezz ta’ għodda lokali tal-issejvjar jew upload ippruvata qabel ma taħżen referenza għal fajl fil-cloud.
Kif taħdem is-sottoskrizzjoni?
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.
Gwidi relatati
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.