Getting started
Proxylang-Handbuch
So richten Sie Proxylang ein, verbessern Übersetzungen und werden in anderen Sprachen gefunden. Entwickler-Material finden Sie am Ende.
Start here
Erste Schritte
Vier Schritte von einem neuen Konto zu einer übersetzten Website. Das Script-Tag ist das Standard- und funktioniert auf jeder Plattform.
In vier Schritten einrichten
Add your site
Gehen Sie zu Setup und geben Sie die Adresse Ihrer Website ein. Wählen Sie die Plattform, auf der sie läuft.
Pick languages
Wählen Sie die eigene Sprache Ihrer Website und dann die Sprachen, die Sie hinzufügen möchten. Ihr Plan bestimmt, wie viele Sie hinzufügen können.
Install
Wählen Sie aus, wie das Script-Tag auf Ihre Website gelangt. Lassen Sie die KI es erledigen: Kopieren Sie unsere Nachricht in ChatGPT, Claude oder Cursor. Machen Sie es selbst: Kopieren Sie eine Zeile und veröffentlichen Sie sie. Oder senden Sie es an Ihren Entwickler: Wir schreiben die E-Mail. WordPress-Websites nutzen das Plugin.
Check your site
Der Assistent bestätigt, dass das Skript aktiv ist. Ein Sprachumschalter erscheint auf Ihrer Website.
Installationsanleitungen nach Plattform:
Verbindung mit Proxylang wählen
Das Script-Tag ist die Standardoption und funktioniert überall. Die anderen Modi bieten Suchmaschinen Sichtbarkeit in anderen Sprachen. Sie können die Modi später auf dem Einrichtungs-Tab der Domäne ändern; nichts geht offline, wenn Sie wechseln.
Script tag
Suchmaschinen lesen Ihre ursprüngliche Website.
Hybrid
Suchmaschinen erhalten übersetzte Seiten.
DNS Proxy
Alle erhalten übersetzte Seiten.
Script tag
Jeder Plan, jede Plattform
Die Übersetzung erfolgt im Browser des Besuchers. Suchmaschinen sehen weiterhin Ihre Originalsprache.
Am besten für: Apps, passwortgeschützte Seiten und jeden Website-Builder.
WordPress plugin
WordPress sites
Installiert das Skript für Sie und fügt sprachspezifische Adressen, SEO-Tags und Sitemaps hinzu, ohne DNS zu berühren.
Ideal für: Jede WordPress- oder WooCommerce-Website.
Hybrid
Lite-Tarif und höher, Websites mit Code erstellt
Eine DNS-Änderung. Suchmaschinen erhalten übersetzte Seiten von Proxylang. Besucher behalten das Skript-Tag.
Ideal für: Marketing-Websites, die in anderen Sprachen gefunden werden sollen.
DNS Proxy
Pro-Plan und höher, Seiten mit Code erstellt
Jeder Besucher erhält übersetzte Seiten von Proxylang unter übersetzten Adressen wie /es-es/about.
Ideal für: Websites, die für alle vollständig übersetzte URLs ohne Skript wünschen.
Übersetzungsprozess verstehen
Mit dem Skript-Tag wird die Seite wie gewohnt von Ihrem Server geladen. Das Skript fordert dann Proxylang zur Übersetzung jedes Satzes auf und tauscht ihn aus. Der erste Besuch einer Seite übersetzt sich während Sie zusehen. Jeder weitere Besuch ist sofort, da die Übersetzung gespeichert ist.
Mit DNS-Proxy oder Hybrid-Modus sitzt Proxylang zwischen dem Besucher (oder der Suchmaschine) und Ihrem Server:
A visitor opens a translated address
yourdomain.com/es-es/pageProxylang ruft die Originalseite von Ihrem Server ab
KI übersetzt den sichtbaren Text
Layout und Code bleiben genau wie sie waren.
Die übersetzte Seite wird gespeichert und ausgeliefert
Der nächste Besucher erhält sie sofort.
SEO tags are added
Sprachlinks, kanonische Adresse und mehr.
Short addresses also work. /es/about and /mx/about both redirect to /es-es/about.
Bei ausbleibenden Änderungen
- 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.
Weiter: Marke & Kontext
Make translations better
Marke & Kontext
Erzählen Sie dem Übersetzer, wer Sie sind. Fünf Minuten hier sind für die Qualität genauso wichtig wie alles andere in diesem Leitfaden.
Was auszufüllen ist
- 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.
Wann es wirksam wird
Klicken Sie auf „Marke & Kontext speichern“. Neue Übersetzungen nutzen den neuen Kontext innerhalb einer Stunde. Bereits übersetzter Text behält seine Formulierung. Um eine Seite neu zu erstellen, können Sie einzelne Sätze im Live-Editor korrigieren.
Weiter: Glossar & Liste der nicht zu übersetzenden Begriffe
Glossar & Ausschlussliste verwalten
Entscheiden Sie einmal, wie ein Wort auf jeder Seite übersetzt werden muss.
Ihre Bedingungen
- 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
Neue Begriffe erreichen die Übersetzungsserver innerhalb von etwa zehn Minuten. Bereits übersetzter Text behält seine alte Formulierung, bis er erneut übersetzt wird. Um eine Seite zu überprüfen, öffnen Sie sie in einem privaten Fenster, damit Ihr Browser Ihnen keine gespeicherte Kopie anzeigt.
Niemals übersetzen
Die Karte „Niemals übersetzen“ oben im Glossar enthält Wörter, die in jeder Sprache exakt so bleiben müssen, wie sie geschrieben sind: Ihre Marke, ein Produktname, ein Hashtag. Bis zu 100 Einträge mit jeweils 60 Zeichen. Der Abgleich ist case-sensitive, fügen Sie also „iPhone“ hinzu, nicht „iphone“.
KI-Verbesserungen
Proxylang überprüft die Übersetzungen auf Ihrer Website nach einem Zeitplan und schlägt kleine Korrekturen vor. Genehmigte Korrekturen werden als mit AI markierte Begriffe zu Ihrem Glossar hinzugefügt, zusammen mit dem Grund und der Formulierung, die sie ersetzt haben. Sie können diese jederzeit löschen.
- 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.
Live-Editor
Beheben Sie eine Übersetzung auf Ihrer eigenen Seite: Klicken Sie auf den Satz, tippen Sie ein, speichern Sie. In jedem Plan enthalten.
Übersetzung bearbeiten
- 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.
Übersetzer einladen
Ein Übersetzer benötigt kein Proxylang-Konto. Er meldet sich auf Ihrer Website an und kann Übersetzungen bearbeiten, nichts anderes.
- 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.
Weiter: Übersetzungseinstellungen steuern
Übersetzungseinstellungen anpassen
Behalten Sie Markennamen, Coupon-Codes und Bewertungen in der Originalsprache oder pausieren Sie die Übersetzung ganz.
Inhalte in der Originalsprache belassen
Einige Texte sollten sich niemals ändern: ein Markename, ein Coupon-Code, ein Zitat, von Kunden geschriebene Bewertungen. Sie haben drei Werkzeuge, von keinem Code bis hin zu einigem Code.
- 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.
Block per Klasse überspringen
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>Bereich per Kommentar überspringen
Nützlich, wenn Sie keine Klasse hinzufügen können oder für Text in JavaScript-Dateien. Alles zwischen den beiden Markern wird übersprungen.
<!-- @proxylang-do-not-translate-start -->
<div class="testimonial">
Customer reviews stay exactly as written.
</div>
<!-- @proxylang-do-not-translate-end -->Für Sie übersprungen
- 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.
Nur für Suchmaschinen überspringen
Manchmal möchten Sie, dass Suchmaschinen die ursprüngliche Formulierung indizieren (eine Schlagzeile, ein Slogan, für den Sie eine gute Platzierung haben), während Besucher ihn übersetzt lesen. Verwenden Sie die Bot-only-Marker. Diese gelten nur dort, wo Proxylang Seiten an Bots ausliefert, also bei DNS-Proxy und Hybrid-Modus. Nur beim Script-Tag allein haben sie keine Wirkung.
<!-- 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 -->Alles pausieren
Zwei Schalter im Reiter „Erweitert“ der Domain stoppen neue Übersetzungen, ohne etwas von Ihrer Website zu entfernen. Bereits übersetzter Text wird weiterhin angezeigt.
- 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.
Rechtliche Seiten
Datenschutzerklärungen und Nutzungsbedingungen bleiben standardmäßig in Ihrer eigenen Sprache.
Rechtliche Seiten in der eigenen Sprache belassen
Eine maschinelle Übersetzung eines Vertrags kann vor Gericht nicht standhalten, und eine lange Rechtsseite würde Ihre Wortbalance für nichts verbrauchen. Deshalb überspringt Proxylang diese Seiten, sofern Sie nichts anderes angeben.
Seiten, die ohne weitere Einrichtung übersprungen werden
Proxylang richtet sich nach der Seitenadresse. Diese Seiten werden in jedem Plan und in jedem Modus übersprungen:
/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
Nur der Haupttext der Seite wird übersprungen. Der Header, das Menü und der Fuß bleiben übersetzt, damit Ihre Besucher sich noch zurechtfinden können.
Rechtsseiten an anderen Adressen
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>Falls Sie eine Übersetzung wünschen
Lassen Sie einen Anwalt oder einen zertifizierten Übersetzer die Version in der anderen Sprache erstellen, dann veröffentlichen Sie sie als eigene Seite. Verlassen Sie sich nicht auf maschinelle Übersetzungen für etwas, das ein Kunde unterzeichnen oder anfechten könnte.
Weiter: SEO in anderen Sprachen
Get found in search
SEO in anderen Sprachen
Erhalten Sie die übersetzten Seiten gefunden. Proxylang fügt die Tags hinzu, nach denen Suchmaschinen suchen, und gibt Ihnen eine Seite zum Überwachen.
Die SEO-Seite
Aktivieren Sie SEO und wählen Sie eine Website aus. Hierfür ist mindestens der Lite-Tarif erforderlich. Die Tabs „Keywords“ und „Seitentitel“ erfordern zudem den Hybrid- oder DNS-Proxy-Modus, da Suchmaschinen allein über das Script-Tag niemals übersetzte Titel sehen.
- 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.
Tags auf jeder übersetzten Seite
- 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.
Gilt in den Modi Hybrid und DNS Proxy, in denen Suchmaschinen Seiten von Proxylang erhalten. Nur für das Script-Tag allein lesen sie Ihre ursprüngliche Website.
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" />Titel, Beschreibungen und Bildtexte
Der Seitentitel, die Meta-Beschreibung, der Social-Vorschau-Titel und die Beschreibung sowie die Schlüsselwörter werden übersetzt. Auch Bild-Alt-Texte, Button-Tooltips und Formularplatzhalter werden übersetzt. Sie können Ihre eigenen Formulierungen für jede Seite im Reiter Seitentitel & Beschreibungen festlegen.
Rich-Suchergebnisse
Wenn Ihre Seiten strukturierte Daten enthalten (die versteckten Produkt-, Artikel-, FAQ- oder Veranstaltungsdetails, die Rich Results in Google ermöglichen), werden die Textfelder übersetzt und das Sprachfeld aktualisiert. Preise, Daten, URLs und Identifikatoren bleiben unverändert.
Sitemaps
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>Seiten für die Sitemap auswählen
Im Reiter SEO-Einstellungen unter Sitemap-Seiten:
- 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.
Suchmaschinen über neue Seiten informieren
- 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.
KI-Suchmaschinen
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.
Sprachkürzel in jeder URL
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.
Nur im DNS-Proxy-Modus. Subdomains folgen ihrem Root-Domain.
Hybrid-Modus (SEO für Suchmaschinen)
Suchmaschinen erhalten von Proxylang übersetzte Seiten, während Ihre Besucher das Script-Tag behalten.
Funktionsweise
Das Script-Tag übersetzt Seiten direkt im Browser des Besuchers. Suchmaschinen führen dieses Script nicht aus und sehen daher nur Ihre Originalsprache. Der Hybrid-Modus löst dieses Problem.
Suchmaschinen und KI-Bots
Erhalten Sie vollständig übersetzte Seiten von Proxylang. Google, Bing, Naver, ChatGPT, Perplexity und Link-Vorschauen (Slack, LinkedIn, Facebook) gehören dazu.
Your visitors
Ihre Website bleibt genau wie heute und wird per Script-Tag übersetzt. Ihr Hosting, Ihre Analysen und A/B-Tests bleiben unberührt.
Websites auf Wix, Squarespace, Webflow und ähnlichen Baukästen können DNS auf diese Weise nicht ändern und nutzen daher weiterhin das Script-Tag.
Aktivierung
Es gibt keinen „Hybrid“-Schalter. Hybrid ist der Zustand, wenn DNS-Proxy und Script-Tag für dieselbe Domain gleichzeitig aktiviert sind.
Öffnen Sie Ihre Domain und dann den Tab Setup
Domains → Ihre Domain → Setup.
Turn on DNS Proxy
Fügen Sie die von uns angezeigten DNS-Einträge bei Ihrem Domain-Registrar hinzu und verifizieren Sie diese. Dies ist der Schritt, der es Suchmaschinen ermöglicht, Proxylang zu erreichen.
Keep Script Tag on
Ihre Besucher können weiterhin das bereits installierte Skript-Tag verwenden.
Done
Wenn beide aktiviert sind, liest das Domain-Badge "Hybrid (SEO)". Wenn Sie eine Option deaktivieren, wechselt die Seite in den anderen Modus, ohne dass Ausfallzeiten auftreten.
Die Kosten
Bot-Besuche verwenden Wörter aus Ihrem Guthaben, und zwar zu einem Viertel des normalen Satzes. Drei Limits verhindern, dass ein unkontrollierter Crawl Ihr Guthaben leert. Sie können jeden dieser Limits auf der SEO-Seite unter Einstellungen senken.
Wörter pro Tag für Bots
Sobald dies erreicht ist, erhalten Bots Ihre Originalsprache bis Mitternacht UTC. Setzen Sie es auf 0, um die Bot-Übersetzung vollständig zu stoppen.
- Start
- 3,000
- Pro+
- 20,000
Budget per page
Wie viel von einer Seite ein Bot-Besuch übersetzen darf, in KI-Token (ca. 2,7 pro Wort). Standard: 4.000. Titel, Beschreibung und Überschriften zählen nicht.
- Start
- 8,000
- Pro+
- 50,000
Besuche pro Tag, nicht verifizierte Bots
Google, Bing, Apple, DuckDuckGo und Yandex sind durch ihre Netzwerkadresse verifiziert und haben keine Begrenzung. Alle anderen teilen sich dieses Limit.
- Start
- 5
- Pro+
- 10
Anwendungsfälle
- 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.
Seiten hinter einem Login profitieren nicht von Hybrid. Halten Sie diese auf dem Skript-Tag.
Weiter: Mehrere Websites & Subdomains
Sites & Subdomains
Fügen Sie kostenlose Subdomains und weitere Root-Domains ab dem Start-Tarif hinzu. Alle Sites teilen ein Wortguthaben.
Mögliche Ergänzungen
- 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.
Alle Ihre Sites teilen ein Wortguthaben. Eine zweite Site fügt keine Wörter hinzu; sie zieht aus demselben Pool.
Wenn Sie später zu einem kleineren Tarif wechseln, geht nichts offline. Sie behalten jede Site, die Sie bereits hinzugefügt haben. Sie können nur keine weiteren hinzufügen, bis Sie wieder unter der Grenze sind.
Vererbte Subdomain-Eigenschaften
Ein Subdomain folgt seinem Root-Domain. Er erhält dieselbe Verbindungsmodus-, Sprachen-, Sitemap-Einstellungen und Schalter im Erweiterte-Tab. Sie setzen diese einmal auf dem Root fest.
Wenn das Root DNS Proxy oder Hybrid-Modus verwendet, benötigt jeder Subdomain auch seine eigenen DNS-Einträge. Die App zeigt die genauen Einträge, die hinzugefügt werden müssen: vier für ein Root-Domain (die nackte Domain, www und zwei Verifizierungsdatensätze), zwei für einen Subdomain.
Der passende Modus für jede Website
Marketing-Website oder Landingpage
Hybrid mode
Sie möchten, dass Ihre Inhalte in anderen Sprachen gefunden werden. Nutzen Sie Hybrid, sofern Ihr Tarif und Ihre Website dies zulassen (Lite-Tarif oder höher, Website mit Code erstellt). Andernfalls übersetzt das Script-Tag die Inhalte weiterhin für Besucher.
App oder Kundenportal
Script tag
Seiten hinter einem Login werden nie indiziert, daher gibt es keinen Suchvorteil. Keine DNS-Änderung, nichts im Datenverkehrspfad.
Features
Live-Chat
Ein Chat-Fenster, das in beide Richtungen übersetzt. Ein Abonnement, jede Website, unbegrenzte Agenten.
Funktionsweise
Ein Chat-Fenster auf Ihrer Website. Besucher schreiben in ihrer Sprache. Sie lesen und antworten in Ihrer. Beide Seiten werden laufend übersetzt. Ein Abonnement deckt jede Website in Ihrem Konto ab, mit so vielen Agenten, wie Sie möchten.
Einschalten
Öffnen Sie die Domain, gehen Sie zum Reiter Live-Chat und stellen Sie den Schalter um. Die Sprechblase erscheint auf Ihrer Website und die Website wird in Ihrer Chat-Konsole unter Chat angezeigt.
- 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.
Team hinzufügen
- 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.
Entfernen Sie jemanden mit der Schaltfläche „Entfernen“ in seiner Zeile.
Chats beantworten
- 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.
Desktop- und Mobil-Apps
Die Download-Seite enthält die Desktop-App für macOS, Windows und Linux. Sie bietet Benachrichtigungen und ungelesene Badges, auch wenn der Browser geschlossen ist, und aktualisiert sich selbst. iPhone- und Android-Apps werden als „demnächst verfügbar“ gelistet.
Beim Anmelden wird Ihr normaler Browser für einen Moment geöffnet und dann wieder zur App zurückgekehrt. Das ist normal.
Inhalte der Tarife
Nur übersetzte Nachrichten werden gezählt. Nachrichten in derselben Sprache sind kostenlos. Das monatliche Kontingent wird über Ihre Websites geteilt und am 1. des Monats zurückgesetzt.
- 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.
Weiter: Bildübersetzung
Bildübersetzung
Schreiben Sie den Text in Bannern und Produktbildern in der Sprache des Besuchers neu.
Einrichtung
1. Buy credits
Die Bildübersetzung ist für jede Domain aktiviert. Ihr Guthaben ist die einzige Voraussetzung. Kaufen Sie ein Paket unter Abrechnung. Pakete sind 12 Monate lang gültig.
- 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. Wählen Sie die zu übersetzenden Bilder aus
Nur von Ihnen ausgewählte Bilder werden übersetzt. Drei Wege, der einfachste zuerst:
- 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 />Ablauf und Kosten
- 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.
Funktioniert in jedem Modus. Mit der Methode "Bildadressen einfügen" läuft die Übereinstimmung im Browser des Besuchers, daher benötigt es den Skripttag (Skripttag oder Hybridmodus).
Was übersetzt werden sollte
Translate these
- Banners with text on them
- Infographics and charts with labels
- Product images with printed details
- Screenshots with on-screen text
Diese nicht taggen (werden trotzdem berechnet)
- Photos with no text
- Logos and icons
- SVG files and GIFs
PNG, JPG und WebP werden unterstützt. Sehr große Dateien werden vor der Übersetzung verkleinert. 33 Zielsprachen werden unterstützt. Die Liste finden Sie auf dem Reiter 'Image Translations' der Domäne.
Weiter: Übersetzung suchen
Suche übersetzen
Übersetzen Sie die Eingaben Ihrer Besucher im Suchfeld, damit diese Ergebnisse in jeder Sprache erhalten.
Einrichtung
1. Buy searches
Zahlung erfolgt mit Prepaid-Suchguthaben. Kaufen Sie ein Paket unter Abrechnung. Pakete laufen nie ab.
- 10,000 searches
- $9.99 / ₩13,900
- 50,000 searches
- $39.99 / ₩55,900
- 200,000 searches
- $139.99 / ₩194,000
2. Pro Domain aktivieren
Öffnen Sie die Domain, gehen Sie zum Reiter „Erweitert“ und schalten Sie „Suchanfragen übersetzen“ ein. Der Schalter bleibt aus, bis Sie Guthaben haben. Es kann bis zu fünf Minuten dauern, bis die Änderung auf Ihrer Live-Website wirksam wird, also warten Sie vor dem Testen.
So funktioniert's
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.
Suchfelder mit Filterfunktion
Einige Suchfelder senden nie etwas an einen Server weiter. Sie filtern eine Liste, die bereits auf der Seite vorhanden ist (eine FAQ, ein Produktgitter). Diese benötigen ein Attribut auf der Eingabe:
<!-- 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.
Übersetzung durch Kontext optimieren
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).
Tipps
- 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.
Bekannte Einschränkungen
- 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.
Weiter: Design des Sprachumschalters
Sprachwechsler-Design
Alles über das Sprachmenü, das Besucher sehen: Wo es sitzt, wie es aussieht, wann es erscheint.
Was Sie anpassen können
- 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.
Änderungen erreichen Ihre Website innerhalb von Sekunden, höchstens fünf Minuten. Wenn Sie sie nicht sehen, aktualisieren Sie die Seite.
Welche Sprache Besucher zuerst sehen
Es gibt nichts zu konfigurieren. Beim ersten Besuch sieht Proxylang nach den Sprachen, die der Browser des Besuchers bevorzugt, und wählt den besten Treffer unter den Sprachen, die Sie aktiviert haben. Wenn keiner übereinstimmt, verwendet es das Land des Besuchers und dann die eigene Sprache Ihrer Website. Danach wird die Wahl des Besuchers für ein Jahr gespeichert.
To test another language, open your site in a private window, or add ?lang=ko-KR to the address.
Sprachwechsler in Ihr Menü einbinden
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.
Weiter: Analysen & Nutzung
Your account
Analysen & Nutzung
Sehen Sie, wer in welcher Sprache besucht und wohin Ihre Inhalte gelangen.
Besucher und Sprachzuordnung
Der Reiter Analytics in Ihrem Dashboard zeigt Besucher, Besuche, Seiten, die Herkunft der Nutzer, ihr Land und Gerät sowie den Anteil derer, die eine übersetzte Version lesen. Es werden keine Cookies verwendet; Besucher werden anhand eines verschlüsselten Fingerabdrucks gezählt, der nicht wieder in eine Adresse zurückverwandelt werden kann.
- 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.
Wohin Ihre Worte reisen
Der Reiter Dashboard zeigt an, wie viel von Ihrem Tarif Sie bereits genutzt haben. Die Reiter Metriken und Seiten schlüsseln dies nach Tag, Sprache und Seite auf.
- 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.
Weiter: Tarife, Abrechnung & Credits
Pläne, Abrechnung & Credits
Was jeder Plan enthält, was bei der Grenze passiert und wie Credits und Codes funktionieren.
Was ein Tarif Ihnen bietet
Jeder Tarif beinhaltet ein Wortkontingent, ein monatliches Seitenaufruf-Kontingent, eine Anzahl an Sprachen und eine Anzahl an Websites. Das Wortkontingent ist ein Gesamtwert, kein monatlicher Betrag: Ein Satz wird nur beim ersten Mal gezählt, wenn er übersetzt wird, und bleibt danach als übersetzt markiert. Jede Sprache wird separat gezählt: Eine 500 Wörter umfassende Seite, die in drei Sprachen aufgerufen wird, verbraucht 1.500 Wörter. Ab dem Start-Tarif können Besucher jede der 77 Sprachen wählen; der Tarif legt fest, wie viele davon von Suchmaschinen indexiert werden. Crawler rufen jede indexierte Sprache ab, sodass dies die Sprachen sind, die Wörter verbrauchen, ohne dass ein Besucher die Seite aufruft.
Wörter: eine Gesamtsumme, die einmal gefüllt ist
Seitenansichten: Zurückgesetzt am 1.
| 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.
Ändern oder Kündigen
- 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.
Bild- und Suchguthaben
Kostenpflichtige Tarife beinhalten bei Abschluss Ihres Abonnements eine einmalige Gutschrift: Lite erhält 2 Bilder und 500 Suchen, Start erhält 10 Bilder und 2.000 Suchen, Pro erhält 30 Bilder und 2.000 Suchen, Business und Global erhalten jeweils 100 Bilder und 2.000 Suchen. Ein Upgrade auf einen höheren Tarif fügt nur die Differenz hinzu. Die enthaltenen Credits verfallen nie und werden einmal pro Konto gewährt, nicht einmal pro Upgrade.
Wenn Ihr Kontingent erschöpft ist, können Sie auf der Abrechnungsseite, auf der Seite für Bildübersetzung oder auf der Seite für die Rückwärtssuche weitere Prepaid-Pakete erwerben. Die Pakete werden über alle Ihre Websites hinweg geteilt. Gekaufte Bildpakete sind 12 Monate lang gültig, und Sie erhalten 30 Tage vor dem Ablauf eine E-Mail; gekaufte Suchpakete verfallen nie.
Der Kauf öffnet sich in einem neuen Tab. Ihr Guthaben auf der Abrechnungsseite aktualisiert sich, wenn Sie dorthin zurückkehren.
Gutscheincodes
- 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.
Freunde werben
Ihr Link befindet sich auf der Empfehlungsseite. Ein Freund, der sich über diesen Link registriert, erhält 15 % Rabatt auf seinen ersten Tarif. Wenn er abonniert, erhalten Sie 50 % Rabatt auf Ihre nächste monatliche Zahlung, einmal pro Freund. Der Link wird für 90 Tage gespeichert. Pakete zählen nicht, Tarife hingegen schon.
Weiter: Attributreferenz
For developers
Attributreferenz, JavaScript-API und Events, Live Chat API, Content Security Policy, rechtschreibende Sprachen.
For developers
Attributreferenz, JavaScript-API und Events, Live Chat API, Content Security Policy, rechtschreibende Sprachen.
Attribut-Referenz
For developersJede Klasse, jedes Attribut und jeder Kommentarmarker, den Proxylang aus Ihrem HTML liest.
Browser bedeutet das Skript-Tag und die Seiten, die Besucher im Hybrid-Modus laden. Server bedeutet die Seiten, die Proxylang für Suchmaschinen im Hybrid-Modus und für alle im DNS-Proxy-Modus rendert. Beides bedeutet beides.
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.
Weiter: JavaScript-API und Ereignisse
JavaScript-API & Events
For developersLese die aktive Sprache, baue deinen eigenen Sprachumschalter und reagiere auf Änderungen.
window.Proxylang
Verfügbar im Script-Tag, Hybrid- und DNS-Proxy-Modus.
| 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:ready
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:translated
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:languagechange
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()Fehlersuche
- 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.
Weiter: Live Chat JavaScript API
Live-Chat-JavaScript-API
For developersGeben Sie Text im Chatfenster ein, öffnen Sie es über Ihre eigenen Schaltflächen und teilen Sie Ihrem Team mit, wer der Besucher ist.
$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'])Text im Chatfenster eingeben
| 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']])Öffnen und Schließen
| 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. |
Ihrem Team mitteilen, wer der Besucher ist
Ihr Team sieht diese in der Besucheransicht der Chat-Konsole. Um eine E-Mail zu verifizieren, signieren Sie diese auf Ihrem Server mit dem Geheimnis aus Chat-Einstellungen › Widget › Verifizierte Besucher-E-Mails. Die Signatur ist der HMAC-SHA256 der E-Mail als Hexadezimalwert.
| 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')Weiter: Content Security Policy
Content Security Policy
For developersDie meisten Websites haben keine Content Security Policy. Wenn niemand eine für Ihre Website eingerichtet hat, können Sie diesen Abschnitt überspringen.
Benötigen Sie dies?
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-Tag und Hybrid-Modus
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:Die gleichen Regeln wie für ein Meta-Tag gelten, wenn Ihre Website ihre Richtlinie auf diese Weise festlegt:
<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-Modus
Übersetzungen werden auf dem Server hinzugefügt, sodass die meisten Richtlinien funktionieren, wie sie sind. Nur eine Richtlinie, die alle Inline-Skripte blockiert, benötigt eine Änderung: Proxylang fügt kleine Inline-Skripte hinzu, die Übersetzungen an Ort und Stelle halten, während die Seite lädt.
# Only needed if your policy blocks all inline scripts:
Content-Security-Policy: script-src 'self' 'unsafe-inline'Weiter: Sprachen von rechts nach links
Rechts-nach-links-Sprachen
For developersArabisch, Hebräisch, Persisch und Urdu werden von links nach rechts gelesen. Proxylang ändert das Layout für Sie.
Was automatisch geschieht
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.
Um die Flip-Funktion für eine Domain zu deaktivieren, verwenden Sie den Schalter auf der Seite „Language Switcher“. Sie wird erst aktiv, wenn auf dieser Domain eine Rechts-nach-Links-Sprache aktiviert wurde.
Pfeile oder Icons spiegeln
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>Animations-Fixes und Opt-out
Einige Animationen sehen beim Spiegeln falsch aus. Proxylang fügt CSS-Fixes für die gängigsten hinzu: Fortschrittsbalken und Ladebalken füllen sich von rechts, Ticker und Laufschriften behalten ihre Scrollrichtung, Karussells und Slider bleiben funktionsfähig und NProgress-Balken bleiben am oberen Rand.
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 .