VibeFox Mondial Relay for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de Mondial Relay: el código de marca (Enseigne) y la Private Key se obtienen con una cuenta de empresa de Mondial Relay: consulta la sección para profesionales de mondialrelay.fr, tu área de cliente "Connect" o tu contacto comercial. El selector de mapa solo necesita el código de marca. La lista de puntos más cercanos necesita ambos. Para las pruebas, Mondial Relay proporciona el código de marca BDTEST13 con la Private Key PrivateK.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta vfd_mondialrelay a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Mondial Relay, o haz clic en Settings debajo del nombre del plugin en la página Plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Introduce tu código de marca (Enseigne) y, para el modo de lista, la Private Key. Rellena Country prices.
6. Añade VibeFox Mondial Relay a las zonas de tus países de entrega en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona solo tiene un campo:
Title (zone): el nombre de esta opción en la finalización de compra. Déjalo vacío para usar el Name global.
Las advertencias en la parte superior de la página indican los problemas que ocultan el método: falta el código de marca, falta la Private Key en el modo de lista y no hay precio para Francia, Bélgica o España.
General
Enable/Disable: activa o desactiva Mondial Relay de forma global.
Name: el nombre del método de envío que ven los clientes en la finalización de compra. Por defecto: Mondial Relay Point Relais.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade.
Cuenta de Mondial Relay
Brand code (Enseigne): obligatorio, hasta 8 caracteres, por ejemplo BDTEST13 para pruebas. Lo usan el mapa de puntos de recogida y el Web Service. Sin él, los clientes no pueden elegir un Point Relais, así que el método no se muestra en la finalización de compra.
Private Key: solo es necesaria para el selector List of nearest points. Cuando el código de marca y la Private Key están configurados, la conexión con el Web Service de Mondial Relay se prueba cada vez que guardas los ajustes, y un mensaje indica si son válidos.
Selector del punto de recogida
Selector: cómo elige el cliente un Point Relais.
Tarifas (en la moneda de tu tienda)
Country prices: precio por país de destino y peso del paquete. Haz clic en + Add country para añadir una fila y en el icono de la cruz para eliminar una. Usa la fila * Default para todos los demás países. Cada fila tiene una columna Price y columnas de peso: XS hasta 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg y XL por más de 5 kg. Si la columna de peso está vacía o es 0, se usa la columna Price. Decimales con punto o con coma (4.90 o 4,90). Las filas sin ningún precio se eliminan al guardar, y los valores que no son números se notifican y se dejan vacíos.
Fallback cost: se usa para los países que no tienen fila en la tabla. Déjalo vacío para ocultar el método en esos países.
Calculation type: cómo se calcula el precio.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío es gratis. Déjalo vacío si no quieres envío gratis.
Disponibilidad
Min weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.
Max weight (kg): oculta el método cuando el carrito pesa más. Mondial Relay acepta paquetes de hasta 30 kg en los Points Relais. Por defecto: 30. 0 significa sin límite.
Minimum subtotal: muestra el método solo cuando el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.
Disabled shipping classes: oculta el método cuando el carrito contiene artículos de estas clases de envío de WooCommerce.
Ignore shipping zones: ofrece el método para los países indicados abajo, o para todos los países admitidos si la lista está vacía, aunque ninguna zona de envío los incluya.
Countries (ignore zones): los países de destino para ese modo. Este campo solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: registra el cálculo de tarifas y las llamadas al Web Service en WooCommerce > Status > Logs (origen vfd-mondialrelay). Los errores siempre se registran, aunque esta opción esté desactivada. No se registran claves ni datos de clientes.
Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes y los métodos de zona. Desactivar el plugin nunca borra nada. Los puntos de recogida guardados en los pedidos se conservan.
Cómo funciona en la finalización de compra
El método se ofrece solo para los países con Points Relais: Francia, Bélgica, Luxemburgo, España, Portugal y los Países Bajos. Se oculta cuando el cliente no podría elegir un punto: sin código de marca, o en el modo de lista sin la Private Key.
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. El plugin comprueba el peso del carrito, el subtotal mínimo y las clases de envío excluidas. El precio sale de la fila del país (o de la fila *): la columna de peso; si no, la columna Price. Sin fila, se usa el coste alternativo. Si no hay precio, el método se oculta. Si el subtotal alcanza Free shipping from, el precio pasa a ser 0.
El método funciona en la finalización de compra clásica y en los bloques Carrito y Finalizar compra. Es compatible con High-Performance Order Storage (HPOS) de WooCommerce.
El plugin no solicita tarifas en tiempo real: Mondial Relay no tiene una API pública de tarifas. No crea envíos, no imprime etiquetas ni hace seguimiento de paquetes. Crea los envíos en tu espacio "Connect" de Mondial Relay usando el número de Point Relais que aparece en el pedido. La entrega a domicilio (Domicile) no se ofrece.
Puntos de recogida
Modo mapa: cuando el cliente selecciona Mondial Relay, aparece debajo del método el botón Choose a Point Relais. Abre el mapa oficial de Mondial Relay para el país de entrega, el código postal y el peso del paquete. Cuando el cliente elige un punto, se muestra como Selected: y el botón cambia a Change Point Relais. El widget del mapa se carga desde widget.mondialrelay.com y su biblioteca de mapas desde unpkg.com solo cuando el cliente abre el mapa. Menciónalo en tu política de privacidad.
Modo lista: un desplegable - Choose a Point Relais - muestra los 10 puntos más cercanos al código postal de entrega, con su distancia. El punto elegido se muestra con su horario de apertura. La lista la carga tu servidor, así que ningún script de terceros se ejecuta en el navegador. Las listas se guardan en caché durante 12 horas, una respuesta vacía durante 1 hora, y una petición fallida se recuerda durante 5 minutos. El tiempo de espera del Web Service es de 10 segundos. Si la lista no está disponible, el cliente ve "The list of pickup points is not available right now. Please use the map." y se le ofrece el mapa.
Un punto es obligatorio. Sin él, el cliente ve Please choose a Mondial Relay pickup point. y el pedido no se realiza. Un punto situado en un país distinto al de la dirección de entrega se rechaza. En el modo de lista, el punto también se comprueba con la lista de esa dirección.
El número del Point Relais, el país, el nombre y la dirección se guardan en el pedido. Se muestran en la pantalla del pedido, debajo de la dirección de envío (con el número del Point Relais), en la página de agradecimiento, en My account > Orders y en los correos electrónicos del pedido (HTML y texto sin formato) como Mondial Relay pickup point.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, Mondial Relay no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí lo ven, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Mondial Relay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que el método esté añadido a la zona del país del cliente (o que Ignore shipping zones esté activado y el país permitido). Revisa las advertencias en la parte superior de la página de ajustes: el método se oculta sin código de marca, en el modo de lista sin la Private Key, para un país sin precio, fuera de los límites de peso y subtotal, y para los países sin Points Relais.
La prueba del Web Service falló después de guardar: el mensaje muestra el error de Mondial Relay, por ejemplo un código de marca o una clave de seguridad no válidos. Comprueba el código de marca y la Private Key con Mondial Relay.
La lista de puntos está vacía o no está disponible: el cliente debe introducir primero un código postal. Si el Web Service falla, se ofrece el mapa en su lugar. Activa Debug log y abre WooCommerce > Status > Logs, origen vfd-mondialrelay, para ver el motivo.
El mapa no se abre: el mapa se carga desde widget.mondialrelay.com y unpkg.com. Comprueba que un bloqueador de privacidad o de scripts no los bloquee. Los desarrolladores pueden cambiar las URL de los scripts con los filtros vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url y vfd_mrel_leaflet_style_url. La lista de países admitidos se puede cambiar con el filtro vfd_mrel_supported_countries.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes. Solo se borran las listas de puntos de recogida en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia, el estado de licencia de este plugin y las cachés siempre se eliminan. Los ajustes y los métodos de zona solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una futura reinstalación. Los puntos de recogida guardados en los pedidos se conservan, y los pedidos existentes mantienen sus líneas de envío.
Mondial Relay es una marca comercial de su respectivo titular. Este plugin no está afiliado a Mondial Relay ni cuenta con su aprobación.