Chiavi del sito WPML: come funzionano, quando servono e come resettarle
Una chiave del sito indica a WPML a quale account appartiene un sito. La maggior parte dei clienti non ha mai bisogno di toccare direttamente le chiavi. Quando un sito viene spostato o copiato, WPML lo riconnette automaticamente e la chiave lo segue. Di seguito sono riportati i pochi casi in cui è necessario gestire le chiavi direttamente.
Come funzionano le chiavi del sito
Ogni sito registrato con WPML ottiene una chiave del sito univoca legata al tuo account WPML. La chiave autorizza il sito a utilizzare la memoria di traduzione, il glossario e la quota di parole del tuo account.
La chiave del tuo sito attuale è visibile in due punti:
- WPML > Attiva e aggiorna. Il banner di registrazione mostra un suffisso mascherato (ad esempio,
******abcd) in modo da poter identificare quale chiave sta utilizzando il sito senza esporre la chiave completa. - La pagina del tuo account su WPML.org. Elenca tutti i siti che hai registrato e la relativa chiave completa.
Per registrare manualmente un nuovo sito, genera una chiave nella pagina del tuo account e incollala nell'area di amministrazione di WPML quando richiesto: nel Setup Wizard durante la configurazione iniziale, oppure nel modulo integrato della chiave del sito nell'avviso di migrazione consolidato quando WPML lo richiede.
Per annullare la registrazione di un sito (ad esempio, perché lo stai dismettendo), fai clic su Annulla la registrazione di WPML da questo sito nel banner di registrazione in WPML > Attiva e aggiorna. La stessa schermata è quella in cui WPML installa e aggiorna i plugin: la chiave del sito in quel punto stabilisce a quale account appartengono quei download.
Rimuovere l'avviso “Questo sito è registrato come sito di sviluppo”
Un account WPML può registrare un sito di sviluppo per ogni sito di produzione. L'avviso del sito di sviluppo (“Questo sito è registrato su WPML.org come sito di sviluppo”) appare intenzionalmente in ogni pagina di amministrazione di WPML sul sito di sviluppo, per evitare che i cloni di sviluppo vengano trattati come siti di produzione.
Quando sei pronto a passare un sito dallo sviluppo alla produzione:
- Apri il tuo account WPML e trova il sito nell'elenco dei siti registrati.
- Cambia il suo tipo da Sviluppo a Produzione.
- Salva.
- Sul sito stesso, apri WPML > Attiva e aggiorna e fai clic su Controlla aggiornamenti. L'avviso del sito di sviluppo scompare una volta sincronizzata la modifica lato account.
Se l'avviso persiste dopo una sincronizzazione, esegui WPML > Supporto > Controllo del sistema > Aggiorna i dati della licenza. Questo cancella la cache locale della licenza e recupera nuovamente lo stato dell'account.
Registrare automaticamente i siti tramite una costante PHP
Per i flussi di lavoro automatizzati di sviluppo/staging/produzione (in cui il sito viene distribuito da una pipeline CI e non c'è alcun intervento umano per incollare una chiave), puoi inserire la chiave del sito direttamente in wp-config.php utilizzando le costanti PHP. WPML le legge durante l'attivazione e registra il sito senza alcuna richiesta.
In wp-config.php, prima della riga “Finito, interrompere le modifiche!”:
define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );WPML rileva la costante quando si attiva e salta la richiesta di registrazione. Lo stesso valore della chiave può essere impostato negli ambienti di sviluppo, staging e produzione. WPML li separa in base al dominio.
Questo è l'approccio corretto per gli ambienti in cui:
- Il sito viene distribuito tramite script Docker / Composer / WP-CLI e non c'è alcun passaggio di configurazione manuale.
- Gestisci molti siti e vuoi che la registrazione sia dichiarativa e non tramite clic.
- L'avviso di migrazione consolidato richiede una chiave in un ambiente appena distribuito.