Ir al contenido

Guía de uso de MDPD Logística

Plugin de WooCommerce para definir zonas de envío, horarios de atención, demoras y datos de contacto de tu tienda física, con un mapa interactivo en el checkout que le muestra al cliente, en tiempo real, si su dirección está dentro del área de cobertura y cuánto le va a salir el envío.

1. Qué hace el plugin

En una tienda que reparte con logística propia (tu motoquero, tu camioneta, tu camión), normalmente lo más complicado es contestar dos preguntas que tiene cada cliente nuevo:

  • “¿Llegan a mi casa?”
  • “¿Cuánto sale el envío hasta acá?”

Logística las contesta sola. El cliente carga su dirección durante la compra y, al instante, ve un mapa con su ubicación, las zonas en las que repartís y el costo correspondiente. Si está dentro de una zona, se le aplica ese precio de envío. Si está afuera, ni le aparece la opción de envío.

Funcionalidades principales

  • Definición de zonas de cobertura con precio individual, en tres modos: dibujo libre sobre el mapa, asignación de barrios oficiales de la ciudad, o una lista de localidades con precio que el comprador elige en el checkout.
  • Reglas por producto: según lo que haya en el carrito, se le ofrecen unos métodos de envío u otros. Sirve cuando una parte del catálogo la despacha un Correo Privado y el resto lo lleva tu Envío Propio.
  • Mapa interactivo en el checkout con geocodificación automática al tipear la dirección, marker de la tienda, marker del cliente y un efecto visual tipo «ping de sonar» sobre la zona que matchea.
  • Configuración de horarios de atención por día, con turnos cortados (mañana / tarde) o atención 24/7.
  • Aviso público de demoras cuando estás saturado de pedidos.
  • Shortcodes para insertar dirección, teléfono, WhatsApp, email, horarios, estado de la sucursal, mapa de zonas y aviso de envío gratis en cualquier página.
  • Soporte de envío gratis a partir de un mínimo de compra configurable.
  • Retiro por el local habilitable o deshabilitable, con sugerencia de canal de contacto (teléfono / WhatsApp).

2. Instalación

  1. Tener WooCommerce instalado y activo

    El plugin requiere WooCommerce. Si todavía no lo instalaste, hacelo desde Plugins → Añadir nuevo → buscar «WooCommerce» y activalo.

  2. Subir el ZIP de Logística

    Andá a Plugins → Añadir nuevo → Subir plugin, seleccioná el archivo mdpd-logistica.zip y hacé click en Instalar ahora.

  3. Activar el plugin

    Una vez instalado, hacé click en Activar. Vas a ver aparecer en el menú lateral del admin un nuevo ítem llamado Logística.

  4. Completar el wizard de setup inicial

    La primera vez que entres al menú Logística, te recibe un asistente de configuración en 3 pasos: te pide la API Key de Google Maps, te hace elegir la ciudad en la que opera tu tienda (del catálogo de ciudades listas para usar) y te ayuda a marcar la ubicación de la sucursal en el mapa. Hasta que lo termines, el resto del menú redirige al wizard.

    Una vez completo, ya tenés todo lo mínimo necesario para empezar a definir zonas y horarios. Mirá la sección Configuración general si después querés ajustar algún dato.

Buena noticia: el plugin se actualiza solo. Cuando publiquemos una nueva versión vas a verla como cualquier otra actualización en Plugins → Actualizaciones disponibles.

3. Configuración general

En Logística → General tenés toda la configuración base de la sucursal y el comportamiento global del plugin.

3.1. Google Maps

Pegá tu API Key de Google Maps. Esta clave habilita el mapa en el checkout y en los shortcodes que incluyen mapa.

Al lado del campo vas a ver un indicador de validación: si la clave tiene el formato correcto, aparece un check verde; si está mal copiada o le falta algún caracter, aparece una cruz roja. Esto te avisa antes de guardar, así no perdés tiempo descubriendo el error después. Si la clave que escribís es claramente inválida, el plugin además rechaza el cambio y conserva la anterior, para no romperte el mapa por un copy-paste accidental.

¿De dónde saco la API Key? Desde la consola de Google Cloud. Tenés que crear un proyecto, habilitar las APIs Maps JavaScript API, Geocoding API y Places API, y generar una clave. Si tu hosting o nosotros ya te la entregamos, simplemente pegala en este campo.

3.2. Datos de la sucursal

