WordPress Extremo: Arquitetura e Engenharia de Plugins
E aí, dev! Aqui é o Asllan, e no Dia 3 da nossa jornada WordPress Extremo, vamos dar mais um passo rumo à arquitetura sólida: separar a lógica de acesso a dados usando a famosa camada de Repositórios.
Talvez você esteja se perguntando:
“Mas Asllan, WordPress já tem
$wpdb,get_posts()… pra quê repositório?”
Eu te explico 👇
🧠 O que é um Repositório?
Um Repositório é uma classe responsável por centralizar o acesso aos dados.
Em vez de espalhar chamadas ao banco ou queries por todo o código, você coloca tudo em um único lugar, organizado e com nomes claros.
🧽 Resultado:
- Código mais limpo
- Fácil de testar
- Fácil de trocar o tipo de armazenamento depois (ex: REST API, banco externo, etc.)
🎯 Exemplo no contexto WordPress:
Imagine que seu plugin precisa listar todos os usuários com role editor.
📉 Forma “bagunçada”:
$users = get_users(['role' => 'editor']);Você repete isso em vários lugares.
📦 Forma com repositório:
$repository = new UserRepository();
$editors = $repository->getEditors();
Agora a lógica está isolada, limpa e pronta pra crescer.
🧰 Mão na massa – Criando nosso primeiro Repository
Estrutura de pastas:
/src
/Hooks
- Init.php
/Services
- HelloService.php
/Repositories
- UserRepository.phpUserRepository.php
<?php
namespace WpArquiteturaExtrema\Repositories;
class UserRepository {
public function getEditors() {
return get_users([
'role' => 'editor'
]);
}
}HelloService.php (atualizado pra usar o repo)
<?php
namespace WpArquiteturaExtrema\Services;
use WpArquiteturaExtrema\Repositories\UserRepository;
class HelloService {
public function execute() {
$repo = new UserRepository();
$editors = $repo->getEditors();
foreach ($editors as $user) {
error_log("Editor encontrado: " . $user->display_name);
}
}
}Init.php continua igual:
namespace WpArquiteturaExtrema\Hooks;
use WpArquiteturaExtrema\Services\HelloService;
class Init {
public function register() {
add_action('init', [$this, 'init_plugin']);
}
public function init_plugin() {
$service = new HelloService();
$service->execute();
}
}🧠 Conclusão do Dia 3
- Usamos a camada de Repositório pra isolar o acesso a dados
- Evitamos acoplamento entre service e query
- Preparamos o terreno pra evoluir pra APIs, filtros avançados, cache, etc.
🔜 Próximo passo: Dia 4
Amanhã vamos introduzir injeção de dependência manual para facilitar ainda mais a arquitetura, criando um container simples de serviços.
