NeuroManifest Landing Page

Landing page personalizada para NeuroManifest Box con integración WooCommerce y MercadoPago

Desarrollado con ❤️ por el equipo de Desarrollo Crecemos

---

📋 Descripción del Proyecto

NeuroManifest Landing es un plugin de WordPress completo que proporciona:

• 🎨 Landing page profesional con hero section, productos, y características
• 🛒 Carrito personalizado con UI moderna y actualización en tiempo real
• 💳 Checkout personalizado con validación de documentos colombianos (CC, NIT, etc.)
• 📍 Geolocalización automática para Colombia (Departamentos y Ciudades)
• 💰 Integración MercadoPago con soporte para múltiples métodos de pago
• 🚚 Envío gratis automático al alcanzar 2 o más artículos
• 📧 Emails personalizados con información de cliente y documentación
• 📱 Responsive Design optimizado para móvil y escritorio
• ⚡ Performance con carga asincrónica de estilos y scripts

---

🚀 Características Principales

Landing Page ([neuromanifest_landing])

• Navbar con navegación fluida
• Hero section con CTA prominentes
• Rejilla de productos destacados
• Sección de características (¿Qué incluye?)
• Footer con redes sociales

Carrito Personalizado ([neuromanifest_cart])

• Visualización elegante de productos
• Actualización de cantidades sin recarga de página
• Cálculo automático de envío gratis
• Resumen dinámico de totales
• Botón de proceder al pago

Checkout Personalizado ([neuromanifest_checkout])

• Campos optimizados para mercado colombiano
• Validación de tipo de documento
• Selección de departamentos y ciudades de Colombia
• Cálculo automático de envío
• Integración segura con MercadoPago

Tienda de Productos ([neuromanifest_shop])

• Grid responsivo de todos los productos
• Iconos y imágenes personalizadas por producto
• Filtrado automático de productos destacados
• Vista previa de detalles

---

📦 Requisitos

• WordPress 5.8 o superior
• WooCommerce 4.0 o superior
• PHP 7.2 o superior
• HTTPS habilitado en el servidor (requerido para MercadoPago)

Dependencias Externas

• SDK de MercadoPago V2 (cargado dinámicamente desde CDN)
• jQuery (incluido en WordPress)

---

🔧 Instalación

1. Clonar o Descargar el Repositorio

git clone git@github.com-crecemos:DesarrolloCrecemos/neuromanifest-landing.git
cd neuromanifest-landing

2. Copiar a la Carpeta de Plugins de WordPress

cp -r . /ruta/a/wordpress/wp-content/plugins/neuromanifest-landing

3. Configurar Variables de Entorno

# Copiar archivo de ejemplo
cp .env.example .env

# Editar .env con valores reales
nano .env

4. Activar el Plugin

1. Ir a WordPress Admin → Plugins
2. Buscar "NeuroManifest Landing Page"
3. Clic en "Activar"

5. Crear Páginas con Shortcodes

En el admin de WordPress, crear páginas nuevas con estos shortcodes:

[neuromanifest_landing]     // Página de inicio/landing
[neuromanifest_shop]        // Tienda de productos
[neuromanifest_cart]        // Carrito de compras
[neuromanifest_checkout]    // Checkout personalizado
[neuromanifest_policies]    // Políticas y términos

---

⚙️ Configuración

Variables de Entorno (.env)

Variable	Descripción	Ejemplo
MP_PUBLIC_KEY	Public Key de MercadoPago	TEST-284931e8-d828-4932...
WHATSAPP_PHONE	Número de WhatsApp	573172289838
PRODUCT_URL_BOXESENCIAL	URL del producto NeuroBox Esencial	https://mapiscarvajal.com/...
PRODUCT_URL_NEURORESET	URL del producto NeuroReset	https://mapiscarvajal.com/...
SANDBOX_MODE	Modo prueba (true/false)	true
DEBUG_MODE	Logs detallados	false

Configurar en functions.php de tu Tema