Ubicación de la tienda
Hay un buscador de direcciones con mini-mapa interactivo: empezá a tipear la dirección, elegila del autocompletado y el marker se ubica solo. Las búsquedas vienen sesgadas a la ciudad que elegiste en el setup, así no te aparecen direcciones de otras ciudades con el mismo nombre. También podés arrastrar el marker sobre el mapa o hacer click en el punto exacto si querés ajustar a mano. Las coordenadas (latitud y longitud) se autocompletan solas a medida que movés el marker — no tenés que copiarlas y pegarlas desde Google Maps. Debajo del mapa ves la «Dirección detectada» en formato corto (calle + altura + piso/depto si corresponde, sin el «Ciudad, Provincia, País, CP» que repite info que ya está en la zona global), con un fade verde cuando cambia para confirmarte que se actualizó. Esa dirección corta es la que se publica en los shortcodes (ej.: «Belgrano 2465 1ºA»).
Email
Email de contacto, usado por el shortcode [email_sucursal].
Teléfono
Teléfono fijo o móvil, usado por [telefono_sucursal].
WhatsApp
Número de WhatsApp con código de país, usado por [whatsapp_sucursal]. Se transforma automáticamente en un link wa.me.

El plugin normaliza automáticamente el teléfono y el WhatsApp al formato internacional E.164 (ej.: +542235123456) cuando guardás. Podés escribirlos como prefieras (con guiones, paréntesis, espacios, con o sin código de país) y el plugin los unifica solo. Si el número no se puede normalizar (porque le falta información o tiene caracteres raros), se guarda como lo escribiste para que no se pierda.

3.3. Markers del mapa

Podés subir tus propias imágenes para el ícono de la tienda y para el ícono del cliente en el mapa. Si dejás los campos vacíos, se usan los markers que trae el plugin por defecto.

3.4. Envío gratis

Activalo si querés ofrecer envío bonificado a partir de un monto mínimo de compra. Si dejás el monto en 0, el envío gratis aplica a todos los pedidos sin condición.

El aviso público se inserta en cualquier página con el shortcode [envio_gratis_aviso].

3.5. Retiro por el local

Por defecto, los clientes pueden elegir retirar el pedido en tu local en lugar de pedir envío. Si tu negocio no recibe gente (por ejemplo, sos una cocina cerrada), activá la opción SOLO ENVÍOS y elegí qué canal sugerís para coordinar contacto: teléfono, WhatsApp o ambos.

3.6. Zona global de envíos

Datos de cobertura general que WooCommerce usa para validar direcciones y para auto-completar el formulario de checkout (Ciudad, Provincia, País, Código Postal).

Estos cuatro campos se cargan automáticamente con los valores de la ciudad que elegiste en el wizard de setup. Podés sobreescribirlos si tu situación particular difiere (por ejemplo, tu CP real es distinto al del centro de la ciudad), y siempre tenés un botón «Restaurar valores de la ciudad» al lado para volver a los defaults sin tener que acordarte cuáles eran.

3.7. Avanzado — Re-ejecutar setup

Si tu tienda mudó de ciudad y necesitás cambiar la configuración, hay un botón «Re-ejecutar setup inicial» en la card «Avanzado» que te lleva otra vez al wizard. Las zonas que ya tenías no se borran: simplemente quedan asociadas a la ciudad anterior. Si en algún momento volvés a elegir la ciudad original, las zonas reaparecen tal cual estaban.

Más abajo en la misma card hay un link «Verificar migración» que abre un reporte de diagnóstico con todo el estado de la configuración del plugin (versión, ciudad activa, datos de la sucursal, cantidad de zonas, etc.). Útil después de actualizar desde versiones viejas para chequear que todo quedó correcto.

3.8. Desinstalación

Si en algún momento desinstalás el plugin, podés elegir conservar todos los datos de configuración (zonas, horarios, etc.) por si lo volvés a instalar, o borrarlos completamente. Por defecto, se conservan.

4. Modos de Envío

En Logística → Modos de Envío definís el área de cobertura de tu tienda. Tenés tres modos y podés elegir el que más te convenga:

4.1. Modo «Polígonos manuales»

Dibujás vos mismo cada zona libremente sobre el mapa, con los puntos que quieras. Útil si tu cobertura no respeta los límites barriales (por ejemplo, «todo lo que esté a 5 km del local»).

  • Cada zona tiene su propio nombre, color y precio. El campo de precio muestra como prefijo el símbolo de moneda configurado en WooCommerce, así no hay duda de unidad.
  • Podés crear, editar y eliminar zonas en el editor visual.
  • Los puntos del polígono se pueden mover individualmente para ajustar la forma exacta.

4.2. Modo «Barrios predefinidos»

