Documentação Técnica — Flat Admin

Apresentação — Flat Admin

O Flat Admin é uma solução avançada para WordPress desenvolvida para transformar por completo o painel administrativo (wp-admin), trazendo mais profissionalismo, segurança, personalização, produtividade e identidade visual ao ambiente de gerenciamento do site.

  • Experiência Flat e Moderna: Interface limpa, responsiva, com temas, identidade visual e navegação aprimorada para todos os tipos de usuários.
  • Controle de Acesso e Permissões: Gerencie funções, permissões, menus, widgets e recursos administrados por usuário ou papel.
  • Redirecionamento Inteligente: Defina fluxos personalizados de login/logout por função, usuário ou regra global.
  • Gestão Avançada de Usuários: Listagem, buscas, filtros, edição, auditoria, logs e ações em massa.
  • Segurança Reforçada: Limite tentativas de login, controle sessões, proteja áreas sensíveis, bloqueie IPs e tenha logs completos de auditoria.
  • Modo Manutenção Completo: Ative para visitantes, personalize mensagem, contagem regressiva, logo, cores e experiência visual durante atualizações.
  • Mensagens Internas: Comunicação direta com usuários ou funções, notificações em massa, histórico, confirmação de leitura e popup.
  • Personalização Visual: Customização total de temas, cores, logos, menus, colunas e widgets do painel.
  • Pronto para LGPD e Auditoria: Registro de logs, permissões granulares, proteção de dados e conformidade com boas práticas de privacidade.

Flat Admin é ideal para agências, equipes, clientes, portais, escolas, e-commerces, órgãos públicos e todo projeto WordPress que busca elevar ao máximo o nível de usabilidade, segurança e design do painel de administração.

Como Instalar o Plugin Flat Admin

  1. Faça download do plugin Flat Admin ou clone o repositório.
  2. Envie a pasta do plugin para wp-content/plugins/ ou faça upload do arquivo ZIP pelo painel do WordPress.
  3. Ative o plugin no menu “Plugins” do WordPress.
  4. Certifique-se que o diretório wp-content/fac-logs/ possui permissão de escrita para logs.
  5. Após ativação, acesse o menu Flat Admin para configurar e personalizar o painel conforme suas necessidades.

Dashboard Administrador

Painel principal e central de comando para administradores do Flat Admin. Exibe métricas globais do site, como total de usuários, posts, status de recursos e registro de logins.

Funções Relacionadas

  • fa_dashboard_admin_page(): Renderiza o dashboard principal do admin.
  • fa_dashboard_get_global_stats(): Recupera estatísticas globais do site (usuários, posts, status).
  • fa_dashboard_widget_login_log(): Exibe registro de logins recentes.

Dashboard do Usuário

Painel personalizado para usuários comuns, com foco em experiência individual. Apresenta dados pessoais do usuário logado, como seus posts publicados. Exibe mensagens administrativas recebidas direto do administrador.

Funções Relacionadas

  • fa_dashboard_user_page(): Renderiza o dashboard do usuário.
  • fa_dashboard_get_user_stats($user_id): Estatísticas do usuário logado.
  • fa_dashboard_widget_recent_activity(): Atividades recentes do usuário.
  • fa_dashboard_custom_greeting($user_id): Saudação personalizada.

Lista de Usuários

Página de gerenciamento completo dos usuários do WordPress.

  • Permite listar todos os usuários cadastrados, filtrar por função, status, nome ou e-mail, e visualizar detalhes do perfil em tempo real.
  • Oferece edição de dados, redefinição de senha, alteração de funções, exclusão de usuários e auditoria de acessos, aplicação de ações em massa (bulk) e criação de novos usuários.
  • Inclui histórico de atividades, logs de alterações e ferramentas para controle granular dos perfis.

Funções Relacionadas

  • fa_user_list_page(): Renderiza a tela de listagem e busca avançada de usuários.
  • fa_user_list_get($filters): Retorna a lista de usuários filtrados.
  • fa_user_bulk_action($action, $user_ids): Ação em massa de usuários.
  • fa_user_search_ajax(): Busca AJAX de usuário.

Gerenciar Funções

