Extensiones
WCPOS admite extensiones que añaden nuevas funcionalidades al punto de venta. El directorio de extensiones permite explorar las extensiones disponibles, instalarlas directamente desde la configuración del POS y gestionar las actualizaciones.
La instalación y gestión de extensiones requiere WCPOS Pro. La versión gratuita muestra el catálogo de extensiones, pero desactiva los controles de instalación y activación.
Extensiones disponibles
Pasarelas de pago
Pasarelas de pago personalizadas diseñadas para el uso presencial en el POS.
¿Desea crear la suya propia? Comience con la Plantilla de pasarela o consulte la descripción general de Pasarelas personalizadas para ver la lista completa.
Multilingüe
Filtrar los productos del POS por idioma para que los duplicados traducidos no aparezcan en la búsqueda del cajero ni en la cuadrícula del catálogo.
Cupones y crédito de tienda
Inventario
Explorar extensiones
Es posible abrir el directorio de extensiones desde POS Settings > Extensiones (también etiquetado como Plugins en algunas versiones).
El directorio muestra una cuadrícula de tarjetas con las extensiones disponibles. Cada tarjeta muestra:
- Icono (o un icono de pieza de rompecabezas como alternativa si la extensión no proporciona uno)
- Nombre y versión
- Descripción
- Insignia de categoría
- Estado — activa, inactiva, actualización disponible o no instalada
Filtrado y búsqueda
Es posible utilizar los botones de categoría en la parte superior para filtrar extensiones por categoría. También se puede usar el campo de búsqueda para encontrar extensiones por nombre, descripción o etiquetas.
Instalación de una extensión
- Abrir
POS Settings > Extensiones. - Buscar la extensión deseada y hacer clic en Instalar.
- La extensión se descarga e instala mediante el instalador de plugins de WordPress.
- Una vez instalada, hacer clic en Activar para habilitarla.
Internamente, WCPOS utiliza el Plugin_Upgrader nativo de WordPress para gestionar la instalación, por lo que las extensiones siguen el mismo proceso que cualquier plugin de WordPress.
Activación y desactivación
Cada extensión instalada tiene los botones Activar y Desactivar en su tarjeta.
- Activar habilita la extensión para que pueda ejecutarse en el POS.
- Desactivar la deshabilita sin desinstalarla. Los archivos de la extensión permanecen en el servidor y se puede reactivar en cualquier momento.
Actualización de extensiones
Cuando hay una versión más reciente de una extensión instalada disponible, la tarjeta muestra una insignia de Actualización disponible y un botón Actualizar.
Actualizaciones automáticas
Las extensiones instaladas desde el directorio tienen las actualizaciones automáticas habilitadas de forma predeterminada. Es posible activar o desactivar las actualizaciones automáticas por extensión desde su tarjeta en el directorio. Cuando la actualización automática está activada, WordPress aplicará las nuevas versiones automáticamente, del mismo modo que lo hace con los plugins que tienen la actualización automática habilitada.
Solución de problemas
Mensaje "Requiere Pro" en los botones
Los botones de instalar, activar y actualizar están deshabilitados en la versión gratuita de WCPOS. Es necesario actualizar a WCPOS Pro para gestionar extensiones.
La extensión no se instala
- Verifique que el servidor de WordPress tenga permisos de escritura en el directorio
wp-content/plugins. - Verifique que el servidor pueda realizar solicitudes HTTPS salientes (algunos proveedores de hosting bloquean las descargas externas).
- Consulte los detalles del error en
WP Admin > POS > Soporte > Registros.
La extensión no aparece después de la instalación
- Actualice el POS — la lista de extensiones se almacena en caché durante un máximo de 12 horas.
- Confirme que la extensión esté activada (las extensiones instaladas pero inactivas no se ejecutarán).
El catálogo no se carga
El catálogo de extensiones se obtiene de una fuente remota y se almacena en caché local durante 12 horas. Si el catálogo no se carga:
- Verifique la conectividad a internet del servidor.
- Intente nuevamente después de que expire la caché, o borre la caché de transitorios del servidor.
Para desarrolladores
Crear una extensión para POS
Una extensión de WCPOS es un plugin estándar de WordPress que se integra con el POS a través de los hooks y las API de WCPOS. Para crear una:
- Comenzar con un plugin de WordPress. La extensión necesita un encabezado de plugin estándar y un archivo de entrada, igual que cualquier plugin de WooCommerce o WordPress.
- Integrar con WCPOS. Es posible utilizar los hooks y filtros proporcionados por WCPOS para añadir funcionalidad a la interfaz del POS o al backend.
- Alojar las versiones en GitHub. El directorio de extensiones utiliza GitHub Releases para realizar el seguimiento de versiones y entregar actualizaciones.
Envío al directorio
El catálogo de extensiones se mantiene en el repositorio de GitHub wcpos/extensions. Para incluir una extensión:
- Revisar el formato del catálogo y los requisitos de metadatos en el README del repositorio.
- Abrir un pull request para añadir los metadatos de la extensión a
catalog.json. - Una vez fusionado, la extensión aparecerá en el directorio para todos los usuarios de WCPOS Pro.
Convenciones de GitHub Release
El ciclo de vida de las actualizaciones se basa en GitHub Releases:
- Etiquetar las versiones utilizando versionado semántico (por ejemplo,
v1.0.0,v1.2.3). - Adjuntar el archivo zip del plugin como un recurso de la versión — este es el archivo que se descarga cuando un usuario instala o actualiza.
- Publicar la versión (no como borrador) para que el directorio pueda detectarla.
Al publicar una nueva versión, los usuarios que tengan la extensión instalada verán la actualización disponible en su directorio de extensiones. Si la actualización automática está habilitada, se aplicará automáticamente.
Para obtener información completa sobre el esquema del catálogo y el proceso de envío, consultar el repositorio wcpos/extensions.