Integración Discord Chat: configuración y ayuda

Inicio rápido

  1. Sube el ZIP de mprdiscordchatintegration desde Módulos > "Module Manager" > "Upload a module".
  2. Haz clic en "Configure" y abre Conexión Discord.
  3. Introduce solo tu código de invitación de Discord en Código de invitación, por ejemplo AbCdEfG123.
  4. Mantén Activar chat de Discord activado y revisa Apariencia del botón, incluidos Posición y Estilo del botón.
  5. Revisa Mostrar en móvil, Mostrar en páginas y Fallback Delay (seconds) en Comportamiento de visualización y guarda.
  6. Usa Probar enlace en Configuración de Discord para confirmar que la invitación es válida.
  7. Abre una página permitida de la tienda, interactúa o espera a la carga de respaldo, pulsa el botón y confirma que tu invitación de Discord se abre en una pestaña nueva.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Manual de configuración

Instalación y configuración

Sigue los pasos de Inicio rápido.

Conexión Discord

Abre "Configure" en "Module Manager". Crea una invitación para tu servidor de Discord antes de configurar el módulo. Elige preferiblemente una invitación que siga siendo válida para el uso previsto.

Ajuste Valor predeterminado Qué configuras
Activar chat de Discord Sí Permite mostrar el botón de invitación en las páginas aptas.
Código de invitación Vacío Introduce de 2 a 64 letras, números, guiones bajos o guiones. Pega el código que aparece después de discord.gg/, no la URL completa.

Para https://discord.gg/AbCdEfG123, introduce AbCdEfG123. Después de guardar, Configuración de Discord muestra tu código y Probar enlace. Los nuevos cambios del identificador se validan. Un cambio no válido conserva los ajustes anteriores. El botón requiere un código de invitación; una invitación de Discord caducada sigue abriendo su enlace.

Apariencia del botón

Ajuste Valor predeterminado Cuándo cambiarlo
Posición Abajo a la derecha (bottom-right) Selecciona Abajo a la izquierda (bottom-left) si otros controles ocupan la esquina derecha.
Estilo del botón Icono flotante (icon) Selecciona Barra con texto (bar) para mostrar texto junto al icono.
Texto del botón "Join our Discord" Establece la etiqueta. En el modo de icono también proporciona la etiqueta accesible del enlace.
Color del botón #5865F2 Establece el color de fondo.
Tamaño del botón (px) 60 Ajusta el diámetro del botón de icono.
Margen desde el borde (px) 20 Ajusta la distancia a los bordes de pantalla elegidos.
Mostrar descripción emergente Sí Desactiva la descripción emergente al pasar el cursor si no la necesitas.
Texto de ayuda "Join us on Discord" Establece el texto de la descripción emergente.
Animación Pulso (pulse) Selecciona Rebote (bounce) o Ninguno (none).

Puedes traducir Texto del botón y Texto de ayuda a los idiomas de tu tienda. Una traducción vacía utiliza el texto del idioma predeterminado y después el valor original almacenado.

Para un botón de texto en las páginas de producto, selecciona Barra con texto, introduce tu etiqueta, elige Abajo a la izquierda, establece Mostrar en páginas en Solo páginas de producto y selecciona Ninguno si no quieres animación.

Comportamiento de visualización

Ajuste Valor predeterminado Qué configuras
Mostrar en móvil Sí Permite el botón en dispositivos que PrestaShop detecte como móviles.
Fallback Delay (seconds) 0 Carga con la primera interacción o tras esta espera máxima. El cero usa una carga de respaldo a los 10 segundos.
Mostrar en páginas Todas las páginas (all) Selecciona Solo páginas de producto (product), Solo páginas de categoría (category) o Solo páginas de pago (checkout).

La selección de páginas de pago coincide con cart, order, order-opc, orderopc y checkout. Un proceso de pago personalizado con otro nombre de controlador no coincidirá con esta selección.

El renderizador compartido inserta el botón con la primera interacción, como desplazarse, hacer clic o tocar, o cuando vence el tiempo de respaldo. Gestiona los tiempos fuera de la plantilla y establece el retraso propio de la plantilla en cero al generar la salida. Por tanto, no necesitas añadir data-delay ni un segundo temporizador.

Comportamiento en la tienda

El módulo registra su archivo local views/css/mprdiscordchatintegration.css mediante displayHeader y muestra su botón mediante displayBeforeBodyClosingTag. El enlace abre https://discord.gg/YOUR_CODE en una pestaña nueva con noopener noreferrer.

Obtienes un enlace de invitación con un icono SVG integrado, estilos locales y el cargador compartido. El módulo no carga un SDK de Discord ni incorpora conversaciones en tu tienda. Los visitantes completan la incorporación en Discord con una cuenta de Discord. Esta versión no tiene campo "Pre-filled Message" ni transferencia de mensajes.

Personalizar el botón

Usa el CSS de tu tema para pequeños ajustes de aspecto:

#mprdiscord-widget.mprdiscord-bar a {
  padding: 10px 18px;
  border-radius: 24px;
}
#mprdiscord-widget .mprdiscord-tooltip {
  background: #111;
  font-size: 12px;
}
#mprdiscord-widget.mprdiscord-bottom-left {
  bottom: 32px;
  left: 32px;
}

El contenedor expone --mprds-color, --mprds-size y --mprds-margin, además de clases de posición, estilo y animación como mprdiscord-bottom-right, mprdiscord-icon y mprdiscord-pulse.

Para cambiar el marcado, copia la plantilla del hook en:

/themes/your-theme/modules/mprdiscordchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl

