Telegram Contact Button Free Joomla Module

This module adds a floating Telegram contact button to any corner of your site. It can open a t.me link or attempt a deep link into the Telegram app on mobile devices.

Key Features

📌

Floating button

Place in any of the 4 corners; brand color #11a37e.

✈️

Open chat

Open https://t.me/<username> or try tg://resolve?domain=<username> deep link.

🔗

Share mode

https://t.me/share/url?url=...&text=... (best-effort tg://msg_url deep link).

💻

Device visibility

Show on Desktop, Mobile, or both.

📏

Sizes & style

Small / Medium / Large; rounded pill with soft shadow.

🎛️

Positioning & a11y

Offset X/Y, z-index, tooltip, customizable ARIA label.

⚙️

Clean assets

Loads CSS/JS via Joomla 5 Web Asset Manager.

Configurations

  • ✓Telegram Username: Your public Telegram username (without @). For channels/groups, use their public name.
  • ✓Link Type: Chat / Channel or Share URL/Text.
  • ✓Bot Start Parameter: Optional payload for bots (e.g., welcome1). Appended as ?start=welcome1.
  • ✓Share URL / Share Text: Used if Link Type is Share.
  • ✓Button Label: Text next to the Telegram icon.
  • ✓Show Label: Show/hide the label (switch).
  • ✓Open Behavior: Auto / Always t.me / Prefer deep link.
  • ✓Open t.me in New Tab: Open the t.me link in a new tab.
  • ✓Position: Bottom Right / Bottom Left / Top Right / Top Left.
  • ✓Offset X / Offset Y: Spacing from the edges in pixels.
  • ✓Size: Small / Medium / Large.
  • ✓Tooltip: Short help text.
  • ✓z-index: Stacking order (default 9999).
  • ✓Show On: Desktop & Mobile / Desktop only / Mobile only.
  • ✓Rounded: Pill-rounded shape.
  • ✓Shadow: Drop shadow on the button.
  • ✓Use Brand Color: Use #11a37e.
  • ✓Custom Color: Override brand color.
  • ✓Accessible Label: ARIA label for screen readers.

Frequently Asked Questions

Should I include the @ symbol in the username?
No. Enter the username without the @.
What about private groups/channels?
They don’t have public usernames, so use a public landing chat or bot instead.