# Conflictos de Plugin
Los conflictos de plugin son una de las causas más comunes de problemas con WCPOS. Cuando otros plugins de WordPress interfieren con la funcionalidad de WooCommerce o WCPOS, puedes experimentar bloqueos, problemas de rendimiento o comportamientos inesperados.
## Signos de Conflictos de Plugin[](#signs-of-plugin-conflicts "Enlace directo a Signos de Conflictos de Plugin")
Puedes tener un conflicto de plugin si experimentas:
* **Errores fatales** - "Ha habido un error crítico en este sitio web"
* **Problemas de rendimiento** - Carga lenta, tiempos de espera o alta carga del servidor
* **Problemas de funcionalidad** - Funciones que no funcionan como se esperaba
* **Problemas de sincronización de datos** - Productos, pedidos o clientes que no se sincronizan correctamente
* **Problemas con las pasarelas de pago** - Fallos en el proceso de pago o errores en el procesamiento de pagos
## Antes de Comenzar: Utiliza un Sitio de Staging[](#before-you-start-use-a-staging-site "Enlace directo a Antes de Comenzar: Utiliza un Sitio de Staging")
Importante
**Nunca resuelvas conflictos de plugins en tu sitio en vivo.** Siempre utiliza un entorno de staging para evitar interrumpir tus operaciones comerciales.
### ¿Qué es un Sitio de Staging?[](#what-is-a-staging-site "Enlace directo a ¿Qué es un Sitio de Staging?")
Un sitio de staging es una copia exacta de tu sitio web en vivo donde puedes probar cambios de forma segura sin afectar a tus clientes. La mayoría de los proveedores de hosting modernos ofrecen entornos de staging como una característica estándar.
### Si tu Proveedor No Ofrece Staging[](#if-your-host-doesnt-offer-staging "Enlace directo a Si tu Proveedor No Ofrece Staging")
Si tu proveedor de hosting no ofrece sitios de staging, **considera cambiar a un proveedor que sí lo haga**. Esta es una característica estándar hoy en día y es esencial para:
* Pruebas seguras de plugins/temas
* Actualizaciones de WordPress
* Resolución de problemas
* Trabajo de desarrollo
**Proveedores recomendados con staging:**
* WP Engine
* SiteGround
* Kinsta
* Cloudways
* Muchos otros
## Paso 1: Verifica Errores Fatales[](#step-1-check-for-fatal-errors "Enlace directo a Paso 1: Verifica Errores Fatales")
Si estás experimentando bloqueos o errores críticos, comienza por verificar los registros de errores:
1. **Verifica los Registros de WCPOS** - Abre la pantalla de [Registros](/es/support/logs.md) en WCPOS para ver cualquier mensaje de error
2. **Verifica los Registros de Errores Fatales** - Sigue la [guía de resolución de problemas de errores críticos](/es/support/troubleshooting/critical-error.md) para encontrar mensajes de error detallados
3. **Anota los detalles del error** - Busca nombres de plugins o rutas de archivos mencionadas en el error
Si encuentras un error fatal que menciona un plugin específico, ese es probablemente el culpable. Puedes desactivar ese plugin y probar si el problema se resuelve.
## Paso 2: El Método de Eliminación de Plugins[](#step-2-the-plugin-elimination-method "Enlace directo a Paso 2: El Método de Eliminación de Plugins")
Si no hay errores fatales en los registros, o si deseas identificar conflictos relacionados con el rendimiento, utiliza este enfoque sistemático:
### 2.1 Crea una Línea Base[](#21-create-a-baseline "Enlace directo a 2.1 Crea una Línea Base")
1. **Accede a tu sitio de staging**
2. **Prueba la funcionalidad problemática** - Anota exactamente qué no está funcionando o es lento
3. **Registra métricas de rendimiento** - Si es un problema de rendimiento, anota los tiempos de ejecución de los [Registros](/es/support/logs.md)
### 2.2 Desactiva Todos los Plugins (Excepto los Esenciales)[](#22-disable-all-plugins-except-essential-ones "Enlace directo a 2.2 Desactiva Todos los Plugins (Excepto los Esenciales)")
**Mantén activos estos plugins:**
* WooCommerce
* WCPOS
* WCPOS Pro (si lo tienes)
**Desactiva todo lo demás:**
1. Ve a `WP Admin > Plugins`
2. Selecciona todos los demás plugins
3. Elige "Desactivar" en el menú desplegable de acciones masivas
4. Haz clic en "Aplicar"
### 2.3 Prueba el Problema[](#23-test-the-issue "Enlace directo a 2.3 Prueba el Problema")
1. **Limpia cualquier caché** - Si usas plugins de caché, limpia todas las cachés
2. **Prueba la funcionalidad problemática** - ¿Funciona ahora?
3. **Verifica el rendimiento** - ¿Han mejorado los tiempos de ejecución?
**Si el problema se resuelve:** Tienes un conflicto de plugin. Procede al Paso 2.4.
**Si el problema persiste:** Es probable que el problema no sea un conflicto de plugin. Considera:
* Problemas con los recursos del servidor (ver [Rendimiento del Servidor](/es/support/performance/server.md))
* Conflictos de tema (ver Paso 3)
* Problemas con el núcleo de WordPress/WooCommerce
### 2.4 Habilita los Plugins Uno a Uno[](#24-enable-plugins-one-by-one "Enlace directo a 2.4 Habilita los Plugins Uno a Uno")
Ahora necesitas identificar qué plugin está causando el conflicto:
1. **Habilita un plugin** - Comienza con los más esenciales
2. **Prueba la funcionalidad** - Verifica si el problema regresa
3. **Si no hay problema** - Habilita el siguiente plugin y prueba nuevamente
4. **Si el problema regresa** - ¡Has encontrado el plugin en conflicto!
**Orden de Prioridad de Plugins (habilita en este orden):**
1. **Plugins de seguridad** - Wordfence, Sucuri, etc.
2. **Plugins de SEO** - Yoast, RankMath, etc.
3. **Plugins de rendimiento** - Caché, optimización
4. **Pasarelas de pago** - Stripe, PayPal, etc.
5. **Otras extensiones de WooCommerce**
6. **Plugins generales de WordPress**
### 2.5 Documenta Tus Hallazgos[](#25-document-your-findings "Enlace directo a 2.5 Documenta Tus Hallazgos")
Cuando identifiques el plugin en conflicto:
1. **Anota el nombre y la versión del plugin**
2. **Documenta el problema específico que causa**
3. **Verifica si hay una versión actualizada disponible**
4. **Busca plugins alternativos que ofrezcan funcionalidad similar**
## Paso 3: Verifica Conflictos de Tema[](#step-3-check-for-theme-conflicts "Enlace directo a Paso 3: Verifica Conflictos de Tema")
Si bien los temas rara vez afectan a WCPOS (ya que utiliza su propia interfaz), a veces pueden causar problemas con:
* Procesos de pago (si se utiliza una pasarela de pago web)
* Funcionalidad del área de administración
* Respuestas de la API
### Prueba con un Tema Predeterminado[](#test-with-a-default-theme "Enlace directo a Prueba con un Tema Predeterminado")
1. **En tu sitio de staging**, cambia a un tema predeterminado de WordPress:
* Twenty Twenty-Four
* Twenty Twenty-Three
* Twenty Twenty-Two
2. **Prueba la funcionalidad problemática**
3. **Si el problema se resuelve** - Tu tema tiene un conflicto
Impacto del Tema
Los temas tienen muchas menos probabilidades de causar problemas con WCPOS en comparación con los plugins. La interfaz de POS funciona independientemente de tu tema. Sin embargo, los temas pueden afectar:
* Páginas de pago de WooCommerce
* Funcionalidad administrativa de WordPress
* Respuestas de la API REST
## Paso 4: Resolviendo Conflictos de Plugin[](#step-4-resolving-plugin-conflicts "Enlace directo a Paso 4: Resolviendo Conflictos de Plugin")
Una vez que hayas identificado el plugin en conflicto, tienes varias opciones:
### Opción 1: Actualiza el Plugin[](#option-1-update-the-plugin "Enlace directo a Opción 1: Actualiza el Plugin")
1. **Verifica las actualizaciones** - El conflicto puede haber sido solucionado en una versión más reciente
2. **Actualiza el plugin** primero en tu sitio de staging
3. **Prueba a fondo** antes de actualizar en el sitio en vivo
### Opción 2: Encuentra un Alternativo[](#option-2-find-an-alternative "Enlace directo a Opción 2: Encuentra un Alternativo")
1. **Investiga plugins alternativos** que proporcionen la misma funcionalidad
2. **Prueba alternativas** en tu sitio de staging
3. **Migra configuraciones** si cambias de plugins
### Opción 3: Contacta al Desarrollador del Plugin[](#option-3-contact-plugin-developer "Enlace directo a Opción 3: Contacta al Desarrollador del Plugin")
1. **Informa sobre el conflicto** al desarrollador del plugin
2. **Proporciona información detallada:**
* Versiones de los plugins involucrados
* Versiones de WordPress y WooCommerce
* Mensajes de error exactos o comportamientos
* Pasos para reproducir el problema
### Opción 4: Solución Personalizada[](#option-4-custom-solution "Enlace directo a Opción 4: Solución Personalizada")
Para plugins esenciales que no se pueden reemplazar:
1. **Contacta a un desarrollador de WordPress** para crear una solución personalizada
2. **Considera ganchos específicos del plugin** para desactivar funcionalidad en conflicto
3. **Utiliza lógica condicional** para desactivar el plugin en páginas relacionadas con POS
## Tipos Comunes de Plugins en Conflicto[](#common-conflicting-plugin-types "Enlace directo a Tipos Comunes de Plugins en Conflicto")
### Categorías de Plugins de Alto Riesgo[](#high-risk-plugin-categories "Enlace directo a Categorías de Plugins de Alto Riesgo")
**Plugins de Seguridad:**
* Pueden bloquear solicitudes de API
* Pueden interferir con la autenticación
* A menudo tienen reglas de firewall agresivas
**Plugins de Caché:**
* Pueden almacenar en caché respuestas de API inapropiadamente
* Pueden interferir con datos en tiempo real
* Pueden causar problemas de datos obsoletos
**Plugins de SEO:**
* Plugins pesados pueden ralentizar el área administrativa
* Pueden agregar consultas innecesarias a la base de datos
* Pueden interferir con respuestas de la API REST
**Creadores de Páginas:**
* A menudo cargan scripts pesados en el área administrativa
* Pueden entrar en conflicto con las páginas administrativas de WooCommerce
* Pueden interferir con procesos de pago
**Plugins de Membresía/Restricción:**
* Pueden bloquear el acceso a la API
* Pueden interferir con la autenticación del usuario
* Pueden restringir el acceso a recursos necesarios
### Categorías de Plugins de Bajo Riesgo[](#lower-risk-plugin-categories "Enlace directo a Categorías de Plugins de Bajo Riesgo")
**Formularios de Contacto:** Por lo general, no interfieren con WCPOS
**Plugins de Redes Sociales:** Rara vez causan conflictos
**Plugins de Análisis:** Generalmente seguros a menos que sean muy pesados
**Plugins de Contenido Básico:** Por lo general, compatibles
## Conflictos de Plugin Conocidos[](#known-plugin-conflicts "Enlace directo a Conflictos de Plugin Conocidos")
Los plugins a continuación son conocidos por interferir con WCPOS. Muchos problemas ya se han corregido automáticamente en versiones recientes de WCPOS — **actualizar a la última versión** los resuelve sin necesidad de configuración.
La mayoría de las soluciones son "excluir el POS"
El hilo común: WCPOS depende de la API REST de WooCommerce y renderiza algunos flujos (inicio de sesión, pago, recibos) en iframes. La solución habitual es **excluir los endpoints/URLs del POS** (`/wp-json/wcpos/`, `/wp-json/wc/v3/` y la ruta `/pos/`) del otro plugin — no desactivarlo por completo.
### Plugins de seguridad e inicio de sesión[](#security-and-login-plugins "Enlace directo a Plugins de seguridad e inicio de sesión")
Estos son la fuente **más común** de conflictos, especialmente para el inicio de sesión de la aplicación de escritorio/móvil.
| Plugin | Síntoma | Solución |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wordfence** | El firewall bloquea la API REST; el campo de código 2FA no se renderiza en el iframe de inicio de sesión; una CSP restrictiva puede bloquear los recursos del POS | Incluye en la lista blanca `/wp-json/wcpos/` y `/wp-json/wc/v3/` en el firewall. Para 2FA: desactívalo temporalmente para los usuarios del POS. La CSP se elimina automáticamente en v1.9.0+ |
| **Really Simple Security** | Bloquea el acceso a la API / fuerza redirecciones | Desactiva cualquier restricción de la API REST en los ajustes **Advanced** del plugin |
| **WPS Hide Login** | La URL de inicio de sesión personalizada rompe el iframe de inicio de sesión de la aplicación | Usa la URL de inicio de sesión estándar `/wp-admin/` para el acceso al POS |
| **iThemes / Solid Security** | Bloquea la API REST o desencadena bloqueos por fuerza bruta debido a las llamadas del POS | Incluye en la lista blanca solo los endpoints del POS y la propia IP del servidor — evita reglas de IP generales |
| **Sucuri** | El WAF bloquea las solicitudes de API | Incluye en la lista blanca los endpoints de la API REST en el panel de Sucuri |
| **Security Optimizer** | Bloquea el inicio de sesión del POS de administración (*"use customize login URL"*) | Inicia sesión en WP Admin a través de la URL personalizada primero, luego ve a `/pos` |
| **Force Login** (y plugins de autenticación REST similares) | `/wp-json/` devuelve 401/403; las aplicaciones más antiguas reportaban *"Site does not seem to be a WordPress site"* | Permite el acceso no autenticado a los endpoints del POS, o desactívalo durante la conexión inicial. Las aplicaciones v1.x ahora muestran el mensaje de error real |
| **LoginPress** | Fuerza el inicio de sesión basado en correo electrónico; rompe el inicio de sesión multiusuario del POS | Permite el inicio de sesión con nombre de usuario, o desactívalo para el acceso al POS |
| **Plugins de autenticación JWT** | 403 en todas las solicitudes de la API del POS tras la activación (el inicio de sesión puede tener éxito, todo lo demás falla) | Corregido automáticamente en v1.8.x+. En versiones más antiguas, desactiva el plugin JWT o excluye los endpoints del POS |
| **Captcha / reCAPTCHA** | Bucle de inicio de sesión en la aplicación de escritorio (el captcha no puede renderizarse en el iframe) | Desactiva el captcha para la URL de inicio de sesión del POS |
| **Defender Pro** | El encabezado `X-Frame-Options` bloquea todos los iframes del POS (inicio de sesión, pago, recibos) | Agrega una excepción específica del POS para `/pos/` en lugar de desactivar `X-Frame-Options` en todo el sitio |
| **Jetpack CRM Client Portal** | Rompe el inicio de sesión del POS por completo | Desactiva solo la extensión Client Portal |
### Plugins de rendimiento, caché y optimización[](#performance-caching-optimisation-plugins "Enlace directo a Plugins de rendimiento, caché y optimización")
| Plugin | Síntoma | Solución |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **WP Rocket, Autoptimize, Hummingbird, Smush** | Diferir/minificar JS rompe el proceso de pago y Stripe Terminal | Excluye las URL de `/pos/` de la optimización de JS |
| **LiteSpeed Cache** | Bucle de recarga constante en el pago en la aplicación de escritorio; CSP restrictiva | Actualiza WCPOS, purga la caché, excluye las páginas del POS del almacenamiento en caché. La CSP se elimina automáticamente en v1.9.0+ |
| **Image Prioritizer** | Satura el encabezado HTTP `Link`, rompiendo el descubrimiento de la API REST; la aplicación de escritorio muestra *"does not appear to be a WordPress site"* | Desactiva el plugin |
### Creadores de páginas e inyectores de front-end[](#page-builders-front-end-injectors "Enlace directo a Creadores de páginas e inyectores de front-end")
| Plugin | Síntoma | Solución |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Elementor** | `elementor-frontend.js` rompe el acordeón de pago dentro del iframe del POS — los métodos de pago no se expanden | Excluye las páginas del POS de la carga de scripts de Elementor |
| **Omnisend / plugins de marketing** | Inyectan scripts en el iframe de pago, rompiendo el diseño y los pagos | Usa los **Checkout Settings** del POS para desactivar los scripts no esenciales |
| **MyStickyElements / Complianz** | Inyectan superposiciones (botones fijos, banners de cookies) en el iframe de pago | Configúralos para excluir las URL de `/pos/` |
### Extensiones de WooCommerce y otros plugins[](#woocommerce-extensions-other-plugins "Enlace directo a Extensiones de WooCommerce y otros plugins")
| Plugin | Síntoma | Solución |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **WooCommerce Subscriptions** | Conflicto del script de migración durante la actualización de v1.7→v1.8 | Desactiva Subscriptions, activa POS Pro (deja que se ejecute la migración), luego vuelve a habilitarlo |
| **WP Activity Log** | Registra cada acción del POS → saturación de postmeta → *"only 10 products"* | Desactívalo, o excluye los tipos de entrada del POS del registro |
| **Jetpack / Astra / Xero** (cualquier cosa que enganche `save_post`) | Filas de meta duplicadas en cada llamada a la API del POS (una tienda llegó a 36 867 filas en un producto) | Corregido automáticamente en v1.8.12+ (gratuito) / v1.8.14+ (Pro) con una migración de limpieza — solo actualiza |
| **Stripe Tax** | Incompatible con pedidos creados por la API REST (cómo el POS crea pedidos) | Sin solución alternativa — incompatible |
| **Mollie** | Puede ocultar el método BACS (transferencia bancaria) del pago del POS | Actualiza Mollie a la última versión |
| **CTX Feed** | Errores 403 intermitentes en la página de ajustes del POS | Desactívalo para confirmar; no hay solución alternativa conocida |
| **Plugins de escáner de código de barras de terceros** | Corrompen el JSON de la API de pedidos, rompiendo la creación/visualización de pedidos | Desactívalos; usa el escaneo de código de barras integrado del POS |
| **MailerLite** (Signup Forms + WooCommerce) | Error 500 en la creación de pedidos del POS (agotamiento de memoria) | Desactívalo para confirmar, luego contacta a MailerLite |
| **The Courier Guy Shipping** | La creación de pedidos del POS falla con un error del servidor | Revierte a una versión anterior, o contacta al desarrollador |
| **PixelYourSite / PixelMySite** | Error fatal: *call to member function `is_type()` on bool* | Desactívalo temporalmente |
| **Google Listings & Ads** | Conflicto del autoloader → error crítico *"Class WCPOS\…\Stores not found"* | Elimina todos los plugins del POS y reinstala solo la última versión Pro independiente |
Stripe Terminal: no lo habilites globalmente
La pasarela **Stripe Terminal** debe habilitarse **solo** dentro de los Ajustes del POS, nunca en `WooCommerce > Settings > Payments`. Habilitarla globalmente hace que aparezca en el pago de tu tienda pública y bloquea el flujo de pago en línea.
### Conflictos a nivel de servidor[](#server-level-conflicts "Enlace directo a Conflictos a nivel de servidor")
| Fuente | Síntoma | Solución |
| -------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Encabezados CSP personalizados** (`.htaccess`, Nginx o un plugin de seguridad) | El POS se queda atascado en el logo; JS/CSS bloqueados | Se eliminan automáticamente en las páginas del POS en v1.9.0+. Para CSP a nivel de servidor, permite `cdn.jsdelivr.net` en `script-src`/`style-src`, o agrega una excepción para `/pos/` |
| **GoDaddy Website Firewall** | Bloquea `/wp-json/` (*"Received 'undefined'"*) | Permite la ruta de URL `/wp-json/` en el firewall — consulta [Rendimiento del Servidor](/es/support/performance/server.md#hosting-specific-notes) |
## Consejos de Prevención[](#prevention-tips "Enlace directo a Consejos de Prevención")
### Mantenimiento Regular[](#regular-maintenance "Enlace directo a Mantenimiento Regular")
1. **Mantén los plugins actualizados** - Siempre usa las versiones más recientes
2. **Elimina plugins no utilizados** - No solo desactives, elimínalos
3. **Prueba actualizaciones en el staging** antes de aplicarlas al sitio en vivo
4. **Monitorea el rendimiento** regularmente utilizando métricas de [Rendimiento del Servidor](/es/support/performance/server.md)
### Mejores Prácticas en la Selección de Plugins[](#plugin-selection-best-practices "Enlace directo a Mejores Prácticas en la Selección de Plugins")
1. **Elige desarrolladores de buena reputación** - Verifica reseñas y frecuencia de actualizaciones
2. **Evita funcionalidad redundante** - No instales múltiples plugins que hagan lo mismo
3. **Lee información de compatibilidad** - Verifica si los plugins han sido probados con WooCommerce
4. **Comienza con plugins mínimos** - Agrega funcionalidad gradualmente según sea necesario
## Obtener Ayuda[](#getting-help "Enlace directo a Obtener Ayuda")
Si no puedes resolver el conflicto de plugins:
### Para Usuarios Pro[](#for-pro-users "Enlace directo a Para Usuarios Pro")
Soporte Pro
Los usuarios Pro reciben soporte prioritario para la resolución de conflictos de plugins. Nuestro equipo puede ayudar a identificar y resolver conflictos por ti.
### Soporte de la Comunidad[](#community-support "Enlace directo a Soporte de la Comunidad")
[Discord Community](https://wcpos.com/discord)
### Cuando Contactes Soporte[](#when-contacting-support "Enlace directo a Cuando Contactes Soporte")
Por favor proporciona:
1. **Lista de plugins activos** con versiones
2. **Versiones de WordPress y WooCommerce**
3. **Descripción detallada** del problema
4. **Pasos que ya has intentado**
5. **Mensajes de error** de los registros
6. **Métricas de rendimiento del servidor** si son relevantes
## Documentación Relacionada[](#related-documentation "Enlace directo a Documentación Relacionada")
[Error CríticoCómo encontrar registros de errores fatales](/es/support/troubleshooting/critical-error.md)
[RegistrosComprendiendo los registros y métricas de WCPOS](/es/support/logs.md)
[Rendimiento del ServidorDiagnosticando problemas de rendimiento](/es/support/performance/server.md)
[Rendimiento del Proceso de PagoOptimizando la velocidad de pago](/es/support/performance/checkout.md)