All Systems Operational
Powered By
profound-logo
profound-logoProfound CMS
⌘K
Admin

Configurar Proxy Do Painel Administrativo

configurar proxy do painel administrativo

Continue Reading
Previous‹SseNextRenderização estática com suporte ao modo de edição›

Híbrido

Projeto RenderizadorRoteamento ParamétricoTipos De ComponentesSseConfigurar Proxy Do Painel AdministrativoRenderização estática com suporte ao modo de ediçãoScripting no Construtor de TemplatesCreate Profound Next

Sem interface

Início rápidoJson E Claude CodeComponente Zod Puxar

Mcp

Mcp

Recursos Do Cms

Recurso Modelo De DocumentosRecurso Construtor De ModelosTradutor De FuncionalidadesRecurso Organizacao

Motivação

Nossa Abordagem

Terminologia

Hibrido Vs Headless

Anexar o painel de administração ao seu site é um passo simples


Por que isso é necessário

Isso garante que sua experiência de edição seja contínua. Com o painel de administração anexado ao seu site por meio de um proxy, você pode editar seu site na mesma URL e ter uma visualização das alterações em tempo real. Também permite a edição sobreposta, o que proporciona uma experiência de usuário melhor ao editar a página.


Passos Necessários

Configuração do proxy (há alguns detalhes)

A configuração do proxy é apenas um arquivo proxy.ts no seu projeto que se comporta como uma reescrita de URL, permitindo que o endpoint /admin do seu site seja direcionado para o CMS.

  • Para localhost: você deve usar um túnel (já que o CMS não consegue acessar localhost diretamente)
  • Funciona perfeitamente em sites publicados

Configuração do Proxy

// proxy.ts
import { createCmsProxy } from 'cms-renderer/lib/proxy';

export const proxy = createCmsProxy({
  upstream: "https://cms.dev.tryprofound.com", // painel de administração do CMS
});

export const config = {
  matcher: [
    '/admin',
    '/admin/:path*',
    '/api/:path*',
    '/auth/:path*',
    '/_next/:path*',
    '/((?:.*\\.(?:css|js|map|png|jpg|jpeg|gif|svg|ico|webp|avif|woff|woff2|ttf|eot|txt|xml))$)',
  ],
};

Agora você pode acessar: /admin para abrir o painel de administração a partir do seu site. Isso habilita a pré-visualização ao vivo.


Resolução dos Parâmetros de Busca do Renderizador

As sobreposições são tratadas automaticamente. Você só precisa passar searchParams para o seu renderizador.

// page.tsx
interface PageProps {
  params: Promise<{ slug: string[] }>;
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>;
}



Como Verificar

  1. Acesse /admin no seu site
  2. Deve pedir que você faça login e abrir imediatamente o painel de administração do CMS

As sobreposições e as pré-visualizações ao vivo devem funcionar automaticamente.


export
default
async
function
Page
({
params
,
searchParams
}
:
PageProps
) {
const { slug } = await params;
return (
<ParametricRoutePage
registry={registry}
apiKey="sk_..."
websiteId="a2717ba3-29db-..."
cmsUrl={"https://cms.dev.tryprofound.com"}
params={Promise.resolve({ slug })}
searchParams={searchParams}
/>
);
}