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 - Características que no funcionan como se espera
  • 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 Pruebas​

Importante

Nunca soluciones conflictos de plugins en tu sitio en vivo. Siempre utiliza un entorno de pruebas para evitar interrumpir tus operaciones comerciales.

¿Qué es un Sitio de Pruebas?​

Un sitio de pruebas 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 alojamiento modernos ofrecen entornos de pruebas como característica estándar.

Si Tu Proveedor No Ofrece Pruebas​

Si tu proveedor de alojamiento no ofrece sitios de pruebas, considera cambiarte a un proveedor que sí lo haga. Esto es una característica estándar en la actualidad y esencial para:

  • Pruebas de plugins/temas de forma segura
  • Actualizaciones de WordPress
  • Solución de problemas
  • Trabajo de desarrollo

Proveedores recomendados con entorno de pruebas:

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

Paso 1: Verificar 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 si hay algún mensaje 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. Anota 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 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 quieres identificar conflictos relacionados con el rendimiento, utiliza este enfoque sistemático:

2.1 Crea una Línea Base​

  1. Accede a tu sitio de pruebas
  2. Prueba la funcionalidad problemática - Anota exactamente qué no está funcionando o está lento
  3. Registra métricas de rendimiento - Si es un problema de rendimiento, anota los tiempos de ejecución desde 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 otros plugins
  3. Elige "Desactivar" en el menú desplegable de acciones en grupo
  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 de recursos del servidor (ver Rendimiento del Servidor)
  • Conflictos de tema (ver Paso 3)
  • Problemas en el núcleo de WordPress/WooCommerce

2.4 Activa los Plugins Uno por Uno​

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

  1. Activa un plugin - Comienza con los más esenciales primero
  2. Prueba la funcionalidad - Verifica si el problema regresa
  3. Si no hay problema - Activa el siguiente plugin y prueba de nuevo
  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: Verificar Conflictos de Tema​

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

  • Procesos de pago (si se usa 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 pruebas, cambia a un tema predeterminado de WordPress:
    • Veinte Veinticuatro
    • Veinte Veintitrés
    • Veinte Veintidós
  2. Prueba la funcionalidad problemática
  3. Si el problema se resuelve - Tu tema tiene un conflicto
Impacto del Tema

Los temas son mucho menos propensos a causar problemas en WCPOS en comparación con los plugins. La interfaz POS funciona de manera independiente de 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: Resolviendo Conflictos de Plugins​

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

Opción 1: Actualizar el Plugin​

  1. Verifica si hay actualizaciones - El conflicto puede haberse solucionado en una versión más reciente
  2. Actualiza el plugin en tu sitio de pruebas primero
  3. Prueba a fondo antes de actualizar en el sitio en vivo

Opción 2: Encontrar un Alternativo​

  1. Investiga plugins alternativos que proporcionen la misma funcionalidad
  2. Prueba alternativas en tu sitio de pruebas
  3. Migra configuraciones si cambias de plugins

Opción 3: Contactar al Desarrollador del Plugin​

  1. Informa sobre el 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 se pueden reemplazar:

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

Tipos Comunes de Plugins Conflictivos​

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 Caché:

  • Pueden almacenar en caché respuestas de la API inapropiadamente
  • 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 en 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 confligir con 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 necesarios

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: Usualmente 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 pruebas 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 reseñas 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 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 para ti.

Soporte Comunitario​

Discord Communitysupport@wcpos.com

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