Si prefieres usar constantes en lugar de .env:

// En wp-config.php o functions.php
define('MP_PUBLIC_KEY', 'TEST-tu-public-key');
define('WHATSAPP_PHONE', '573172289838');

---

🔒 Seguridad

Credenciales Sensibles

✅ NUNCA commitear el archivo .env con valores reales al repositorio

✅ SIEMPRE usar variables de entorno para:

• API Keys de MercadoPago
• Números de teléfono (WhatsApp)
• URLs internas
• Información sensible

✅ Validación automática de campos en checkout

✅ HTTPS obligatorio en producción

Logs Sensibles

El plugin NO registra:

• Números de tarjeta completos
• CVV
• Tokens de pago
• Información personal sin hashear

---

📱 Respuesta a Dispositivos Móviles

El plugin está optimizado para:

• ✅ Smartphones (320px+)
• ✅ Tablets (768px+)
• ✅ Escritorio (1024px+)
• ✅ Pantallas grandes (1920px+)

---

🌐 Localización (i18n)

El plugin soporta traducción al español. Los textos clave incluyen:

• Etiquetas de formulario
• Mensajes de validación
• Notificaciones user-friendly
• Términos y condiciones

Para agregar más idiomas, usar gettext hooks en functions.php.

---

🛠️ Desarrollo y Contribución

Estructura de Archivos

neuromanifest-landing/
├── neuromanifest-landing.php       # Plugin principal
├── neuromanifest-landing.js        # JavaScript frontend
├── neuromanifest-landing.css       # Estilos principales
├── neuromanifest-cart.css          # Estilos del carrito
├── neuromanifest-woocommerce.css   # Estilos WooCommerce
├── assets/                         # Imágenes, fuentes, iconos
├── config/                         # Configuración (con .env)
├── docs/                           # Documentación
├── .gitignore                      # Archivos a ignorar en Git
├── .env.example                    # Variables de entorno ejemplo
└── README.md                       # Este archivo

Estándares de Código

• PHP: PSR-2 (WordPress Coding Standards)
• JavaScript: Google JavaScript Style
• CSS: SMACSS Methodology

Debugging

Habilitar modo debug en .env:

DEBUG_MODE=true
DEBUG_LOG_PAYMENT_INFO=true

Ver logs en: wp-content/debug.log

---

🐛 Problemas Comunes

"MercadoPago SDK no cargado"

• ✓ Verificar HTTPS habilitado
• ✓ Revisar credencial MP_PUBLIC_KEY en .env
• ✓ Limpiar caché del navegador

"Envío no se calcula"

• ✓ Configurar zonas de envío en WooCommerce
• ✓ Revisar que el departamento/ciudad sea válido

"Carrito vacío después de agregar producto"

• ✓ Revisar que WooCommerce esté activo
• ✓ Verificar permisos de sesión/cookies

"Documentos no se guardan en orden"

• ✓ Verificar que billing_doc_* sea de prioridad 25-35
• ✓ Revisar caché de WordPress

---

📞 Contacto y Soporte

Equipo de Desarrollo Crecemos:

• 📧 Email: desarrollo@crecemoslab.com
• 💬 WhatsApp: +57 317 2289838
• 🔗 GitHub: DesarrolloCrecemos

---

📄 Licencia

Este proyecto es propiedad de Crecemos Lab. Todos los derechos reservados © 2026.

Para uso, modificación o distribución, contactar a: desarrollo@crecemoslab.com

---

🚀 Roadmap Futuro

• [ ] Soporte para múltiples monedas
• [ ] Dashboard analytics integrado
• [ ] Aplicación móvil nativa
• [ ] Integración con Mailchimp
• [ ] Sistema de cupones avanzado
• [ ] Historial de compras mejorado

---

📊 Estadísticas del Proyecto

• Versión: 1.1
• Última actualización: Febrero 2026
• Lenguaje Principal: PHP + JavaScript
• Líneas de Código: ~3000+

---

Hecho con 💙 en Crecemos Lab