Criar um plugin no Domain System v2.7.0 é simples, direto e sem mágica escondida. Como desenvolvedor autodidata, projetei o sistema para ser o mais enxuto e transparente possível. Não usamos frameworks gigantescos nem centenas de pacotes de terceiros: tudo roda em PHP limpo, com contratos bem definidos e uma arquitetura orientada a eventos.
Neste tutorial passo a passo, você vai aprender a construir um plugin do zero, com:
plugin.json;osRegister, osBoot, activate, deactivate);$_SESSION, $_POST) diretamente. Todos os componentes do ecossistema Domain utilizam Providers e Interfaces para garantir segurança e testabilidade com 100% de cobertura.
Você pode criar o esqueleto do seu plugin em segundos usando o comando de console:
php os-cli.php make:plugin meu_app
Se você usa ferramentas de Inteligência Artificial (GitHub Copilot, Cursor, Gemini, Claude ou Cline), consulte o nosso Guia de Contratos para IA para gerar plugins perfeitamente compatíveis de primeira.
Crie uma pasta em src/Plugins/meu_app. O ponto de partida é o arquivo de manifesto plugin.json:
{
"name": "meu_app",
"version": "1.0.0",
"description": "Meu primeiro módulo no Domain System v2.7.0",
"author": "Seu Nome ou Comunidade",
"os_version": "2.7"
}
A classe Plugin.php gerencia as fases de Negociação (osRegister), Execução (osBoot) e Instalação (activate).
<?php namespace DomainSystem\Plugins\meu_app; use DomainSystem\Core\Plugin\AbstractPlugin; use DomainSystem\Core\Contracts\OsExtensionInterface; use DomainSystem\Core\Contracts\OsConnectorInterface; use DomainSystem\Core\Contracts\OsRuntimeInterface; class Plugin extends AbstractPlugin implements OsExtensionInterface { // 1. NEGOCIAÇÃO: Declara dependências e hooks ouvidos public function osRegister(OsConnectorInterface $os): void { $os->requireLink('core.identity'); $os->requireLink('core.database'); $os->listenHook('admin_menu.register'); $os->listenHook('dashboard.register_widgets'); } // 2. EXECUÇÃO: Registra rotas, menus e ouve eventos public function osBoot(OsRuntimeInterface $runtime): void { // Registra uma rota pública no sistema $runtime->addRoute('GET', '/meu-app', function() { return '<h1>Olá mundo do Plugin Meu App!</h1>'; }); // Adiciona um item no menu do painel administrativo $runtime->onHook('admin_menu.register', function(&$menuItems) { $menuItems[] = [ 'title' => 'Meu App', 'url' => '/admin/meu-app', 'icon' => 'box' ]; }); // Registra um widget no Dashboard $identity = $runtime->getLink('core.identity'); $runtime->onHook('dashboard.register_widgets', function($registry) use ($identity) { $registry->registerProvider(new MeuWidgetProvider($identity)); }); } // 3. INSTALAÇÃO: Executado apenas uma vez ao clicar em Ativar public function activate(OsRuntimeInterface $runtime): void { $db = $runtime->getDb(); $db->exec("CREATE TABLE IF NOT EXISTS ds_meu_app_itens ( id INTEGER PRIMARY KEY AUTOINCREMENT, titulo VARCHAR(255) NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP )"); // Registra a permissão no controle de acessos (ACL) $runtime->registerCapability('meu_app.acessar', 'Módulo Meu App'); } public function deactivate(OsRuntimeInterface $runtime): void {} public function uninstall(OsRuntimeInterface $runtime): void {} }
Para adicionar caixas e resumos no painel sem injetar HTML no vazio, implemente DashboardWidgetProviderInterface:
<?php namespace DomainSystem\Plugins\meu_app; use DomainSystem\Core\Contracts\DashboardWidgetProviderInterface; use DomainSystem\Core\Contracts\SessionManagerInterface; use DomainSystem\Core\Security\IdentityManager; class MeuWidgetProvider implements DashboardWidgetProviderInterface { private IdentityManager $identity; private ?SessionManagerInterface $session; public function __construct(IdentityManager $identity, ?SessionManagerInterface $session = null) { $this->identity = $identity; $this->session = $session; } public function getProviderName(): string { return 'Meu App Widgets'; } public function getAvailableWidgets(): array { return [ 'resumo_meu_app' => [ 'title' => 'Status do Meu App', 'description' => 'Métricas e avisos rápidos' ] ]; } public function renderWidget(string $widgetId): string { if ($widgetId === 'resumo_meu_app') { $userId = (int)($this->session?->get('auth_user_id', 0) ?? 0); if (!$this->identity->userCan($userId, 'meu_app.acessar')) { return '<div class="error">Acesso restrito.</div>'; } return '<div class="card"><h4>Meu App Ativo!</h4><p>Tudo operando normalmente.</p></div>'; } return ''; } }
No Domain System v2.7.0, você não precisa editar o core para ter documentação do seu plugin. Basta criar o arquivo src/Plugins/meu_app/manual/module.php retornando uma classe que implemente ManualModuleInterface:
<?php // src/Plugins/meu_app/manual/module.php require_once __DIR__ . '/MeuAppManualModule.php'; return new \DomainSystem\Plugins\meu_app\manual\MeuAppManualModule();
O PluginManualScanner detecta seu módulo automaticamente e o insere no menu Manual de Instruções (/admin/manual) com seu checklist de homologação e guia interativo!
Este sistema nasceu da necessidade real de um ambiente web enxuto, independente de gigantes corporativos, capaz de rodar uma loja, portal ou aplicação inteira em um servidor modesto consumindo menos de 30 MB.
Sou um desenvolvedor autodidata. Utilizo Inteligências Artificiais constantemente na bancada de trabalho para auditar linha por linha do código, caçando brechas de segurança, falhas de lógica e gargalos de performance. Mas nada substitui o olhar de outros programadores humanos experientes.
Se você entende de arquitetura PHP, segurança, testes automatizados ou usabilidade, venha somar conosco! Abra uma issue, proponha um Pull Request ou ajude a revisar nossos contratos:
👉 GitHub: github.com/hadelrachid/domain-system | Wiki: github.com/hadelrachid/domain-system/wiki