En lugar de dibujar, hacés click sobre los barrios oficiales de la ciudad y los asignás a una zona. Útil si trabajás con tarifas por barrio (común en delivery local).

  • Creás zonas (con nombre, precio y color) en el panel lateral. El campo de precio muestra como prefijo el símbolo de moneda de WooCommerce, igual que en el modo manual.
  • Seleccionás una zona y hacés click en los barrios del mapa para sumarlos a esa zona.
  • Volvés a hacer click sobre un barrio para sacarlo.
  • Cada barrio puede pertenecer a una sola zona a la vez.

4.3. Modo «Localidades»

En lugar de dibujar nada, cargás una lista de localidades con su precio y el comprador elige la suya en el checkout. Sin mapa y sin geocodificación: el dato sale del formulario.

Es el modo para cuando repartís con camión propio a muchas localidades y el precio depende del destino, no de la distancia exacta ni del peso. Los otros dos modos resuelven bien una ciudad; este resuelve un territorio, donde dibujar cada zona a mano sería interminable.

  • La lista se carga desde una planilla: elegís un archivo CSV o pegás su contenido. El archivo se lee en tu navegador, no se sube a ningún lado.
  • Las dos columnas que no pueden faltar son nombre y precio. Opcionalmente podés sumar grupo, detalle, código postal e identificador.
  • El grupo ordena el desplegable del checkout. Con muchas localidades es lo que lo hace navegable.
  • El detalle se muestra al lado del nombre, para el plazo o el día de reparto: «Batán — 48 hs».
  • Al guardar, la lista se reemplaza por completo. Si dejás el cuadro vacío, se conserva la que ya estaba.

¿Por qué por localidad y no por código postal? Porque un código postal suele abarcar varias zonas con tarifas distintas. En Mar del Plata, por ejemplo, todos los barrios comparten el 7600: por CP sería imposible cobrar distinto en Batán que en Chapadmalal. Por eso el comprador elige su localidad, y eso fija el precio.

El importador es tolerante con lo que sale de una planilla real: acepta separador ; o ,, precios escritos como 32.043,83 o como 32043.83, el símbolo $, el BOM que agrega Excel, filas vacías en el medio y nombres de columna con o sin tildes. Si una fila viene sin nombre o con un precio que no es un número, la saltea y te avisa cuál.

Si la importación falla entera, se conserva la lista anterior. Nunca te quedás sin nada por un archivo mal armado.

Mientras el comprador no elija su localidad, el envío a domicilio no le muestra ninguna tarifa: sin destino no hay precio que calcular. Y si su localidad no está en la lista, le queda el retiro por el local.

Podés alternar entre modos sin perder datos: cada modo guarda su configuración por separado. Si dibujaste polígonos manuales y después pasás a barrios, los polígonos quedan guardados; si volvés a polígonos manuales, los recuperás tal cual.

4.4. Precios por localidad

Una vez cargada la lista, los precios se editan desde Logística → Precios por localidad, sin volver a subir la planilla.

El precio base

El precio de cada localidad es una base por un multiplicador. Si llegar a Batán cuesta lo mismo que la base, su multiplicador es 1; si a Balcarce cuesta el triple, es 3. Así, cuando aumenta el combustible o el flete, cambiás un solo número y se recalculan todas.

Arriba de la pantalla vas a ver los multiplicadores que estás usando, con cuántas localidades tiene cada uno y qué precio da. Es la forma rápida de ver si la escala quedó como querías.

Si alguna localidad se aparta de la escala, le podés escribir el precio a mano y la base deja de moverla. La fila queda marcada para que sepas cuáles siguen el modelo y cuáles no.

La lista

Las localidades se ven agrupadas, y cada grupo se abre cuando lo necesitás. Desde ahí podés:

  • Cambiar el orden en que se ven en el checkout, arrastrando: los grupos entre sí, y las localidades dentro de cada grupo. Antes era alfabético, que en un comercio marplatense pone «Buenos Aires» arriba de «Mar del Plata».
  • Editar una localidad con el lápiz: su nombre, el plazo que se muestra al comprador, el código postal, el multiplicador y, si hace falta, el precio a mano. Una llave dice cuál de los dos manda.
  • Apagar una localidad con el ojo: sale del checkout pero conserva su precio, su orden y sus datos. Sirve cuando un destino se suspende por un tiempo y no querés perder lo cargado.
  • Cambiar el multiplicador de varias a la vez: tildás las que quieras —hay filtro por grupo y buscador— y les ponés el mismo.
  • Agregar y borrar localidades y grupos, renombrar grupos, y mover varias localidades de un grupo a otro.