Central de gerenciamento de funções (roles) do WordPress. Permite criar novas funções personalizadas, editar permissões (capabilities) detalhadas de cada papel, clonar regras, excluir ou proteger funções existentes.

  • Atribuição visual das capacidades de cada role, com explicações claras em português e tooltips para facilitar a configuração.
  • Garante restrição de acessos, proteção de áreas sensíveis, e controle granular do painel.
  • Registra logs completos de todas as operações, exibe tabela visual das funções cadastradas, busca por nome, edição inline e proteção da função "administrator".
  • Possibilita personalizar regras conforme as necessidades do projeto, aumentando a segurança e flexibilidade da equipe.

Funções Relacionadas

  • fa_role_creator_page(): Renderiza tela para criar, editar e remover papéis.
  • fa_create_role($role, $caps): Cria novo papel/role no WP.
  • fa_edit_role($role, $caps): Edita papel existente.
  • fa_delete_role($role): Remove papel personalizado.
  • fa_list_roles(): Lista papéis customizados.

Permissões de Menu

Ferramenta para controle total sobre menus e submenus do painel administrativo. Define quais funções podem visualizar ou acessar cada item do menu, permitindo ocultar opções sensíveis de acordo com o perfil do usuário.

  • Ao tentar acessar áreas bloqueadas, o sistema exibe mensagens personalizadas de acesso negado.
  • Permite personalizar o menu lateral e superior do painel, criando experiências minimalistas e sob medida para cada tipo de usuário.

Funções Relacionadas

  • fa_hide_admin_menus(): Remove do menu do admin itens indesejados para o perfil atual.

Login

Sistema de personalização avançada da tela de login do WordPress. Permite upload de logotipo e favicon, escolha de cores para fundo e campos, seleção de imagem de fundo, placeholders customizados, botão personalizado, textos alternativos (alt), link do logo, e mensagem de boas-vindas.

  • Habilita ativação ou ocultação de labels, links padrões ("Lembrar-me", "Perdeu a senha?", "Voltar ao blog"), alteração do slug da URL de login, proteção automática contra bruteforce e integração visual com o painel.
  • Possui reset para o padrão do WordPress, preview imediato das alterações, segurança por nonce e feedback visual.

Funções Relacionadas

  • fa_login_custom_styles(): Adiciona CSS customizado à tela de login.
  • fa_login_logo_url(): Altera o link do logo na tela de login.
  • fa_login_logo_title(): Altera o título (title) do logo.
  • fa_login_footer_message(): Mensagem no rodapé do login.
  • fa_login_redirect($user_login, $user): Redireciona o usuário após login.

Ocultar Itens do Admin

Configuração global para ocultar elementos do painel administrativo de todos os usuários.

  • Permite esconder barra superior (admin bar), widgets do dashboard, campos, notificações de atualização, plugins, rodapé, colunas, botões, editor, links, menus, títulos, painel de comentários, painel de usuários, ferramentas, configurações, customizer, suporte de plugins e outros elementos sensíveis.
  • Oferece toggles intuitivos para cada item, seleção em massa ("marcar todos como sim/não"), feedback visual instantâneo e aplicação automática via CSS e hooks PHP.
  • Garante ambiente mais seguro, limpo, minimalista e adaptado conforme a necessidade do projeto.
  • Ideal para entregar um painel profissional, seguro e livre de distrações para clientes e equipes.

Funções Relacionadas

  • fa_hide_admin_bar_items(): Remove itens da admin bar superior.
  • fa_hide_dashboard_widgets(): Esconde widgets padrão do dashboard.

Ferramentas

Modo de manutenção: permite ativar/desativar página de manutenção para visitantes não logados, com personalização de mensagem, logotipo, cor de fundo, cor da fonte e contador regressivo de tempo para finalização.

  • Reordenação de menus: interface drag & drop para definir a ordem dos menus do painel admin, aplicada automaticamente para todos os usuários.
  • Design moderno, com upload de logotipo via dropzone, preview instantâneo, tooltips explicativos, validação de arquivos, campos intuitivos para configuração rápida e feedback visual de sucesso ou erro.
  • Ideal para sites em atualização, agências, ou projetos que exigem máxima flexibilidade e controle sobre o painel administrativo.

Funções Relacionadas

  • fa_menu_order_custom($menu_order): Altera a ordem dos itens do menu admin.

Perfil do Usuário

