Hospedagem com 20% de desconto comprando pelo link

Publicar alterações

Mude um site que já está no ar sem perder o que o cliente publicou: o ciclo seguro, a publicação com versão e como a IA junta o trabalho de outras pessoas.

Depois que o site está no ar, o site no ar é o de verdade: o cliente publica posts, recebe leads, sobe imagens. Um campo novo, uma página nova ou outro cabeçalho é mudança de tema: você faz numa cópia, confere e publica só o tema.

A publicação tem versão: cada uma soma uma versão em cima do que está no ar e, antes, junta o que os outros publicaram. Ninguém perde trabalho.

O ciclo seguro

  1. Traga a produção para o seu computador

    A sua cópia local é atualizada com o tema, as imagens e o conteúdo do site no ar, sem dados pessoais, e você trabalha com o que é de verdade. Se ela tem mudanças de tema ainda não publicadas, a IA para e pergunta: atualizar sobrescreveria essas mudanças.

  2. Mude e confira no local

    Peça a mudança e olhe no navegador e no painel, no celular também.

  3. Publique só o tema

    Sobem os arquivos do tema. Conteúdo e banco, nunca.

  4. Confira no ar

    Abra as páginas que você mudou.

Peça à IA

Baixa o site de produção pro meu local, pra eu trabalhar com o conteúdo real.

Peça no começo de cada rodada de mudanças, não só na primeira vez.

Peça à IA

Atualiza o tema em produção: o campo novo de vídeo nos cases e a página do case que mostra ele. Mais nada.

A IA envia só o tema e responde com o número da versão nova e com o que juntou do trabalho de outras pessoas.

O que a IA roda
# atualizar a cópia local com o site no ar $ scripts/local/content.sh --project . # ver em http://localhost:8080 $ ./bin/velk serve 8080 # publicar o tema, com versão $ scripts/theme/publish.sh run --project . ▸ Bringing in what changed on the server ▸ Staging the new theme on the server ▸ Swapping it in ✓ Published as v5
Depois, em português claro: “Publicado como v5. Juntei as mudanças que o João publicou na v4: 2 arquivos, sem conflito.”

Como funciona a publicação com versão

O servidor guarda um registro do que está no ar: o número da versão, quem publicou e quando, e uma impressão digital de cada arquivo do tema. A sua cópia lembra de qual versão partiu. Na hora de publicar, a IA compara de onde você partiu, a sua cópia e o que está no ar:

  • Nada mudou no ar desde que você partiu: as suas mudanças sobem como a próxima versão.
  • Alguém publicou no meio do caminho, ou mexeu em arquivo direto no servidor: as mudanças dessa pessoa entram na sua cópia primeiro, depois tudo é conferido e publicado. Um arquivo que ela apagou sai da sua cópia também, e a IA diz qual.

Exemplo: no ar está a v3, e você e o João partem dela. O João publica a v4. Quando você publica, a sua cópia recebe as mudanças dele, é conferida e sobe como v5.

Quando a IA para e pergunta

SituaçãoO que acontece
Você e outra pessoa mudaram as mesmas linhas, ou o mesmo arquivoUm conflito. A IA mostra em português claro como o arquivo era, o que cada lado mudou e a combinação que propõe, ou você fica com um lado inteiro. Nada vai para o ar sem o seu OK.
A publicação apagaria arquivos que estão no arEla lista os arquivos e pergunta. Sem sim, nada é apagado.
Alguém está publicando agoraEla diz quem é e oferece tentar de novo em um minuto.
Uma publicação parou no meio há 15 minutos ou maisEla explica e pergunta antes de assumir. Uma publicação cortada no meio é terminada ou desfeita na próxima ação: o site nunca fica meio publicado.
O site já estava falhando antes da sua publicaçãoEla diz o que falha, que não foi a sua mudança, e pergunta antes de publicar mesmo assim, para mandar uma correção, por exemplo.

As verificações no caminho

Com a cópia local, antes de qualquer coisa sair do seu computador, a IA confere os arquivos PHP do tema e roda o schema:validate, que pega erro de estrutura no site.json (desde a v3.9.0 ele também avisa de template declarado cujo arquivo não existe, sem travar a publicação). No servidor, o tema novo fica preparado ao lado do que está no ar, é conferido, entra no lugar com duas renomeações instantâneas e é testado no ar: schema:validate, page:sync (que cria as páginas novas declaradas no site.json e mantém o que foi digitado no painel) e a home respondendo sem erro de servidor. Qualquer falha traz o tema anterior de volta na hora, e a versão não muda.

Se o CSS ou o JavaScript mudaram e o tema carrega esses arquivos sem uma versão no endereço, a IA avisa: o navegador guarda esses arquivos por um mês, e quem volta ao site veria o visual antigo.

O que uma publicação leva

Só o tema: site.json, templates, partials, functions.php, estilos, scripts e as imagens do tema. Nunca o conteúdo, o storage/uploads/, o .env do servidor ou o banco, e nunca arquivos de backup ou de sistema (*.bak, .DS_Store) nem arquivos PHP na raiz do tema além do functions.php. Versão nova do Velk é outro pedido (Atualizar o Velk).

Perguntas frequentes

Somos duas pessoas no mesmo tema. Precisamos de Git?

Para publicar, não: cada publicação junta o que os outros publicaram. O Git ainda ajuda no seu próprio histórico, mas nada do .git vai para o servidor nem vem de lá.

A primeira publicação pergunta de cada arquivo que mudei. Por quê?

A sua cópia ainda não tem ponto de partida, porque nunca foi trazida do site no ar: a pasta de onde você fez o deploy, por exemplo, ou um site que foi ao ar antes da publicação com versão. Cada arquivo do tema diferente do que está no ar vira uma pergunta; a IA pergunta e, quando a sua cópia é a que vale, fica com ela. Depois dessa publicação, ela passa a lembrar.