Acervo Vivo
Acervo Vivo Central de Ajuda
← Voltar

Acervo Vivo Sync: Integração de Acervo de Arte no WordPress

"Aplica-se a: Studio, Guardian, Galleria" "Keyword: sincronizar acervo wordpress integracao plugin sync api webhooks" "Title: Acervo Vivo Sync: Sincronização e Integração de Acervo no WordPress | Central de Ajuda - Acervo Vivo" "Meta: Conecte a curadoria do Acervo Vivo ao seu site WordPress. Sincronize obras, exposições e publicações em tempo real com total soberania." "Slug: plugin-wordpress" "Alt-Capa: Painel de controle do plugin WordPress Acervo Vivo Sync de integração de acervo de arte" "HelpContext: settings" "Guardião Oficial: SME Central de Ajuda e Adinha (IA)"

O Acervo Vivo Sync é o plugin WordPress oficial para sincronizar e expor o catálogo da plataforma curatorial Acervo Vivo (Headless CMS/Airtable). Ele automatiza o espelhamento físico de mídias, gerencia taxonomias e expõe dados em tempo real sob medida para artistas, galerias e colecionadores.

O que é o Acervo Vivo Sync?

O Acervo Vivo Sync é a ponte inteligente entre a curadoria física/catalogação da sua plataforma e o seu site público. Criado sob medida para artistas, galerias e acervos privados, o plugin recria nativamente no WordPress todas as suas obras de arte, mostras, ensaios críticos e catálogos de livros em estruturas organizadas de forma limpa, rápida e totalmente otimizada para o Google.

Diferenciais Técnicos e de Curadoria

Foco Absoluto na Obra (Sem distrações)

O site é projetado para destacar o trabalho artístico. Fichas técnicas, legendas e carrosséis adicionais de imagens são integrados de forma limpa e fluida. As listas de exposições e bibliografias nas páginas de obras são apresentadas em formato textual simples, evitando links de saída que dispensam o foco do seu visitante.

Sincronização Automática ou Em Tempo Real (Instantâneo)

Chega de esperar o dia virar para refletir uma alteração de status ou uma venda. Além da sincronização diária em segundo plano, o plugin possui integração com Webhooks, permitindo que qualquer alteração de curadoria ou disponibilidade no painel reflita no seu site WordPress em poucos segundos.

Soberania Digital (Seus dados pertencem a você)

Livre-se da dependência de plataformas exclusivas (vendor lock-in). Se você decidir cancelar a assinatura, o seu site WordPress permanece 100% no ar, funcional e com todos os dados técnicos e imagens intactos e locais. A plataforma funciona apenas como o canal de curadoria; o legado digital gerado é irrevogavelmente seu.

Asset Mirroring (Imagens Locais e Protegidas)

Ao invés de carregar links temporários da nuvem que expiram rapidamente, o plugin realiza o download físico das fotos principais e carrosséis de imagens diretamente para a Biblioteca de Mídia do seu próprio servidor WordPress, garantindo que as imagens nunca fiquem quebradas.

Pronto para Desenvolvedores e SEO

Com Custom Post Types nativos (obras, exposicoes, textos, publicacoes) e links amigáveis, o plugin é compatível com qualquer tema do mercado e permite que o desenvolvedor do seu site customize o layout como desejar.

Como Funciona? (4 Passos Simples)

  1. Instale o Plugin: Baixe o arquivo .zip e faça o upload na seção "Plugins" do seu WordPress.
  2. Conecte com sua API ID: Insira a chave única de conexão gerada no seu painel do Acervo Vivo na tela de configurações do plugin.
  3. Force a Primeira Sincronização: Acesse as configurações do Acervo Vivo Sync no painel do WordPress e force a primeira sincronização de dados para carregar o seu acervo no site.
  4. Crie suas Grades Visuais: Use o shortcode [acervo_grade tipo="obras"] para renderizar instantaneamente uma galeria responsiva em qualquer página, utilizando os construtores de sua preferência (Gutenberg, Elementor ou Construtor Clássico).

Funcionalidades Principais

  • Sincronização em Tempo Real (Webhook): Atualização instantânea de status de venda ou novas obras sem depender do agendamento diário.
  • Renderização Dinâmica (Arquitetura Limpa): Mantém o banco de dados limpo gravando apenas textos brutos (post_content), montando os layouts premium e badges em tempo de exibição via hook the_content.
  • Segurança contra Sobrecarga (Race Conditions): Sistema de trava de concorrência que impede "tempestades de sincronização" no servidor (retorna 409 Conflict).
  • Asset Mirroring (Download Local): Salva as fotos na biblioteca do WordPress de forma idempotente, contornando a expiração de assinaturas CDN externas.
  • Resolução de IDs Nativos: Traduz as relações do Airtable em IDs de posts reais do WordPress (_acervo_wp_*_ids) para consultas rápidas no frontend.

