Discord Chat Integration: setup and help

Follow the steps in Quick start.

Open Configure in Module Manager. Create an invite for your Discord server before configuring the module. Prefer an invite that will remain valid for your intended use.

For https://discord.gg/AbCdEfG123, enter AbCdEfG123. After saving, Discord Setup shows your code and a Test link. New identifier edits are validated. An invalid edit keeps the previous settings. The button requires an invite code; an expired Discord invite still opens its link.

You can translate Button Text and Tooltip Text for your shop languages. An empty translation follows the default-language text, then the original stored value.

For a text button on product pages, select Bar with Text, enter your label, choose Bottom Left, set Show on Pages to Product Pages Only, and select None if you want no animation.

Checkout targeting matches cart, order, order-opc, orderopc and checkout. A custom checkout with another controller name will not match this selection.

The shared renderer inserts the button on the first interaction, such as scroll, click or touch, or when the fallback expires. It manages timing outside the template and sets the template's own delay to zero while rendering. You therefore do not need to add data-delay or a second timeout.

The module registers its local views/css/mprdiscordchatintegration.css file through displayHeader and renders its button through displayBeforeBodyClosingTag. The link opens https://discord.gg/YOUR_CODE in a new tab with noopener noreferrer.

You get an invite link with an inline SVG icon, local styling and the shared loader. The module does not load a Discord SDK or embed conversations in your shop. Visitors complete the join process in Discord with a Discord account. There is no Pre-filled Message field or message handoff in this version.

Use your theme's CSS for small appearance adjustments:

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

The wrapper exposes --mprds-color, --mprds-size and --mprds-margin, plus position, style and animation classes such as mprdiscord-bottom-right, mprdiscord-icon and mprdiscord-pulse.

To change the markup, copy the hook template to:

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

The assigned array is mprdiscord; the default template aliases it to ds. Available keys are invite_code, position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation and delay. There is no message key. Keep escaping, the accessible label and the link's new-tab protection in your override.

Use Test link to test the invite separately from the widget. Then check a product page, a category page and checkout against your targeting choice. Test first interaction and a fresh page left untouched for the fallback. Check translated text and the mobile setting.

If the button is absent, check the enabled switch, code, page/controller match and mobile detection. Confirm your theme executes both registered hooks and loads the local stylesheet. Check JavaScript errors if the interaction loader never releases the button.

If the button overlaps another control, adjust Position, Margin from Edge (px) or your theme CSS. If the invite fails, replace it with a valid code in Discord Connection. The module cannot renew expired Discord invites.

Set Enable Discord Chat to No and save to pause the button while keeping settings. Uninstall through Module Manager to remove its menu and module configuration. Manage the server, membership and invites in Discord.

Use the setting names above when a reference screenshot differs from your installed version.