WPML

WPML-Website-Keys – Wie sie funktionieren, wann Sie einen benötigen und wie Sie ihn zurücksetzen

Ein Website-Key teilt WPML mit, zu welchem Konto eine Website gehört. Die meisten Kunden müssen Keys nie direkt bearbeiten. Wenn eine Website verschoben oder kopiert wird, stellt WPML die Verbindung automatisch wieder her und der Key wird übernommen. Die wenigen Fälle, in denen Sie Keys direkt verwalten müssen, sind unten aufgeführt.

Wie Website-Keys funktionieren

Jede mit WPML registrierte Website erhält einen einzigartigen Website-Key, der mit Ihrem WPML-Konto verknüpft ist. Der Key autorisiert die Website, den Übersetzungsspeicher, das Glossar und das Wörter-Kontingent Ihres Kontos zu nutzen.

Der Key Ihrer aktuellen Website ist an zwei Stellen sichtbar:

  • WPML > Aktivieren & Aktualisieren. Das Registrierungsbanner zeigt ein maskiertes Suffix (z. B. ******abcd), sodass Sie erkennen können, welchen Key die Website verwendet, ohne den vollständigen Key preiszugeben.
  • Ihre WPML.org-Kontoseite. Listet jede von Ihnen registrierte Website und deren vollständigen Key auf.

Um eine neue Website manuell zu registrieren, generieren Sie einen Key auf Ihrer Kontoseite und fügen Sie ihn nach Aufforderung in den WPML-Admin-Bereich ein: entweder im Setup Wizard während der Einrichtung oder in das eingebettete Website-Key-Formular auf dem konsolidierten Migrationshinweis, wenn WPML danach fragt.

Um die Registrierung einer Website aufzuheben (z. B. weil Sie sie stilllegen), klicken Sie im Registrierungsbanner unter WPML > Aktivieren & Aktualisieren auf WPML von dieser Website abmelden. Auf demselben Bildschirm installiert und aktualisiert WPML Plugins – der dortige Website-Key legt fest, zu welchem Konto diese Downloads gehören.

Entfernen des Hinweises „Diese Website ist als Entwicklungswebsite registriert“

Ein WPML-Konto kann eine Entwicklungswebsite pro Live-Website registrieren. Der Hinweis der Entwicklungswebsite („Diese Website ist auf WPML.org als Entwicklungswebsite registriert“) erscheint absichtlich auf jeder WPML-Admin-Seite der Entwicklungswebsite, um zu verhindern, dass Entwicklungs-Klone als Live-Websites behandelt werden.

Wenn Sie bereit sind, eine Website von einer Entwicklungswebsite zu einer Live-Website umzuwandeln:

  1. Öffnen Sie Ihr WPML-Konto und suchen Sie die Website in Ihrer Liste der registrierten Websites.
  2. Ändern Sie ihren Typ von Entwicklung in Produktion.
  3. Speichern Sie.
  4. Öffnen Sie auf der Website selbst WPML > Aktivieren & Aktualisieren und klicken Sie auf Nach Updates suchen. Der Hinweis zur Entwicklungswebsite verschwindet, sobald die Änderung auf Kontoseite synchronisiert wurde.

Wenn der Hinweis nach einer Synchronisierung weiterhin besteht, führen Sie WPML > Support > Systemprüfung > Lizenzdaten aktualisieren aus. Dadurch wird der lokale Lizenz-Cache geleert und der Kontostatus neu abgerufen.

Automatisches Registrieren von Websites über eine PHP-Konstante

Für automatisierte Dev-/Staging-/Prod-Workflows (bei denen die Website durch eine CI-Pipeline bereitgestellt wird und niemand manuell einen Key einfügt), können Sie den Website-Key in der wp-config.php mithilfe von PHP-Konstanten fest codieren. WPML liest diese während der Aktivierung und registriert die Website ohne Nachfrage.

In der wp-config.php, vor der Zeile „That’s all, stop editing!“:

define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );

WPML erkennt die Konstante bei der Aktivierung und überspringt die Registrierungsaufforderung. Derselbe Key-Wert kann in Dev-, Staging- und Produktionsumgebungen festgelegt werden. WPML trennt sie nach Domain.

Dies ist der richtige Ansatz für Umgebungen, in denen:

  • Die Website durch Docker- / Composer- / WP-CLI-Skripte bereitgestellt wird und es keinen manuellen Einrichtungsschritt gibt.
  • Sie viele Websites verwalten und möchten, dass die Registrierung deklarativ erfolgt und nicht durch Klicken.
  • Der konsolidierte Migrationshinweis in einer frisch bereitgestellten Umgebung nach einem Key fragt.