Sincronização em Tempo Real

Além da sincronização automática diária em segundo plano, você pode atualizar as informações no seu site WordPress de forma instantânea de duas maneiras:

1. Botão "Atualizar Site" (Recomendado — Sem custo de automação)

Após finalizar a organização, edição ou reordenação de suas obras na plataforma, acesse a seção de Palavras-chave no menu lateral, selecione a palavra-chave "Site" (🌐Site/Ecommerce) e clique no botão "Atualizar Site" no cabeçalho.

  • Atenção à Aba Ativa: A reordenação de obras pelo botão "Organizar" (Drag & Drop) apenas é permitida enquanto você estiver na aba "Únicos" (Trabalhos). Na aba "Todos", o botão "Organizar" fica desativado por questões de integridade do catálogo, já que exibe tiragens intercaladas.
  • Visibilidade: O botão "Atualizar Site" só estará visível se a sua palavra-chave for da categoria Site e se a sua conta estiver habilitada para uso de API Headless nas configurações de Perfil.
  • Esse comando dispara uma chamada direta e segura para o seu site WordPress iniciar a sincronização em segundo plano imediatamente, sem consumir sua cota de automações do banco de dados e sem travar o painel durante o salvamento.

2. Automação Automática (Airtable)

Configurando uma regra de automação no banco de dados que chama a API do seu site de forma invisível toda vez que uma obra é editada.

Rota do Webhook de Integração (REST API)

O plugin expõe um endpoint REST público e seguro para receber alertas de alteração da plataforma de curadoria.

Rota do Webhook

  • URL: POST /wp-json/acervo-vivo/v1/sync-trigger
  • Content-Type: application/json

Autenticação

A chamada exige o identificador exclusivo apiId (o mesmo salvo nas configurações do plugin) passado de duas formas:

  1. No cabeçalho da requisição HTTP: X-Acervo-API-ID
  2. No payload JSON: apiId

Exemplos de Teste do Gatilho

Teste 1: Autenticação via Cabeçalho (cURL)

Substitua seu-site.com e seu-api-id com os dados correspondentes:

curl -X POST https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger \
  -H "Content-Type: application/json" \
  -H "X-Acervo-API-ID: seu-api-id"

Teste 2: Autenticação via Corpo JSON (cURL)

curl -X POST https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger \
  -H "Content-Type: application/json" \
  -d '{"apiId": "seu-api-id"}'

Teste 3: Utilizando PowerShell

$headers = @{
    "Content-Type" = "application/json"
    "X-Acervo-API-ID" = "seu-api-id"
}
Invoke-RestMethod -Uri "https://seu-site.com/wp-json/acervo-vivo/v1/sync-trigger" -Method Post -Headers $headers

Respostas da API (HTTP Status Codes)

  • 200 OK: Sincronização concluída com sucesso. Exemplo de retorno:
    {
  "status": "success",
  "message": "[Webhook] Sincronização via Webhook realizada com sucesso: 12 Obras, 2 Exposições...",
  "stats": {
    "created": 1,
    "updated": 5
  }
}
  • 401 Unauthorized: Chave apiId inválida, ausente ou não configurada no painel.
  • 409 Conflict: Outra rodada de sincronização já está ativa no servidor (trava de segurança temporária ativa).
  • 500 Internal Server Error: Instabilidade na conexão com o servidor do Acervo Vivo ou falha fatal na ingestão de dados.

Exibição de Grades (Shortcode)

Insira o shortcode em qualquer editor de blocos, Elementor ou construtor clássico:

  • Listagem de Obras: [acervo_grade tipo="obras"]
  • Filtrar Obras por Linguagem: [acervo_grade tipo="obras" linguagem="Colagem"]
  • Filtrar Obras por Série: [acervo_grade tipo="obras" serie="Paisagens"]
  • Limitar quantidade: [acervo_grade tipo="obras" limite="6"]
  • Definir colunas fixas responsivas (ex: 3 colunas): [acervo_grade tipo="obras" colunas="3"]
  • Exibir imagem cheia sem cortes (ajuste vertical/horizontal centralizado): [acervo_grade tipo="obras" imagem="contain"]
  • Exemplo completo: [acervo_grade tipo="obras" serie="Gotas" colunas="3" imagem="contain"]