E EmDash CMS Everything Guides, use cases, plugins, templates
Português

O registo de plugins

Nesta página

O registo de plugins é o catálogo suportado para plugins sandbox. Qualquer pessoa pode explorar plugins publicados em plugins.emdashcms.com. Os administradores podem revê-los e instalá-los a partir da secção Registry do painel de administração EmDash.

O EmDash usa o registo hospedado em https://registry.emdashcms.com por padrão quando o site tem um sandbox de plugins ativado.

Nomes públicos de plugins

Cada plugin do registo tem um nome público formado pelo handle atual da conta Atmosphere do seu editor e pelo slug do pacote. Por exemplo, um pacote com o slug my-gallery publicado por example.com aparece como @example.com/my-gallery.

O nome público aparece nos resultados do registo e em Plugins após a instalação. Selecione-o para abrir a página de detalhes do plugin, ou cole o nome completo na pesquisa do registo para encontrar esse pacote exato. O EmDash resolve o handle para o identificador de conta estável do editor antes de carregar o pacote.

Se o handle deixar de se resolver conclusivamente para o editor, o EmDash exibe INVALID HANDLE e impede novas instalações a partir da página de detalhes do pacote. As instalações existentes permanecem no seu estado atual para que uma pesquisa de identidade não possa desativar um site em execução. Reveja o plugin instalado e contacte o seu editor antes de o atualizar. Uma falha temporária de pesquisa exibe o identificador de editor estável com Handle unavailable em vez de reportar um handle inválido.

Ativar instalações do registo

Para instalar plugins do registo, configure armazenamento e um runner sandbox disponível. Complete primeiro a configuração do sandbox de plugins específica da plataforma.

Adicione o runner sandbox Cloudflare à configuração emdash() em astro.config.mjs:

import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: sandbox(),
		}),
	],
});

O EmDash exibe o catálogo Registry após o runner sandbox estar configurado. Consulte a referência de configuração registry para selecionar um agregador diferente, definir política de registo ou desativar a descoberta.

Instalar um plugin do registo

  1. Abra Registry no painel de administração.
  2. Pesquise por título, descrição ou um nome público completo como @example.com/my-gallery, depois abra a página de detalhes do plugin.
  3. Selecione uma versão e reveja o seu editor, metadados, permissões solicitadas e estado de verificação.
  4. Selecione Install.
  5. Reveja o estado de verificação e as permissões na caixa de diálogo de consentimento, depois confirme.

Antes de mostrar a caixa de diálogo de consentimento, o EmDash verifica a soma de verificação, nome, versão e permissões do bundle transferido. Se o editor exigir proveniência de compilação, o EmDash verifica essa evidência também. A instalação para se uma verificação falhar. A caixa de diálogo de consentimento mostra o estado de verificação e as permissões exatas antes da instalação.

As atualizações do registo repetem estas verificações. Uma atualização aguarda confirmação quando adiciona permissões ou ferramentas MCP, ou muda uma rota de autenticada para pública. A desinstalação remove o bundle e preserva os dados de armazenamento do plugin a menos que selecione Also delete plugin storage data. Consulte Instalar plugins para os passos partilhados de atualização e desinstalação.

Páginas relacionadas