En lote solo se cambia el multiplicador, y es a propósito. Un precio escrito a mano es una excepción; repetir la misma excepción en seis localidades no es una excepción, es un multiplicador mal puesto. Y poner porcentajes sobre un puñado llena la tabla de importes sueltos que la base ya no puede mover, que es justamente lo que este modo viene a evitar.

Los cambios no se guardan solos: las filas tocadas quedan marcadas y arriba aparece «Guardar todo», que guarda los precios y el orden juntos.

Volver atrás

Cada vez que se guarda, el plugin se queda con una copia de cómo estaba, y conserva las últimas cinco. Cada una dice qué cambió —«la base pasó de $32.043,83 a $36.850,40 · 300 precios cambiaron»— así sabés cuál querés recuperar. Volver a una también deja copia, así que no se pierde nada por equivocarse de versión.

Importar una planilla también deja copia. Es la acción que más cambia de una vez, así que es la que más la necesita.

La planilla, de ida y de vuelta

Desde la misma pantalla podés bajar la lista como está, editarla en Excel y volver a subirla en Modos de Envío. El archivo que baja es exactamente el que el importador acepta, y el importador entiende tanto CSV como libros de Excel: si lo abrís y lo guardás, sigue sirviendo.

4.5. ¿Cuál elijo?

Tu situación Modo recomendado
Cobrás por barrio Barrios predefinidos
Cobrás por radio o por kilómetros desde el local Polígonos manuales
Tenés zonas raras (mitad de un barrio sí, mitad no) Polígonos manuales
Querés algo rápido y no necesitás precisión milimétrica Barrios predefinidos
Repartís a muchas localidades y el precio depende del destino Localidades
Tu cobertura es tan grande que dibujarla sería interminable Localidades

4.6. Pausar una zona temporalmente (stand-by)

Cada zona tiene un toggle «Pausar zona» para suspenderla sin borrarla. Útil cuando, por algún motivo puntual, dejás de cubrir una zona (se rompió la moto, hay un corte en el barrio, querés probar quitarla unas horas) pero no querés perder la configuración.

  • En el editor, las zonas en stand-by se ven con efecto rayado y desaturado para distinguirlas de las activas a simple vista.
  • En el frontend (mapa público y leyenda de zonas), aparecen igualmente pintadas pero con la etiqueta «(No disponible)» al lado del nombre.
  • En el checkout, si la dirección del cliente cae dentro de una zona pausada, no se le ofrece la opción de envío y se le muestra un mensaje específico.

Cada zona pausada tiene además un campo opcional «Mensaje al cliente» para personalizar ese aviso (ej.: «Esta zona no está disponible los domingos. Volvé el lunes o pasá a retirarlo por el local.»). Si lo dejás vacío, el plugin muestra un mensaje genérico.

El stand-by es reversible y no destructivo: cuando destildás «Pausar zona», la zona vuelve a operar exactamente como estaba (mismo nombre, color, precio, polígonos / barrios). Es la opción correcta para suspender temporalmente; si la querés sacar de forma definitiva, mejor borrala.

4.7. Probar una dirección desde el admin

En el sidebar de Logística → Zonas tenés una herramienta de «Test de zona»: pegás una dirección, hacés click en Probar y el plugin te dice con qué zona matchea (con el nombre y el precio que se le aplicaría al cliente) o si la dirección queda fuera de toda zona.

Sirve para verificar configuraciones antes de publicarlas en el frontend, y también para responder consultas concretas del estilo «¿les llego a la calle X 1234?» sin tener que abrir el checkout y simular una compra.

5. Reglas por producto

En Logística → Reglas por producto decidís qué métodos de envío se le ofrecen al comprador según lo que tenga en el carrito.

Hay dos formas de que un pedido salga de tu local: lo lleva tu camión —Envío Propio— o lo despacha una empresa de afuera —Correo Privado—. El caso típico es una ferretería: las herramientas vienen encajonadas y un correo las despacha sin problema, pero los materiales de obra no los toma nadie. Las dos cosas conviven en el mismo carrito y el envío que corresponde no es el mismo.

El plugin no se ata a ningún correo en particular, y ahí está la gracia: funciona con el que ya tengas configurado en tu tienda, sea cual sea. Si mañana sumás el plugin oficial de otro, alcanza con volver a esta pantalla y tildarlo. Y si uno deja de operar, lo destildás.

5.1. Cómo se configura

  1. Activás las reglas. Mientras estén apagadas, el checkout muestra todos los métodos como siempre.
  2. Marcás qué clases de envío acepta el correo. Salen de las clases de envío de WooCommerce. Lo que no marques es Envío Propio: lo lleva el camión.
  3. Marcás cuáles de tus envíos son Correo Privado y están operando. El plugin los detecta solo de tus zonas de envío, y los lista con el nombre que ve el comprador.
  4. Decidís si el retiro por el local queda siempre disponible. Es la salida que siempre funciona cuando ningún envío alcanza.

