VibeFox LP Express 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.
LP Express: no necesitas una cuenta de API. LP Express no tiene una API pública de precios. La API de Unisend solo está disponible para clientes con contrato y este plugin no la usa, así que introduces tus propios precios (de contrato). Crea los paquetes en tu cuenta de Unisend («Mano siuntos»).
Lista de terminales de paquetes: el plugin usa la lista abierta de terminales de LP Express, la misma que usaban los plugins anteriores de LP Express. En el momento de la versión 1.1.0 esta lista en línea no estaba disponible. Mientras no esté disponible, el plugin usa la última copia descargada si existe; si no, tu propia lista. Prepárate para introducir tu propia lista (véase Configuración).
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_lp_express a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox LP Express, o haz clic en Settings debajo del nombre del plugin en la página de 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. Rellena la tabla de precios (al menos una fila) o un coste alternativo. Revisa la línea de estado sobre los terminales de paquetes en la parte superior de la página y añade tu propia lista de terminales si la lista en línea no está disponible.
6. Añade VibeFox LP Express a tu zona de Lituania en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox LP Express. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene solo un campo:
Title (zone): el nombre que ven los clientes en esta zona. Déjalo vacío para usar el Method title global.
En la parte superior de la página, los avisos muestran los problemas y el estado de los terminales. Un aviso rojo aparece cuando no hay ningún precio definido o no hay ningún terminal de paquetes disponible, porque en ese caso el método no se muestra en la finalización de compra. Una línea informativa muestra cuántos terminales de paquetes en cuántas ciudades están disponibles y de qué fuente: la lista en línea, una copia guardada de la lista en línea (con su fecha) o tu propia lista.
General
Enable/Disable: activa o desactiva LP Express en todas las zonas a la vez.
Method title: el nombre del método de envío que ven los clientes. El título de un método de zona lo sustituye. Por defecto: LP Express parcel terminal.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade.
Precios (en la moneda de tu tienda; los decimales pueden escribirse como 2.99 o 2,99)
Price table: una fila por cada país de destino. Haz clic en + Add country para añadir una fila y en la cruz (×) para quitar una. Elige * Any other country para cualquier país sin fila propia. Cada fila tiene un Base price y columnas de peso: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) y XL (>5 kg). El peso es el del carrito, o el de un artículo con Per item. Una columna vacía usa el precio base de la fila. 0 significa gratis. Los precios que no son números se notifican tras guardar y se dejan vacíos.
Fallback cost: se usa cuando la tabla de precios no tiene fila para el país de destino. Déjalo vacío para ocultar el método en esos países.
Calculation: cómo se calcula el precio.
Free shipping from: el total del carrito (después de descuentos, como se muestra en el carrito) a partir del cual LP Express es gratis. Déjalo vacío si no hay envío gratis.
Disponibilidad
Minimum weight (kg): oculta el método cuando el carrito pesa menos. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Los terminales de LP Express aceptan paquetes de hasta 30 kg. Por defecto: 30. 0 significa sin límite.
Minimum cart total: muestra el método solo a partir de este total del carrito. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método cuando el carrito contiene productos de estas clases de envío de WooCommerce.
Ignore shipping zones: ofrece LP Express para los países indicados abajo sin añadirlo a una zona. Cuando está desactivado, los países se definen por las zonas de envío donde se ha añadido el método. Se recomienda.
Countries (without zones): los países de destino para ese modo. Este campo solo se usa cuando Ignore shipping zones está activado. Déjalo vacío para ofrecer el método a cualquier destino.
Terminales de paquetes
Terminal list: de dónde proceden los terminales.
Own terminal list: un terminal por línea en el formato ID | Name | City | Address | ZIP, por ejemplo 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID y City son obligatorios. Las líneas que empiezan por # se ignoran. Usa los ID de terminal que espera tu cuenta de Unisend.
Al guardar los ajustes, la lista de terminales se vuelve a cargar.
Avanzado
Debug log: registra en WooCommerce > Status > Logs (origen vfd-lp-express) el cálculo de precios y los detalles de la lista de terminales. Los errores, como una lista de terminales no disponible, siempre se registran. No se registran datos de clientes.
Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes, los métodos de zona y los terminales en caché. Desactivar el plugin nunca borra los ajustes. El terminal guardado en los pedidos se conserva.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. El plugin comprueba el peso del carrito, el total mínimo del carrito y las clases de envío excluidas. Si no hay ningún terminal de paquetes disponible, el método se oculta, así que el cliente nunca ve una finalización de compra que no se pueda completar. Si se aplica el envío gratuito, el precio es 0. Si no, el precio viene de la fila del país (o de la fila *): la columna de peso, si no, el precio base, si no, el coste alternativo. Si no hay precio, el método se oculta.
La lista en línea de terminales se guarda en caché durante 24 horas. Una descarga fallida se recuerda durante 15 minutos, para que la finalización de compra no espere a la lista en cada actualización. El tiempo de espera de la descarga es de 10 segundos. Solo se ofrecen los terminales activos de la lista.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS). Los precios están en la moneda de tu tienda. El plugin no convierte monedas.
El plugin no solicita precios de LP Express ni de Unisend, no crea envíos, no imprime etiquetas, no llama a un mensajero ni hace seguimiento de paquetes. Crea los paquetes en tu cuenta de Unisend («Mano siuntos»). La entrega a domicilio por mensajería (puerta a puerta) no forma parte de este método.
Puntos de recogida
Cuando el cliente selecciona LP Express, aparecen dos listas debajo del método: -- Select city -- y -- Select parcel terminal --. La ciudad de la dirección de envío se preselecciona cuando coincide con una ciudad de la lista. Cada terminal se muestra con su nombre, dirección y código postal. La elección se recuerda durante la finalización de compra, así que no se pierde cuando la página se actualiza.
El terminal es obligatorio. En la finalización de compra clásica el cliente ve Please select an LP Express parcel terminal. En el bloque de finalización de compra, Place order está bloqueado hasta que se elige un terminal. En ambas finalizaciones de compra, el servidor vuelve a comprobar el terminal con la lista, así que un ID de terminal falsificado o desactualizado se rechaza.
El ID, el nombre y la ciudad del terminal se guardan en el pedido. Se muestran en la pantalla del pedido debajo de la dirección de envío (con el ID del terminal), en la página de pedido recibido, en My account > Orders y en los correos electrónicos del pedido (HTML y texto sin formato) como LP Express parcel terminal.
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 LP Express. 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 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, LP Express no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí la ven, marcada 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 de 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
LP Express 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). Abre la página de ajustes: un aviso rojo explica si no hay ningún precio definido o no hay ningún terminal de paquetes disponible. Revisa también los límites de peso, el Minimum cart total y las Excluded shipping classes. Con Debug log activado, WooCommerce > Status > Logs (origen vfd-lp-express) muestra por qué se ocultó el método.
No hay terminales de paquetes: la lista en línea no se pudo cargar y no hay copia guardada ni lista propia. El plugin vuelve a intentarlo cada 15 minutos. Introduce tu propia lista en Own terminal list, o elige Only my own list.
La lista de terminales está desactualizada: guarda la página de ajustes. Esto vuelve a cargar la lista de terminales. Con tu propia lista, actualiza tú las líneas.
El cliente no puede realizar el pedido: hay que elegir un terminal de paquetes. Si el cliente ve «The LP Express parcel terminal list is temporarily unavailable», ahora mismo no hay terminales disponibles. Añade tu propia lista.
Moneda de los precios: la de tu tienda. El plugin no convierte monedas.
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 acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes. Solo se borra la lista de terminales en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin y las cachés siempre se eliminan. Los ajustes, los métodos de zona y la copia guardada de la lista de terminales se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. El terminal guardado en los pedidos nunca se borra, y los pedidos existentes conservan sus líneas de envío.
LP Express es una marca comercial de su respectivo propietario. Este plugin no está afiliado ni avalado por LP Express.