Getting started
Proxylang Rehberi
Proxylang nasıl kurulur, çeviriler nasıl iyileştirilir ve diğer dillerde nasıl bulunursunuz? Geliştirici materyalleri sonunda yer almaktadır.
Start here
Başlangıç
Yeni bir hesaptan çevrilmiş bir siteye kadar dört adım. Script etiketi varsayılan yöntemdir ve her platformda çalışır.
Dört adımda kur
Add your site
Kurulum'a gidin ve web sitesi adresinizi yazın. Çalıştığı platformu seçin.
Pick languages
Önce sitenizin kendi dilini, ardından eklemek istediğiniz dilleri seçin. Planınız kaç dil ekleyebileceğinizi belirler.
Install
Pick how the script tag gets onto your site. Let AI do it: paste our message into ChatGPT, Claude or Cursor. Do it yourself: copy one line and publish. Or send it to your developer: we write the email. WordPress sites use the plugin.
Check your site
Sihirbaz, scriptin yayında olduğunu onaylar. Sitenizde bir dil değiştirici görünür.
Platforma göre kurulum kılavuzları:
Proxylang bağlantısını seç
Script etiketi varsayılan yöntemdir ve her yerde çalışır. Diğer modlar, diğer dillerde arama motoru görünürlüğü sağlar. Modları daha sonra alan adının Kurulum sekmesinden değiştirebilirsiniz; geçiş yaptığınızda hiçbir şey çevrimdışı kalmaz.
Script tag
Arama motorları orijinal sitenizi okur.
Hybrid
Arama motorları çevrilmiş sayfaları alır.
DNS Proxy
Herkes çevrilmiş sayfaları görür.
Script tag
Her plan, her platform
Çeviri, ziyaretçinin tarayıcısında gerçekleşir. Arama motorları orijinal dilinizi görmeye devam eder.
En iyisi: Uygulamalar, giriş gerektiren sayfalar ve tüm site oluşturucular için.
WordPress plugin
WordPress sites
DNS ayarlarınıza dokunmadan scripti sizin için kurar; dile özel adresler, SEO etiketleri ve site haritaları ekler.
En iyisi: Herhangi bir WordPress veya WooCommerce sitesi için.
Hybrid
Lite planı ve üzeri, kodla oluşturulmuş siteler
Tek bir DNS değişikliği. Arama motorları Proxylang üzerinden çevrilmiş sayfaları görür. Ziyaretçiler script etiketini korur.
En iyisi: Diğer dillerde bulunmasını istediğiniz pazarlama siteleri için.
DNS Proxy
Pro plan ve üzeri, kodla oluşturulan siteler
Her ziyaretçi, /es-es/about gibi çevrilmiş adresler üzerinden Proxylang tarafından sağlanan çevrilmiş sayfaları görür.
En iyisi: Herkes için script gerektirmeden tam çevrilmiş URL'ler isteyen siteler için.
Sayfa çevirisini öğren
Script etiketi sayesinde sayfa sunucunuzdan her zamanki gibi yüklenir. Script daha sonra her cümlenin çevirisi için Proxylang ile iletişime geçer ve çeviriyi sayfaya yerleştirir. Bir sayfaya yapılan ilk ziyaret, siz izlerken çevrilir. Çeviri kaydedildiği için sonraki tüm ziyaretler anlıktır.
DNS Proxy veya Hibrit mod ile Proxylang, ziyaretçi (veya arama motoru) ile sunucunuz arasında konumlanır:
A visitor opens a translated address
yourdomain.com/es-es/pageProxylang, orijinal sayfayı sunucunuzdan getirir
Yapay zeka görünür metni çevirir
Düzen ve kod tam olarak olduğu gibi kalır.
Çevrilmiş sayfa kaydedilir ve sunulur
Bir sonraki ziyaretçi sayfaya anında erişir.
SEO tags are added
Dil bağlantıları, canonical adres ve daha fazlası.
Short addresses also work. /es/about and /mx/about both redirect to /es-es/about.
Sitenizde değişiklik olmazsa
- Open your site in a private window and use the language switcher. Your own browser may have a language remembered.
- Check the script is on every page, not only the home page. Your platform guide shows where it goes.
- Turn off ad blockers for a moment. Some block third-party scripts.
- Nothing at all, even after a refresh? Your site may have a Content Security Policy. See the developer section at the end of this guide.
İleri: Marka ve bağlam
Make translations better
Marka ve bağlamı ayarla
Çevirmene kim olduğunuzu söyleyin. Burada geçireceğiniz beş dakika, bu kılavuzdaki diğer her şeyden daha fazla kalite sağlar.
Neler doldurulmalı
- Brand Name. Your name in your site's language and in English. It is kept exactly as written in every language.
- Site Description. Two or three sentences: what you sell, who reads the site, the tone you want. Example: "Online shop for Korean skincare. Customers are women 25 to 40. Friendly, not formal." This also helps translate visitors' search queries.
- Landing Pages. Pick up to 20 pages (your home page, pricing) where headlines and calls to action should read like native marketing copy rather than a word-for-word translation.
- Translation Formality. Formal, casual or automatic. This one is chosen when you add the domain and cannot be changed later, because every saved translation depends on it.
Ne zaman yürürlüğe girer
Marka ve Bağlamı Kaydet butonuna tıklayın. Yeni çeviriler, bir saat içinde yeni bağlamı kullanmaya başlar. Halihazırda çevrilmiş olan metinler kelime seçimini korur. Bir sayfayı yeniden düzenlemek için Canlı Düzenleyici üzerinden tekil cümleleri düzeltebilirsiniz.
Sıradaki: Sözlük ve çevrilmeyecekler listesi
Sözlüğü ve çevrilmeyecekleri yönet
Her sayfa için bir kelimenin nasıl çevrileceğine bir kez karar verin.
Şartlarınız
- A term is a word or phrase in your site's language, its translation, and the language it applies to. Add one with Add Term . Tick case sensitive if "Apple" and "apple" should be treated differently.
- Terms apply everywhere the phrase appears. Up to 5,000 terms per domain.
- Have a list already? Use Import with a CSV file. Columns:
source_text, target_text, source_lang, target_lang, case_sensitive, notes. Export gives you the same format back. - Tick rows and click Delete Selected to remove many at once.
Timing
Yeni terimler yaklaşık on dakika içinde çeviri sunucularına ulaşır. Halihazırda çevrilmiş olan metinler, tekrar çevrilene kadar eski ifadelerini korur. Bir sayfayı kontrol etmek için, tarayıcınızın kayıtlı bir kopyayı göstermemesi adına sayfayı gizli bir pencerede açın.
Asla çevirme
Sözlüğün en üstündeki Hiçbir Zaman Çevirme kartı, her dilde tam olarak yazıldığı gibi kalması gereken kelimeleri tutar: markanız, bir ürün adı veya bir hashtag. Her biri 60 karakterden oluşan 100 girişe kadar desteklenir. Eşleştirme büyük/küçük harfe duyarlıdır, bu nedenle "iphone" değil, "iPhone" ekleyin.
Yapay zeka iyileştirmeleri
Proxylang sitenizdeki çevirileri belirli bir program dahilinde inceler ve küçük düzeltmeler önerir. Onaylanan düzeltmeler, nedeni ve değiştirdikleri kelimelerle birlikte sözlüğünüze AI olarak işaretlenmiş terimler olarak eklenir. Bunların herhangi birini silebilirsiniz.
- Turn the review off for a domain with the switch in the AI Improvements card. Terms already added stay until you delete them.
- A sentence you edited in the Live Editor is never changed by an AI improvement. Your edit wins.
Canlı Düzenleyici
Kendi sitenizdeki bir çeviriyi düzeltin: cümleye tıklayın, yazın ve kaydedin. Tüm planlara dahildir.
Bir çeviriyi düzenleyin
- Go to Live Editor , pick the domain and click Start editing . Your site opens in a new tab with the editor bar on it. Shortcut: on any page of your site, press Esc twice and click Open editor .
- Switch the site to the language you want to fix.
- Click any text. A panel shows the Original and the Translation . Change the translation and click Save .
- You see your change at once. Other visitors see it within about five minutes.
- Your edit always wins. Proxylang will not overwrite it, and neither will AI improvements.
- Changed your mind? Open the same text and click Reset to automatic translation .
- Some text has placeholders like
{0}for a link or bold word. Keep them in your translation, in any order. - Only verified domains you own appear in the Live Editor.
Bir çevirmen davet edin
Bir çevirmenin Proxylang hesabına ihtiyacı yoktur. Sitenizde oturum açarak çevirileri düzenleyebilirler, başka hiçbir şeyi yapamazlar.
- On the Live Editor page, find Invite a translator . Type their email.
- Under Can edit , leave All languages or pick only the languages they should touch.
- Click Send invite . A password appears once . Copy it now, or click Email them to open a ready-made email. Nothing is sent automatically.
- The translator opens your site, switches language, presses Esc twice and signs in with that email and password.
- To remove someone, hover their row in the translator list and click the ×. They are locked out at once.
- The editor bar and panels are available in English, Korean, Japanese, Spanish, German, French, Italian and Portuguese.
İleri: Çevrilecekleri kontrol edin
Çevrilecek içeriği kontrol et
Marka adlarını, kupon kodlarını ve incelemeleri orijinal dilde bırakın veya çeviriyi tamamen durdurun.
Bir içeriği orijinal dilinde tutun
Bazı metinler asla değişmemelidir: bir marka adı, bir kupon kodu, bir alıntı veya müşteriler tarafından yazılan incelemeler. Kod gerektirmeyen yöntemlerden kod gerektiren yöntemlere kadar üç aracınız var.
- A single word or name, everywhere. Add it to the Never Translate list in the glossary. No code.
- A block on a page. Add the
proxylang-no-translateclass to the element. Everything inside it is skipped. See below. - A whole file or region. Wrap it in the comment markers. See below.
Bir sınıf ile bloğu atlayın
Add the class proxylang-no-translate to any element. The attribute data-proxylang-no-translate does the same thing. Works in every mode.
<!-- Everything inside is left in the original language -->
<div class="proxylang-no-translate">
<h2>Brand Name™</h2>
<p>SAVE20 is your coupon code.</p>
</div>
<!-- The attribute form does the same -->
<span data-proxylang-no-translate>Acme Corp</span>Yorumlar ile bir bölgeyi atlayın
Bir sınıf ekleyemediğiniz durumlarda veya JavaScript dosyaları içindeki metinler için kullanışlıdır. İki işaretçi arasındaki her şey atlanır.
<!-- @proxylang-do-not-translate-start -->
<div class="testimonial">
Customer reviews stay exactly as written.
</div>
<!-- @proxylang-do-not-translate-end -->Sizin için atlandı
- Code samples inside
<pre>and<code>, in every mode. Syntax highlighters that render into those tags (Shiki, highlight.js, Prism) are covered. Code editors that render into a plain<div>(CodeMirror, Monaco) are not; add the class to their wrapper. <kbd>,<var>and<samp>when Proxylang translates on the server (DNS Proxy and Hybrid).- Legal pages at standard addresses. See the Legal pages section.
- Email addresses, URLs, numbers and prices.
Yalnızca arama motorları için atla
Bazen ziyaretçilerin içeriği çevrilmiş halde okumasını sağlarken, arama motorlarının orijinal ifadeyi (sıralama aldığınız bir slogan veya motto gibi) dizine eklemesini istersiniz. Bunun için yalnızca botlara özel işaretleyicileri kullanın. Bunlar yalnızca Proxylang sayfaları botlara sunduğunda, yani DNS Proxy ve Hybrid modunda geçerlidir. Sadece script etiketi üzerinde hiçbir işe yaramazlar.
<!-- Search engines index the original wording.
Visitors still see it translated. -->
<h2 class="proxylang-bot-only-no-translate">Our Brand Tagline</h2>
<!-- Attribute form -->
<p data-proxylang-bot-only-no-translate>Ranked slogan</p>
<!-- Comment form, for a larger region -->
<!-- @proxylang-bot-only-do-not-translate-start -->
<section>...</section>
<!-- @proxylang-bot-only-do-not-translate-end -->Her şeyi duraklatın
Alan adının Gelişmiş sekmesindeki iki anahtar, sitenizden hiçbir şeyi kaldırmadan yeni çevirileri durdurur. Halihazırda çevrilmiş olan metinler gösterilmeye devam eder.
- Pause Translations. Humans. Visitors see cached translations only. New pages stay in the original language. Use it while you look into a cost spike or a quality problem.
- Pause Translations. Bots. Same, for search engines and AI crawlers. Stops SEO spend without touching what visitors see.
- Also on that tab: Preserve Line Breaks keeps line breaks where the original has them. DNS Proxy mode only.
Yasal sayfalar
Gizlilik politikaları ve şartlar varsayılan olarak kendi dilinizde kalır.
Yasal sayfaları kendi dilinizde tutun
Bir sözleşmenin makine çevirisi mahkemede geçerli olmayabilir ve uzun bir hukuk sayfası, kelime bakiyenizin büyük bir kısmını boş yere tüketebilir. Bu nedenle Proxylang, siz aksini belirtmedikçe bu sayfaları atlar.
Herhangi bir kurulum yapılmadan atlanan sayfalar
Proxylang sayfa adresine göre işlem yapar. Aşağıdakiler her planda ve her modda atlanır:
/privacy,/privacy-policy,/cookie-policy,/cookies,/gdpr/terms,/tos,/terms-of-service,/terms-and-conditions,/legal,/eula/disclaimer,/dmca,/copyright,/refund,/refund-policy,/return-policy,/shipping-policy- German:
/agb,/datenschutz,/impressum,/nutzungsbedingungen
Sadece sayfanın ana metni atlanır. Üst bilgi, menü ve alt bilgi çevrilmeye devam eder, böylece ziyaretçileriniz yollarını bulmaya devam edebilir.
Diğer adreslerdeki hukuk sayfaları
If your legal page lives somewhere else (for example /about/policies), mark it yourself. Add the proxylang-no-translate class to the element that wraps the legal text. On a site builder, put the legal text in a code block or custom HTML element and add the class there.
<!-- Wrap the legal text, not the whole page -->
<main class="proxylang-no-translate">
<h1>Privacy Policy</h1>
<p>Last updated ...</p>
</main>Eğer çevrilmelerini istiyorsanız
Diğer dildeki versiyonu bir avukata veya sertifikalı bir tercümana hazırlatın, ardından bunu kendi sayfası olarak yayınlayın. Bir müşterinin imzalayabileceği veya itiraz edebileceği hiçbir şey için makine çevirisine güvenmeyin.
Sıradaki: Diğer dillerde SEO
Get found in search
Diğer dillerde SEO
Bulunan çevrilmiş sayfaları alın. Proxylang arama motorlarının aradığı etiketleri ekler ve takip etmeniz için size tek bir sayfa sunar.
SEO sayfası
SEO'yu açın ve bir site seçin. Lite plan veya üzeri gereklidir. Anahtar Kelimeler ve Sayfa Başlıkları sekmeleri için Hybrid veya DNS Proxy modu da gereklidir; çünkü sadece script etiketi kullanıldığında arama motorları çevrilmiş başlıkları asla göremez.
- Health
- A score from 0 to 100 and a to-do list. It checks that search engines can reach your translated pages, that the right tags are on them, and that setup is finished.
- Keywords
- Type up to 20 phrases your customers search for, in your own language. Proxylang writes a matching set for every language search engines index and uses them for your home page title and description. A language that joins them later gets its set shortly after you save, with no click. You can give a pricing or campaign page its own set.
- Page Titles & Descriptions
- See the title and description each language really shows in search results, and pin your own wording for any page. A pin is exact and final for that page and language. Too long? Click Shorten.
- Settings
- Bot translation budget, which pages go in the sitemap, and a switch to stop SEO tags while you test.
- Google Search Console. The Health checklist has a "Connect Google Search Console" step. It pulls Google's own indexing data into the Health tab. Available once Hybrid or DNS Proxy is on.
- Naver and Daum. If Korean is one of your languages, a card lists the four manual steps those engines need. Tick each one off as you go.
- AI answers. A second checklist covers listings that help ChatGPT, Gemini and Perplexity recommend you: Wikidata, Google Business Profile and, for software, G2 and Product Hunt.
Which languages search engines see
Your plan sets how many languages search engines index. Visitors can still pick every language you turn on. A language you add joins the indexed ones on its own while your plan has room. It goes into the sitemap and language links, and if you have saved keywords on the Keywords tab, it gets its own keywords and home page title written from them. To choose them yourself, use the search icon next to each language on the domain's Languages tab.
When every slot is taken, the Languages tab and the SEO Keywords tab name the languages search engines can't see. Swap one in for an indexed language, or upgrade for more.
Her çevrilmiş sayfaya eklenen etiketler
- Language links (hreflang) that tell search engines which page is which language.
- A canonical address per language, so translations are not seen as duplicates.
- The page's language tag, for Bing and Baidu.
- Social preview locale, so shared links show the right language.
Arama motorlarının sayfaları Proxylang üzerinden aldığı Hybrid ve DNS Proxy modlarında geçerlidir. Sadece script etiketi sayesinde orijinal sitenizi okurlar.
Show an example
<link rel="alternate" hreflang="en-US" href="https://example.com/page" />
<link rel="alternate" hreflang="es-ES" href="https://example.com/es-es/page" />
<link rel="alternate" hreflang="fr-FR" href="https://example.com/fr-fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />
<link rel="canonical" href="https://example.com/es-es/page" />
<meta property="og:locale" content="es_ES" />Başlıklar, açıklamalar ve görsel metinleri
Sayfa başlığı, meta açıklaması, sosyal önizleme başlığı ve açıklaması ile anahtar kelimeler çevrilir. Ayrıca görsel alt metinleri, buton ipuçları ve form yer tutucuları da çevrilir. Sayfa Başlıkları ve Açıklamaları sekmesinden herhangi bir sayfa için kendi ifadelerinizi sabitleyebilirsiniz.
Zengin sonuçlar
Sayfalarınız yapılandırılmış veri (Google'daki zengin sonuçları besleyen gizli ürün, makale, SSS veya etkinlik ayrıntıları) içeriyorsa, metin alanları çevrilir ve dil alanı güncellenir. Fiyatlar, tarihler, URL'ler ve tanımlayıcılar olduğu gibi bırakılır.
Site haritaları
Proxylang builds a sitemap per language and lists them all at /sitemap.xml on your domain. Pages come from your own sitemap, plus pages Proxylang has seen. Each language also has its own file, such as /es-es/sitemap.xml . They refresh daily, and right away when a language save changes which languages search engines see; click Regenerate sitemap on the SEO Settings tab to rebuild now.
Show an example
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap><loc>https://example.com/sitemap-1.xml</loc></sitemap>
<sitemap><loc>https://example.com/es-es/sitemap.xml</loc></sitemap>
<sitemap><loc>https://example.com/fr-fr/sitemap.xml</loc></sitemap>
</sitemapindex>Site haritasında hangi sayfaların yer alacağını seçin
SEO Ayarları sekmesinde, Site Haritası Sayfaları altında:
- All pages. The default.
- Only specific paths. Start with a few pages, add more later.
- Exclude paths. Hide a section, such as
/internal/*.
One path per line. * matches anything, so /blog/* covers every blog post. The home page is always included. Subdomains use their root domain's setting.
Arama motorlarını yeni sayfalardan haberdar etme
- Bing, Yandex, Naver, Seznam and Yep are told the moment a translated page is saved. DuckDuckGo, Ecosia and Qwant use Bing's index. Nothing to set up.
- Google does not take pings. It finds your pages through the sitemap and the language links. Connecting Search Console lets you watch it happen.
- Your
robots.txtis served with the sitemap lines added. Your own rules are kept.
Yapay zeka arama motorları
robots.txtallows GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot and Google-Extended.- A
/llms.txtfile describes your site and lists its languages and sitemaps for AI tools that look for one. - AI bots get translated pages only in Hybrid or DNS Proxy mode. They are counted under the bot budget like any other crawler.
Her adreste dil seçeneği
In DNS Proxy mode, visitors normally see clean addresses and their language is remembered in a cookie. Turn on URL Language Prefix (domain → Advanced tab) and every visitor sees the language in the address, like /es-es/about . Search results, ads and analytics then always point at one clear version of each page.
Yalnızca DNS Proxy modu. Alt alan adları kök alan adlarını takip eder.
Hibrit mod (Arama motorları için SEO)
Arama motorları Proxylang üzerinden çevrilmiş sayfaları alırken, ziyaretçileriniz script etiketini kullanmaya devam eder.
Ne işe yarar
Script etiketi, sayfaları ziyaretçinin tarayıcısında çevirir. Arama motorları bu scripti çalıştırmadığı için sadece orijinal dilinizi görürler. Hibrit mod bu sorunu çözer.
Arama motorları ve yapay zeka botları
Proxylang ile tamamen çevrilmiş bir sayfa elde edin. Google, Bing, Naver, ChatGPT, Perplexity ve bağlantı önizlemeleri (Slack, LinkedIn, Facebook) bu listededir.
Your visitors
Sitenizi, script etiketi tarafından çevrilmiş halde tam olarak bugünkü haliyle alın. Barındırma, analitik ve A/B testleriniz olduğu gibi kalır.
Wix, Squarespace, Webflow ve benzeri oluşturuculardaki siteler bu şekilde DNS değiştiremez, bu nedenle script etiketinde kalırlar.
Nasıl etkinleştirilir
"Hibrit" şeklinde bir anahtar bulunmamaktadır. Hibrit, aynı alan adı için hem DNS Proxy hem de Script Tag açık olduğunda elde edilen moddur.
Alan adınızı açın, ardından Kurulum sekmesine gidin
Alan Adları → alan adınız → Kurulum.
Turn on DNS Proxy
Alan adı tescil firmanızda gösterdiğimiz DNS kayıtlarını ekleyin ve ardından doğrulayın. Bu adım, arama motorlarının Proxylang adresine ulaşmasını sağlar.
Keep Script Tag on
Ziyaretçileriniz halihazırda yüklemiş olduğunuz script tag'i kullanmaya devam eder.
Done
Her ikisi de açık olduğunda, alan adı rozetinde "Hibrit (SEO)" yazar. Herhangi birini kapattığınızda, site kesinti yaşanmadan diğer moda geri döner.
Maliyet nedir
Bot ziyaretleri, normal oranın dörtte biri hızında bakiyenizdeki kelimeleri kullanır. Üç farklı limit, kontrolsüz taramaların bakiyenizi tüketmesini engeller. Her birini SEO sayfasındaki Ayarlar altından düşürebilirsiniz.
Botlar için günlük kelime sayısı
Sınıra ulaşıldığında, botlar UTC saatine göre gece yarısına kadar orijinal dilinizi kullanır. Bot çevirisini tamamen durdurmak için bu değeri 0 olarak ayarlayın.
- Start
- 3,000
- Pro+
- 20,000
Budget per page
Bir bot ziyaretinin bir sayfanın ne kadarını AI token'ı (kelime başına yaklaşık 2,7) cinsinden çevirebileceğini belirler. Varsayılan 4.000'dir. Başlık, açıklama ve alt başlıklar hiçbir zaman sayılmaz.
- Start
- 8,000
- Pro+
- 50,000
Günlük ziyaret sayısı, doğrulanmamış botlar
Google, Bing, Apple, DuckDuckGo ve Yandex ağ adresleri üzerinden doğrulanır ve sınırlandırılmaz. Diğer her şey bu sınırı paylaşır.
- Start
- 5
- Pro+
- 10
Ne zaman kullanılır
- You want your pages to rank in other languages.
- You want AI search tools to quote your translated pages.
- You do not want Proxylang in the path of real visitors. Hybrid keeps them on your own server.
Giriş gerektiren sayfalar Hybrid modelinden hiçbir fayda sağlamaz. Bunları script etiketinde tutun.
Sıradaki: Çoklu site ve alt alan adları
Çoklu site ve alt alan adları
Start ve üzeri planlarda ücretsiz alt alan adları ve daha fazla kök alan adı ekleyin. Tüm siteler tek bir kelime bakiyesini paylaşır.
Neler ekleyebilirsiniz
- Subdomains of a site you already added (app.yourdomain.com, shop.yourdomain.com). Free on every plan. They do not count toward your domain limit.
- Separate root domains (yourdomain.com and yourapp.io). Needs the Start plan or above, which carries as many as you like. Test Drive and Lite cover one site.
Tüm siteleriniz tek bir kelime bakiyesini paylaşır. İkinci bir site kelime eklemez; aynı havuzdan kullanır.
Daha sonra daha küçük bir plana geçerseniz hiçbir şey çevrimdışı olmaz. Halihazırda eklediğiniz her siteyi korursunuz. Sadece tekrar limitin altına inene kadar daha fazla site ekleyemezsiniz.
Alt alan adının devraldıkları
Bir alt alan adı, kök alan adını takip eder. Aynı bağlantı modunu, dilleri, site haritası ayarlarını ve Gelişmiş sekmesi anahtarlarını alır. Bunları kök alan adında bir kez ayarlarsınız.
Kök alan adı DNS Proxy veya Hibrit mod kullanıyorsa, her alt alan adının da kendi DNS kayıtlarına ihtiyacı vardır. Uygulama, eklenmesi gereken tam kayıtları gösterir: bir kök alan adı için dört kayıt (yalın alan adı, www ve iki doğrulama kaydı), bir alt alan adı için iki kayıt.
Hangi site için hangi mod
Pazarlama sitesi veya açılış sayfası
Hybrid mode
Diğer dillerde bulunmasını istersiniz. Planınız ve siteniz izin veriyorsa Hybrid kullanın (Lite planı veya üzeri, kodla oluşturulmuş site). Aksi takdirde, script etiketi ziyaretçiler için çeviriyi yapmaya devam eder.
Uygulama veya müşteri portalı
Script tag
Giriş gerektiren sayfalar asla dizine eklenmez, bu nedenle peşinden koşulacak bir arama avantajı yoktur. DNS değişikliği gerekmez, trafik yolunda hiçbir değişiklik olmaz.
Features
Canlı Sohbet
Her iki yöne de çeviri yapan bir sohbet balonu. Tek abonelik, her site, sınırsız temsilci.
Ne işe yarar
Sitenizde bir sohbet balonu. Ziyaretçiler kendi dillerinde yazar. Siz kendi dilinizde okur ve cevaplarsınız. Her iki taraf da anlık olarak çevrilir. Tek bir abonelik, hesabınızdaki her siteyi kapsar ve dilediğiniz kadar temsilci ekleyebilirsiniz.
Etkinleştir
Alan adını açın, Canlı Sohbet sekmesine gidin ve anahtarı çevirin. Baloncuk sitenizde görünür ve site, Chat panelinizde Chat olarak görünür.
- On Start and above, chat is already included with your plan. Nothing to buy and no trial to start.
- On Test Drive and Lite, every account gets one 14-day trial with 2,000 translated messages. No card needed. The trial is per account, not per site.
- When nobody is online, visitors see "We are away" and can leave their email. You answer by email from the console. Turn this off in widget settings if you prefer.
Ekibinizi ekleyin
- On the Live Chat tab, in the Agents card, type a teammate's email and click Invite . Seats are free and unlimited.
- They get a link, good for seven days. They enter the name visitors will see and the language they want to read chats in.
- They see that site's conversations only, marked "Shared". No settings, no billing.
Birini, kendi satırındaki Kaldır butonuyla kaldırın.
Sohbetleri yanıtlama
- The console has three panes: conversations, the open chat, and visitor details (page they are on, country, past chats).
- Having the console open makes you "Online". Click the pill to go "Away"; visitors then get the offline form.
- Type
/in the reply box for quick replies (hello, order, refund, shipping). - You can send images up to 10 MB. Edit a sent message and the visitor's translation is redone.
- If a teammate is already answering, your reply box locks so the visitor never gets two answers.
- Under Chat settings → Widget , set the bubble colour, position, greeting and the name visitors see. The greeting is shown as written and is not translated yet.
Masaüstü ve mobil uygulamalar
The Downloads page has the desktop app for macOS, Windows and Linux. It gives you alerts and unread badges with the browser closed, and updates itself. iPhone and Android apps are listed as coming soon.
Oturum açtığınızda normal tarayıcınız bir anlığına açılır ve ardından uygulamaya geri döner. Bu beklenen bir durumdur.
Her planın içeriği
Yalnızca çevrilen mesajlar sayılır. Aynı dildeki mesajlar ücretsizdir. Aylık kota siteleriniz arasında paylaşılır ve her ayın 1'inde sıfırlanır.
- Test Drive and Lite include no chat plan beyond the trial. Bigger chat plans are a monthly add-on, priced on the Live Chat page.
- At the limit, chat keeps running but messages arrive untranslated and new conversations wait until the 1st. A chat already in progress always finishes.
- Hiding the "Powered by Proxylang" line in the chat window needs the Pro plan or above.
İleri: Görsel çevirisi
Görsel çevirisi
Bannerların ve ürün görsellerinin içindeki metni ziyaretçinin dilinde yeniden çizin.
Kurulum
1. Buy credits
Image translation is on for every domain. Your credit balance is the only gate. Buy a pack from Billing . Packs are valid for 12 months.
- 10 images
- $5 / ₩7,000
- $0.50 per image
- 50 images
- $20 / ₩28,000
- $0.40 per image
- 100 images
- $35 / ₩49,000
- $0.35 per image
2. Çevrilecek görselleri seçin
Sadece seçtiğiniz görseller çevrilir. Üç yöntem, en kolayı en başta:
- Live Editor. Open your site, press Escape twice, sign in, click Image Translation in the editor bar and tap the images. Works on any platform.
- Paste image addresses. On the domain's Image Translations tab, use Auto-Translate Images by URL . Good for site builders where you cannot edit HTML.
- Tag the HTML. Add
data-pl-translate-imageto the image tag.
<!-- Only tagged images are translated -->
<img src="/hero-banner.png" data-pl-translate-image alt="Welcome" />
<!-- Any image source works -->
<img src="https://cdn.example.com/promo.jpg" data-pl-translate-image />Neler oluyor ve maliyeti nedir
- The first visitor in a language sees the original image. Translation runs in the background, usually under two minutes, then the translated image replaces it on the page without a refresh.
- Every visitor after that gets the translated image instantly. It is kept forever.
- One credit per image, per language. The same banner in Korean and Japanese costs two credits.
- Images whose longer side is over 2000px cost two credits per language. Tall product detail images usually fall in this group.
- Visitors reading your site in its own language never use credits.
Her modda çalışır. "Resim adreslerini yapıştır" yöntemiyle eşleştirme ziyaretçinin tarayıcısında gerçekleştirilir, bu nedenle script etiketi (script etiketi veya Hibrit mod) gereklidir.
Neler çevrilmeli
Translate these
- Banners with text on them
- Infographics and charts with labels
- Product images with printed details
- Screenshots with on-screen text
Bunları etiketlemeyin (ücretlendirilmeye devam eder)
- Photos with no text
- Logos and icons
- SVG files and GIFs
PNG, JPG ve WebP formatları desteklenmektedir. Çok büyük dosyalar çeviri öncesinde ölçeklendirilir. 33 hedef dil desteklenmektedir; listeye alan adının Görsel Çevirileri sekmesinden ulaşabilirsiniz.
İleri: Arama çevirisi
Arama çevirisi
Ziyaretçilerin arama kutusuna yazdıklarını çevirin, böylece her dilde sonuç alabilirler.
Kurulum
1. Buy searches
Paid with prepaid search credits. Buy a pack from Billing . Packs never expire.
- 10,000 searches
- $9.99 / ₩13,900
- 50,000 searches
- $39.99 / ₩55,900
- 200,000 searches
- $139.99 / ₩194,000
2. Alan adına göre aç
Open the domain, go to the Advanced tab and switch on Translate Search Queries . The switch stays off until you have credits. It can take up to five minutes to reach your live site, so wait before testing.
Nasıl çalışır
If your search box is a normal form, or its field is named q, query, search, keyword, term or s, it works with no changes. When the visitor presses Enter, Proxylang translates the query and your search receives the translated text.
<form action="/search" method="GET">
<input type="search" name="q" />
<button type="submit">Search</button>
</form>- Runs from the script tag, so it works in script tag and Hybrid mode. Not on DNS Proxy-only sites.
- Visitors reading your site in its own language are not affected and use no credits.
- Each search uses one credit, including repeats. Translated queries are remembered per domain, so repeats are instant.
- If translation takes longer than 4.5 seconds, the original query is sent through instead. Visitors never wait on a spinner.
Sayfadaki listeyi filtreleyen arama kutuları
Bazı arama kutuları sunucuya hiçbir şey göndermez. Sayfada halihazırda bulunan bir listeyi (bir SSS veya ürün ızgarası gibi) filtrelerler. Bunlar için input üzerinde bir öznitelik gereklidir:
<!-- Translate when the visitor presses Enter (default) -->
<input type="text" placeholder="Search..." data-proxylang-reverse-search />
<!-- Translate as they type, after a short pause -->
<input type="text" placeholder="Search..." data-proxylang-reverse-search="live" /> By default the query is translated when the visitor presses Enter. Add ="live" to translate as they type, after a short pause. Live mode uses more credits, one per pause.
Bağlam ile çeviriye yardımcı olun
A one-word query can mean many things. Proxylang uses the Site Description from your Brand & Context tab to pick the right meaning. For one specific search box you can override it with data-proxylang-search-context="..." on the input (up to 240 characters).
İpuçları
- Keep Enter mode unless your search really needs results while typing. It costs a fraction of live mode.
- Write a clear Site Description. "Korean skincare shop" gives better query translations than "our website".
- Test in a private window with the site switched to another language.
Bilinen sınırlar
- Queries over 200 characters are passed through untranslated.
- When credits reach zero, searches pass through untranslated. Buying a pack turns it back on within a minute.
- For developers: searches sent by
form.submit()in code are not intercepted; use a normal submit. For fetch requests, only the query parameters and top-level JSON fields are translated. GraphQL requests are skipped.
Sonraki: Dil değiştirici görünümü
Dil değiştirici görünümünü ayarla
Ziyaretçilerin gördüğü dil menüsü hakkında her şey: konumu, görünümü ve ne zaman göründüğü.
Neleri değiştirebilirsiniz
- Activate Switcher
- The on/off switch for the widget on this site. Also holds a test key for trying the script on your own computer.
- Layout
- Floating in a corner, or inline where you place it. Starting corner. Whether visitors can drag it.
- Appearance
- Button size, menu size, corner shape, shadow, and whether languages show as "EN", "English" or both.
- Colors
- Six ready-made themes, or your own colours for light and dark mode.
- Behavior
- Shrink to an icon after a few seconds, menu animation, and a soft fade when translated text appears.
- Branding
- Hide the "Translation by Proxylang" line in the menu. Start plan and above.
- Loading Indicators
- A spinner, a thin bar at the top, both, or nothing while a page translates.
- Dark Mode Detection
- Follow the visitor's system setting, or tell Proxylang which CSS class your site uses for dark mode.
- Advanced
- Stacking order, the width at which the mobile layout kicks in, and the right-to-left auto-flip switch.
Değişiklikler saniyeler içinde, en geç beş dakika içinde sitenize ulaşır. Eğer görmezseniz sayfayı yenileyin.
Ziyaretçinin ilk göreceği dil
Ayarlanacak bir şey yok. İlk ziyarette Proxylang, ziyaretçinin tarayıcısının tercih ettiği dillere bakar ve etkinleştirdiğiniz diller arasından en iyi eşleşmeyi seçer. Hiçbiri eşleşmezse, ziyaretçinin ülkesini ve ardından sitenizin kendi dilini kullanır. Bundan sonra, ziyaretçinin seçimi bir yıl boyunca hatırlanır.
To test another language, open your site in a private window, or add ?lang=ko-KR to the address.
Dil değiştiriciyi kendi menünüze ekleyin
Under Layout, choose Inline and place <div id="proxylang-widget"></div> where the switcher should appear, for example in your header. For a second spot in a mobile menu, add <div id="proxylang-widget-mobile"></div> as well.
Sıradaki: Analitik ve kullanım
Your account
Analiz ve kullanım
Kimin hangi dilde ziyaret ettiğini ve kelimelerinizin nereye gittiğini görün.
Kimin, hangi dilde ziyaret ettiği
Panelinizdeki Analizler sekmesi; ziyaretçileri, ziyaretleri, sayfaları, insanların nereden geldiğini, ülkelerini ve cihazlarını ve çevrilmiş bir sürümü okuyanların oranını gösterir. Çerez kullanılmaz; ziyaretçiler, bir adrese geri döndürülemeyen karmaşıklaştırılmış bir parmak izinden sayılır.
- A visit ends after 30 minutes without activity.
- Bots are hidden by default, and so is your own traffic from a development machine. Use the Filter button to show them.
- Detailed records are kept for 90 days.
- The Visitor Map shows the same data on a world map.
Kelimelerinizin nereye ulaştığı
Panel sekmesi, planınızın ne kadarını kullandığınızı gösterir. Metrikler ve Sayfalar sekmeleri ise bunu gün, dil ve sayfa bazında detaylandırır.
- A sentence costs words once, the first time it is translated for your site. Showing it again is free.
- Bot visits in Hybrid and DNS Proxy mode count at a quarter of the rate. The chart shows "Visitor words" and "Bot words" separately.
- A page view is one page opened by a real visitor in a translated language. Bots, visitors reading the original language, and your own testing on localhost do not count.
- You get an email at 75%, 90% and 100% of your allowance.
Sonraki: Planlar, faturalandırma ve krediler
Planlar, faturalandırma ve krediler
Her planın neleri kapsadığı, limitlere ulaşıldığında ne olacağı ve kredi ile kodların nasıl çalıştığı hakkında bilgiler.
Bir planın size sundukları
Her planın bir kelime kotası, aylık sayfa görüntüleme kotası, bir dil sayısı ve bir site sayısı vardır. Kelime kotası aylık bir miktar değil, toplam bir miktardır: bir cümle sadece ilk kez çevrildiğinde sayılır ve sonrasında çevrilmiş olarak kalır. Her dil ayrı ayrı sayılır: üç dilde açılan 500 kelimelik bir sayfa 1.500 kelime kullanır. Start ve üzeri planlarda ziyaretçiler 77 dilden herhangi birini seçebilir ve plan, bunlardan kaçının arama motorları tarafından dizine ekleneceğini belirler. Tarayıcılar dizine eklenen her dili çeker, bu nedenle bu diller bir ziyaretçi olmasa bile kelime kotasından harcar.
Kelimeler: bir kez dolan toplam miktar
Sayfa görüntüleme: her ayın 1'inde sıfırlanır
| Plan | Words (total) | Page views / month | Languages | Sites |
|---|---|---|---|---|
| Test Drive | 2,000 | 1,500 | 1 | 1 |
| Lite | 20,000 | 15,000 | 5 | 1 |
| Start | 100,000 | 50,000 | All 77 (3 indexed) | Unlimited |
| Pro | 500,000 | 150,000 | All 77 (10 indexed) | Unlimited |
| Business | 2,500,000 | 750,000 | All 77 (25 indexed) | Unlimited |
Test Drive
- Words (total)
- 2,000
- Page views / month
- 1,500
- Languages
- 1
- Sites
- 1
Lite
- Words (total)
- 20,000
- Page views / month
- 15,000
- Languages
- 5
- Sites
- 1
Start
- Words (total)
- 100,000
- Page views / month
- 50,000
- Languages
- All 77 (3 indexed)
- Sites
- Unlimited
Pro
- Words (total)
- 500,000
- Page views / month
- 150,000
- Languages
- All 77 (10 indexed)
- Sites
- Unlimited
Business
- Words (total)
- 2,500,000
- Page views / month
- 750,000
- Languages
- All 77 (25 indexed)
- Sites
- Unlimited
- Global, Enterprise and Custom plans are arranged through the Custom card on the pricing page.
- Lite and above add per-language SEO and Hybrid mode. Pro and above add DNS Proxy mode.
- Words used up. New text stays in the original language until you upgrade. Text already translated keeps showing, and the language switcher keeps working. There is no overage charge.
- Page views used up. The same happens for one month, then the whole site is served in its original language until the next month or an upgrade.
- Bot visits in Hybrid and DNS Proxy mode count at a quarter of the rate.
- Yearly billing is ten months for twelve.
- Moving to a smaller plan never takes a site offline. You keep what you have and cannot add more until you fit.
Değiştirme veya iptal etme
- Open Billing and pick a plan under Available Plans . A change takes effect at once. The price difference is settled on your next invoice.
- New subscriptions on Start or Pro (monthly, paid in USD, outside Korea) start with a 14-day free trial.
- Korean customers pay in KRW through KG이니시스, with VAT shown separately. Yearly Korean plans are a one-time payment you renew by hand. Cancel with the 해지 button; you keep access to the end of the period.
- Every charge and receipt is under Payment History at the top of the Billing page.
Görsel ve arama kredileri
Ücretli planlar, abone olduğunuz ilk seferde tek seferlik bir kredi paketi içerir: Lite için 2 görsel ve 500 arama, Start için 10 görsel ve 2.000 arama, Pro için 30 görsel ve 2.000 arama, Business ve Global için 100 görsel ve 2.000 arama. Bir üst plana geçmek sadece aradaki farkı ekler. Dahil edilen kredilerin süresi asla dolmaz ve her yükseltmede değil, hesap başına bir kez tanımlanır.
Eğer krediniz biterse, Faturalandırma sayfasından, Görsel Çeviri sayfasından veya Tersine Arama sayfasından ön ödemeli paket olarak daha fazla satın alabilirsiniz. Paketler siteleriniz arasında paylaşılır. Satın alınan görsel paketleri 12 ay boyunca geçerlidir ve bir paketin süresi dolmadan 30 gün önce e-posta alırsınız; satın alınan arama paketlerinin süresi asla dolmaz.
Satın alma işlemi yeni bir sekmede açılır. Faturalandırma sayfasına geri döndüğünüzde bakiyeniz yenilenir.
Promosyon kodları
- Outside Korea there is no code box. Your discount is attached to your account and applied at checkout on its own.
- In Korea, the code box is on the Billing page while you are on the free plan. Codes apply to the first payment only.
- Discounts do not stack. The largest one wins.
Arkadaşını öner
Bağlantınız Referans sayfasındadır. Bu bağlantı üzerinden üye olan bir arkadaşınız ilk planında %15 indirim kazanır. Onlar abone olduğunda, bir arkadaş başına bir kez olmak üzere bir sonraki aylık ödemeniz %50 indirimli olur. Bağlantı 90 gün boyunca hatırlanır. Paketler değil, planlar sayılır.
Sonraki: Öznitelik referansı
For developers
Attribute reference, JavaScript API and events, Live Chat API, Content Security Policy, right-to-left languages.
For developers
Attribute reference, JavaScript API and events, Live Chat API, Content Security Policy, right-to-left languages.
Öznitelik referansı
For developersProxylang tarafından kullanılan her sınıf, öznitelik ve yorum işareti HTML kodunuzdan okunur.
Browser means the script tag and pages visitors load in Hybrid mode. Server means pages Proxylang renders for search engines in Hybrid mode and for everyone in DNS Proxy mode. Both means both.
Skip
class="proxylang-no-translate"Both- Skip this element and everything inside it.
data-proxylang-no-translateBoth- Same as the class.
class="notranslate"Browser- Google’s standard skip class. Honoured as well.
translate="no"Browser- The HTML standard skip attribute. Honoured as well.
data-pl-skipBrowser- Short form of the skip attribute.
<!-- @proxylang-do-not-translate-start --> … <!-- @proxylang-do-not-translate-end -->Server- Skip a region of HTML. JS files use the same words after //.
class="proxylang-bot-only-no-translate"Server- Keep the original wording for search engines only. Visitors still get the translation.
data-proxylang-bot-only-no-translateServer- Attribute form of the bot-only skip.
<!-- @proxylang-bot-only-do-not-translate-start --> … <!-- @proxylang-bot-only-do-not-translate-end -->Server- Comment form of the bot-only skip.
Hint
data-pl-context="…"Server- A hint for the translator about this element (“button label”, “product name”).
data-pl-max-chars="N"Server- Keep the translation at or under N characters. Useful for fixed-width buttons.
data-proxylang-search-context="…"Browser- Context for translating what visitors type in this search box.
Force
data-pl-retranslate="token"Both- Translate this element again, bypassing every cache. Change the token to trigger it. Must be switched on for your domain by Proxylang support.
data-no-url-path-langBrowser- On the script tag itself. Your own router owns /xx-xx/ paths, so Proxylang will not read the language from the URL.
Features
data-pl-translate-imageBoth- Translate the text in this image. See Image translation.
data-proxylang-reverse-searchBrowser- Translate what visitors type in this search box. See Search translation.
class="proxylang-flip-on-rtl"Both- Mirror this element for right-to-left languages.
data-pl-no-rtl-fixBoth- Leave this element out of the right-to-left animation fixes.
Also skipped without markers: <pre> and <code> everywhere; <kbd>, <var> and <samp> on the server; <script>, <style>, <svg>, <math>, form inputs and iframes.
Sıradaki: JavaScript API ve etkinlikler
JavaScript API ve olaylar
For developersAktif dili okuyun, kendi seçicinizi oluşturun ve değişikliklere tepki verin.
window.Proxylang
Script tag, Hybrid ve DNS Proxy modlarında mevcuttur.
| Method | Returns | Description |
|---|---|---|
getCurrentLanguage() | string | Active language code, e.g. "ko-KR". |
getBaseLanguage() | string | The site’s own language. |
getLanguages() | Array | Enabled languages as { code, english, native, isBase }. Empty until the config has loaded. |
setLanguage(code) | Promise<void> | Switch language. Navigates the page. Unknown codes are ignored with a console warning. |
isReady() | boolean | True once the widget has initialised. |
onReady(fn) | void | Runs fn when ready, or at once if already ready. |
isTranslated() | boolean | True once the first translation pass has finished. |
onTranslated(fn) | void | Runs fn when the first pass finishes, or at once if it already has. |
onLanguageChange(fn) | () => void | Runs fn on every switch. Returns a function that unsubscribes. |
window.Proxylang.getCurrentLanguage() // "ko-KR"
window.Proxylang.getBaseLanguage() // "en-US"
window.Proxylang.getLanguages()
// [{code: "en-US", english: "English", native: "English", isBase: true},
// {code: "ko-KR", english: "Korean", native: "한국어", isBase: false}, ...]
window.Proxylang.setLanguage("fr-FR") // navigatesProxylang:hazır
Fired on document once the widget has initialised. detail carries language and baseLanguage .
window.Proxylang.onReady(() => {
console.log(window.Proxylang.getCurrentLanguage())
})
document.addEventListener('proxylang:ready', (e) => {
console.log(e.detail.language, e.detail.baseLanguage)
})Proxylang:çevrildi
Fired on document exactly once per page load, when the first translation pass has finished. It never fires again, not for added content or client-side navigation. It is guaranteed within about five seconds; if the safety cap fires first, detail.timedOut is true and language may be null. Use it to remove a loading overlay.
document.addEventListener('proxylang:translated', (e) => {
console.log(e.detail.language) // "ko-KR", or null if timedOut
console.log(e.detail.baseLanguage) // "en-US"
console.log(e.detail.timedOut) // true if the 5s cap fired first
document.getElementById('loading-overlay')?.remove()
})
// Same thing, callback style. Runs at once if already finished.
window.Proxylang.onTranslated(() => { /* ... */ })Proxylang:dil-degisimi
Fired on document when the visitor switches language, with detail.language . Callbacks run before the page navigates, so an analytics call may not finish sending. Use your analytics library's beacon or "transport: beacon" option.
// Returns a function that unsubscribes
const stop = window.Proxylang.onLanguageChange((lang) => {
navigator.sendBeacon('/analytics', JSON.stringify({ event: 'language_change', lang }))
})
// Or listen for the DOM event
document.addEventListener('proxylang:languagechange', (e) => {
console.log(e.detail.language)
})
// Later, e.g. when a component unmounts
stop()Hata Ayıklama
- Add
?proxylang_debug=1to any page address to get verbose logs in the console. - In DNS Proxy mode a
proxylang:translatingevent fires onwindowwithdetail.loadingtrue or false around each re-translation. - Framework apps: the script waits for hydration before touching the page. If your app re-renders text after that, the observer picks it up and translates it.
Live Chat JavaScript API
For developersPut text in the chat window, open it from your own buttons, and tell your team who the visitor is.
$proxylang
The chat loads with your Proxylang script tag. Send it commands by pushing them onto window.$proxylang . Commands pushed before the chat has loaded wait and run in order once it has.
- The commands use the same format as Crisp's
$crisp. A page already wired to Crisp moves over by renaming$crispto$proxylang. - Commands the chat does not know are ignored. They never throw an error on your page.
$proxylang.get()and$proxylang.is()exist only after the chat has loaded. Before that,$proxylangis a plain array.
// Safe to run before the chat has loaded. Commands wait, then run in order.
window.$proxylang = window.$proxylang || []
$proxylang.push(['do', 'chat:open'])Put text in the chat window
| Command | What it does |
|---|---|
['set', 'message:text', [text]] | Fills the reply box. The visitor can edit it and presses send themselves. Nothing reaches your team until they do. |
['do', 'message:show', ['text', text]] | Shows a message from your team in the chat. Only this visitor sees it, only on this page. It is not sent to your team or saved, and a reload removes it. |
['do', 'message:send', ['text', text]] | Sends a message as the visitor. Your team gets it in the console, translated like any other message. |
- Text is capped at 4,000 characters. Empty text is ignored.
message:textandmessage:showappear exactly as you write them. They are not translated. Pick the text for the visitor's language yourself withwindow.Proxylang.getCurrentLanguage().- A
message:showmessage while the window is closed adds to the unread count on the chat bubble.
// A "Request a quote" button: open the chat with a message ready to send
function requestQuote() {
$proxylang.push(['set', 'message:text', ['Hi, I would like a quote for the Pro plan.']])
$proxylang.push(['do', 'chat:open'])
}
// A message from your team, shown only to this visitor on this page
$proxylang.push(['do', 'message:show', ['text', 'Questions about plans? Ask us here.']])
// A message sent as the visitor. Your team gets it in the console.
$proxylang.push(['do', 'message:send', ['text', 'I need help with order #1042']])Open and close
| Command | What it does |
|---|---|
['do', 'chat:open'] | Opens the chat window. |
['do', 'chat:close'] | Closes it. |
$proxylang.is('chat:opened') | True while the window is open. |
Tell your team who the visitor is
Your team sees these in the visitor pane of the chat console. To make an email verified, sign it on your server with the secret from Chat settings › Widget › Verified visitor emails . The signature is the HMAC-SHA256 of the email, as hex.
| Command | What it does |
|---|---|
['set', 'user:email', [email, signature]] | The visitor’s email. Add the signature to mark it verified. |
['set', 'user:nickname', [name]] | The name your team sees. |
['set', 'user:avatar', [url]] | Picture address. https only. |
['set', 'user:phone', [phone]] | Phone number. |
['set', 'user:company', [name, { url, description }]] | Company name, with an optional website and description. |
['set', 'session:data', [[[key, value], ...]]] | Up to 32 key/value pairs. Values are text, numbers or true/false. Keys are cut to 40 characters and text values to 200. Pushing again adds new keys and overwrites existing ones; keys are never removed until session:reset. Once there are 32 keys, new keys are skipped without an error. |
['set', 'session:event', [[[name, data, colour]]]] | Adds entries to the visitor’s timeline. Colour is red, orange, yellow, green, blue, purple, pink, brown, grey or black. |
$proxylang.get('user:email') | Reads back a value you set. Works for every user: key and for session:data. |
['do', 'session:reset'] | Starts a new visitor in this browser. Call it when a user signs out, so the next person to sign in does not see their chats or take over their email. |
$proxylang.push(['set', 'user:email', [user.email, signature]])
$proxylang.push(['set', 'user:nickname', [user.name]])
$proxylang.push(['set', 'user:company', ['Acme', { url: 'https://acme.com' }]])
// Key/value pairs shown in the visitor pane
$proxylang.push(['set', 'session:data', [[['plan', 'pro'], ['orders', 3]]]])
// Timeline entries: name, optional data, optional colour
$proxylang.push(['set', 'session:event', [[['checkout-failed', { total: 120 }, 'red']]]])
// When the user signs out: start a new visitor in this browser
$proxylang.push(['do', 'session:reset'])
// Once the chat has loaded
$proxylang.get('user:email')
$proxylang.is('chat:opened')Sonraki: İçerik Güvenliği Politikası
İçerik Güvenlik Politikası
For developersÇoğu sitede İçerik Güvenlik Politikası (CSP) bulunmaz. Eğer siteniz için bir politika ayarlanmadıysa bu bölümü atlayın.
Buna ihtiyacınız var mı?
A CSP is a rule list that tells the browser which scripts and servers a page may use. If your site has one, it can block Proxylang. The sign: translations never appear and there is no error on the page. Open the browser console (F12) and look for a line starting with Refused to and mentioning Content Security Policy.
Script etiketi ve Hibrit mod
The script loads from proxy.proxylang.dev and Live Chat from chat.proxylang.dev . It also fetches translations, swaps in translated images and adds a few inline styles. Add these sources to your existing policy:
# Add these sources to your existing policy.
# script-src: the Proxylang script, plus 'unsafe-inline' for the small styles/scripts it injects
# connect-src: translation, image and chat requests (wss:// is the Live Chat socket)
# img-src: translated images are served from Proxylang storage
Content-Security-Policy:
script-src 'self' https://proxy.proxylang.dev https://chat.proxylang.dev 'unsafe-inline';
style-src 'self' 'unsafe-inline';
connect-src 'self' https://proxy.proxylang.dev https://chat.proxylang.dev wss://chat.proxylang.dev;
img-src 'self' data: https:Siteniz politikasını bu şekilde ayarlıyorsa, meta etiketi ile aynı kurallar geçerlidir:
<meta http-equiv="Content-Security-Policy"
content="script-src 'self' https://proxy.proxylang.dev https://chat.proxylang.dev 'unsafe-inline'; style-src 'self' 'unsafe-inline'; connect-src 'self' https://proxy.proxylang.dev https://chat.proxylang.dev wss://chat.proxylang.dev; img-src 'self' data: https:">DNS Proxy modu
Çeviriler sunucu tarafında eklenir, bu nedenle çoğu politika mevcut haliyle çalışır. Sadece tüm satır içi (inline) betikleri engelleyen bir politikanın değiştirilmesi gerekir: Proxylang sayfa yüklenirken çevirilerin yerinde kalmasını sağlayan küçük satır içi betikler ekler.
# Only needed if your policy blocks all inline scripts:
Content-Security-Policy: script-src 'self' 'unsafe-inline'Sıradaki: Sağdan sola diller
Sağdan sola diller
For developersArapça, İbranice, Farsça ve Urduca sağdan sola okunur. Proxylang düzeni sizin için tersine çevirir.
Otomatik olarak ne gerçekleşir?
When a visitor picks a right-to-left language, Proxylang sets dir="rtl" on the page so text, menus and layout mirror. When an Arabic or Hebrew site is shown in English, it sets dir="ltr" and overrides any CSS that pins the direction, so the layout flips back.
- Any right-to-left target gets
dir="rtl", even if the source is already right-to-left. - Left-to-right to left-to-right leaves the page untouched.
- In script tag and Hybrid mode the page paints in its original direction first and flips once the script runs. DNS Proxy mode flips on the server with no flash.
To turn the flip off for a domain, use the switch on the Language Switcher page. It only becomes active once a right-to-left language is enabled on that domain.
Ok veya simgeyi yansıtma
Directional graphics (a "next" arrow, a back icon) do not mirror on their own. Add the proxylang-flip-on-rtl class to any element that should.
<!-- Mirrored when the page is right-to-left -->
<img src="/arrow-next.svg" class="proxylang-flip-on-rtl" />
<svg class="proxylang-flip-on-rtl">...</svg>Animasyon düzeltmeleri ve devre dışı bırakma
Bazı animasyonlar aynalandığında hatalı görünebilir. Proxylang yaygın olanlar için CSS düzeltmeleri ekler: ilerleme çubukları ve yükleme çubukları sağdan dolar, haber bandı ve kayan yazılar kaydırma yönlerini korur, karuseller ve sliderlar çalışmaya devam eder ve NProgress çubukları üst kenarda kalır.
If one of those fixes breaks something on your site, add data-pl-no-rtl-fix to that element and Proxylang leaves it alone. The one exception is NProgress, which is styled by its own class and cannot be excluded this way.
For your own CSS, two variables follow the reading direction: --pl-transform-origin-start and --pl-transform-origin-end .