Abajo de todo, la pantalla te muestra en castellano cómo queda la regla, escrita con los nombres de tus propios métodos y armada en el momento, mientras tildás.

5.2. Cómo decide

Qué hay en el carrito Qué se le ofrece
Todo lo acepta el correo Correo Privado
Hay aunque sea un producto que el correo no toma Envío Propio, que lleva el pedido completo
Cualquiera de los dos casos El retiro por el local, si lo dejaste siempre disponible

Un carrito nunca se parte en dos envíos: siempre resuelve a una sola opción.

5.3. Detalles que conviene saber

  • Un producto sin clase de envío es Envío Propio. Es el criterio seguro: tu camión siempre puede llevarlo, y un correo podría rechazarlo en el mostrador.
  • Los productos que no necesitan envío no cuentan. Un descargable o un servicio en el carrito no cambia la decisión.
  • Las reglas nunca tocan los precios. Solo deciden qué métodos se muestran; cada uno sigue cobrando lo suyo.
  • Nunca te dejan sin opciones. Si la configuración quedara tal que no sobrevive ningún método, el plugin vuelve a mostrar todos en lugar de dejar el checkout sin salida. Si eso pasa, revisá que haya al menos un Correo Privado tildado.

6. Horarios de atención

En Logística → Horarios definís cuándo tu tienda está abierta. Esto se usa para mostrar al público el estado actual de la sucursal (Abierto / Cerrado / Cierra pronto) y los horarios completos.

6.1. Modo «Abierto todo el tiempo» (24/7)

Si tu tienda atiende las 24 horas, activá el switch Abierto todo el tiempo. La tabla de horarios se oculta y la sucursal se considera siempre abierta. Podés escribir un mensaje opcional (ej.: «Atendemos las 24 horas, todos los días») que va a aparecer donde uses el shortcode [horarios_completos].

6.2. Horarios por día

Si tenés un horario «normal», desactivá la opción 24/7 y completá la tabla:

  • Abre: tildá los días que abrís. Los demás se consideran cerrados.
  • Turno: Corrido (un solo bloque, ej.: 09:00 a 18:00) o Cortado (mañana y tarde, ej.: 09:00 a 13:00 y 17:00 a 21:00).
  • Apertura / Cierre: la hora del primer turno (y del segundo si elegiste Cortado).

6.3. Atajos para cargar la grilla más rápido

Para no tener que tildar día por día, hay presets rápidos arriba de la tabla con un click:

  • Lun-Vie 9-18 — oficina clásica.
  • Lun-Sáb 9-13 — turno mañana.
  • Lun-Sáb 9-13 / 16-20 — turno cortado típico de comercio.
  • Todos 10-22 — atención larga incluyendo finde.
  • Limpiar todo — vacía todos los días para empezar de cero.

Y si querés un esquema parecido al estándar pero ajustado, cada fila de día tiene un botón «Copiar día anterior» que toma exactamente la configuración del día de arriba (turno + horarios) en un solo click. Útil para cargar de a varios días iguales sin repetir.

El plugin usa la zona horaria configurada en WordPress (Ajustes → Generales → Zona horaria) para calcular si la tienda está abierta o cerrada en cada momento. Si tu sitio está pensado para una ciudad fuera de Argentina, asegurate de que ese ajuste esté correcto antes de configurar los horarios; si no, podés ver «Cerrado» cuando deberías estar «Abierto» (o viceversa) por una diferencia de huso.

El plugin agrupa días con el mismo horario automáticamente. Si de lunes a viernes abrís 09:00–18:00, el shortcode lo va a mostrar como «Lunes a Viernes: 09:00 a 18:00», no como siete líneas separadas.

7. Demoras en pedidos

En días puntuales (un sábado a la noche, una semana de promociones, etc.) puede pasar que tu cocina o depósito esté saturado y los envíos demoren más de lo normal. Para no defraudar al cliente, podés avisar la demora directamente desde el admin sin tocar ninguna página.

Andá a Logística → Demora en Pedidos, activá el aviso y elegí una franja:

  • de 15 a 30 minutos
  • de 30 a 45 minutos
  • de 45 minutos a 1 hora
  • 1 hora o más
  • Entrega en el día
  • 1 a 2 días
  • de 2 a 3 días hábiles
  • 1 semana
  • 2 semanas

7.1. Dónde se muestra el aviso

