# 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.

Función Pro

La instalación y gestión de extensiones requiere [WCPOS Pro](/es/getting-started/pro-license.md). La versión gratuita muestra el catálogo de extensiones, pero desactiva los controles de instalación y activación.

## Extensiones disponibles[​](#available-extensions "Enlace directo a Extensiones disponibles")

### Pasarelas de pago[​](#payment-gateways "Enlace directo a Pasarelas de pago")

Pasarelas de pago personalizadas diseñadas para el uso presencial en el POS.

[ES: Stripe TerminalES: Pagos con tarjeta presenciales mediante hardware Stripe Terminal (S700, WisePOS E). Compatible con modo MOTO y simulador.](/es/payment/gateways/stripe-terminal.md)

[ES: SumUp TerminalES: Aceptar pagos con tarjeta a través de lectores de tarjetas SumUp.](/es/payment/gateways/sumup-terminal.md)

[ES: Vipps MobilePayES: Pagos desde el teléfono mediante código QR o notificación push. Vipps (Noruega), MobilePay (Dinamarca, Finlandia).](/es/payment/gateways/vipps-mobilepay.md)

[ES: Factura por correo electrónicoES: Enviar al cliente un enlace de pago por correo electrónico para completar el pedido en línea.](/es/payment/gateways/email-invoice.md)

¿Desea crear la suya propia? Comience con la [Plantilla de pasarela](/es/reference/gateway-template.md) o consulte la [descripción general de Pasarelas personalizadas](/es/payment/gateways/.md) para ver la lista completa.

### Multilingüe[​](#multilingual "Enlace directo a 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.

[ES: WCPOS PolylangES: Integración con Polylang: sincronización de productos según el idioma y selección de idioma por tienda para WCPOS Pro.](/es/extensions/polylang.md)

[ES: WCPOS WPMLES: Integración con WPML — filtra los productos del POS a un solo idioma.](/es/extensions/wpml.md)

[ES: WCPOS WP MultilangES: Integración con WP Multilang — filtra los productos del POS a un solo idioma.](/es/extensions/wp-multilang.md)

### Cupones y crédito de tienda[​](#coupons-and-store-credit "Enlace directo a Cupones y crédito de tienda")

[ES: WCPOS StoreApps Smart CouponsES: Canjea el crédito de tienda de StoreApps Smart Coupons en WCPOS, con etiquetas de saldo en el recibo e historial de auditoría en las notas del pedido.](/es/extensions/storeapps-smart-coupons.md)

### Inventario[​](#inventory "Enlace directo a Inventario")

[ES: Integración WCPOS con ATUMES: Vincula las tiendas de WCPOS Pro con las ubicaciones de ATUM Multi-Inventory para gestionar stock, precios y SKU por ubicación.](/es/extensions/atum.md)

## Explorar extensiones[​](#browsing-extensions "Enlace directo a 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[​](#filtering-and-search "Enlace directo a 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[​](#installing-an-extension "Enlace directo a Instalación de una extensión")

1. Abrir `POS Settings > Extensiones`.
2. Buscar la extensión deseada y hacer clic en **Instalar**.
3. La extensión se descarga e instala mediante el instalador de plugins de WordPress.
4. 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[​](#activating-and-deactivating "Enlace directo a 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[​](#updating-extensions "Enlace directo a 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[​](#auto-updates "Enlace directo a 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[​](#troubleshooting "Enlace directo a Solución de problemas")

### Mensaje "Requiere Pro" en los botones[​](#requires-pro-message-on-buttons "Enlace directo a 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](/es/getting-started/pro-license.md) para gestionar extensiones.

### La extensión no se instala[​](#extension-fails-to-install "Enlace directo a 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[​](#extension-not-appearing-after-install "Enlace directo a 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[​](#catalog-not-loading "Enlace directo a 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[​](#for-developers "Enlace directo a Para desarrolladores")

### Crear una extensión para POS[​](#creating-a-pos-extension "Enlace directo a 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:

1. **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.
2. **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.
3. **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[​](#submitting-to-the-directory "Enlace directo a Envío al directorio")

El catálogo de extensiones se mantiene en el repositorio de GitHub [`wcpos/extensions`](https://github.com/wcpos/extensions). Para incluir una extensión:

1. Revisar el formato del catálogo y los requisitos de metadatos en el README del repositorio.
2. Abrir un pull request para añadir los metadatos de la extensión a `catalog.json`.
3. Una vez fusionado, la extensión aparecerá en el directorio para todos los usuarios de WCPOS Pro.

### Convenciones de GitHub Release[​](#github-release-conventions "Enlace directo a 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`](https://github.com/wcpos/extensions).
