Täielik häälestusjuhend
Kõik, mida vajate rakenduse GoLocal! installimiseks, konfigureerimiseks ja kasutamiseks, et muuta rakendus Bubble.io mitmekeelseks.
Turvalised Bubble andmed, stabiilne kasutajaliidese tõlge ja selge mitmekeelne loogika
Värskendage Bubble pistikprogrammi Pluginad enne allolevate funktsioonide testimist. Projecti konfiguratsioon, tõlked ja arveldamine jäävad GoLocali projekti külge. Rakenduste arendajad ei pea skripti Bubble päisesse HTML kleepima ega säilitama; avaldatud pistikprogrammi versioon sisaldab toetatud käitusaega.
Redigeeritavad andmed jäävad puutumata
Tavalisi sisendeid, mitmerealisi sisendeid, redigeerijaid Quill ja muid contenteditable alasid ei tõlgita kasutaja tippimise ajal.
Korduvkasutatava sisu välistused
Kaitske kasutaja sisestatud andmebaasiväärtused ja korduvate rühmade lahtrid do_not_translate_selectors-ga dubleeritud HTML ID-de asemel.
Ohutu automaatne pöördotsing
Bubble SearchBox, rippmenüü, pärand MultiDropdown ja Select2 MultiDropdown suudavad võrrelda tõlgitud valikuid lähtekeele väärtustega.
Element GoLocal Query
Kasutage tavasisendi kohta ühte sõltumatut elementi GoLocal Query ainult siis, kui see sisend käivitab lähtekeelse tekstiotsingu, tingimuse või filtri API.
1 Installige pistikprogramm
GoLocal! on saadaval kujul tasuta pistikprogramm Bubble.io turul. Selle installimise eest ei maksa te midagi – pistikprogramm ise maksab 0 dollarit. Arveldamine kehtib ainult siis, kui ühendate selle API-võtmega projektiga GoLocal!.
Avage redaktor Bubble → vahekaart Pluginad.
Klõpsake "+ Lisa pistikprogramme" ja otsige "GoLocal" või "Auto Translator".
Installige GoLocal! — automaatne tõlkija. Kui see on juba installitud, värskendage seda uusimale avaldatud versioonile.
Lohistage element GoLocal! mis tahes lehele (tavaliselt korduvkasutatavale päisele). Element on nähtamatu.
2 Looge oma konto ja Project
Pistikprogrammi aktiveerimiseks vajate Võti API. API võtmed luuakse teie GoLocal! armatuurlaual projekti loomisel.
A 5-päevane tasuta prooviperiood käivitub automaatselt. Krediitkaarti pole vaja. Sinu Võti API genereeritakse kohe.
Kopeerige võti API – vajate seda Bubble pistikprogrammi seadistamisel.
myapp.bubbleapps.io, sisestage täpselt see.3 Konfigureerige plugin
Klõpsake elemendil GoLocal!. Vähemalt seatud üks väli:
Minimaalne nõutav seadistus:
api_key→ kleepige oma GoLocal! projektist võti APIVaid klahvi API abil laadib GoLocal! projekti konfiguratsiooni, kasutab külastaja brauserit või salvestatud vidinate valikut, tõlgib nähtava kasutajaliidese teksti ja näitab keelevahetust.
4 Plugina väljad — viide
api_keyNõutavTeie projekti võti API GoLocal! armatuurlaualt.
Domeeniga seotud – turvaline lisada kliendipoolsesse koodi.
source_languageValikulineTeie rakenduse algkeele kahetäheline kood. Näited: en, uk, de.
Tavaliselt jätke see tühjaks, kui lähtekeel on GoLocali projektis juba konfigureeritud. Määrake see ainult siis, kui peate tahtlikult projekti/töötaja väärtust alistama.
target_languageValikulineTavaliselt jätke see väli tühjaks. Vidin ja külastaja püsiv valik juhivad aktiivset keelt lehe laadimise ajal.
Kõvakodeeritud väärtus, näiteks fr sunnib seda keelt alati, kui element initsialiseerub ja võib külastaja valiku tühistada. Siduge dünaamiline väärtus ainult siis, kui teie rakendus Bubble omab tahtlikult keeleolekut ja annab igal lehel ühe stabiilse keelekoodi.
enabledValikulineMärkeruut, mis kontrollib, kas tõlge on aktiivne. Vaikimisi: kontrollitud.
show_widgetValikulineKuvage sisseehitatud keelevahetuse vidin. Vaikimisi: kontrollitud. Lülitage see välja ainult siis, kui teie rakendus Bubble pakub oma keelejuhtimisseadeid ja kõnesid switch_language.
widget_positionValikulineVidina asukoht: bottom-right (vaikimisi), bottom-left, top-right, top-left.
dataset_1ValikulineKiireks laadimiseks eeltõlgige oma Bubble andmebaas.
Struktureeritud vorming (soovitatav):
// Bubble seadistus:
Otsige tekstina (Kategooriad) :formaat
Sisu: {Selle kategooria pealkiri ; Selle kategooria nimi ; Selle kategooria keha}
Eraldaja: ,
// Lisage teine tüüp:
:append Otsige tekstina (ravib) :format
Sisu: {Selle ravi pealkiri ; Selle ravimi nimi ; See Cure'i retsept}
Eraldaja: ,
Väljad sees { } poolt eraldatud ; — plokid, mis on eraldatud ,. Vaata Andmekogumid üksikasjade saamiseks.
do_not_translate_idsValikulineKomaga eraldatud elementide ID-d mitte kunagi tõlkida. Rühma/konteineri ID määramine välistab kõik lapsed.
Näide: user-bio, code-block, brand-section
HTML ID-d peavad olema kordumatud. Ärge kasutage sama ID-d korduva rühma lahtrites; kasutage selle asemel klassiga do_not_translate_selectors.
do_not_translate_selectorsValikulineCSS-i valijad korduvkasutatava või korduva sisu jaoks, mis peab jääma täpselt nii nagu talletatud. Sobiv element ja kõik selle lapsed on välistatud.
Näited: .gl-user-content, [data-user-content], [id^="gl-user-content-"]
Soovitatav kasutaja sisestatud andmebaasi väärtuste ja korduvate rühmade jaoks. Klassi või ID-eesliite valija saab turvaliselt sobitada palju ridu ilma HTML ID-de duplikaate looma.
private_translate_idsValikulineElemendid, mis on tõlgitud aga tõlked pole globaalselt vahemällu salvestatud. Kasutage kasutajate andmete (nimed, aadressid) jaoks.
Näide: user-name, order-address
Kui sisu peab jääma täpselt selliseks, nagu kasutaja selle sisestas, ärge seda välja kasutage. Selle asemel välistage see do_not_translate_selectors-ga.
5 Andmekogud – teie Bubble andmebaasi tõlkimine
Enamik Bubble rakendusi kuvab andmeid andmebaasist. Ilma andmekogumiteta tõlgitakse dünaamiline sisu esimesel kuval, mis põhjustab nähtavat viivitust. Andmekogumid tõlgivad kõik jaoks ette kohene laadimine.
Vorming 1: struktureeritud – mitme väljaga üksuste jaoks (soovitatav)
Pakkige iga üksus sisse {}, eraldage väljad koos ; (semikoolon), kasuta , elementide vahel eraldajana.
// Bubble: Otsige tekstina (Kategooriad) :formaat
Sisu: {Selle kategooria pealkiri ; Selle kategooria nimi ; Selle kategooria keha}
Eraldaja: ,
// Lisa: otsige tekstina (Ravib) :format
Sisu: {Selle ravi pealkiri ; Selle ravimi nimi ; See Cure'i retsept}
Eraldaja: ,
// Tulemus: {Tervis, heaolu, juhend...},{Ilu;nahahooldus;rutiinid...},{Aspiriin; Leevendus; Võtke 2x...}
{} poolt jagatud ; — jagatud plokid , — komad teie tekstis on ohutud.Vorming 2: Lihtne – ühe väärtusega loendite jaoks
Lühike väärtused ilma komadeta (kategooriate nimed, sildid):
Sisu: Selle kategooria nimi Eraldaja: ,
// Väljund: elektroonika, rõivad, raamatud, mänguasjad
Tähtis: Kui tekst võib sisaldada komasid, kasutage alati struktureeritud vormingut {field;field} pakkimine.
normalized_query ainult filtris või seisukorras. Vaadake täielikku Bubble juhendit.6 Bubble Osariigid, sündmused ja toimingud
Põhielement GoLocal! omab lehe tõlget ja paljastab aktiivse keele Bubble. Kasutage selle olekuid tingimustes ja sündmustes, et käivitada töövood tõlke elutsükli õiges punktis.
1. Tööaeg on valmis
translator_ready = yes tähendab, et GoLocal on lähtestatud. See ei tähenda, et kõik dünaamilised Bubble-elemendid on tõlkimise lõpetanud.
2. Keel muudetud
language_changed süttib aktiivse keele muutumisel. Lugege current_language siin.
3. Läbitud
translation_complete käivitub pärast tõlkepartii valmimist. Dünaamiline sisu võib luua hilisemaid partiisid.
current_languagetextAktiivne kahetäheline keelekood. Kasutage seda PDF-linkide, Bubble tingimustingimuste ja rakendusele kuuluva keele kasutajaliidese jaoks.
detected_languagetextTuvastatud lähte-/brauseri keel, millest käitusaeg teatab.
translator_readyyes/noJah pärast tõlke käitusaja lähtestamist.
is_translatingyes/noJah, kui GoLocal töötleb tõlkepääse.
translation_completeyes/noViimase läbimise lõpetamise lipp.
total_textsnumberPraeguses käitusaja seansis vaadeldud tekstiüksuste arv.
cached_local / cached_bundle / cached_servernumberDiagnostika vahemälu loendurid. Kasulik toe ja jõudluse kontrollimiseks.
tõlgitud / vead / tokens_usednumberKestusaegne tõlge ja vealoendurid.
last_error / preload_statustextViimane käitusaegne viga ja diagnostika eellaadimise olek.
Elementide toimingud
switch_language— lülituge nõutavale toiminguväljaletarget_langnäiteksfr.Start_translation— alustada või jätkata vaatlemist ja tõlkimist.Stop_translation— lõpetage vaatlemine ja tõlkimine kuni taaskäivitamiseni.rescan_dom— pärast Bubble hüpikakent, korduvkasutatavat elementi või korduva rühma värskendust renderdatud sisu selgesõnaline skannimine.
Näide: näita prantsuskeelset PDF-i linki
Looge lingile või rühmale tingimus Bubble: When GoLocal! A's current_language is "fr". Kui töövoog peab käima, kui külastaja keelt vahetab, kasutage When GoLocal! A language_changed. Sa ei pea ootama translation_complete ainult selleks, et lugeda valitud keelt.
7 Kasutajaandmed, vormid ja korduvad rühmad
GoLocal tõlgib liidese teksti, kuid teie kasutajate sisestatud või loodud andmed peavad jääma stabiilseks. Praegune käitusaeg kaitseb tavalisi sisendeid, mitmerealisi sisendeid, Quill redaktoreid ja muid contenteditable alasid, kui inimene tipib.
Vaikimisi turvaline
- • Sisend- ja mitmerealised sisendi väärtused salvestatakse täpselt nii, nagu need on sisestatud.
- • Quill
.ql-editorja muud redigeeritavad piirkonnad jäetakse tippimise ajal vahele. - • Meilid, paroolid, numbrid, kuupäevad, ID-d ja failid peaksid alati kasutama nende algseid Bubble väärtusi.
Ekraan vajab välistamist
Kui salvestatud kasutajasisu kuvatakse hiljem tavalise Bubble tekstielemendiga, ei saa GoLocal teada, kas tegemist on kasutajaliidese koopia või kasutajaandmetega. Märkige see kuvaelement või selle väikseim konteiner tõlkimiskeelutsooniks.
Soovitatav korduva rühma seadistamine
- 1. Valige ainult element Text, mis kuvab kasutaja sisu. Ärge välistage kogu korduvat rühma, kui selle nupud, pealkirjad ja staatilised sildid peaksid siiski tõlgima.
- 2. Andke igale reale kordumatu dünaamiline ID.gl-user-content-Praeguse lahtri asja kordumatu ID
- 3. Lisage GoLocali elemendile üks valija.do_not_translate_selectors = [id^="gl-user-content-"]
Kui teie Bubble seadistus või korduvkasutatav element saab rakendada kohandatud klassi, .gl-user-content on veelgi lihtsam. Lisage see klass üks kord do_not_translate_selectors.
Toetatud tõlkevabad markerid
Tööaeg austab data-tr-skip, data-no-translate, translate="no"ja pesastatud .notranslate elemendid. Konfigureeritud ID ja CSS-i valija väljad jäävad Bubble-i lihtsaimaks meetodiks.
Vahelejätmine versus eratõlge
do_not_translate_* säilitab algse väärtuse. private_translate_ids tõlgib siiski väärtuse, kuid takistab jagatud globaalset vahemälu. Kasutage privaatset tõlget ainult siis, kui sisu peaks olema tõeliselt tõlgitud.
home või check_box. Kui ikoon on tekstitaga, välistage väikseim ikoon/juhtkonteiner, et glüüfi märksõna kunagi ei tõlgitaks.8 Tõlkeredaktor ja käsitsi parandused
Kasutage tõlkeredaktorit fikseeritud tootekoopiate jaoks: navigeerimissildid, pealkirjad, nupud, abitekst ja muud fraasid, millel peaks olema üks üle vaadatud tõlge. Käsitsi sisestatud kirjed on lukustatud ja neid ei asendata hilisema automaatse tõlkega.
Hea käsitsi korrigeerimine
Allikas Uuendamise plaan → läbi vaadatud prantsuse tootefraas Améliorer le plan. See on stabiilne liidese koopia ja kuulub redaktorisse.
Ärge parandage kasutajaandmeid rea kaupa
Kliendi loodud nimi, näiteks Travail à domicile tuleks kuvaelemendil Bubble välja jätta. Tuhandete identiteedi tõlgete lisamine ei asenda tõlkekeelutsooni ohutult.
- 1. Avage projekt GoLocali armatuurlaual ja valige Tõlked.
- 2. Otsige täpset lähtefraasi ja keelepaari.
- 3. Muutke sihtväärtust või kasutage Lisa tõlge uue täpse lähtefraasi jaoks.
- 4. Salvesta. Kirje on märgitud manuaal, muutub komplekti versioon ja käitusaeg värskendab projektisõnastikku.
- 5. Katsetage uuesti täpset Bubble marsruuti, kus fraas esitatakse. Kasutage
rescan_domainult siis, kui fraas ilmub pärast ebatavalist kolmanda osapoole renderdust.
en → fr, mitte auto → fr. Käitusaeg taotleb projekti lahendatud allikapaari.9 Kuidas tõlkimine töötab
GoLocal jälgib renderdatud faili Bubble DOM, rakendab esmalt tõlked projektipaketist ja kohalikust vahemälust ning taotleb ainult puuduvaid või muudetud fraase. See jätkab hüpikakende, korduvkasutatavate elementide ja korduvate rühmade jälgimist, mida Bubble hiljem renderdab.
Lehe esialgne laadimine
Käitusaeg lahendab lähte- ja sihtkeeled, laadib praeguse projektipaketi, skannib nähtavat kasutajaliidese teksti ja avab lehe sisseehitatud virvendusvastase voo kaudu.
Vahemällu salvestatud tõlked
Tuntud fraase rakendatakse paketist või brauseri vahemälust ilma neid uuesti genereerimata. Muudetud komplekti versioon muudab aegunud vahemällu väärtused kehtetuks.
Dünaamiline Bubble sisu
Vaatleja DOM korjab üles äsja renderdatud hüpikaknad, korduvkasutatavad elemendid, tingimuslikult nähtavad rühmad ja korduvate rühmade lahtrid. rescan_dom on selge varu.
10 Tõrkeotsing ja vabastamistestimine
Leht lähtestatakse ühele keelele
Jätke target_language igal lehel tühjaks ja jätke korduvkasutatav GoLocal element, välja arvatud juhul, kui teie rakendus Bubble omab seda keelt tahtlikult. Initsialiseerimisel rakendatakse uuesti kõvakodeeritud väärtus.
Vidin on puudu
Kinnitage, et show_widget on märgitud, uusim pistikprogrammi versioon on installitud ja lehte juhib ainult üks kavandatud GoLocali element. Seejärel testige väljaspool Bubble samm-sammult silurirežiimi.
Hüpikaken või uus korduva rühma rida jääb tõlkimata
Oodake, kuni element muutub nähtavaks. Vaatleja leiab selle tavaliselt automaatselt; kui kolmanda osapoole element renderdub ebatavaliselt, käivitage pärast hüpikakna või rühma kuvamist rescan_dom.
Sisestus või rikastekst muutub sisestamise ajal
Värskendage pistikprogrammi, kinnitage praegune käitusaeg ja veenduge, et salvestamise töövoog loeks algset sisendi/redaktori väärtust, mitte tõlgitud kuvateksti ega normalized_query.
Kasutaja loodud prantsuskeelne tekst tõlgitakse uuesti
Välistage kuva tekst/konteiner do_not_translate_selectors kaudu. ProTuvastab väikseima dünaamilise väärtuse, mitte kogu selle ümber oleva staatilise kasutajaliidese.
Käsitsi korrigeerimine naaseb automaatseks
Praegused käsitsi sisestatud sisestused on lukustatud. Kinnitage, et redigeerisite sama lähteteksti ja täpset keelepaari, mida käitusaeg kasutas, seejärel saatke projekt, marsruut, fraas ja testiaeg toele.
Kuude/päevade nimed jäävad inglise keelde
Native brauser või Bubble kuupäevavalija Chrome järgib brauseri/juhtimislokaati. GoLocal tõlgib ümbritsevad sildid, kuid ei kirjuta ümber sisemise kuupäevavalija kasutajaliidese.
Chrome pakub oma lehe tõlget
Pistikprogramm märgib juba dokumendi brauseri tõlkimiseks mittetõlgitavaks, lubades samal ajal GoLocalil endal käitada. Värskendage pistikprogrammi; ärge lisage teist tõlkelaiendit ega skripti.
Tekst murtakse pärast tõlkimist erinevalt
GoLocal säilitab Bubble tüpograafia. Tõlgitud fraasid võivad olla pikemad, seega kontrollige Bubble minimaalset laiust, maksimaalset laiust, sobivuse kõrgust, ületäitumist ja reageerimisreegleid igas katkestuspunktis.
Bubble aktsepteerimise kontrollnimekiri
- ✓Vahetage allikat → sihtmärki → allikat ilma värskendamiseta.
- ✓Navigeerige kõigi Bubble lehtede ja korduvkasutatavate päiste vahel.
- ✓Avage hüpikaknad ja laadige pärast lehe laadimist korduvate rühmade read.
- ✓Tippige, kleepige, muutke, salvestage ja avage uuesti tavalised ja rikastekstiväljad.
- ✓Testige igas korduvas rühmas ühte välistatud kasutajaandmete väärtust.
- ✓Testige SearchBox, rippmenüü, pärand/Select2 MultiDropdown otsing.
- ✓Testige iga current_language tingimuslikku ja PDF-i/ressursi linki.
- ✓Testige uuesti Chrome, Safari, mobiililaiust ja privaatseanssi.
[GoLocal v4].11 Hinnakujundus& Arveldamine
Kolm plaani, kõik koos piiramatu arv tõlkesõnu ja piiramatu arv sihtkeeli.
| Funktsioon | Starter | Pro | Business |
|---|---|---|---|
| Kuu hind | $15/mo | $35/mo | $89/mo |
| Aastahind | $149/yr | $349/yr | $890/yr |
| Sihtkeeled | Piiramatu | Piiramatu | Piiramatu |
| MAU piirang | 30K | 150K | 1M |
| Projects | 1 | 1 | 2 |
MAU
Unikaalsed külastajad, kes nägid tõlkeid. Botid filtreeriti välja. 10% vanusest tasuta, siis 3/10 000 dollarit lisatasu.
Keeled
Kõik tasulised plaanid sisaldavad piiramatult sihtkeeli ilma täiendava keeletasuta.
5-päevane tasuta prooviperiood
Iga uus projekt algab tasuta prooviperioodiga. Krediitkaarti pole vaja.
12 Partner Program
Teenige raha, soovitades GoLocal!
Jagage oma soovituslinki – teenige korduvad komisjonitasud iga kaasavõetud maksva kliendi kohta.
Registreeruge partneriks
Armatuurlaud → vahekaart Partner → "Liitu partneriga Program". Hankige oma ainulaadne viitelink.
Jaga oma linki
Blogi, YouTube, Bubble foorum, sotsiaalmeedia, õpetused või otse koos klientidega.
Teeni komisjonitasusid
Korduv vahendustasu iga viidatud kasutaja tellimuse kehtivusaja jooksul.
Saage makse
Taotlege väljamakset pangaülekande või PayPali kaudu, kui saldo jõuab miinimumläveni.
Kas olete valmis muutma oma rakenduse mitmekeelseks?
Installige tasuta pistikprogramm, looge projekt, kleepige API võti – ja teie rakendus Bubble räägib igas keeles.