Requisitos
Antes de instalar o MIDDAG Account, verifique se o seu ambiente atende a todos os pré-requisitos.
Requisitos do servidor
- [ ] PHP 8.4 ou superior — O plugin utiliza recursos modernos do PHP (enums, typed properties, readonly classes). PHP 8.3 e versões anteriores não são suportados.
- [ ] WordPress 6.5 ou superior — Necessário para compatibilidade com a REST API e renderização da interface admin.
- [ ] WooCommerce 9.0 ou superior — O MIDDAG Account usa o WooCommerce como motor de comércio. Pedidos, produtos e processamento de pagamentos passam pelo WooCommerce.
- [ ] MySQL 8.0+ ou MariaDB 10.6+ — Requisitos padrão de banco de dados do WordPress.
- [ ] HTTPS habilitado — Necessário para comunicação segura via API, assinaturas de webhook e autenticação JWT.
Extensões PHP obrigatórias
Estas extensões precisam estar instaladas e habilitadas no seu servidor. A maioria dos servidores de hospedagem WordPress gerenciada já as inclui por padrão.
| Extensão | Finalidade |
|---|---|
curl | Comunicação com APIs externas (Stripe, HubSpot, etc.) |
dom | Processamento de XML/HTML |
intl | Internacionalização, formatação de moedas, tratamento de locale |
json | Codificação/decodificação JSON (nativo desde PHP 8.0) |
mbstring | Manipulação de strings multi-byte |
openssl | Assinatura JWT, comunicação segura |
simplexml | Parsing de XML para integrações |
soap | Integração de nota fiscal de serviço (NFSe) com ISSNet |
xml | Processamento de XML |
zip | Atualizações de plugin e manipulação de arquivos |
decimal | Cálculos financeiros precisos (evita erros de arredondamento com ponto flutuante) |
Verifique suas extensões PHP
Consulte seu provedor de hospedagem ou acesse Ferramentas > Saúde do Site no admin do WordPress. A tela de Saúde do Site informa extensões ausentes.
Especificações recomendadas de hospedagem
| Recurso | Mínimo | Recomendado |
|---|---|---|
| Limite de memória PHP | 128 MB | 256 MB ou mais |
| Tempo máximo de execução | 30 segundos | 60 segundos |
| Tamanho máximo de upload | 8 MB | 32 MB |
Limite de memória WordPress (WP_MEMORY_LIMIT) | 128 MB | 256 MB |
Esses valores são especialmente importantes durante a configuração inicial, importações grandes e no processamento de payloads de webhook do Stripe ou HubSpot.
Dependências Composer
O MIDDAG Account já vem com todas as dependências PHP incluídas no diretório vendor/. Você não precisa executar composer install — o ZIP do plugin já traz tudo. Principais bibliotecas utilizadas internamente:
- Symfony Dependency Injection Container
- Stripe PHP SDK
- HubSpot API Client
- Firebase PHP-JWT
- Carbon (manipulação de datas)
- Respect Validation
Requisitos de navegador (interface admin)
A interface admin do MIDDAG Account é uma aplicação React 19 que roda dentro do admin do WordPress. Ela requer um navegador moderno:
- [ ] Chrome / Edge 90+
- [ ] Firefox 90+
- [ ] Safari 15+
Internet Explorer não é suportado. A interface admin utiliza recursos JavaScript (ES2020+) que navegadores antigos não conseguem executar.
O que você NÃO precisa
- Sem necessidade de acesso via linha de comando — A instalação e configuração são feitas inteiramente pelo admin do WordPress.
- Sem Composer no servidor — As dependências já estão incluídas.
- Sem Node.js no servidor — A interface admin React já vem compilada.
- Sem banco de dados separado — O MIDDAG Account armazena dados no banco de dados existente do WordPress.
Verificação rápida de compatibilidade
- Acesse Ferramentas > Saúde do Site no admin do WordPress
- Clique na aba Informações
- Verifique Servidor > Versão do PHP (precisa ser 8.4+)
- Verifique Plugins Ativos se o WooCommerce aparece (precisa ser 9.0+)
- Verifique Servidor > Extensões PHP para a lista acima
Se algo estiver faltando, entre em contato com seu provedor de hospedagem antes de prosseguir para a Instalação.