El aviso de demora aparece en cualquier página donde uses los shortcodes [cartel_de_tienda] o [demora_envios] (ver sección Shortcodes). Si no insertaste ninguno de los dos, el aviso queda activo en el admin pero no se muestra al público.

Cuando termine la situación, simplemente desactivá el aviso desde Logística → Demora en Pedidos. Los shortcodes dejan de imprimirlo automáticamente.

El aviso de demora solo se muestra si la tienda está abierta en ese momento. Si estás cerrado según los horarios configurados, no tiene sentido avisar demora porque no hay envíos en curso, así que el plugin lo oculta solo.

Acordate de desactivar el aviso cuando ya volvieron a tiempos normales: si lo dejás encendido, los clientes lo van a seguir viendo aunque ya no haya demora.

8. Shortcodes

Pegá cualquiera de estos shortcodes en el contenido de una página, una entrada o un widget de texto. WordPress los reemplaza por la información actualizada al momento de cargar la página.

  • [direccion_sucursal]

    Dirección de la sucursal en texto plano. Útil para meter en el footer o en una página de contacto.

  • [telefono_sucursal]

    Teléfono de la tienda como link clickeable (en celulares, hace tap-para-llamar).

    Atributos opcionales

    Atributo Valor Descripción
    boton "1" Lo renderiza como botón con fondo azul en lugar de link plano.
    icono "phone" Antepone un ícono de FontAwesome (requiere que tu tema cargue FA).
    size "0" a "3" Tamaño del botón: 0 = inline, 1 = chico, 2 = normal (default), 3 = grande.

    Ejemplo: [telefono_sucursal boton="1" icono="phone" size="3"]

  • [whatsapp_sucursal]

    Número de WhatsApp como link a wa.me. Acepta los mismos atributos boton, icono y size que el teléfono. Como botón, sale en verde WhatsApp.

    Ejemplo: [whatsapp_sucursal boton="1" icono="whatsapp" size="2"]

  • [email_sucursal]

    Email como link mailto:. Mismos atributos opcionales que los anteriores.

    Ejemplo: [email_sucursal boton="1" icono="envelope" size="1"]

  • [estado_sucursal]

    Muestra dinámicamente Abierto, Cerrado o Cierra pronto según los horarios configurados y la hora actual del visitante.

  • [horarios_completos]

    Lista los horarios de atención agrupando días iguales (ej.: Lunes a Viernes: 09:00 a 18:00). Si activaste el modo 24/7 y pusiste un mensaje, muestra ese texto.

  • [envio_gratis_aviso]

    Si tenés activado el envío gratis, muestra el aviso (con o sin monto mínimo, según lo configures). Si está desactivado, no muestra nada.

  • [cartel_de_tienda]

    Cartel listo para insertar debajo del header del sitio. Imprime «PIDIENDO EN: [nombre de tu tienda] [estado]» y, si la tienda está abierta y tenés la demora activada, agrega abajo el aviso de demora estimada.

    No tiene atributos: el comportamiento es siempre el mismo. Pensado para meterlo una sola vez, en una zona de header / barra superior, y olvidarse.

  • [demora_envios]

    Aviso destacado de demora estimada (versión grande, standalone). Útil para meter en el medio de una página o en un widget cuando querés que el aviso sea más visible que en el cartel del header.

    No imprime nada si la demora está desactivada en el admin o si la tienda está cerrada en ese momento.

  • [zonas_de_entrega_mapa]

    Inserta un mapa interactivo con las zonas pintadas y la lista de zonas con sus precios. Las zonas en stand-by también se pintan en el mapa pero con efecto desaturado, y en la leyenda aparecen con la etiqueta «(No disponible)» al lado del nombre.

    Atributos opcionales

    Atributo Valor Descripción
    mostrar "completo" Mapa + leyenda de zonas (default).
    mostrar "mapa" Solo el mapa, sin leyenda.
    mostrar "leyenda" Solo la lista de zonas con sus precios, sin mapa.

    Ejemplo: [zonas_de_entrega_mapa mostrar="mapa"]

  • [zonas_lista]

    Igual que [zonas_de_entrega_mapa mostrar="leyenda"]: solo la lista de zonas con precios, sin mapa. Útil para pegarlo en el footer o en una columna estrecha. Las zonas en stand-by aparecen con la etiqueta «(No disponible)» al lado del nombre.

Los shortcodes también están disponibles desde el admin del plugin: en cualquier página de configuración, en la barra lateral derecha vas a ver el listado completo con un botón Copiar para no tener que escribirlos a mano.