El array asignado es mprdiscord; la plantilla predeterminada usa el alias ds. Las claves disponibles son invite_code, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation y delay. No hay clave message. Conserva el escape de caracteres, la etiqueta accesible y la protección del enlace al abrir una pestaña nueva en tu sobrescritura.

Verificación y solución de problemas

Usa Probar enlace para probar la invitación por separado del widget. Después comprueba una página de producto, una de categoría y el pago según la selección de páginas. Prueba la primera interacción y una página recién cargada sin tocar para la carga de respaldo. Revisa los textos traducidos y el ajuste móvil.

Si no aparece el botón, comprueba el interruptor de activación, el código, la coincidencia de página/controlador y la detección móvil. Confirma que tu tema ejecuta ambos hooks registrados y carga la hoja de estilos local. Revisa los errores de JavaScript si el cargador de interacción nunca libera el botón.

Si el botón se superpone a otro control, ajusta Posición, Margen desde el borde (px) o el CSS de tu tema. Si falla la invitación, sustitúyela por un código válido en Conexión Discord. El módulo no puede renovar invitaciones de Discord caducadas.

Desactivación o desinstalación

Establece Activar chat de Discord en No y guarda para pausar el botón conservando los ajustes. Desinstala desde "Module Manager" para eliminar su menú y la configuración del módulo. Gestiona el servidor, los miembros y las invitaciones en Discord.

Capturas de referencia

Usa los nombres de los ajustes anteriores cuando una captura de referencia difiera de tu versión instalada.

Discord Chat Integration, aspecto de Discord en el back office

Discord Chat Integration, descripción emergente del botón de la tienda

Discord Chat Integration, conexión de Discord en el back office

Discord Chat Integration, botón visible en la tienda

Discord Chat Integration, botón móvil de la tienda

Discord Chat Integration, comportamiento de Discord en el back office

Preguntas

1

¿El botón de invitación de Discord envía la identidad del cliente o guarda conversaciones?

El botón abre tu invitación de Discord en una pestaña nueva sin añadir la identidad del cliente ni un mensaje. Usa estilos locales y un icono SVG integrado y no guarda conversaciones de Discord en PrestaShop.

Problemas conocidos

5

Etiquetas de ajustes sin traducir

ResueltoActualizado:
Corregido en: 1.1.18
Los ajustes traducidos del módulo podían seguir mostrándose en inglés.

Nombre accesible del enlace de chat distinto del texto

ResueltoActualizado:
Corregido en: 1.1.18
Los lectores de pantalla podían anunciar una etiqueta incorrecta en lugar del texto de contacto visible en el idioma actual de la tienda.

Aviso de configuración obsoleto tras guardar

ResueltoActualizado:
Corregido en: 1.1.18
El aviso de configuración no reflejaba inmediatamente los ajustes guardados.

Compatibilidad con la combinación de recursos

ResueltoActualizado:
Corregido en: 1.1.14
Los archivos de integración de Discord no se combinaban correctamente con la optimización nativa de archivos de la tienda.

Ajustes antiguos del chat no transferidos

ResueltoActualizado:
Corregido en: 1.1.13
Los ajustes del chat de instalaciones anteriores podían perderse al usar el almacenamiento de ajustes actualizado.

Solicitudes de funcionalidades

5

Implementado

Actualizaciones del módulo con un clic

Implementado
Busca e instala actualizaciones del módulo desde el back office.

Interfaz multilingüe

Implementado
Usa las etiquetas y los mensajes del módulo traducidos al francés, alemán, español, italiano y polaco.

Comprobación y reparación de la instalación

Implementado
Comprueba la instalación del módulo y restaura las entradas de menú que falten en el back office.

Enlace de contacto de Discord

Implementado
Permite a los compradores abrir el destino de contacto de Discord configurado desde la tienda.

Textos para visitantes por idioma

Implementado
Configura los textos del chat para visitantes en cada idioma de la tienda.

Registro de cambios

v1.1.132026-09-02

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate chat config from ps_configuration to ConfigTable
Versiones anteriores

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-16

  • AddedPrestaShop 9 and Hummingbird theme compatibility
  • Addedconfigurable widget tooltip text displayed on mouse hover
  • Improvedmobile button positioning with adjustable bottom offset to avoid browser navigation bar
  • Fixedwidget appearing on checkout pages when hide-on-checkout option is enabled
  • Addedconsent-aware loading: widget defers until functional cookie consent category is accepted

v1.1.02025-06-20

  • Addedoption to open Discord invite in a new tab or in an embedded popup overlay
  • Addedconfigurable button icon: Discord logo, generic chat bubble, or community icon
  • Improvedbutton animation options: pulse, bounce, or static display
  • Fixedwidget not rendering on category pages when PS theme uses deferred DOM insertion

v1.0.02025-05-30

  • Initialrelease with Discord Chat Integration
  • InitialFloating Discord community button displayed on all front-end pages
  • InitialConfigurable Discord invite URL and button corner position
  • InitialBack-office toggle to show or hide independently on desktop and mobile devices

Demo

Prueba el módulo completo antes de comprar

Compra la licencia más tarde y conserva tus ajustes.

  • Tu demo de 30 días Pruébalo en tu propia tienda durante 30 días desde la primera instalación.
  • Tienda demo lista Explora una tienda demo lista en tu navegador.
  • Sin registro Sin cuenta, correo ni dominio de tienda.
Iniciar tienda demo

Al descargar, aceptas las condiciones de la demo y la política de privacidad.

Al abrir esta demo, acepta los términos de la demo y la política de privacidad.

Cargando...
Volver arriba