Saltar al contenido principal
Versión: 1.x

Conflictos de Plugins

Los conflictos de plugins 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 Plugins​

Puedes tener un conflicto de plugins si experimentas:

  • Errores fatales - "Ha ocurrido 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 la pasarela de pago - Fallos en el proceso de pago o errores en el procesamiento de pagos

Antes de Comenzar: Usa un Sitio de Staging​

Importante

Nunca diagnostiques conflictos de plugins en tu sitio en vivo. Siempre utiliza un entorno de staging para evitar interrumpir las operaciones de tu negocio.

¿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​

Si tu proveedor de hosting no ofrece sitios de staging, considera cambiar a un host que sí lo haga. Esta es una característica estándar hoy en día y esencial para:

  • Pruebas seguras de plugins/temas
  • Actualizaciones de WordPress
  • Resolución de problemas
  • Trabajo de desarrollo

Hosts recomendados con staging:

  • WP Engine
  • SiteGround
  • Kinsta
  • Cloudways
  • Muchos otros

Paso 1: Verifica Errores Fatales​

Si estás experimentando bloqueos o errores críticos, comienza revisando los registros de errores:

  1. Verifica los Registros de WCPOS - Abre la pantalla de Registros en WCPOS para ver mensajes de error.
  2. Verifica los Registros de Errores Fatales - Sigue la guía de solución de problemas de errores críticos para encontrar mensajes de error detallados.
  3. Toma nota de los detalles del error - Busca nombres de plugins o rutas de archivos mencionados en el error.

Si encuentras un error fatal que menciona un plugin específico, es probable que sea el causante del problema. Puedes deshabilitar ese plugin y comprobar si se resuelve el problema.

Paso 2: El Método de Eliminación de Plugins​

Si no hay errores fatales en los registros, o deseas identificar conflictos relacionados con el rendimiento, utiliza este enfoque sistemático:

2.1 Crea una Línea Base​

  1. Accede a tu sitio de staging
  2. Prueba la funcionalidad problemática - Anota exactamente qué no funciona o es lento.
  3. Registra métricas de rendimiento - Si es un problema de rendimiento, anota los tiempos de ejecución de los Registros.

2.2 Desactiva Todos los Plugins (Excepto los Esenciales)​

Mantén activos estos plugins:

  • WooCommerce
  • WooCommerce POS (WCPOS)
  • WooCommerce POS 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​

  1. Limpia cualquier caché - Si utilizas plugins de caché, limpia todas las cachés.
  2. Prueba la funcionalidad problemática - ¿Funciona ahora?
  3. Verifica el rendimiento - ¿Mejoraron los tiempos de ejecución?

Si el problema se resuelve: Tienes un conflicto de plugins. Procede al Paso 2.4.

Si el problema persiste: Es probable que el problema no sea un conflicto de plugins. Considera:

  • Problemas de recursos del servidor (ve Rendimiento del Servidor)
  • Conflictos de temas (ve el Paso 3)
  • Problemas en el núcleo de WordPress/WooCommerce

2.4 Habilita Plugins Uno por Uno​

Ahora necesitas identificar qué plugin está causando el conflicto:

  1. Habilita un plugin - Comienza con los más esenciales primero
  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 - Caching, optimización
  4. Pasarelas de pago - Stripe, PayPal, etc.
  5. Otras extensiones de WooCommerce
  6. Plugins generales de WordPress

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 proporcionen funcionalidad similar

Paso 3: Verifica Conflictos de Tema​

Si bien los temas rara vez afectan a WCPOS (ya que usa su propia interfaz), a veces pueden causar problemas con:

  • Procesos de pago (si utilizas una pasarela de pago web)
  • Funcionalidad del área de administración
  • Respuestas de la API

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

Es mucho menos probable que los temas causen problemas en WCPOS en comparación con los plugins. La interfaz de POS funciona de manera independiente a tu tema. Sin embargo, los temas pueden afectar:

  • Páginas de pago de WooCommerce
  • Funcionalidad del área de administración de WordPress
  • Respuestas de la API REST

Paso 4: Resolver Conflictos de Plugins​

Una vez que hayas identificado el plugin en conflicto, tienes varias opciones:

Opción 1: Actualiza el Plugin​

  1. Verifica si hay actualizaciones - Es posible que el conflicto esté 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 una Alternativa​

  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​

  1. Informa del conflicto al desarrollador del plugin
  2. Proporciona información detallada:
    • Versiones de plugins involucrados
    • Versiones de WordPress y WooCommerce
    • Mensajes de error o comportamiento exacto
    • Pasos para reproducir el problema

Opción 4: Solución Personalizada​

Para plugins esenciales que no pueden ser reemplazados:

  1. Contacta a un desarrollador de WordPress para crear una solución personalizada
  2. Considera hooks específicos del plugin para deshabilitar la funcionalidad en conflicto
  3. Usa lógica condicional para deshabilitar el plugin en páginas relacionadas con POS

Tipos Comunes de Plugins en Conflicto​

Categorías de Plugins de Alto Riesgo​

Plugins de Seguridad:

  • Pueden bloquear solicitudes a la API
  • Pueden interferir con la autenticación
  • A menudo tienen reglas de firewall agresivas

Plugins de Caching:

  • Pueden almacenar en caché respuestas de API de manera inapropiada
  • Pueden interferir con datos en tiempo real
  • Pueden causar problemas de datos obsoletos

Plugins de SEO:

  • Plugins pesados pueden ralentizar el área de administración
  • Pueden agregar consultas innecesarias a la base de datos
  • Pueden interferir con respuestas de la API REST

Constructores de Páginas:

  • A menudo cargan scripts pesados en el área de administración
  • Pueden causar conflictos con las páginas de administración 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 de usuarios
  • Pueden restringir el acceso a recursos requeridos

Categorías de Plugins de Bajo Riesgo​

Formularios de Contacto: Generalmente no interfieren con WCPOS Plugins de Redes Sociales: Rara vez causan conflictos Plugins de Analítica: Generalmente seguros a menos que sean muy pesados Plugins de Contenido Básico: Normalmente compatibles

Consejos de Prevención​

Mantenimiento Regular​

  1. Mantén los plugins actualizados - Siempre utiliza las versiones más recientes
  2. Elimina plugins no utilizados - No solo desactives, elimínalos
  3. Prueba actualizaciones en el sitio de staging antes de aplicarlas al sitio en vivo
  4. Monitorea el rendimiento regularmente utilizando métricas de Rendimiento del Servidor

Mejores Prácticas para la Selección de Plugins​

  1. Elige desarrolladores reputados - Verifica opiniones y frecuencia de actualizaciones
  2. Evita funcionalidad redundante - No instales múltiples plugins que hagan lo mismo
  3. Lee la información de compatibilidad - Verifica si los plugins se han probado con WooCommerce
  4. Comienza con plugins mínimos - Agrega funcionalidad gradualmente según sea necesario

Obtener Ayuda​

Si no puedes resolver el conflicto de plugins:

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 Comunidad​

Al Contactar 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 es relevante

Documentación Relacionada​