Intégration Discord Chat : installation et aide

Suivez les étapes du Démarrage rapide.

Ouvrez "Configure" dans "Module Manager". Créez une invitation pour votre serveur Discord avant de configurer le module. Privilégiez une invitation qui restera valide pour l’usage prévu.

Pour https://discord.gg/AbCdEfG123, saisissez AbCdEfG123. Après l’enregistrement, Configuration Discord affiche votre code et Tester le lien. Les nouvelles modifications de l’identifiant sont validées. Une modification invalide conserve les paramètres précédents. Le bouton nécessite un code d'invitation ; une invitation Discord expirée ouvre toujours son lien.

Vous pouvez traduire Texte du bouton et Texte de l'infobulle dans les langues de votre boutique. Une traduction vide reprend le texte de la langue par défaut, puis la valeur stockée d’origine.

Pour un bouton textuel sur les pages produit, sélectionnez Barre avec texte, saisissez votre libellé, choisissez En bas à gauche, réglez Afficher sur les pages sur Pages produit uniquement et sélectionnez Aucun si vous ne souhaitez aucune animation.

Le ciblage des pages de commande correspond à cart, order, order-opc, orderopc et checkout. Un processus de commande personnalisé avec un autre nom de contrôleur ne correspondra pas à cette sélection.

Le moteur de rendu partagé insère le bouton à la première interaction, comme un défilement, un clic ou un toucher, ou à l’expiration du délai de secours. Il gère le temps en dehors du template et règle le délai propre du template à zéro pendant le rendu. Vous n’avez donc pas besoin d’ajouter data-delay ni un second délai.

Le module enregistre son fichier local views/css/mprdiscordchatintegration.css via displayHeader et affiche son bouton via displayBeforeBodyClosingTag. Le lien ouvre https://discord.gg/YOUR_CODE dans un nouvel onglet avec noopener noreferrer.

Vous obtenez un lien d’invitation avec une icône SVG intégrée, des styles locaux et le chargeur partagé. Le module ne charge pas de SDK Discord et n’intègre pas de conversations dans votre boutique. Les visiteurs terminent l’inscription dans Discord avec un compte Discord. Cette version ne comporte ni champ "Pre-filled Message" ni transmission de message.

Utilisez le CSS de votre thème pour de petits ajustements visuels :

#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;
}

L’élément englobant expose --mprds-color, --mprds-size et --mprds-margin, ainsi que des classes de position, de style et d’animation comme mprdiscord-bottom-right, mprdiscord-icon et mprdiscord-pulse.

Pour modifier le balisage, copiez le template du hook vers :

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

Le tableau assigné est mprdiscord ; le template par défaut utilise l’alias ds. Les clés disponibles sont invite_code, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation et delay. Il n’existe pas de clé message. Conservez l’échappement, le libellé accessible et la protection du lien ouvert dans un nouvel onglet dans votre surcharge.

Utilisez Tester le lien pour tester l’invitation indépendamment du widget. Vérifiez ensuite une page produit, une page de catégorie et le processus de commande selon votre ciblage. Testez la première interaction et une page fraîchement chargée laissée intacte pour le déclenchement de secours. Vérifiez les textes traduits et le paramètre mobile.

Si le bouton est absent, vérifiez l’activation, le code, la correspondance page/contrôleur et la détection mobile. Confirmez que votre thème exécute les deux hooks enregistrés et charge la feuille de style locale. Vérifiez les erreurs JavaScript si le chargeur d’interaction ne libère jamais le bouton.

Si le bouton chevauche une autre commande, ajustez Position, Marge depuis le bord (px) ou le CSS de votre thème. Si l’invitation échoue, remplacez-la par un code valide dans Connexion Discord. Le module ne peut pas renouveler les invitations Discord expirées.

Réglez Activer le chat Discord sur Non et enregistrez pour suspendre le bouton tout en conservant les paramètres. Désinstallez via "Module Manager" pour supprimer son menu et la configuration du module. Gérez le serveur, les adhésions et les invitations dans Discord.

Utilisez les noms des paramètres ci-dessus lorsqu’une capture de référence diffère de votre version installée.