Tam Kurulum Kılavuzu
GoLocal!'yi yüklemek, yapılandırmak ve kullanmak için ihtiyacınız olan her şey Bubble.io uygulaması çok dilli.
Güvenli Bubble verileri, kararlı kullanıcı arayüzü çevirisi ve açık çok dilli mantık
Eklentiyi şuradan güncelleyin: Aşağıdaki özellikleri test etmeden önce Bubble'nin Eklentiler sekmesine bakın. Project yapılandırması, çevirileri ve faturalandırması GoLocal projesine bağlı kalır. Uygulama geliştiricilerinin Bubble'nin HTML Başlığına bir komut dosyası yapıştırması veya sürdürmesi gerekmez; yayınlanan eklenti sürümü desteklenen çalışma zamanını içerir.
Düzenlenebilir verilere dokunulmaz
Sıradan Girişler, Çok Satırlı Girişler, Quill düzenleyicileri ve diğer contenteditable alanları, kullanıcı yazarken ters çevrilmez.
Yeniden kullanılabilir içerik hariç tutmaları
Koruyun: yinelenen HTML kimlikleri yerine kullanıcı tarafından girilen veritabanı değerleri ve yinelenen grup hücreleri HTML kimlikleri.
Güvenli otomatik geriye doğru arama
Bubble SearchBox, Açılır Menü, eski MultiDropdown ve Select2 MultiDropdown, çevrilmiş seçenekleri kaynak dile göre eşleştirebilir değerler.
GoLocal Query öğesi
Sıradan Giriş başına bir bağımsız GoLocal Query öğesi kullanın, yalnızca bu Giriş bir kaynak dil metin aramasını, koşulunu veya API filtresini çalıştırdığında.
1 Eklentiyi Yükleyin
GoLocal!, GoLocal! pazarında ücretsiz bir eklenti olarak mevcuttur. Yüklemek için herhangi bir ödeme yapmazsınız; eklentinin maliyeti 0 ABD dolarıdır. Faturalandırma yalnızca onu bir API anahtarıyla bir GoLocal! projesine bağladığınızda geçerli olur.
Bubble düzenleyicisini → Eklentiler sekmesini açın.
"+ Eklenti ekle"yi tıklayın ve "GoLocal" veya "Otomatik Çevirmen"i arayın.
GoLocal! — Otomatik Çevirici'yi yükleyin. Zaten yüklüyse, yayınlanan en son sürüme güncelleyin.
GoLocal! öğesini herhangi bir sayfaya (genellikle yeniden kullanılabilir bir başlık) sürükleyin. Öğe görünmez.
2 Hesabınızı Oluşturun ve Project
Eklentiyi etkinleştirmek için şunları yapmanız gerekir: bir API anahtarı. API anahtarları, bir proje oluşturduğunuzda GoLocal! kontrol panelinizde oluşturulur.
A 5 günlük ücretsiz deneme otomatik olarak başlar. Kredi kartı gerekmez. API anahtarı adınız hemen oluşturulur.
API anahtarını kopyalayın; Bubble'de eklentiyi yapılandırırken buna ihtiyacınız olacak.
myapp.bubbleapps.ioüzerinde çalışıyorsa, tam olarak bunu girin.3 Eklentiyi Yapılandırın
GoLocal! öğesine tıklayın. En azından bir alan belirleyin:
Gerekli minimum kurulum:
api_key→ GoLocal! projenizden API anahtarını yapıştırınYalnızca API anahtarıyla, GoLocal! proje yapılandırmasını yükler, ziyaretçinin tarayıcısını veya kaydedilmiş widget seçimini kullanır, görünür kullanıcı arayüzü metnini çevirir ve dil değiştirici.
4 Eklenti Alanları — Referans
api_keyGerekliGoLocal! panosundaki projenizin API anahtarı.
Etki alanına bağlı — istemci tarafı koduna dahil etmek güvenlidir.
source_languageİsteğe bağlıUygulamanızın orijinal dilinin iki harfli kodu. Örnekler: en, uk, de.
Kaynak dil GoLocal projesinde zaten yapılandırılmışsa normalde bunu boş bırakın. Bunu yalnızca proje/Çalışan değerini kasıtlı olarak geçersiz kılmanız gerektiğinde ayarlayın.
target_languageİsteğe bağlıNormalde bu alanı boş bırakın. Widget ve ziyaretçinin kalıcı seçimi, sayfa yüklemelerinde etkin dili kontrol eder.
A hard-coded value such as fr gibi sabit kodlanmış bir değer, öğe başlatıldığında bu dili zorlar ve ziyaretçinin seçimini geçersiz kılabilir. Yalnızca Bubble uygulamanız kasıtlı olarak dil durumuna sahip olduğunda ve her sayfada tek bir sabit dil kodu sağladığında dinamik bir değer bağlayın.
enabledİsteğe bağlıÇevirinin etkin olup olmadığını kontrol eden onay kutusu. Varsayılan: işaretli.
show_widgetİsteğe bağlıYerleşik dil değiştirici widget'ını gösterir. Varsayılan: işaretli. Yalnızca Bubble uygulamanız kendi dil kontrollerini ve çağrılarını sağladığında kapatın switch_language.
widget_positionİsteğe bağlıWidget konumu: bottom-right (varsayılan), bottom-left, top-right, top-left.
dataset_1İsteğe bağlıAnında yükleme için Bubble veritabanınızı önceden çevirin.
Yapısal format (önerilen):
// Bubble kurulumu:
(Kategoriler) :format as text
İçerik: {Bu Kategorinin Başlığı ; Bu Kategorinin Adı; Bu Kategorinin Gövdesi}
Sınırlayıcı: ,
// Başka bir tür ekle:
:append (Cures) :format as text ifadesini arayın
İçerik: {Bu Tedavinin Başlığı ; Bu Tedavinin Adı; Bu Tedavinin Reçetesi}
Sınırlayıcı: ,
İçerdeki alanlar { } şunlarla ayrılmış ; — bloklar ,ile ayrılmıştır. Ayrıntılar için Veri kümeleri konusuna bakın.
do_not_translate_idsİsteğe bağlıAsla çevrilmeyecek virgülle ayrılmış öğe kimlikleri. Bir grup/kapsayıcı kimliğinin belirtilmesi tüm alt öğeleri hariç tutar.
Örnek: user-bio, code-block, brand-section
HTML kimlikleri benzersiz olmalıdır. Tekrarlanan grup hücrelerinde aynı kimliği yeniden kullanmayın; bunun yerine do_not_translate_selectors'yi bir sınıfla birlikte kullanın.
do_not_translate_selectorsİsteğe bağlıTam olarak depolandığı gibi kalması gereken yeniden kullanılabilir veya yinelenen içerik için CSS seçiciler. Eşleşen bir öğe ve onun tüm alt öğeleri hariç tutulur.
Örnekler: .gl-user-content, [data-user-content], [id^="gl-user-content-"]
Kullanıcı tarafından girilen veritabanı değerleri ve yinelenen gruplar için önerilir. Bir sınıf veya kimlik öneki seçici, yinelenen HTML kimlikleri oluşturmadan birçok satırı güvenli bir şekilde eşleştirebilir.
private_translate_idsİsteğe bağlıÇeviri çevrilen ancak çeviriler genel olarak önbelleğe alınmayanöğeler. Kullanıcı başına veriler (adlar, adresler) için kullanın.
Örnek: user-name, order-address
İçeriğin tam olarak kullanıcının girdiği gibi kalması gerekiyorsa bu alanı kullanmayın. Bunun yerine do_not_translate_selectors ile hariç tutun.
5 Veri Kümeleri — Bubble Veritabanınızı Çevirme
Çoğu Bubble uygulaması veritabanındaki verileri görüntüler. Veri kümeleri olmadığında dinamik içerik ilk görünümde çevrilir ve gözle görülür bir gecikmeye neden olur. Veri kümeleri, anında yükleme için.
Biçim 1: Yapılandırılmış — çok alanlı öğeler için (önerilen)
Her öğeyi {}içine sarın, alanları ; (noktalı virgül) ile ayırın, , arasında ayırıcı olarak kullanın öğeler.
// Bubble: (Categories) :format as text için bir arama yapın
İçerik: {Bu Kategorinin Başlığı ; Bu Kategorinin Adı; Bu Kategorinin Gövdesi}
Sınırlayıcı: ,
// Ekle: (Cures) :format as text için bir arama yapın
İçerik: {Bu Tedavinin Başlığı ; Bu Tedavinin Adı; Bu Tedavinin Reçetesi}
Sınırlayıcı: ,
// Sonuç: {Sağlık;Wellness;Kılavuz...},{Güzellik;Cilt Bakımı;Rutinler...},{Aspirin;Rahatlama;2x alın...}
{} bölünmüş ; — bloklar bölünmüş , — metninizdeki virgüller güvenlidir.Biçim 2: Basit — için tek değerli listeler
Virgül içermeyen kısa değerler için (kategori adları, etiketler):
İçerik: Bu Kategorinin Adı Sınırlayıcı: ,
// Çıktı: Elektronik,Giyim,Kitaplar,Oyuncaklar
Önemli: Metin virgül içeriyorsa her zaman yapılandırılmış biçimi kullanın {field;field} sarmalama ile.
normalized_query yalnızca filtre veya koşulda kullanın. Bubble kılavuzunun tamamına bakın.6 Bubble Durumlar, Etkinlikler ve Eylemler
Ana GoLocal! öğesi sayfa çevirisinin sahibidir ve aktif dili Bubble'ye sunar. İş akışlarını çeviri yaşam döngüsünün doğru noktasında başlatmak için koşullardaki durumlarını ve olaylarını kullanın.
1. Çalışma zamanına hazır
translator_ready = yes GoLocal'ın başlatıldığı anlamına gelir. Bu, her dinamik Bubble öğesinin çevrilmesinin tamamlandığı anlamına gelmez.
2. Dil değişti
language_changed etkin dil değiştiğinde etkinleşir. current_language Buradan okuyun.
3. Bir çeviri toplu işlemi tamamlandıktan sonra tamamlandı
translation_complete ateşlemelerini geç. Dinamik içerik daha sonraki gruplar oluşturabilir.
current_languagetextEtkin iki harfli dil kodu. PDF bağlantıları, Bubble koşulları ve uygulamaya ait dil kullanıcı arayüzü için kullanın.
detected_languagetextÇalışma zamanı tarafından bildirilen algılanan kaynak/tarayıcı dili.
translator_readyyes/noEvet, çeviri çalışma zamanı tamamlandıktan sonra başlatıldı.
is_translatingyes/noEvet, GoLocal bir çeviri geçişini işlerken.
translation_completeyes/noEn son geçiş için tamamlanma işareti.
total_textsnumberGeçerli çalışma zamanında gözlemlenen metin öğelerinin sayısı oturumu.
cached_local / cached_bundle / cached_servernumberTeşhis önbellek sayaçları. Destek ve performans kontrolleri için kullanışlıdır.
çevrildi / hatalar / tokens_usednumberÇalışma zamanı çevirisi ve hata sayaçları.
last_error / preload_statustextTeşhis için en son çalışma zamanı hatası ve önyükleme durumu.
Öğe eylemleri
switch_language— gerekli eylem alanına geçintarget_lang, örneğinfr.Start_translation— gözlemlemeyi ve çeviriyi başlatın veya devam ettirin.Stop_translation— durdur yeniden başlatılana kadar gözlemleme ve çeviri.rescan_dom— Bubble açılır penceresinden, yeniden kullanılabilir öğeden veya yinelenen grup güncellemesinden sonra oluşturulan içeriği açıkça tarayın.
Örnek: Fransızca bir PDF bağlantısı gösterin
Bağlantıda veya grupta bir Bubble koşulu oluşturun: When GoLocal! A's current_language is "fr". Ziyaretçi dili değiştirdiğinde bir iş akışının çalışması gerekiyorsa When GoLocal! A language_changedkullanın. translation_complete Sadece seçilen dili okumak için beklemenize gerek yoktur.
7 Kullanıcı Verileri, Formlar ve Tekrarlanan Gruplar
GoLocal arayüz metnini çevirir, ancak kullanıcılarınız tarafından yazılan veya oluşturulan verilerin sabit kalması gerekir. Geçerli çalışma zamanı, kişi yazarken sıradan Girişleri, Çok Satırlı Girişleri, Quill düzenleyicilerini ve diğer contenteditable alanları korur.
Varsayılan olarak güvenlidir
- • Giriş ve Çok Satırlı Giriş değerleri tam olarak yazıldığı gibi kaydedilir.
- • Quill
.ql-editorve diğer düzenlenebilir bölgeler, yazarken atlanır. yazarak. - • E-postalar, şifreler, sayılar, tarihler, kimlikler ve dosyalar her zaman orijinal Bubble değerlerini kullanmalıdır.
Görüntünün hariç tutulması gerekir
Kaydedilen kullanıcı içeriği daha sonra normal bir Bubble Metin öğesi tarafından görüntülendiğinde, GoLocal bunun kullanıcı arayüzü kopyası mı yoksa kullanıcı verisi mi olduğunu bilemez. Bu görüntüleme öğesini veya en küçük kapsayıcısını çevirisi olmayan bölge olarak işaretleyin.
Önerilen yinelenen grup kurulumu
- 1. Yalnızca kullanıcı içeriğini görüntüleyen Metin öğesini seçin. Düğmelerin, başlıkların ve statik etiketlerin hâlâ çevrilmesi gerekiyorsa yinelenen grubun tamamını hariç tutmayın.
- 2. Her satıra benzersiz bir dinamik kimlik verin.gl-user-content-Current hücresinin Thing'in benzersiz kimliği
- 3. GoLocal öğesine bir seçici ekleyin.do_not_translate_selectors = [id^="gl-user-content-"]
Bubble kurulumunuz veya yeniden kullanılabilir bir öğe özel bir sınıf uygulayabiliyorsa .gl-user-content daha da basittir. Bu sınıfı do_not_translate_selectors.
Desteklenen çeviri gerektirmeyen işaretçilere
Çalışma zamanı saygı gösterir data-tr-skip, data-no-translate, translate="no"ve iç içe .notranslate öğeler. Yapılandırılmış kimlik ve CSS seçici alanları, en kolay Bubble-yerel yöntem olmaya devam ediyor.
Özel çeviriye karşı atla
do_not_translate_* orijinal değeri korur. private_translate_ids değeri hâlâ çevirir ancak paylaşılan genel önbelleği engeller. Özel çeviriyi yalnızca içeriğin gerçekten çevrilmesi gerektiğinde kullanın.
home veya check_boxgibi gerçek glif adlarından oluşturulur. Bir simge metin destekliyse, en küçük simgeyi/kontrol kapsayıcısını hariç tutun, böylece glif anahtar sözcüğünün hiçbir zaman çevrilmemesi sağlanır.8 Çeviri Düzenleyici ve Manuel Düzeltmeler
Sabit ürün kopyası için Çeviri Düzenleyiciyi kullanın: gezinme etiketleri, başlıklar, düğmeler, yardım metni ve gözden geçirilmiş bir çeviriye sahip olması gereken diğer ifadeler. Manuel girişler kilitlenir ve daha sonra otomatik çeviri ile değiştirilmez.
İyi manuel düzeltme
Kaynak Yükseltme planı → gözden geçirilmiş Fransızca ürün ifadesi Améliorer le plan. Bu kararlı arayüz kopyasıdır ve düzenleyiciye aittir.
Kullanıcı verilerini satır satır düzeltmeyin
A customer-created name such as Travail à domicile gibi müşteri tarafından oluşturulan bir ad, Bubble görüntü öğesinde hariç tutulmalıdır. Binlerce kimlik çevirisi eklemek, çeviri yapılmayan bir bölgenin yerine güvenli bir alternatif değildir.
- 1. GoLocal kontrol panelinde projeyi açın ve Çeviriler.
- 2. Tam kaynak ifadeyi ve dil çiftini arayın.
- 3. Hedef değeri düzenleyin veya tam olarak yeni bir kaynak ifade için Çeviri Ekle seçeneğini kullanın.
- 4. Kaydet. Giriş işaretlendi manuel, paket sürümü değişir ve çalışma zamanı proje sözlüğünü yeniler.
- 5. İfadenin oluşturulduğu Bubble yolunu tam olarak yeniden test edin.
rescan_domYalnızca ifade alışılmadık bir üçüncü taraf oluşturma işleminden sonra görünüyorsa kullanın.
en → frolarak ekleyin, auto → frolarak değil. Çalışma zamanı, projenin çözümlenen kaynak çiftini ister.9 Çeviri Nasıl Çalışır?
GoLocal, oluşturulan Bubble DOM'yi izler, önce proje paketinden ve yerel önbellekten çevirileri uygular ve yalnızca eksik veya değiştirilmiş ifadeleri ister. Bubble'nin daha sonra oluşturduğu açılır pencereleri, yeniden kullanılabilir öğeleri ve yinelenen grupları gözlemlemeye devam eder.
İlk sayfa yükleme
Çalışma zamanı, kaynak ve hedef dilleri çözer, geçerli proje paketini yükler, görünür kullanıcı arayüzü metnini tarar ve yerleşik titreşim önleme akışı aracılığıyla sayfayı ortaya çıkarır.
Önbelleğe alınmış çeviriler
Bilinen ifadeler paketten veya tarayıcıdan uygulanır. yeniden oluşturmadan önbellek. Değiştirilen paket sürümü, eski önbelleğe alınmış değerleri geçersiz kılar.
Dinamik Bubble içeriği
DOM gözlemcisi, yeni oluşturulan açılır pencereleri, yeniden kullanılabilir öğeleri, koşullu olarak görünür grupları ve yinelenen grup hücrelerini alır. rescan_dom açık bir geri dönüştür.
10 Sorun Giderme ve Sürüm Testi
Sayfa tek bir dile sıfırlanır
Bubble uygulamanız bu dile kasıtlı olarak sahip olmadığı sürece target_language'yi her sayfada boş bırakın ve yeniden kullanılabilir GoLocal öğesini bırakın. Başlatma sırasında sabit kodlanmış bir değer yeniden uygulanır.
Widget eksik
show_widget'nin işaretlendiğini, en yeni eklenti sürümünün yüklendiğini ve sayfayı yalnızca amaçlanan bir GoLocal öğesinin kontrol ettiğini doğrulayın. Ardından Bubble adım adım hata ayıklayıcı modunun dışında test edin.
Bir açılır pencere veya yeni yinelenen grup satırı çevrilmeden kalır
Öğenin görünür hale gelmesini bekleyin. Gözlemci normalde bunu otomatik olarak bulur; üçüncü taraf bir öğe olağan dışı bir şekilde oluşturulursa, açılır pencere veya grup gösterildikten sonra rescan_dom'yi çalıştırın.
Yazarken giriş veya zengin metin değişiklikleri
Eklentiyi güncelleyin, geçerli çalışma zamanını onaylayın ve kaydetme iş akışının orijinal Giriş/düzenleyici değerini okuduğunu doğrulayın; çevrilmemiş ekran metni veya normalized_query.
Kullanıcı tarafından oluşturulan Fransızca metin çevrilir. tekrar
do_not_translate_selectors aracılığıyla ekran Metnini/kapsayıcısını hariç tutun. Proetrafındaki tüm statik kullanıcı arayüzlerini değil, en küçük dinamik değeri algılar.
Manuel düzeltme otomatiğe döner
Geçerli manuel girişler kilitlenir. Çalışma zamanı tarafından kullanılan aynı kaynak metni ve tam dil çiftini düzenlediğinizi doğrulayın, ardından projeyi, rotayı, ifadeyi ve test zamanını desteğe gönderin.
Ay/gün adları İngilizce kalır
Yerel tarayıcı veya Bubble tarih seçici kromu, tarayıcı/kontrol yerel ayarını takip eder. GoLocal çevredeki etiketleri çevirir ancak dahili tarih seçici kullanıcı arayüzünü yeniden yazmaz.
Chrome kendi sayfa çevirisini sunar
Eklenti, GoLocal'ın çalışmasına izin verirken, tarayıcı çevirisi için belgeyi zaten notranslate olarak işaretliyor. Eklentiyi güncelleyin; ikinci bir çeviri uzantısı veya komut dosyası eklemeyin.
Çeviriden sonra metin farklı şekilde sarılır
GoLocal, Bubble tipografisini korur. Çevrilmiş ifadeler daha uzun olabilir; bu nedenle her kesme noktasında Bubble minimum genişliği, maksimum genişliği, sığdırma yüksekliğini, taşmayı ve yanıt verme kurallarını doğrulayın.
Bubble kabul kontrol listesi
- ✓Yenilemeden kaynak → hedef → kaynak değiştirin.
- ✓Tüm Bubble sayfaları ve yeniden kullanılabilir başlıklar arasında gezinin.
- ✓Açılır pencereleri açın ve yükleyin. sayfa yüklendikten sonra yinelenen grup satırları.
- ✓Normal ve zengin metin alanlarını yazın, yapıştırın, düzenleyin, kaydedin ve yeniden açın.
- ✓Her yinelenen grup içinde hariç tutulan bir kullanıcı verisi değerini test edin.
- ✓SearchBox, Açılan, eski/Select2 MultiDropdown aramasını test edin.
- ✓Her current_language koşullu testini yapın ve PDF/kaynak bağlantısı.
- ✓Chrome, Safari, mobil genişliği ve özel oturumu yeniden test edin.
[GoLocal v4].11 Fiyatlandırmave Faturalandırma
Üç plan, tümü sınırsız çeviri kelimesi ve sınırsız hedef ile diller.
| Özellik | Starter | Pro | Business |
|---|---|---|---|
| Aylık fiyat | $15/mo | $35/mo | $89/mo |
| Yıllık fiyat | $149/yr | $349/yr | $890/yr |
| Hedef diller | Sınırsız | Sınırsız | Sınırsız |
| MAU sınırı | 30K | 150K | 1M |
| Pronesneler | 1 | 1 | 2 |
MAU
Çevirileri gören benzersiz ziyaretçiler. Botlar filtrelendi. %10 aşım ücretsiz, ardından 3/10.000 ABD doları ekstra.
Diller
Tüm ücretli planlar, dil başına ek ücret olmaksızın sınırsız hedef dil içerir.
5 Günlük Ücretsiz Deneme
Her yeni proje, ücretsiz bir denemeyle başlar. Kredi kartı gerekmez.
12 İş Ortağı Program
GoLocal!'yi önererek para kazanın
Yönlendirme bağlantınızı paylaşın — getirdiğiniz her ödeme yapan müşteri için yinelenen komisyonlar kazanın.
iş ortağı
Kontrol Paneli → İş Ortağı sekmesi → "İş Ortağı Program'a Katılın". Benzersiz yönlendirme bağlantınızı alın.
Bağlantınızı paylaşın
Blog, YouTube, Bubble forumu, sosyal medya, eğitimler veya doğrudan müşterilerle.
Komisyon kazanın
Yönlendirilen her kullanıcının aboneliği boyunca yinelenen komisyon.
Ödeme alın
Bakiye minimum eşiğe ulaştığında banka havalesi veya PayPal yoluyla ödeme isteğinde bulunun.
Uygulamanızı çok dilli hale getirmeye hazır mısınız?
Ücretsiz eklentiyi yükleyin, bir proje oluşturun, API anahtarınızı yapıştırın; Bubble uygulamanız her dili konuşur.