Página dedicada à exibição e edição do perfil do usuário logado. Permite atualizar nome, sobrenome, nome exibido, e-mail, avatar (upload e visualização instantânea), senha (com verificação de força e feedback visual), campos extras, histórico de acessos e logs de alterações.

  • Inclui preferências de exibição, configurações de segurança, preview do avatar, toggle para mostrar/ocultar senha, validação de e-mail único e senha forte.
  • Facilita a gestão de dados pessoais, aumentando a segurança e a experiência do usuário.

Funções Relacionadas

  • fa_profile_page_render($user_id): Renderiza a página de perfil.
  • fa_profile_update($user_id, $data): Atualiza dados do perfil.
  • fa_profile_avatar_upload($user_id): Upload de avatar.

Redirecionamentos

Ferramenta para configuração de redirecionamentos automáticos após login e logout. Permite definir URLs de destino por função (role) ou regra padrão, garantindo que cada perfil seja direcionado para o local ideal ao acessar ou sair do painel.

  • Ideal para ambientes com áreas restritas, multi-perfis ou necessidades de personalização do fluxo de acesso.

Funções Relacionadas

  • fa_custom_redirects(): Gerencia e executa redirecionamentos automáticos configurados.
  • fa_redirect_after_login($user_id): Redireciona após login.
  • fa_redirect_after_logout(): Redireciona após logout.

Personalização do Admin

Biblioteca do tema visual para o painel administrativo. Permite visualizar, selecionar cores para personalizar cores do menu e fundo das páginas admin. Ocultação de ícones do menu e criação de ambientes únicos para cada equipe ou cliente.

  • Ideal para entregar um painel com identidade visual profissional, adaptado às necessidades do projeto.

Funções Relacionadas

  • fa_custom_page_assets($slug): Adiciona JS/CSS para esta página.

Segurança

Central de configurações e controles de segurança do painel administrativo.

  • Permite limitar tentativas de login, bloquear IPs suspeitos, ocultar versão do WordPress, controlar sessões e logins simultâneos, proteger contra bots.
  • Controle sobre desativação XML-RPC, desabilitar usuário admin padrão, proteger arquivos sensíveis do WordPress, bloquear REST API não autenticada, desabilitar clique direito do mouse, ocultar código fonte no frontend com ofuscação leve.
  • Essencial para projetos que exigem máxima proteção, rastreabilidade e conformidade com LGPD e boas práticas de segurança digital.

Funções Relacionadas

  • fa_security_page_render(): Renderiza tela de segurança.
  • fa_security_enforce_headers(): Define headers HTTP extras.
  • fa_security_toggle_2fa($user_id, $on): Ativa/desativa autenticação em dois fatores.
  • fa_security_audit_logs(): Exibe logs de eventos de segurança.

Mensagens Administrativas

Sistema de envio e gerenciamento de mensagens administrativas para usuários ou funções específicas. Permite cadastrar, editar, excluir (individualmente ou em lote) para mensagens que aparecem no painel dos destinatários.

  • Controle de leitura por usuário, confirmação via popup, tracking e estatísticas de leitura, visualização em modal, feedback visual e histórico completo.
  • Inclui interface para envio de mensagens em massa, edição rápida, exclusão de notificações, visualização do histórico e relatórios de engajamento.
  • Direcionado para comunicação interna, avisos críticos e integração com o fluxo de trabalho da equipe e cliente.

Funções Relacionadas

  • fa_mensagens_page(): Renderiza a página de mensagens.
  • fa_mensagens_modal_render($user_id): Modal de mensagens rápidas.
  • fa_mensagens_get_all($user_id): Lista mensagens do usuário.
  • fa_mensagens_delete($msg_id): Excluir mensagem.
  • fa_mensagens_mark_read($msg_id): Marcar como lida.

Configuração de E-mail

Ferramenta visual e segura para configuração do remetente dos e-mails administrativos do WordPress. Permite definir nome e e-mail do remetente, habilitar envio por SMTP personalizado (host, porta, usuário, senha, criptografia SSL/TLS), ativar autenticação, realizar testes de envio com feedback visual, e integrar logs de envio.

  • Inclui interface moderna, responsiva, validação dos campos, alertas de erro ou sucesso, debug SMTP (em modo WP_DEBUG) e instruções para evitar que mensagens caiam no spam.
  • Aplica as configurações em todos os envios de e-mail via WordPress, garantindo conformidade e profissionalismo nas comunicações do site.

Funções Relacionadas

  • fa_email_settings_page(): Renderiza página de configurações de e-mail.