Chaves do site do WPML – como elas funcionam, quando você precisa de uma e como redefinir

Uma chave do site informa ao WPML a qual conta um site pertence. A maioria dos clientes nunca precisa mexer nas chaves diretamente. Quando um site é movido ou copiado, o WPML o reconecta automaticamente e a chave o acompanha. Os poucos casos em que você realmente precisa gerenciar as chaves diretamente estão abaixo.

Como as chaves do site funcionam

Todo site registrado com o WPML recebe uma chave do site exclusiva vinculada à sua conta do WPML. A chave autoriza o site a usar a memória de tradução, o glossário e a franquia de palavras da sua conta.

A chave do seu site atual é visível em dois lugares:

WPML > Ativar e atualizar. O banner de registro mostra um sufixo mascarado (por exemplo, ******abcd) para que você possa identificar qual chave o site está usando sem expor a chave completa.
Sua página de conta no WPML.org. Lista todos os sites que você registrou e a chave completa deles.

Para registrar um novo site manualmente, gere uma chave na página da sua conta e cole-a no painel de administração do WPML quando solicitado: seja no Assistente de configuração durante a integração, ou no formulário de chave do site incorporado no aviso de migração consolidado quando o WPML solicitar.

Para cancelar o registro de um site (por exemplo, porque você o está desativando), clique em Cancelar o registro do WPML neste site no banner de registro em WPML > Ativar e atualizar. A mesma tela é onde o WPML instala e atualiza plugins – a chave do site lá determina a qual conta esses downloads pertencem.

Como remover o aviso “Este site está registrado como um site de desenvolvimento”

Uma conta do WPML pode registrar um site de desenvolvimento por site de produção. O aviso do site de desenvolvimento (“Este site está registrado no WPML.org como um site de desenvolvimento”) aparece intencionalmente em todas as páginas do painel de administração do WPML no site de desenvolvimento, para evitar que clones de desenvolvimento sejam tratados como produção.

Quando você estiver pronto para mudar um site de desenvolvimento para produção:

Abra a sua conta do WPML e encontre o site na sua lista de sites registrados.
Mude o seu tipo de Desenvolvimento para Produção.
Salve.
No próprio site, abra WPML > Ativar e atualizar e clique em Verificar atualizações. O aviso do site de desenvolvimento desaparecerá assim que a alteração no lado da conta for sincronizada.

Se o aviso persistir após uma sincronização, execute WPML > Suporte > Verificação do sistema > Atualizar dados da licença. Isso limpa o cache de licença local e busca novamente o estado da conta.

Como registrar sites automaticamente via constante PHP

Para fluxos de trabalho automatizados de desenvolvimento/homologação/produção (em que o site é implantado por um pipeline de CI e não há um humano para colar uma chave), você pode codificar a chave do site no wp-config.php usando constantes PHP. O WPML as lê durante a ativação e registra o site sem solicitar.

No wp-config.php, antes da linha “That’s all, stop editing!”:

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

O WPML pega a constante quando é ativado e pula o prompt de registro. O mesmo valor de chave pode ser definido em ambientes de desenvolvimento, homologação e produção. O WPML os separa por domínio.

Essa é a abordagem certa para ambientes em que:

O site é provisionado por scripts do Docker / Composer / WP-CLI e não há uma etapa de configuração manual.
Você está gerenciando muitos sites e quer que o registro seja declarativo, não um processo de cliques.
O aviso de migração consolidado solicita uma chave em um ambiente recém-implantado.