Los precios de las zonas que se muestran en la leyenda usan el formato de moneda configurado en WooCommerce (símbolo, posición y separadores de miles/decimales). Si cambiás el currency en WooCommerce → Ajustes → General, los precios se reformatean automáticamente sin tener que tocar nada en el plugin.

9. Cómo se ve en el checkout

Cuando un cliente completa su dirección de envío en el checkout de WooCommerce, el plugin hace dos cosas en tiempo real:

  1. Geocodifica la dirección (la convierte en latitud/longitud) usando Google Maps.
  2. Verifica si esa coordenada cae dentro de alguna de tus zonas de cobertura.

Si cae dentro de una zona, el cliente ve:

  • Un mapa con su ubicación, la ubicación de tu tienda y la zona pintada. El zoom se ajusta solo para mostrar al mismo tiempo la zona matcheada, el marker del cliente y el de la tienda con un margen prolijo.
  • Un efecto visual tipo «ping de sonar» sobre la zona que matcheó, para que sea evidente cuál es.
  • El costo de envío correspondiente, que se aplica al carrito automáticamente.
  • Un mensaje debajo del mapa con la zona y el precio.

Si está fuera de toda zona, no se le ofrece la opción de envío y se le invita a retirar por el local (o a contactar a la tienda, si tenés desactivado el retiro). Esto evita que cargue una compra que después no podés cumplir.

Si la dirección cae dentro de una zona en stand-by, tampoco se le ofrece el envío, pero el plugin le muestra el mensaje específico que cargaste para esa zona (o uno genérico si lo dejaste vacío). Así el cliente entiende que normalmente sí cubrís esa zona pero que justo ahora está pausada, en lugar de pensar que nunca llegan ahí.

El cliente puede arrastrar y hacer zoom en el mapa del checkout para ver mejor la zona, su ubicación o las calles cercanas. Para evitar que el scroll de la página quede «atrapado» dentro del mapa al hacer scroll con la rueda, hay que mantener apretada la tecla Ctrl mientras se hace zoom (o usar dos dedos en mobile). Es el comportamiento estándar de Google Maps embebido y le evita al cliente quedarse «encerrado» en el mapa sin poder seguir bajando en la página de checkout.

El cliente no necesita ser preciso con la dirección: el plugin entiende variantes, abreviaciones y errores comunes de tipeo gracias a Google Maps. Igual, lo ideal es que escriba calle y altura.

10. Cómo se actualiza el plugin

Cuando publicamos una nueva versión, WordPress te la muestra como cualquier otra actualización: en la pantalla de Plugins aparece un cartel diciendo «Hay una nueva versión disponible», hacés click en Actualizar ahora y listo.

Las actualizaciones llegan desde nuestro servidor (mardelplatadigital.com), no desde el repositorio público de WordPress.org. Esto te garantiza que recibís la versión oficial, mantenida por nosotros.

Tu configuración no se pierde al actualizar. Las zonas, horarios, datos de contacto y el resto de la configuración quedan exactamente igual. Solo se reemplazan los archivos de código del plugin.

Las versiones más grandes (las que cambian el primer o segundo número, ej.: 0.10.x → 0.11.0) suelen incluir además una migración automática que actualiza el formato interno de la configuración a la versión nueva. Esto pasa una sola vez, sin tu intervención: la primera vez que entrás al admin después de actualizar, el plugin detecta la versión vieja, normaliza los datos y queda todo listo. Si venís de versiones muy antiguas (anteriores a la 0.9.0, que dependían de ACF Pro), también hay una migración específica que toma los datos viejos y los pasa al nuevo formato.

11. Preguntas frecuentes

¿El plugin funciona en cualquier ciudad o solo en Mar del Plata?

El plugin trae un catálogo de ciudades listas para usar, que se elige en el wizard de setup: Mar del Plata – General Pueyrredón, Ciudad Autónoma de Buenos Aires, Córdoba, Rosario, La Plata, Bahía Blanca, Tandil, Santa Fe, Corrientes, Salta, Neuquén, Santa Rosa, Comodoro Rivadavia y Ushuaia. Todas vienen con sus barrios oficiales pre-cargados (modo «barrios predefinidos») y, por supuesto, también funcionan con «polígonos manuales».

El modo Localidades trabaja sin mapa: sirve para repartir a las localidades que vos cargues, con su precio, estén o no en el catálogo. Y si tu ciudad todavía no está en la lista, podemos sumarla al plugin: escribinos por contacto contándonos cuál es.

Una instalación del plugin maneja una sola ciudad. Si tenés varias tiendas en distintas ciudades, cada una necesita su propia instalación.

¿Puedo cambiar de ciudad después del setup inicial?

