Trabalhando em um site que alguém compartilhou com você

O proprietário de um site pode conceder a você acesso a um de seus sites — não à conta dele, não à cobrança, não aos outros sites dele —, e você trabalha nele com o seu próprio login do Zinn Digital® e a CLI gratuita do Zinnector®. Este guia cobre ambas as partes disso: o que o proprietário faz e o que você faz.

Se você nunca usou o Zinnector® antes, Introdução ao Zinnector® faz a instalação em cerca de dois minutos. Nada aqui exige que você compre hospedagem.

Para o proprietário do site — compartilhando um site

1. Abra o site no seu painel e vá para Segurança.
2. Em Quem mais pode acessar este site, escolha Compartilhar este site.
3. Digite o endereço de e-mail do desenvolvedor. Ele ainda não precisa ter uma conta — se nunca tiver feito login, ele receberá um convite e o acesso começará no momento em que o aceitar.
4. Escolha uma função:

• Visualizador — pode ver, mas não pode alterar nada.
• Editor — a função que um desenvolvedor normalmente precisa. Ele pode alterar os arquivos do site, usar o wp-admin e baixar um arquivo compactado do site para trabalhar nele localmente. Esse arquivo compactado inclui o banco de dados.
• Gerente — tudo o que um editor pode fazer, além de restaurar um backup.

1. Forneça um motivo e, se o trabalho tiver uma data de término, uma data de expiração. A permissão simplesmente para de contar nessa data; você não precisa se lembrar de removê-la.
2. Salve.

Independentemente do que você escolher, um colaborador nunca poderá excluir o site, ver sua cobrança ou acessar qualquer um dos seus outros sites.

O que "o arquivo compactado inclui o banco de dados" significa

Um editor ou um gerente pode obter uma cópia do site para trabalhar, e a cópia de um site consiste em seus arquivos e seu banco de dados. Um banco de dados do WordPress armazena tudo o que seus visitantes forneceram ao site — nomes e endereços de e-mail de comentaristas, contas de clientes, pedidos e endereços de entrega do WooCommerce, envios de formulários.

Normalmente, isso é exatamente o que um desenvolvedor precisa: sem isso, ele estará vendo seu tema em um site vazio. Vale a pena saber disso, porque são dados pessoais reais e as pessoas a quem pertencem são seus clientes, não os nossos.

Duas coisas decorrem disso, e a plataforma faz ambas para você:

• Todas as exportações ficam no seu registro de auditoria. Abra Registro de auditoria e procure por site.backup.exported. Cada linha indica quem realizou a ação, quando e se esse arquivo compactado trazia o banco de dados. Você não precisa perguntar.
• Você pode encerrar o acesso a qualquer momento. A revogação é instantânea — veja abaixo.

Se preferir que eles trabalhem sem o banco de dados, diga-lhes para adicionar --no-database ao fazer o pull; é apenas uma flag e o restante funciona da mesma forma.

Para o desenvolvedor — colocando o site na sua máquina

1. Instalar o Zinnector®

npm install -g zinnector
zinnector --version

Você precisa do Node 24 ou mais recente. node --version deve exibir v24 ou superior.

2. Entrar com a sua própria conta

zinnector login

Isso abre o seu navegador e faz o login com a sua própria conta do Zinn Digital® — aquela para a qual o convite foi enviado. Você nunca precisa da senha do proprietário, e ele nunca precisa fornecer uma para você.

Verifique o que foi concedido a você:

zinnector sites

Você verá exatamente os sites compartilhados com você, e nada mais. Se a lista estiver vazia, o convite ainda não foi aceito, a permissão foi revogada ou expirou.

3. Baixar o site (pull)

zinnector clone client-domain.com
cd client-domain.com

O comando clone cria um projeto local a partir do site hospedado. Ele obtém:

• wp-content — os temas, plugins, mu-plugins, idiomas e mídias que fazem parte do trabalho próprio do site;
• o banco de dados, gravado em database.sql no projeto.

Ele deixa propositalmente de fora o núcleo do WordPress (seu ambiente de execução local fornece a versão correta), o arquivo wp-config.php (ele contém a senha do banco de dados do site ativo) e qualquer mídia que tenha sido descarregada para o armazenamento de objetos.

Cada execução exibe exatamente o que foi obtido e o que foi deixado de fora, com contagens. Se você quiser apenas os arquivos, adicione --no-database.

Já tem o projeto e quer apenas a versão mais recente? Execute zinnector pull dentro dele.

4. Executar localmente, com o conteúdo real

zinnector dev --runtime docker

No ambiente de execução do Docker, isso importa o database.sql, reescreve a URL do site para o seu endereço local e abre o site com o conteúdo real do cliente nele. Faça login usando as contas do próprio WordPress do site.

O ambiente de execução padrão — WordPress Playground, que não precisa do Docker — inicia mais rapidamente e não importa o banco de dados; ele avisará você em vez de iniciar silenciosamente vazio. Use-o quando estiver trabalhando em código e não precisar do conteúdo.

5. Cuidar da cópia que foi fornecida a você

O arquivo database.sql é o banco de dados de um site ativo. O Zinnector® o adiciona ao .gitignore do seu projeto no momento em que o grava, para que um git add -A distraído não publique os clientes de alguém em um repositório. Não mexa nessa linha e exclua o arquivo quando o trabalho estiver concluído.

O que um colaborador pode e não pode fazer

| | Visualizador | Editor | Gerente | |---|---|---|---| | Ver o site e suas configurações | ✔ | ✔ | ✔ | | Alterar arquivos, usar o wp-admin, implantar | | ✔ | ✔ | | Fazer o pull do site, com banco de dados incluído | | ✔ | ✔ | | Restaurar um backup sobre o site ativo | | | ✔ | | Excluir o site | | | | | Ver a cobrança ou faturas | | | | | Acessar os outros sites do proprietário | | | |

As últimas três linhas ficam em branco para todas as funções. Elas não são uma configuração.

Encerrando o acesso

O proprietário abre a seção Segurança do site e escolhe Revogar ao lado do nome da pessoa. Isso entra em vigor imediatamente: o próximo comando do Zinnector® executado por esse desenvolvedor não conseguirá ver o site, assim como qualquer outro recurso que ele possua.

Uma data de expiração faz a mesma coisa em uma data específica, sem que ninguém precise se lembrar. Se você definiu uma ao compartilhar o site, o processo já está concluído.

Quando algo não funciona

• zinnector sites não exibe nada. O convite não foi aceito, ou a permissão foi revogada ou expirou. Peça ao proprietário para verificar a seção Segurança do site — um convite pendente é listado lá.
• zinnector pull informa que o site não tem nenhum backup recente. O comando obtém um novo se o plano permitir e pergunta primeiro. Se o plano não incluir backups sob demanda, aumente --max-age para aceitar um mais antigo.
• zinnector dev inicia um WordPress vazio. Você está usando o ambiente de execução Playground, que não importa um banco de dados. Execute zinnector dev --runtime docker.
• O site local continua redirecionando para o domínio ativo. A importação reescreve a URL do site; se essa etapa falhar, o comando informará o erro e exibirá a linha wp search-replace a ser executada.

Mais erros e suas correções: Solução de problemas do Zinnector®.