logo

Paleta - Deixe colorido🎨

Palette — Construtor visual de páginas. Não precisa ser designer.

Demonstração ao vivo Baixar Palette

Scroll
  1. Início

Sincronizar páginas do Palette entre sites com o Palette Pro (Channel + Pull)

O canal do Palette Pro permite que um site leia as páginas do Canvas de outro site via HTTP. Um site fonte expõe suas páginas; um site destino o registra como remoto e puxa as páginas que deseja — com um status por página de Nova / Precisa de atualização / Sincronizada, para que você sempre saiba o que está desatualizado. Ele permite sincronizar páginas entre Staging e Produção.

Neste passo a passo, a fonte é o staging (stg.drupalbook.org) e o destino é a produção (drupalbook.org). Vamos sincronizar uma página que mostra as estruturas de layout do componente Row.

Staging
stg.drupalbook.org
fonte · Channel
HTTP →/palette-pro/channel
Production
drupalbook.org
destino · Remote + Pull

A página que estamos sincronizando

Nossa página de staging empilha vários layouts Row — colunas iguais, um 1/3 + 2/3 deslocado, uma linha de quatro colunas, um multi-linha full + 2, e um arranjo com barra lateral — cada célula rotulada para que a estrutura seja óbvia.

A página de exemplos Row no staging, mostrando várias estruturas de colunas.
A página de exemplos Row em stg.drupalbook.org (a fonte).
Antes de começar Ambos os sites precisam dos mesmos módulos — canvas, canvas_palette, palette_pro — e da mesma versão do provedor de componentes, para que a página seja renderizada de forma idêntica. O destino também deve conseguir alcançar a fonte via HTTP.

Step 1 Expor o canal na fonte

On staging, go to Configuration → Web services → Palette Sync channel and choose how the channel is protected:

  • No authentication — open; only for trusted networks / internal use.
  • HTTP Basic Auth — a Drupal user on the source holding the “Access the Palette Pro channel” permission.
  • Access token — a secret sent in the X-Palette-Sync-Token header (there's a “Generate” button).
Palette Sync channel settings on staging with three authentication options.
Channel settings on the source. The endpoints are /palette-pro/channel/pages and /palette-pro/channel/page/{uuid}.
Use autenticação na internet pública “No authentication” is fine for a trusted staging → production link on the same infrastructure. For anything reachable publicly, pick a token or Basic Auth and use the matching credentials on the remote in Step 2.

Step 2 Adicionar o remoto no destino

On production, go to Configuration → Web services → Palette Sync remotes and Add sync remote:

  • Label — e.g. “Staging”.
  • Source site URL — the source's base URL, https://stg.drupalbook.org (no channel path).
  • Authentication — match the source's setting (here, none).
Palette Sync remotes list on production showing the Staging remote.
The remotes list on production, with the Staging remote pointing at the source.

Step 3 Puxar a página

Use the remote's Pull pages operation. You get a paged list of the source's pages, each with a status badge:

BadgeMeaning
NewNo page with this UUID exists on the destination yet.
Needs updateA copy exists, but the source changed since you last synced it.
SyncedThe destination copy is up to date with the source.

Our Row page shows as New — it isn't on production yet. Tick it and press Sync selected pages.

Pull pages listing with the Row page marked New.
Pull pages from Staging — the Row page is New; others already exist but Need update.

Palette Pro fetches the page's bundle over the channel and imports it — media, files and the pinned component versions included — matched by UUID. The page flips to Synced.

Pull pages listing after syncing, showing Synced 1 page and a green Synced badge.
“Synced 1 page.” — the Row page is now Synced with the source.

Step 4 Verificar na produção

Rebuild caches (drush cr) and open the page at its alias (/row-examples). Every Row structure renders on production exactly as it did on staging — the component tree, pinned versions and any media all carried across the channel.

The synced Row examples page rendered on production.
The synced page live on drupalbook.org (production) — identical to the source.
Done Uma página construída no staging agora está na produção, puxada pelo canal com dois cliques — sem arquivo de exportação para baixar, copiar e enviar.

Como funcionam o status e a ressincronização

The destination compares each source page's last changed time against the value it recorded the last time it synced that page. So:

  • Edit the page on staging → on the next listing it shows Needs update on production.
  • Pull it again → it updates the same page in place (matched by UUID, never duplicated) and returns to Synced.

Prefere a linha de comando? O mesmo pacote está disponível via Drush — exporte na fonte, importe no destino:

# no staging
drush palette-sync:export 5 --out=row.json
# na produção
drush palette-sync:import row.json

O canal simplesmente automatiza isso via HTTP, com a listagem de status por cima.

Notas e pegadinhas

  • Mantenha as versões sincronizadas. Se a produção rodar uma versão diferente dos componentes em relação ao staging, a página ainda importa mas pode não ficar pixel-idêntica — alinhe as versões dos módulos.
  • Idempotente por UUID. Puxar novamente atualiza no lugar; nunca cria duplicatas.
  • Acessibilidade. O PHP do destino deve conseguir alcançar a URL do canal da fonte via HTTP(S); proteja um canal público com token ou Basic Auth.
  • Múltiplas fontes. Um destino pode registrar vários remotos e puxar de cada um.

Capturas de tela feitas nos sites reais stg.drupalbook.org (fonte) e drupalbook.org (destino) durante uma sincronização real.