MIDDAG Account

Portugues

English

Portugues

English

Appearance

Instalação ​

Este guia acompanha você na instalação e ativação do MIDDAG Account no seu site WordPress.

Antes de começar ​

Certifique-se de que o seu ambiente atende a todos os requisitos. Em especial:

  • PHP 8.4+ está rodando no seu servidor
  • WordPress 6.5+ está instalado
  • WooCommerce 9.0+ está instalado e ativado

Use um ambiente de testes primeiro

Recomendamos fortemente que você instale em um site de staging ou testes antes do ambiente de produção. Isso permite explorar o plugin e verificar a compatibilidade com seus plugins e tema existentes.

Passo 1: Enviar o plugin ​

  1. Baixe o arquivo ZIP do plugin MIDDAG Account
  2. No admin do WordPress, acesse Plugins > Adicionar Novo Plugin
  3. Clique em Enviar Plugin no topo da página
  4. Clique em Escolher Arquivo e selecione o arquivo ZIP que você baixou
  5. Clique em Instalar Agora
  6. Aguarde o WordPress extrair e instalar o plugin

Alternativamente, se você tem acesso via SFTP ou gerenciador de arquivos:

  1. Extraia o arquivo ZIP no seu computador
  2. Envie a pasta middag-account para /wp-content/plugins/ no seu servidor
  3. O caminho final deve ser /wp-content/plugins/middag-account/middag-account.php

Passo 2: Ativar o plugin ​

  1. Acesse Plugins > Plugins Instalados
  2. Encontre MIDDAG Account na lista
  3. Clique em Ativar

Ao ser ativado, o MIDDAG Account irá:

  • Registrar seus custom post types no banco de dados
  • Criar tabelas e opções necessárias no banco de dados
  • Configurar capabilities e roles padrão
  • Registrar seus endpoints da REST API

Passo 3: Verificar a instalação ​

Após a ativação, confirme que tudo está funcionando:

  1. Verifique o menu lateral. Você deve ver um novo item MIDDAG Account no menu lateral do admin do WordPress.
  2. Abra o dashboard. Clique em MIDDAG Account para abrir a interface admin. O dashboard principal deve carregar sem erros.
  3. Verifique a Saúde do Site. Acesse Ferramentas > Saúde do Site e confirme que não há problemas críticos relacionados ao MIDDAG Account.

Primeira vez?

Se esta é uma instalação nova, siga para a Configuração Inicial para configurar sua entidade empresarial e criar sua primeira organização.

Solução de problemas ​

"MIDDAG Account requires PHP 8.4 or higher" ​

Seu servidor está rodando uma versão mais antiga do PHP. Você precisa atualizar o PHP antes de ativar o plugin.

Como resolver:

  • Verifique no painel de controle da sua hospedagem (cPanel, Plesk ou similar) se há um seletor de versão PHP
  • Se você usa hospedagem WordPress gerenciada, entre em contato com seu provedor para solicitar PHP 8.4
  • Confirme a alteração em Ferramentas > Saúde do Site > Informações > Servidor > Versão do PHP

"MIDDAG Account requires WooCommerce 9.0 or higher" ​

O WooCommerce não está instalado, não está ativado ou está em uma versão anterior à 9.0.

Como resolver:

  • Acesse Plugins > Plugins Instalados e certifique-se de que o WooCommerce está ativo
  • Se o WooCommerce está ativo mas desatualizado, atualize para a versão 9.0 ou superior em Plugins > Atualizações
  • Após atualizar o WooCommerce, tente ativar o MIDDAG Account novamente

Plugin ativa mas o menu lateral não aparece ​

Isso geralmente indica um conflito com outro plugin ou um problema de permissões.

Como resolver:

  1. Certifique-se de que está logado como Administrador (não Editor ou Gerente de Loja)
  2. Tente desativar outros plugins um por vez para identificar conflitos
  3. Mude temporariamente para um tema padrão do WordPress (como Twenty Twenty-Five) para descartar conflitos de tema
  4. Verifique Ferramentas > Saúde do Site para problemas críticos

Tela branca ou erro fatal na ativação ​

Isso geralmente indica um problema de memória PHP ou compatibilidade.

Como resolver:

  1. Aumente o limite de memória PHP para pelo menos 256 MB (edite o wp-config.php e defina define('WP_MEMORY_LIMIT', '256M');)
  2. Verifique o log de erros do servidor (geralmente em /var/log/ ou acessível pelo painel da hospedagem) para identificar o erro específico
  3. Confirme que todas as extensões PHP obrigatórias estão instaladas
  4. Se o erro menciona uma extensão específica (ex.: ext-intl), peça ao seu provedor de hospedagem para habilitá-la

Interface admin exibe página em branco ou erros JavaScript ​

A interface admin baseada em React requer um navegador moderno.

Como resolver:

  • Certifique-se de que está usando Chrome 90+, Firefox 90+, Edge 90+ ou Safari 15+
  • Limpe o cache do navegador e recarregue a página
  • Verifique se nenhuma extensão do navegador (bloqueadores de anúncios, bloqueadores de scripts) está interferindo
  • Abra o console de desenvolvedor do navegador (F12) e verifique se há mensagens de erro

Atualizando o plugin ​

Quando uma nova versão estiver disponível:

  1. Baixe o arquivo ZIP atualizado
  2. Acesse Plugins > Adicionar Novo Plugin > Enviar Plugin
  3. Envie o novo arquivo ZIP
  4. O WordPress perguntará se deseja substituir a versão existente — confirme e prossiga
  5. Reative se necessário

O MIDDAG Account trata migrações de banco de dados automaticamente nas atualizações. Seus dados são preservados durante upgrades de versão.

Desinstalação ​

Se precisar remover o MIDDAG Account:

  1. Acesse Plugins > Plugins Instalados
  2. Desative o MIDDAG Account primeiro
  3. Clique em Excluir para remover os arquivos do plugin

Remoção de dados

Desinstalar o plugin remove seus arquivos, mas seus dados (organizações, entitlements, pedidos, etc.) permanecem no banco de dados do WordPress. Isso é proposital — seus dados empresariais não são excluídos acidentalmente. Para remover todos os dados completamente, use a opção de limpeza em MIDDAG Account > Configurações antes de desativar.

Próximos passos ​