Cotizador de Picaderas by Los Vidos

Plugin de WordPress para sistema de cotización de pedidos de picaderas con cálculo automático de precios, delivery y envío directo a WhatsApp.

📋 Características

✨ Funcionalidades Principales

• Cotizador Modal Interactivo: Sistema de pasos guiados para una experiencia fluida
• Gestión de Variedades: Administra múltiples tipos de picaderas con precios diferenciados
• Precios por Mayoreo: Descuentos automáticos a partir de cierta cantidad
• Envases Personalizados: Opciones de envases individuales con imágenes
• Sistema de Delivery: Cálculo automático de distancia y costo usando Google Maps
• Integración WhatsApp: Envío directo de cotización al WhatsApp del negocio
• Auto-apertura Configurable: Modal puede abrirse automáticamente después de X segundos
• Responsive Design: Funciona perfectamente en móviles, tablets y desktop
• Personalización de Colores: Adapta el cotizador a la identidad visual de tu marca

🎯 Flujo del Cliente

1. Modo de Pedido: Elegir entre armar combo personalizado o ver combos pre-armados
2. Cantidad: Indicar número de personas y recibir sugerencia automática
3. Variedades: Seleccionar tipos de picaderas y cantidades
4. Envase: Elegir entre caja o envases individuales (con imágenes)
5. Entrega: Seleccionar retiro en local o delivery con mapa interactivo
6. Comentarios: Agregar especificaciones adicionales
7. Resumen: Ver cotización detallada y enviar a WhatsApp

🚀 Instalación

Opción 1: Instalación Manual

1. Descarga el plugin completo
2. Ve a WordPress Admin → Plugins → Añadir nuevo → Subir plugin
3. Selecciona el archivo .zip del plugin
4. Haz clic en "Instalar ahora"
5. Activa el plugin

Opción 2: Instalación vía FTP

1. Descomprime el archivo del plugin
2. Sube la carpeta picaderas-cotizador-plugin a /wp-content/plugins/
3. Ve a WordPress Admin → Plugins
4. Activa "Cotizador de Picaderas by Los Vidos"

⚙️ Configuración Inicial

1. API de Google Maps (IMPORTANTE)

El plugin requiere una API Key de Google Maps para el sistema de delivery.

Obtener API Key:

1. Ve a Google Cloud Console
2. Crea un proyecto nuevo
3. Habilita "Maps JavaScript API" y "Places API"
4. Crea credenciales (API Key)
5. Restringe la key a tu dominio

Agregar API Key al Plugin:

Edita el archivo picaderas-cotizador.php en la línea 85:

// Busca esta línea:
wp_enqueue_script('google-maps', 'https://maps.googleapis.com/maps/api/js?key=&libraries=places,geometry', array(), null, true);

// Reemplázala por:
wp_enqueue_script('google-maps', 'https://maps.googleapis.com/maps/api/js?key=TU_API_KEY_AQUI&libraries=places,geometry', array(), null, true);

2. Configuración del Plugin

1. Ve a WordPress Admin → Cotizador Picaderas
2. Configura cada pestaña:

📌 Pestaña: Variedades

• Las variedades ya vienen pre-configuradas con tus precios
• Puedes agregar, editar o eliminar variedades
• Define precio normal y precio mayoreo

📌 Pestaña: Envases

• Las opciones de envases ya están configuradas
• IMPORTANTE: Sube imágenes de cada tipo de envase
• Haz clic en "Subir Imagen" para cada envase

📌 Pestaña: Datos del Negocio

• Verifica que todos los datos estén correctos
• La dirección y coordenadas ya están configuradas
• El número de WhatsApp ya está configurado (8492211020)

📌 Pestaña: Delivery

• Fórmula ya configurada: (Distancia × 2) × 15 + 100
• Radio máximo: 30 km
• Puedes ajustar estos valores si es necesario

📌 Pestaña: Apariencia

• Los colores de tu marca ya están configurados:
  • Primario: #42170d
  • Secundario: #EE202E
  • Acento: #FFCC40

📌 Pestaña: Avanzado

• Cantidad mínima: 20 unidades (ya configurado)
• Cantidad para mayoreo: 80 unidades (ya configurado)
• Configurar auto-apertura del modal si lo deseas
• Agregar URL de página de combos pre-armados

3. Uso del Shortcode

Insertar en una Página/Post

Usa el shortcode en cualquier página o post:

[cotizador_picaderas]

Personalizar el Botón

[cotizador_picaderas texto_boton="¡Cotiza tu pedido ahora!"]

[cotizador_picaderas texto_boton="Pide aquí" clase_boton="mi-boton-personalizado"]

Insertar en un Widget

1. Ve a Apariencia → Widgets
2. Agrega un widget de "HTML Personalizado"
3. Pega el shortcode: [cotizador_picaderas]

Insertar en el Tema (PHP)

<?php echo do_shortcode('[cotizador_picaderas]'); ?>

🎨 Personalización Avanzada

Modificar Estilos CSS

Puedes sobrescribir los estilos del plugin en tu tema:

