VibeFox LP Express for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posterior (probado en 4.1.0.3), con el tema predeterminado y la finalización de compra estándar de OpenCart.
PHP: 8.0 o posterior.
LP Express: no se necesita una cuenta de API. LP Express no tiene una API pública de precios y la extensión no usa la API de Unisend, así que tú introduces tus propios precios (de contrato). Crea los paquetes en tu cuenta de Unisend («Mano siuntos»).
Lista de terminales de paquetes: la extensión usa la lista abierta de terminales de LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). No se necesita ninguna clave. Si esta lista en línea no está disponible, la extensión usa la última copia descargada si existe, y si no, tu propia lista. Prepárate para introducir tu propia lista (consulta Configuración).
Lituania: el país debe estar activado en System > Localisation > Countries.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
El archivo de descarga es un único zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_lp_express-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_lp_express.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.
OpenCart 3
1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_lp_express-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del Installer, puedes copiar el contenido de la carpeta upload del paquete en la carpeta raíz de tu tienda.
2. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox LP Express y haz clic en Install (el botón verde +).
3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes.
4. Introduce tu clave de licencia de VibeFox en el campo License key del bloque de licencia de la parte superior de la página Edit y haz clic en Activate (consulta Clave de licencia).
5. Rellena la tabla de precios (al menos una fila; la primera fila nueva es Lituania) o un coste de reserva. 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. Activa Enable/Disable y haz clic en Save.
OpenCart 4
1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_lp_express.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.
2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.
3. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox LP Express, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).
4. Introduce la clave de licencia y los ajustes como en los pasos 4 y 5 de OpenCart 3. La página de ajustes y sus campos son iguales en ambas versiones.
Al instalarse, la extensión crea dos tablas pequeñas (los terminales elegidos y la lista de terminales en caché) y registra sus eventos de OpenCart para la finalización de compra y la página de pedido. El método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión tras desinstalarla, se usan de nuevo los ajustes que conservaste.
Configuración
Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox LP Express > Edit. Las secciones aparecen a la izquierda. Un botón Save al final guarda toda la página sin recargarla. Cada guardado también recarga la lista de terminales. Solo los usuarios administradores con el permiso de modificación para esta extensión pueden guardar los ajustes.
En la parte superior de la página, los avisos muestran problemas y el estado de los terminales. Aparece una advertencia cuando no hay ningún precio o ningún terminal de paquetes disponible, porque entonces el método no se muestra en la finalización de compra, y cuando la tienda no tiene una clase de peso con la unidad kg, porque entonces los pesos de los productos se leen según el nombre de su unidad (kg, g, lb, oz) y cualquier otra unidad como kg. 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.
Al guardar, un título de método vacío o que contenga alguno de los caracteres < > ; = # { } se rechaza con Enter a valid method title., y también se rechaza un título de más de 64 caracteres. Un orden de clasificación que no sea un número entero también se rechaza. En estos casos no se guarda nada. Un importe o un peso que no sea un número (o que sea negativo) se notifica, y se conserva su valor anterior. Un Minimum weight (kg) mayor que Maximum weight (kg) (30 kg cuando el máximo está vacío) también se notifica, porque el método nunca se mostraría, y ambos pesos conservan sus valores anteriores. Los precios de la tabla que no sean números se notifican y se dejan vacíos. Los demás valores se guardan.
General
Enable/Disable: muestra u oculta LP Express en la finalización de compra (el estado de esta extensión). Predeterminado: off.
Method title: el nombre del método de envío que ven los clientes en el carrito y en la finalización de compra. Predeterminado: LP Express parcel terminal. Obligatorio, como máximo 64 caracteres.
Tax class: --- None --- (predeterminado) significa que los precios siguientes son finales. Con una clase de impuesto, OpenCart añade el impuesto de envío sobre los precios siguientes.
Sort order: la posición de LP Express entre los métodos de envío en la finalización de compra. Un número entero.
Precios (en la moneda predeterminada de tu tienda, indicada en el título de la sección; los decimales pueden escribirse como 2.99 o 2,99)
Price table: una fila por país de destino. Haz clic en Add country para añadir una fila y en el botón de eliminar para borrar una. Elige * Any other country para cualquier país que no tenga fila propia. Cada fila tiene un Base price y columnas de peso: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg y XL por encima de 5 kg. El peso es el del carrito, o el peso de un artículo con Per item. Una columna vacía usa el precio base de la fila. 0 significa gratis. Una fila sin ningún precio no se guarda.
Fallback cost: se usa cuando la tabla de precios no tiene fila (o precio) 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 (productos que requieren envío, después de descuentos, sin impuestos) a partir del cual LP Express es gratis. Se aplica antes que la tabla de precios, así que también cubre los países sin fila propia. Déjalo vacío si no hay envío gratuito.
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. Predeterminado: 30. 0 significa sin límite. Vacío significa 30 kg, o sin límite cuando Ignore shipping zones está activado.
Minimum cart total: muestra el método solo a partir de este total del carrito (productos que requieren envío, después de descuentos, sin impuestos). Déjalo vacío para mostrarlo siempre.
Geo zone: el método se ofrece solo para direcciones dentro de esta zona geográfica. All Zones (predeterminado) significa en todas partes. Las zonas geográficas se gestionan en System > Localisation > Geo Zones. La zona geográfica no se comprueba cuando Ignore shipping zones está activado.
Ignore shipping zones: ofrece LP Express para los países indicados abajo, sea cual sea la zona geográfica. En este modo no se comprueba la zona geográfica. Cuando está desactivado, los países se definen por la zona geográfica. Se recomienda. Predeterminado: off.
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 en todos los países.
Terminales de paquetes
Terminal list: de dónde proceden los terminales.
Own terminal list: un terminal por línea con 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.
Avanzado
Debug log: escribe los detalles del cálculo de precios y de la lista de terminales en storage/logs/vfd_lpex_debug.log.php (en OpenCart 4, system/storage/logs/vfd_lpex_debug.log.php). El archivo no se puede leer desde la web. Los errores, como una lista de terminales no disponible o un pedido sin terminal, siempre se registran. No se registra ningún dato del cliente. Cuando el archivo llega a 5 MB, se inicia un registro nuevo.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar la extensión se borran los ajustes, la lista de terminales guardada, el registro y los terminales de las finalizaciones de compra sin terminar. Cuando está desactivado (predeterminado), los ajustes se conservan para una reinstalación. El terminal guardado en los pedidos siempre se conserva.
Importar / Exportar
Export: haz clic en Download JSON para guardar los ajustes como archivo JSON.
Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores se comprueban igual que en un guardado normal.
Cómo funciona en la finalización de compra
Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio de LP Express. Si se ha definido una Geo zone y la dirección está fuera de ella, LP Express no se ofrece. Con Ignore shipping zones, la zona geográfica no se comprueba: LP Express se ofrece solo para los países indicados (todos los países cuando la lista está vacía). Solo cuentan los productos con Requires Shipping establecido en Yes: los demás productos no añaden peso y no se incluyen en el total del carrito. El total del carrito es el precio de estos productos después del descuento del cupón y antes de los impuestos. Los certificados de regalo, los puntos de recompensa y el crédito de la tienda no se tienen en cuenta.
La extensión comprueba el peso del carrito y el total mínimo del carrito. Si se aplica el envío gratuito, el precio es 0. En caso contrario, el precio sale de la fila del país (o de la fila *): la columna de peso, si no, el precio base, si no, el coste de reserva. Si no hay precio, o 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.
Los precios y los importes están en la moneda predeterminada de tu tienda. El precio se redondea a sus decimales y se muestra al cliente en su moneda, con el impuesto de la Tax class seleccionada.
La lista de terminales en línea 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. Los terminales sin ciudad aparecen en Other.
En OpenCart 4 el cliente hace clic en Choose en el bloque del método de envío de la página de finalización de compra y elige LP Express en la ventana Shipping method options. Los precios son los mismos que en OpenCart 3.
La extensión no solicita precios de LP Express ni de Unisend, no crea envíos, no imprime etiquetas, no llama a un mensajero ni rastrea paquetes. Crea los paquetes en tu cuenta de Unisend («Mano siuntos»). La entrega a domicilio mediante mensajería no forma parte de este método.
Puntos de recogida
Cuando el cliente elige LP Express en el paso del método de entrega, debajo aparece el bloque LP Express parcel terminal con dos listas: -- Select city -- y -- Select parcel terminal --. La lista de terminales solo se carga cuando se selecciona LP Express. La ciudad de la dirección de entrega aparece preseleccionada 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 guarda para la finalización de compra de inmediato, así que no se pierde cuando la finalización de compra se actualiza.
El terminal es obligatorio. Cuando el cliente hace clic en Continue, el servidor vuelve a comprobar el terminal con la lista. Sin terminal, la finalización de compra muestra Please select an LP Express parcel terminal. Un ID de terminal falsificado o desactualizado se rechaza con The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. Si no se puede cargar ningún terminal, el cliente ve The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.
En OpenCart 4 el bloque LP Express parcel terminal con las dos listas aparece en la ventana Shipping method options, debajo de la opción LP Express, cuando el cliente la selecciona. El botón Continue de la ventana no avanza sin un terminal válido, con los mismos mensajes.
El ID del terminal, el nombre y la ciudad se guardan con el pedido. El panel LP Express parcel terminal de la página de pedido del administrador (Sales > Orders, información del pedido) muestra la ciudad, el terminal y su Terminal ID. El método de envío del pedido muestra el título del método, dos puntos, la ciudad y el terminal (por ejemplo LP Express parcel terminal: Kaunas, …), de modo que aparece en los detalles del pedido del cliente, en los correos electrónicos de pedido y en la factura. Si un pedido no tiene terminal, la página de pedido del administrador muestra No parcel terminal was chosen for this order. El panel también se muestra para los pedidos realizados mientras la extensión está desactivada. En OpenCart 4 se muestra encima de History. OpenCart 4 mantiene un solo pedido para la finalización de compra y lo actualiza cada vez que el cliente vuelve a confirmar, y el terminal del pedido se actualiza con él. Si el cliente cambia ese pedido a otro método de envío, su terminal se elimina.
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque License — VibeFox LP Express es el primer bloque de Extensions > Extensions > Shipping > VibeFox LP Express > Edit, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo están la línea Product: opencart-shipping-lp-express y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del administrador (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar un hueco de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, la extensión sigue funcionando con el último estado conocido.
Una clave funciona en un dominio: la dirección de la tienda de la configuración de OpenCart. Eliminar la clave de la tienda no libera su hueco de dominio. Libéralo en tu cuenta de vibefox.net.
Sin una clave activa, el método de envío LP Express no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un administrador que haya iniciado sesión en el panel de administración en el mismo navegador sigue viendo el método en la tienda, marcado como (unlicensed — visible to admins only), así que puedes configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que sin una clave activa el método está oculto para todos. Después de abrir una vez la página Edit, aparece un recordatorio en el Dashboard del administrador. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard del administrador o la página Edit: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez por semana. No hace falta ningún cron job. Al desinstalar la extensión siempre se eliminan la clave de licencia y el estado de la licencia.
Solución de problemas
LP Express no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable esté activado. Revisa la Geo zone (o que Ignore shipping zones esté activado y el país esté permitido). Abre la página de la extensión: una advertencia explica si no hay precio o no hay terminal de paquetes disponible. Revisa también los límites de peso y el Minimum cart total, y que los productos tengan Requires Shipping establecido en Yes. Con Debug log activado, el campo Log de la página de la extensión muestra por qué se ocultó el método.
No hay terminales de paquetes: no se pudo cargar la lista en línea y no hay copia guardada ni lista propia. La extensión lo reintenta cada 15 minutos. Introduce tu propia lista en Own terminal list, o elige Only my own list.
La lista de terminales está desactualizada: haz clic en Save en la página de la extensión. Esto recarga la lista de terminales. Si usas tu propia lista, actualiza las líneas tú mismo.
El cliente no puede continuar: hay que elegir un terminal de paquetes. Si el cliente ve el mensaje de que la lista de terminales no está disponible temporalmente, no hay terminales disponibles en ese momento. Añade tu propia lista.
El selector de terminales no aparece: el selector se añade al paso del método de entrega de la finalización de compra estándar de OpenCart (en OpenCart 4, a la ventana Shipping method options) y se probó con el tema predeterminado. Un tema muy modificado o una extensión de finalización de compra de terceros puede no mostrarlo.
En qué moneda están los precios: en la moneda predeterminada de tu tienda. Los clientes que paguen en otra moneda verán el precio convertido con el tipo de cambio de OpenCart.
La página dice "Warning: You do not have permission to modify VibeFox LP Express!": tu grupo de usuarios administradores solo puede ver los ajustes. Da al grupo el permiso de modificación para extension/shipping/vfd_lp_express (OpenCart 3) o extension/vfd_lp_express/shipping/vfd_lp_express (OpenCart 4) en System > Users > User Groups.
Para desarrolladores: la dirección de la lista de terminales puede sustituirse con el ajuste vfd_lpex_feed_url (para pruebas); no tiene campo en la página de ajustes.
Desinstalación
Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox LP Express. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre restablece Enable/Disable, Sort order, Tax class y Geo zone. Los eventos de la extensión siempre se eliminan, y la lista de terminales en caché se borra. Si Remove data on uninstall está activado, los ajustes, el registro, la copia guardada de la lista de terminales y los terminales de las finalizaciones de compra sin terminar también se eliminan. Si está desactivado, los demás ajustes y la copia guardada se conservan y se usan de nuevo al volver a instalar la extensión. El terminal guardado en los pedidos nunca se borra, y los pedidos existentes conservan el terminal en su método de envío.
En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox LP Express en la lista de extensiones instaladas, y luego en Delete (el botón rojo de papelera) para eliminar el paquete subido.
LP Express es una marca comercial de su respectivo titular. Esta extensión no está afiliada a LP Express ni cuenta con su respaldo.