Xodera Plugins · Bubble Native
Xodera Photo Editor Native
Wandelt eng ausgewielte Foto an e konsequent Avatar, Produktbild oder Rapport-Anhang ëm. Beschneidt, dréit a änner d'Gréisst, an späichert d'exportéiert Kopie an Ärer App.
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.
Dokumentatioun iwwerkuckt 6 November 2026
Praktesch Beispiller
Konsistent Profil-Avatare virun dem Upload
Benotzer sollten wielen, wéi en Deel vun hirem Foto an engem quadratesche Profilbild erschéngt, amplaz e willeche Beschnëtt ze akzeptéieren.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
Waart op `source_loaded`; Begin crop → Apply crop, mat Rotate oder Undo no Bedarf. Beim explizite Späicheren, Export image.
Nëmmen op `export_completed`, benotzt `output_uri`, `output_width`, `output_height` an `output_mime` als Input fir Ären Dateiupload-Workflow. Späichert d'stéiere Referenz duerno am Profil.
Falls de Benotzer annuléiert oder `editor_error` ausgeléist gëtt, behält de ale Avatar. Läert d'Sessioun bei Kontowechsel ewech, sou datt en anere Benotzer den Entworf net gesähe kann.
Beim Editéiere gëtt eng lokal Kopie erstallt. Är App entscheidet, wéi se gespäichert oder eropgelueden gëtt.
Bereet konsequent Maartplaz- oder Katalogfotoen vir.
Verschidde Rahmengestaltung an iwwergréisser Biller maachen e Katalog ongläich a vergréisseren d'Eroplueden-Gréisst.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` an `export_quality` kommen aus Ärer Eroplueden-Politik.
Beschneid den relevante Beräich, optional Resize, dann Export image nodeems de Benotzer bestätegt. Halte d'original Datei/Referenz separat.
Iwwerpréif `output_width`, `output_height`, `output_bytes` an `output_mime` ier Äre Eroplueden-Workflow d'Resultat späichert. Späichere d'Resultatbild-Referenz um Element.
Falls den Export fehlschléit oder d'Resultat Är Eroplueden-Politik verletzt, weist `error_code` an erlaabt dem Benotzer et ze korrigéieren. Iwwerschreift net d'virdrun Bild vum Element ier d'Eroplueden-Bestätegung.
Beim Editéiere gëtt eng lokal Kopie erstallt. Är App entscheidet, wéi se gespäichert oder eropgelueden gëtt.
Erstellt eng fokusséiert Bildkopie fir e Feldbericht.
En Techniker kann eng Nähopnahm vun engem beschädigte Bestanddeel brauchen, wärend d'original Bild vum Bericht erhalen gëtt.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; Beschneedungsverhältnis kann onbeschränkt bleiwen.
Begin crop → Apply crop, dann benotzt Undo/Redo fir d'Ännerungen ze vergläichen. Export image erstallt d'geännerte Kopie; Är App freet, ob dës Kopie dem Rapport bäigefüügt soll ginn.
Benotzt `has_changes`, `can_undo`, `can_redo` an `output_uri`. Späichert d'originell an d'geännerte Referenzen an getrennte App-Felder no engem erfollechen Upload.
Cancel crop oder Reset edits restauréiert de Bearbeitungswee; d'Annulatioun muss de originale Rapport-Anhang onverännert loossen.
Beim Editéiere gëtt eng lokal Kopie erstallt. Är App entscheidet, wéi se gespäichert oder eropgelueden gëtt.
Wat elo funktionéiert
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.
Den Workflow bauen
Benotzt déi verfügbar Beta-Aktiounen hei drënner a test d'Resultat op Äre Zielgeräter.
Dës Beispiller benotzen App-Recourcen wéi Lesson, Message an Order. Ersetzt se mat Äre eegenen Datentypen an Elementnimm. Beispill-Media-Adressë musse mat Äre eegenen Fichieren ersat ginn.
Setzt source_url op dat gewielte Bild. Benotzt document_context fir de Kont an de Rekord, deen bearbecht gëtt, ze identifizéieren, sou datt d'Ännerung vum Rekord d'virgëtt Foto läscht.
No source_loaded, féiert Begin crop aus. Wielt 1:1 fir en Avatar, passt de Beschnëtt un an benotzt Apply crop. Cancel crop léisst d'Bild onverännert.
Benotzt Rotate, Flip oder Resize wann néideg. Undo an Redo navigéieren duerch fäerdeg Ännerungen; Reset edits stellt d'Originalbild zréck.
Féiert Export image aus. Beim export_completed, lies output_uri, output_width, output_height an output_mime. Späichert oder lued déi Kopie mat Ärem gewielte Dateispeicherungs-Workflow erop, an späichert d'späicherten Datei dann am Rekord.
Eenmal konfiguréieren
D'Activatioun vum Schlëssel ass fir dëse Plugin geplangt. Erstellt oder wielt Äre Bubble App-Projet an BestPlugins → Dashboard → Plugins. Wielt Xodera Photo Editor Native, kopéiert säi Schlëssel, dann opmaachen Bubble → Plugins → Xodera Photo Editor Native an füügt en an licensing_api_key an. Späichert eemol; benotzt dann d'Aktiounen hei drënner. All Plugin an all Projet huet säin eegene Schlëssel.
Wielt oder erfaasst d'Bild z'erst mat Ärer App. Gitt dem Editor d'Resultat-URL vum liesbare Bild. Kamera- a Foto-Bibliothéksrechter gehéieren zum Picker deen Dir benotzt.
Eenmal konfiguréieren
- Erstellt oder wielt Äre Bubble App-Projet bei BestPlugins → Dashboard → Plugins.
- Wielt dësen Plugin aus an kopéiert säi Projet-Schlëssel.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Füügt d'Element derbäi, wielt Är App-Daten an baut de Workflow hei drënner op.
- 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.
Installatioun an 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.
Späichert d'Resultat an Ärer App
Späichert d'gelueden oder permanent gespäichert Bild an Profile.image oder Ärem Anhangsfeld. output_uri ass eng temporär Datei um Gerät, späichert also déi Datei als éischt mat Ärem gewielte Workflow. Dann späichert output_width, output_height an output_mime als Metadaten. Behält d'original Bild wann Dir béid Versiounen braucht.
Feeler, annuléieren an Erhuelung
Op source_load_failed oder editor_error, weist error_code un a proposéiert Load source. Cancel operation hält op d'Empfang vum onvollstännege Resultat; waart bis is_busy=no ier Dir eng aner Bearbeitung ufänkt. Clear session läscht den Editor, net e Bild dat scho anescht gespäichert ass.
Fäegkeeten an Limiten
JPEG an PNG Export; Qualitéit 0–1; maximal Ausgabeseit 1–4096 Pixel. Input: bis zu 15 MiB an 20 Megapixel. Bis zu 20 fäerdeg Editiounen. Beschneedungsoptiounen: fräi, 1:1, 4:3, 3:4 an 16:9. Kee integrierten Kamera, Filter, Textiwwerleeungen, Perspektivkorrektur, WebP Export oder automateschen Upload.
Astellungen, Aktiounen an Resultater
Benotzt dës Nimm an Bubble. Geplang Features sinn separat markéiert.
Verfügbare Beta-Astellungen
Element-Astellungen
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 · textZoustänn
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 · textEvenementer
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorAktiounen an hir Inputen
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionElement-Astellungen · 12
source_urltext · Standard: ""- Beispillwäert
https://bestplugins.online/native-samples/avatar.jpg - Beispiel Bubble Ausdrock
Selected Profile's image_url - Adress vun der ausgewielten Audio-, Video- oder Bilddatei. Benotzt e Dateityp, deen dëse Plugin ënnerstëtzt.
document_contexttext · Standard: ""- Beispillwäert
<current-user-id> - Beispiel Bubble Ausdrock
Current User's unique id - Stabile Wäert fir dësen Kont oder Dossié. Benotzt de selwechten Wäert beim Restauréieren vun senge gespäicherten Dateien oder Entwécklungen.
is_activeyes_no · Standard: true- Beispillwäert
yes - Beispiel Bubble Ausdrock
GuideHost's view_is_active (your yes/no custom state) - Setzt Ja, soulaang dës Vue op ass. Setzt Nee beim Verloossen, sou datt d'Playback oder d'aktuell Aarbecht gestoppt ka ginn.
disabledyes_no · Standard: false- Beispillwäert
no - Beispiel Bubble Ausdrock
GuideHost's is_busy (your yes/no custom state) - Desaktivéiert d'Element, wann Är App beschäftegt ass oder dës Aktioun net verfügbar ass.
show_controlsyes_no · Standard: true- Beispillwäert
yes - Beispiel Bubble Ausdrock
App Settings' show_editor_controls - Built-in Kontrollen weisen oder verstoppen.
crop_aspecttext · Standard: "free"- Beispillwäert
1:1 - Beispiel Bubble Ausdrock
Avatar Settings' crop_ratio - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
export_formattext · Standard: "jpeg"- Beispillwäert
jpeg - Beispiel Bubble Ausdrock
Format Dropdown's value - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
export_qualitynumber · Standard: 0.85- Beispillwäert
0.85 - Beispiel Bubble Ausdrock
Image Settings' quality - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
export_max_dimensionnumber · Standard: 2048- Beispillwäert
2048 - Beispiel Bubble Ausdrock
Image Settings' max_side - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
allow_upscaleyes_no · Standard: false- Beispillwäert
no - Beispiel Bubble Ausdrock
Allow upscale Checkbox is checked - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
ui_text_jsontext · Standard: ""- Beispillwäert
{} - Beispiel Bubble Ausdrock
App Settings' player_labels_json (supported keys only) - Optional JSON mat ënnerstëtzten Knäppchenbeschrëftungen. Loosst eidel fir den integrierten Text ze benotzen.
languagetext · Standard: "auto"- Beispillwäert
uk - Beispiel Bubble Ausdrock
Current User's preferred_language - Setzt language=auto fir eng ënnerstëtzt Apparat oder Browser-Sprooch ze verfollegen. Gitt e ënnerstëtzte Sproochcode an fir se explizit auszewielen.
Aktiounen an hir Inputen · 13
Load source
Keng Aktiounsparameter
Begin crop
Keng Aktiounsparameter
Apply crop
origin_xnumber · Standard: —- Beispillwäert
0 - Beispiel Bubble Ausdrock
Crop Settings' x (or omit all rectangle inputs) - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
origin_ynumber · Standard: —- Beispillwäert
0 - Beispiel Bubble Ausdrock
Crop Settings' y (or omit all rectangle inputs) - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
widthnumber · Standard: —- Beispillwäert
512 - Beispiel Bubble Ausdrock
Resize Width Input's value:converted to number - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
heightnumber · Standard: —- Beispillwäert
512 - Beispiel Bubble Ausdrock
Resize Height Input's value:converted to number - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
Cancel crop
Keng Aktiounsparameter
Rotate
degreesnumber · Standard: —- Beispillwäert
90 - Beispiel Bubble Ausdrock
Rotation Dropdown's value - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
Flip
axistext · Standard: —- Beispillwäert
horizontal - Beispiel Bubble Ausdrock
Flip Direction Dropdown's value - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
Resize
widthnumber · Standard: —- Beispillwäert
512 - Beispiel Bubble Ausdrock
Resize Width Input's value:converted to number - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
heightnumber · Standard: —- Beispillwäert
512 - Beispiel Bubble Ausdrock
Resize Height Input's value:converted to number - Benotzt de Wäert vum aktuelle Geschäftsdatenbank-Datensatz; validéiert en géint d'Grenzwerte hei drënner.
Undo
Keng Aktiounsparameter
Redo
Keng Aktiounsparameter
Reset edits
Keng Aktiounsparameter
Export image
Keng Aktiounsparameter
Cancel operation
Keng Aktiounsparameter
Clear session
Keng Aktiounsparameter
Zoustänn an Evenementer
Zoustänn
editor_status · textAktuellt Resultat vun dëser Aktioun. Benotzt den entspriechende Ofschloss-Event ier Dir de Succès späichert.
is_busy · yes_noAarbecht ass nach am gaangen. Waart ier Dir eng aner Aktioun ufänkt.
has_image · yes_noAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
has_changes · yes_noAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
can_undo · yes_noAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
can_redo · yes_noAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
image_width · numberAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
image_height · numberAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
output_uri · textDatei-Standort op dësem Gerät. Späichert oder lued d'Datei separat erop, wann se online muss bleiwen.
output_width · numberAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
output_height · numberAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
output_bytes · numberAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
output_mime · textAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
error_code · textFeelinformatioun fir déi lescht Aktioun. Weist eng hëllefräich Noriicht an bidd de passende Wiederhuelungsversuch un.
crop_active · yes_noAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
crop_rect_json · textAktuellen Wäert fir dat ausgewielte Element. Liest et no dem verbonne Event.
Evenementer
source_loadedWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
source_load_failedWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
edit_appliedWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
edit_undoneWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
edit_redoneWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
editor_resetWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
export_startedWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
export_completedWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
operation_cancelledWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
editor_errorWann dëst Evenement optrëtt, lies d'verbonne Stänn vum selwechten Element.
Froen déi Entwéckler stellen
Ass output_uri eng Bubble Datei?
Nee. Et ass e lokale Cache-Pfad. Halten Si et duerch e bewäerten lokalen Späicherer oder Uploader fest, ier Dir eng Cloud-Dateireferenz späichert.
Wéi funktionéiert d'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.
Zesummehangend Guides
Fir Hëllef, sot eis, wéi en Plugin a Gerät Dir benotzt, d'Aktioun déi Dir probéiert hutt an wat geschitt ass. Benotzt e Beispill ouni perséinlech Daten. Deelt ni Ären Schlëssel oder privat Fichieren.