Saltar al contenido principal
Versión: 1.x

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​

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​

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

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

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

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​

  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

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​

  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)
  • Conflictos de tema (ver Paso 3)
  • Problemas con el núcleo de WordPress/WooCommerce

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​

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​

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​

  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​

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

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​

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

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​

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​

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

Consejos de Prevención​

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

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​

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

Discord Communitysupport@wcpos.com

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
Error CríticoCómo encontrar registros de errores fatales
RegistrosComprendiendo los registros y métricas de WCPOS
Rendimiento del ServidorDiagnosticando problemas de rendimiento
Rendimiento del Proceso de PagoOptimizando la velocidad de pago