Registar a licença

O WP Staging CLI requer uma licença WP Staging Pro válida (plano Agency ou Developer) para extrair ou restaurar Backups. Este guia explica como registar e gerir a tua licença.

Registar a tua licença (recomendado)

A forma mais fácil de usar a tua licença é registá-la uma vez. Após o registo, a tua chave de licença é encriptada e guardada localmente, por isso não precisas de a introduzir novamente.

Modo interativo:

wpstaging register

Vai-te ser pedido que introduzas a tua chave de licença. O CLI vai validá-la com os servidores do WP Staging e armazená-la de forma segura.

Modo não interativo (para scripts/automação):

wpstaging register --license=YOUR_LICENSE_KEY

Após o registo: Podes correr qualquer comando sem a flag --license. A tua chave de licença é encriptada e validada automaticamente.

Métodos alternativos

Se preferes não armazenar a tua licença, podes fornecê-la de outras formas:

Variável de ambiente

Define a variável de ambiente WPSTGPRO_LICENSE para usar a tua licença sem a armazenar:

Linux, macOS, WSL:

# Set for current session
export WPSTGPRO_LICENSE=YOUR_LICENSE_KEY

# Or add to ~/.bashrc or ~/.zshrc for permanent use
echo 'export WPSTGPRO_LICENSE=YOUR_LICENSE_KEY' >> ~/.bashrc

Windows PowerShell:

# Set for current session
$env:WPSTGPRO_LICENSE="YOUR_LICENSE_KEY"

# Or add to your PowerShell profile for permanent use
Add-Content $PROFILE '$env:WPSTGPRO_LICENSE="YOUR_LICENSE_KEY"'

Windows CMD:

set WPSTGPRO_LICENSE=YOUR_LICENSE_KEY

Flag por comando

Também podes fornecer a tua chave de licença diretamente em cada comando:

wpstaging extract --license=YOUR_LICENSE_KEY backup.wpstg
wpstaging restore --license=YOUR_LICENSE_KEY --path=/var/www/html backup.wpstg

Desativar a licença

Para desativar a tua licença nos servidores do WP Staging e remover a chave armazenada:

wpstaging deactivate

Este comando:

Contacta os servidores do WP Staging para desativar a tua licença
Remove a chave de licença armazenada na tua máquina local
Liberta um slot de licença na tua conta

Alias: Também podes usar wpstaging unregister como alternativa ao deactivate.

Remover licença armazenada (apenas local)

Para remover apenas a licença armazenada localmente sem a desativar no servidor:

wpstaging clean license

Isto apenas remove o ficheiro de licença local. A licença mantém-se ativa na tua conta WP Staging. Usa isto se quiseres mudar para uma licença diferente ou voltar a introduzir a tua chave.

Ordem de prioridade da licença

O WP Staging CLI procura a licença por esta ordem:

Flag da linha de comandos: --license=KEY
Variável de ambiente: WPSTGPRO_LICENSE
Licença armazenada: a partir de wpstaging register

É usada a primeira licença válida encontrada.

Resolução de problemas

Validação da licença falhou

Se vês um erro de validação de licença:

Confirma que a chave de licença está correta
Verifica que a tua subscrição WP Staging está ativa
Garante que tens uma licença Agency ou Developer (não Personal)
Verifica a tua ligação à internet

Licença já ativada

Cada licença pode ser ativada num número limitado de dispositivos. Se atingiste o teu limite:

Desativa a licença num dispositivo não utilizado: wpstaging deactivate
Ou compra slots de licença adicionais em wp-staging.com

Não consigo ligar ao servidor de licenças

Se o CLI não consegue alcançar os servidores do WP Staging:

Verifica a tua ligação à internet
Confirma que wp-staging.com é acessível a partir da tua rede
Se estás atrás de uma firewall corporativa, garante que o tráfego HTTPS de saída é permitido

Próximos passos

Com a tua licença registada, estás pronto para começar a usar o WP Staging CLI: