EWEB - Funnel Services Form

Plugin de formulário de serviços com etapas (steps) para cotações. Permite criar formulários de múltiplas fases com personalização de cores e estilos.

📋 Requisitos

• WordPress: 6.0 ou superior
• PHP: 8.1 ou superior
• Testado até: WordPress 6.4
• ACF Pro: Requerido para campos personalizados

🚀 Instalação

1. Faça o download do plugin
2. Extraia na pasta /wp-content/plugins/
3. Execute os comandos de build:

cd wp-content/plugins/services-form
npm install
npm run build

4. Ative o plugin no painel do WordPress

🌍 Internacionalização (i18n)

O plugin está 100% preparado para traduções:

• ✅ Text Domain: funnel-services-form
• ✅ Domain Path: /languages/
• ✅ Funções de tradução __() e _e() implementadas
• ✅ Arquivo .pot incluído em /languages/

Como traduzir

1. Copie o arquivo languages/funnel-services-form.pot
2. Renomeie para funnel-services-form-{LOCALE}.po (ex: funnel-services-form-es_ES.po)
3. Traduza usando Poedit ou similar
4. Salve para gerar o arquivo .mo
5. Coloque ambos arquivos na pasta /languages/

Locales suportados

• pt_BR - Português (Brasil) - Padrão
• es_ES - Español
• en_US - English

🎨 Funcionalidades

Formulário Multi-Fases

• Navegação inteligente por fases
• Seleção única ou múltipla por fase
• Validação de campos em tempo real
• Proteção CSRF com nonce

Personalização Visual

• 6 templates de cores predefinidos:
  • 🌙 Escuro (Padrão)
  • ☀️ Claro
  • 🔵 Azul Corporativo
  • 🟢 Verde Natural
  • 🟣 Púrpura Elegante
  • 🟠 Laranja Quente
• Upload de logo personalizado
• Glassmorphism design
• Cores totalmente customizáveis

Template Full Screen

• Página dedicada para o formulário
• Sem conflitos com Elementor/builders
• Fundo gradiente personalizável

E-mails Automáticos

• Notificação ao admin (lead)
• Cotação para o usuário
• Templates HTML personalizáveis

📁 Estrutura do Plugin

services-form/
├── funil-services-form.php    # Bootstrap principal
├── app/                       # Frontend React
│   ├── components/            # Componentes UI
│   ├── form/                  # Formulários
│   ├── store/                 # Estado (Zustand)
│   └── utils/                 # Utilitários
├── assets/                    # CSS/SCSS/JS
├── dist/                      # Build compilado
├── includes/                  # Lógica PHP
│   ├── acf/                   # Campos ACF
│   ├── admin/                 # Panel de administração
│   │   ├── color-templates.php
│   │   ├── frontend-styles.php
│   │   ├── styles-admin.php
│   │   └── views/
│   ├── templates/             # Templates de página
│   └── *.php                  # Módulos
└── languages/                 # Traduções
    └── funnel-services-form.pot

🔧 Desenvolvimento

Build para produção

npm run build

Build em modo watch

npm run watch

📝 Changelog

v1.4.0 (Nov 2025)

• Refactor: Código admin separado en módulos (/includes/admin/)
• Otimização: CSS reducido ~24% (9.77 KiB → 7.39 KiB)
• Otimização: SCSS reducido ~56% (~435 → ~190 líneas)
• Melhoria: Isolamento de Elementor sem quebrar estilos MUI
• Melhoria: Variables CSS centralizadas
• Fix: Conflitos de padding/margin com page builders

v1.3.7 (Nov 2025)

• Novo: Template de página full screen
• Novo: Sistema de templates de cores
• Novo: Indicador de tema ativo
• Melhoria: Mensagem de sucesso como modal centralizado
• Melhoria: Cabeçalho do plugin padronizado

v1.3.1 (Nov 2025)

• Selector de mídia WordPress para logo
• Botão de reset de estilos
• Valores por defeito melhorados

v1.3.0 (Nov 2025)

• Design Glassmorphism
• Panel de personalização completo
• Sistema de cores dinâmico

v1.2.0 (Out 2025)

• Correção do "passo fantasma"
• Validação CSRF implementada
• Melhorias na navegação

🗺️ Roadmap (Futuro)

🔜 Próximas versões

Independência de ACF

• Criar campos personalizados nativos sem depender de ACF Pro
• Interface de administração para criar/editar fases
• Exportar/importar configurações de formulário (JSON)
• Migração automática de dados ACF para sistema nativo

Traduções e i18n

• Tradução completa para Español (es_ES)
• Tradução completa para English (en_US)
• Integração com WPML/Polylang
• Tradução de strings do frontend React

Performance

• Lazy loading de componentes React
• Code splitting por rota/fase
• Caché de configurações (transients)
• Minificação automática de CSS inline

Funcionalidades

• Lógica condicional entre fases
• Campos personalizados por fase (texto, número, archivo)
• Integração con CRMs (HubSpot, Pipedrive, etc.)
• Webhooks para automatizaciones
• Dashboard de analytics (leads, conversiones)
• A/B testing de templates

UX/UI

• Animaciones de transición entre fases
• Modo dark/light automático
• Preview en tiempo real en el admin
• Más templates de colores
• Tipografías personalizables

Integraciones

• WooCommerce (productos como servicios)
• Elementor widget nativo
• Gutenberg block
• Zapier/Make integration
• reCAPTCHA v3

💡 ¿Tienes ideas?

Abre un issue en GitHub con tu sugerencia.

👨‍💻 Autor

Yisus Develop

• GitHub: @Yisus-Develop
• Website: enlaweb.co

📄 Licença

Este plugin está licenciado sob a GNU General Public License v3.0.