VibeFox GLS ParcelShop 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.
GLS: el plugin no usa ni necesita una cuenta de GLS ni una clave de API. El mapa de ParcelShop es público. Necesitas un contrato con GLS para enviar los paquetes a los ParcelShop elegidos.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_gls_parcelshop a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, 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. Define el nombre y tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost (consulta Configuración).
6. Añade VibeFox GLS ParcelShop a una zona de envío 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 GLS ParcelShop. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene un solo campo:
Title (zone): el nombre del método de envío que ven los clientes en esta zona. Déjalo vacío para usar el Name global.
Las advertencias en la parte superior de la página de ajustes señalan problemas de configuración, por ejemplo cuando no hay ningún precio definido o cuando ninguno de los países seleccionados está cubierto por el mapa de GLS. Los números no válidos se rechazan con un mensaje y se mantiene el valor anterior.
General
La sección muestra los países cubiertos por el mapa de GLS. El método no se ofrece para otros países de destino.
Enable/Disable: activa o desactiva el método en todas las zonas a la vez. Por defecto: activado.
Name: el nombre del método de envío que se muestra al cliente. Una zona puede sustituirlo con su propio Title. Por defecto: GLS ParcelShop.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío, None no lo añade. Por defecto: Taxable.
Precios
Los precios se introducen en la moneda de tu tienda. Los decimales pueden usar coma o punto (4,99 o 4.99).
Calculation type: cómo se aplica el precio.
Country prices: una tabla con una fila por país de destino. Haz clic en + Add country para añadir una fila y en la cruz para eliminar una. Cada fila tiene un Country, un Price y cinco columnas de peso: XS hasta 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg y XL más de 5 kg. Se usa la columna del peso del carrito. Una columna de peso que se deja en 0 usa la columna Price. La fila * Default se usa para los países que no tienen fila propia. Las filas nuevas empiezan con 0 en todas las columnas, y una fila con todos los precios en 0 da envío gratis, así que rellena los precios antes de guardar.
Fallback cost: el precio que se usa cuando la tabla no tiene fila para el país de destino y no hay fila * Default. Déjalo vacío para ocultar el método en esos países.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío a GLS ParcelShop es gratis. Déjalo vacío si el envío nunca es gratis.
Disponibilidad
Minimum weight (kg): oculta el método cuando el carrito pesa menos. El peso se convierte desde la unidad de peso de tu tienda. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 20. Los ParcelShop de GLS suelen aceptar paquetes de hasta 20 kg, así que revísalo en tu contrato con GLS. Vacío o 0 significa sin límite.
Minimum cart subtotal: ofrece el método solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcanza este importe. Déjalo vacío si no hay mínimo.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de una de estas clases de envío de WooCommerce.
Ignore shipping zones: cuando está activado, el método se ofrece para los países seleccionados abajo, aunque no esté añadido a la zona de envío correspondiente. Cuando está desactivado, se ofrece solo en las zonas a las que se ha añadido. Por defecto: desactivado.
Countries (ignore zones mode): los países de destino para ese modo. Déjalo vacío para usar todos los países del mapa de GLS. Los países no cubiertos por el mapa de GLS se omiten. Este campo solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: registra el cálculo de tarifas y las elecciones de ParcelShop en WooCommerce > Status > Logs (origen vfd-gls-parcelshop). No se registran datos personales de los clientes. Desactiva el registro cuando termines.
Remove data on uninstall: cuando está activado, al borrar el plugin se eliminan los ajustes y las instancias de zona de este método. Desactivar el plugin nunca borra nada. El ParcelShop guardado en los pedidos siempre se conserva.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de envío, WooCommerce pide al plugin una tarifa. El plugin primero comprueba las condiciones: país de envío cubierto por el mapa de GLS, peso del carrito, subtotal mínimo del carrito y clases de envío excluidas. Si el subtotal del carrito alcanza Free shipping from, el envío es gratis. Si no, el precio se toma de la fila del país (o de la fila * Default) y de la columna de peso, o de Fallback cost. Si no se encuentra ningún precio, el método se oculta.
Cuando el cliente selecciona GLS ParcelShop, aparece un botón Select GLS ParcelShop debajo del método. Abre el mapa oficial de GLS ParcelShop para el país de envío. Después de elegir un ParcelShop, se muestran su nombre y su dirección, y el botón cambia a Change ParcelShop. La elección se recuerda en la sesión del cliente, así que se mantiene tras una actualización de la finalización de compra o una recarga de la página.
Cuando se realiza el pedido, el plugin comprueba que se ha elegido un ParcelShop y que está en el país de envío. Si no, el cliente ve Por favor, selecciona un GLS ParcelShop. o El GLS ParcelShop seleccionado no está en tu país de envío. Por favor, elige un ParcelShop de nuevo. y el pedido no se realiza. Si no se puede cargar el script del mapa de GLS, el cliente ve un mensaje para recargar la página o elegir otro método de envío.
El mapa de GLS se ejecuta en el navegador del cliente. En la página de finalización de compra el plugin carga el script del mapa de GLS desde map.gls-croatia.com, y el mapa carga los datos de los ParcelShop y las teselas del mapa desde GLS. GLS recibe los datos habituales de la petición del visitante (dirección IP, navegador). Desde tu servidor no se envía nada a GLS.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y de Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin no obtiene tarifas de GLS en tiempo real, no crea envíos de GLS, no imprime etiquetas ni hace el seguimiento de paquetes. No tiene en tu servidor una lista de ParcelShop, así que no puede verificar el ID del ParcelShop con GLS. Entrega el ID del ParcelShop del pedido a GLS de la forma habitual (MyGLS, tu software de GLS u otro plugin).
Puntos de recogida
El ParcelShop elegido se guarda con el pedido: su ID, su nombre con la dirección y su país.
Pantalla de pedidos del administrador: el nombre y la dirección del ParcelShop, con el ID y el país del ParcelShop, se muestran debajo de la dirección de envío. Si un pedido de GLS ParcelShop no tiene ningún ParcelShop, la pantalla muestra No se ha seleccionado ningún ParcelShop para este pedido.
Páginas del cliente: el ParcelShop se muestra en la página de agradecimiento y en la página de vista del pedido de la cuenta del cliente.
Correos electrónicos: el ParcelShop se añade a los correos del pedido, en HTML y en texto sin formato. Los correos enviados al administrador de la tienda también incluyen el ID del ParcelShop.
Los desarrolladores pueden leer el ParcelShop de los metadatos del pedido _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name y _vfd_glps_parcelshop_country.
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 GLS ParcelShop. 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 comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un 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, GLS ParcelShop no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada sí lo ven, marcado como (sin licencia: visible solo para administradores), 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
GLS ParcelShop 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 está permitido). Comprueba que el país de destino es uno de los países del mapa de GLS y que tiene un precio (una fila de país, la fila * Default o Fallback cost). Revisa los límites de peso, Minimum cart subtotal y Excluded shipping classes. Activa Debug log para ver el motivo en WooCommerce > Status > Logs.
El mapa no se abre: el cliente ve «No se pudo cargar el mapa de GLS ParcelShop...» cuando el script de GLS está bloqueado, por ejemplo por un bloqueador de anuncios o de privacidad, una política de seguridad del contenido o una caída de GLS. Permite map.gls-croatia.com en tu política de seguridad del contenido.
El envío es gratis para un país por error: revisa la fila de ese país en Country prices. Una fila donde el Price y todas las columnas de peso son 0 da envío gratis.
La tabla o un campo no se guardó: un valor no es un número válido. El mensaje en la parte superior de la página indica el valor. Usa dígitos con coma o punto como separador decimal.
Filtros para desarrolladores: vfd_glps_map_countries cambia la lista de países del mapa de GLS, vfd_glps_widget_url cambia la URL del script del mapa de GLS.
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 la dirección del sitio ha cambiado, haz clic en Check now para activar la clave para 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 datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan, junto con las cachés antiguas y el archivo de registro de la versión 1.0. Los ajustes y las instancias de zona del método se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. El ParcelShop guardado en los pedidos siempre se conserva, y los pedidos existentes mantienen sus líneas de envío.
GLS es una marca comercial de su respectivo propietario. Este plugin no está afiliado a GLS ni cuenta con su respaldo.