Sí. En Logística → General → Avanzado hay un botón «Re-ejecutar setup inicial» que te lleva otra vez al wizard. Las zonas que ya tenías no se borran: simplemente quedan asociadas a la ciudad anterior. Si en algún momento volvés a elegir la ciudad original, las zonas reaparecen tal cual estaban.

¿En qué zona horaria calcula los horarios de atención?

El plugin usa la zona horaria configurada en WordPress → Ajustes → Generales → Zona horaria. Si tu sitio está configurado para Argentina, los horarios se calculan en hora argentina; si está en España o México, lo mismo en su huso correspondiente. Si cambiás la zona horaria de WordPress, el plugin se adapta automáticamente sin tener que tocar nada más en la configuración del plugin.

¿Necesito sí o sí una API Key de Google Maps?

Sí. Sin clave de Google Maps, el mapa no carga. Google ofrece un crédito mensual gratuito que para tiendas chicas suele alcanzar de sobra; si tu tienda tiene mucho tráfico, conviene revisar el consumo desde la consola de Google Cloud y, si hace falta, configurar topes de gasto.

Si cambio de modo (polígonos ↔ barrios), ¿pierdo lo que tenía?

No. Cada modo guarda su configuración por separado. Podés ir y volver entre modos las veces que quieras: lo que dibujaste en polígonos sigue ahí cuando volvés, igual que los barrios que asignaste.

¿Puedo cobrar distinto por zona?

Sí, ese es el punto. Cada zona (sea polígono manual o conjunto de barrios) tiene su propio precio de envío. El plugin se encarga de aplicar el correcto según dónde caiga el cliente.

¿Puedo pausar una zona temporalmente sin borrarla?

Sí. Cada zona tiene un toggle «Pausar zona»: la zona deja de aceptar pedidos en el checkout (el cliente que cae ahí ve un mensaje específico que vos personalizás) pero la configuración queda intacta (nombre, color, precio, polígonos / barrios). Cuando la querés volver a habilitar, destildás el toggle y opera como antes. Mirá el detalle en la sección Modos de Envío.

¿Puedo probar una dirección antes de publicar las zonas?

Sí. En el sidebar de Logística → Zonas tenés una herramienta de «Test de zona»: pegás cualquier dirección, hacés click en Probar y el plugin te dice con qué zona matchea (con el precio que se le aplicaría) o si queda fuera de toda zona. Sirve también para responder consultas del estilo «¿llegan a la calle X 1234?» sin tener que abrir el checkout.

¿Qué pasa si el cliente está fuera de todas las zonas?

No se le ofrece la opción de envío. Según cómo lo hayas configurado, se le sugiere retirar por el local o contactarte por teléfono / WhatsApp.

¿Puedo desactivar el retiro por el local?

Sí. En Logística → General hay una opción SOLO ENVÍOS que oculta la opción de retiro y, en cambio, le muestra al cliente un mensaje invitándolo a contactar al local (vos elegís si por teléfono, WhatsApp o ambos).

¿El plugin afecta los métodos de envío de WooCommerce que ya tenía?

El plugin agrega su propio método de envío (Logística MDPD) y respeta los demás. Los métodos que ya tenías configurados (un transporte, un correo, el retiro en sucursal) siguen funcionando: WooCommerce los muestra todos al cliente y este elige.

¿Qué pasa si desactivo o desinstalo el plugin?

Al desactivarlo, simplemente deja de funcionar (las zonas, los shortcodes y el mapa del checkout dejan de aparecer), pero los datos quedan intactos. Si lo reactivás, volvés a tenerlo todo. Al desinstalarlo, los datos se conservan por defecto; solo se borran si activaste explícitamente la opción «Eliminar todos los datos al desinstalar».

¿Puedo poner el mapa de zonas en una página de mi web (no solo en el checkout)?

Sí. Usá el shortcode [zonas_de_entrega_mapa] en cualquier página o entrada. Es ideal para una sección «¿Llegamos a tu zona?» en la home o en una landing.

¿Puedo personalizar los íconos del mapa?

Sí. En Logística → General podés subir tu propia imagen para el marker de la tienda y para el marker del cliente, desde la biblioteca de medios de WordPress. Si dejás los campos vacíos, se usan los íconos por defecto del plugin.

12. Soporte

¿Algo no anda como esperabas? ¿Tenés una sugerencia o necesitás ayuda con la configuración inicial?

Cuando nos escribas, contanos qué versión del plugin estás usando (la vas a ver al pie del botón Guardar Cambios, en el sidebar derecho de cualquier página de Logística) y, si es un problema visual o de comportamiento, una captura de pantalla nos ayuda muchísimo.