/* Personalizar botón */
.btn-cotizar-picaderas {
    background-color: #tu-color !important;
    font-size: 20px !important;
}

/* Personalizar modal */
.picaderas-modal-content {
    max-width: 1000px !important;
}

Usar tus Propios Colores

Ve a Cotizador Picaderas → Apariencia y cambia los colores desde el panel de administración.

📱 Características del Sistema

Cálculo de Precios

• Precio Normal: Aplica para pedidos menores a 80 unidades
• Precio Mayoreo: Se activa automáticamente con 80+ unidades
• Solo aplica descuento a variedades de RD$25 (bajan a RD$22)
• Mini wraps, cativias y mini hamburguesas mantienen su precio

Sistema de Delivery

Fórmula de Cálculo:

Costo = (Distancia en KM × 2) × RD$15 + RD$100

Ejemplo: Para 10 km

Costo = (10 × 2) × 15 + 100 = RD$400

Límites:

• Radio máximo: 30 km desde el local
• El cliente ve el costo antes de confirmar
• Distancia calculada en línea recta (Haversine)

Envases Individuales

• Platitos de foam: RD$6 /unidad
• Platitos de plástico: RD$11 /unidad
• Cajitas de cartón: RD$17 /unidad

El costo se multiplica por el número total de unidades.

Mensaje a WhatsApp

El sistema genera automáticamente un mensaje estructurado con:

• ✅ Detalle de variedades y cantidades
• ✅ Precios individuales y subtotales
• ✅ Indicación de descuento mayoreo (si aplica)
• ✅ Tipo de envase seleccionado
• ✅ Información de entrega y costo
• ✅ Comentarios del cliente
• ✅ Total a pagar
• ✅ Nota de aprobación pendiente

🔧 Solución de Problemas

El mapa no se muestra

1. Verifica que agregaste tu API Key de Google Maps
2. Verifica que las APIs estén habilitadas en Google Cloud Console
3. Revisa la consola del navegador (F12) para ver errores
4. Asegúrate de tener créditos en tu cuenta de Google Cloud

El modal no se abre

1. Verifica que no haya conflictos con otros plugins
2. Desactiva plugins de caché y prueba
3. Verifica la consola del navegador (F12) para ver errores JavaScript

Los precios no se calculan correctamente

1. Ve a Cotizador Picaderas y verifica las configuraciones
2. Asegúrate de que las variedades tengan precios configurados
3. Revisa la cantidad de mayoreo en la pestaña "Avanzado"

El WhatsApp no abre

1. Verifica el número de WhatsApp en Datos del Negocio
2. El número debe estar en formato internacional sin espacios ni guiones
3. Ejemplo correcto: 8492211020
4. Ejemplo incorrecto: 849-221-1020 o +1 849 221 1020

📊 Gestión del Backend

Panel de Administración

Accede a WordPress Admin → Cotizador Picaderas

Agregar Nueva Variedad

1. Ve a la pestaña "Variedades"
2. Haz clic en "+ Agregar Variedad"
3. Completa nombre, precio normal y precio mayoreo
4. Guarda cambios

Modificar Precios

1. Ve a la pestaña correspondiente
2. Edita directamente en los campos
3. Guarda cambios

Cambiar Fórmula de Delivery

1. Ve a la pestaña "Delivery"
2. Modifica los valores:
   • Multiplicador de distancia (default: 2)
   • Precio por KM (default: 15)
   • Precio base (default: 100)
3. Guarda cambios

🎯 Mejores Prácticas

Para el Cliente

1. Sube imágenes de alta calidad de los envases
2. Configura la URL de combos para facilitar el proceso
3. Activa la auto-apertura en páginas principales (5-10 segundos)
4. Prueba el flujo completo antes de publicar

Para el Rendimiento

1. Usa un plugin de caché (WP Rocket, W3 Total Cache)
2. Optimiza las imágenes de envases antes de subirlas
3. Considera usar un CDN para archivos estáticos

Para la Conversión

1. Coloca el botón en posiciones estratégicas
2. Usa textos de llamada a la acción claros
3. Configura la auto-apertura solo en páginas principales
4. Responde rápido a los mensajes de WhatsApp

📞 Soporte

Para soporte técnico o consultas sobre el plugin:

• Negocio: Pastelitos y Picaderas by Los Vidos
• WhatsApp: 849-221-1020
• Ubicación: Avenida 25 de Febrero #62, Las Americas, Santo Domingo Este

🔄 Actualizaciones Futuras

Funcionalidades planificadas:

• Integración con WooCommerce
• Sistema de reserva de horarios
• Cupones de descuento
• Historial de pedidos
• Notificaciones por email
• Múltiples idiomas

📝 Changelog

Versión 1.0.0 (2024)

• Lanzamiento inicial
• Sistema completo de cotización
• Integración con Google Maps
• Envío a WhatsApp
• Panel de administración completo
• Responsive design

📄 Licencia

GPL v2 or later

---

Desarrollado para Pastelitos y Picaderas by Los Vidos 🍽️