TR Social Contact
Complete guide to installing and configuring the module: Free vs Pro, contact items, display modes, position, style, animation, responsive settings, and troubleshooting.
Author: Tarequr Rahman · Joomla 5.x / 6.x
1. Installation
- System → Install → Extensions — upload the Free or Pro ZIP.
- Content → Site Modules → New — choose TR Social Contact (Free edition may show as TR Social Contact (Free)).
- Set title, any module position (floating modes use
position: fixed), status Published, and menu assignment (often On all pages). - Add contact items, choose a display mode, Save, and clear Joomla + browser cache after upgrades.
Free and Pro share the technical name mod_tr_social_contact. Install one edition per site. Pro can be installed over Free; settings are preserved where fields exist in both. Always clear cache after updating.
2. Free vs Pro
Free is production-ready for WhatsApp, phone, email, and custom links. Pro unlocks expandable mode, more platforms, labels, full styling, and up to 20 items. In Free, Pro features appear in the admin as locked fields or PRO notes. Pro PHP, CSS, JS, and extra icons are not included in the Free package.
| Feature | Free | Pro |
|---|---|---|
| Floating bar · Inline list | Yes | Yes |
| WhatsApp · Phone · Email · Custom | Yes | Yes |
| Contact items | Max 3 | Max 20 |
| Position, offsets, layout direction | Yes | Yes |
| Tooltips · Fade · basic mobile | Yes | Yes |
| Expandable floating button | Locked | Full |
| Social platforms (FB, IG, X, …) | Locked | Full |
| Labels · equal width · hover expand | Locked | Full |
| Advanced colours, borders, shadows | Locked | Full |
| Scale / Slide · panel direction | Locked | Full |
3. General settings
- Enable Module — master switch; when off, nothing is output
- Display Mode — Floating bar or Inline (Expandable is Pro)
- Button Shape — Circle, Rounded Square, Square (Custom radius is Pro)
- Button Size / Gap — size in pixels and spacing between buttons
- Show Tooltips — hover/focus tooltip when text is set on an item
- Show Labels — Pro; Free shows a PRO note
- Hover Animation — subtle hover effect on/off
4. Contact items
- Repeatable list: add, remove, reorder (drag)
- Free: maximum 3 items · Pro: maximum 20
- Each item: enable, platform, label, value/URL, tooltip, icon, link target
- Disabled or invalid items are skipped on the frontend
Server-side validation always applies: empty values, wrong platforms (Free), and unsafe URLs are dropped from output.
5. Platforms
Free
- WhatsApp — international number with country code; builds
https://wa.me/{digits}; optional pre-filled message - Phone — generates a
tel:link - Email — validated address; optional subject and body for
mailto: - Custom — HTTP or HTTPS URL only
Pro only
- Facebook, Instagram, LinkedIn, X — HTTPS profile/page URLs
- Messenger / Telegram — HTTPS URL or username (converted to official HTTPS links)
WhatsApp tip
Use a full international number including country code (e.g. +8801712345678). The module strips formatting and builds a digits-only wa.me path.
6. Position & layout
- Side — Left or Right (floating / expandable)
- Vertical alignment — Top, Center, Bottom
- Horizontal / Vertical offset — distance from the viewport edges (px)
- Layout direction — Vertical or Horizontal stack of buttons
- Inline alignment — Left / Center / Right when mode is Inline
- Panel direction — Pro only (expandable: up / down / left / right)
Floating modes are fixed to the viewport. Inline mode flows inside the module position like normal content.
7. Style & appearance
- Free — platform default colours (e.g. WhatsApp green); circle / rounded / square shapes
- Pro — default and hover backgrounds, icon colours, border, radius, shadow, tooltip colours, per-item colour overrides
In Free, advanced style fields appear with a PRO note and are disabled. Platform colours still apply automatically.
8. Animation
- Fade — Free & Pro
- Scale / Slide / None — Pro
- Duration (ms) and Respect reduced motion
When reduced motion is preferred, transforms and opacity transitions are disabled.
9. Responsive
- Free — mobile button size / gap; enable on mobile
- Pro — separate desktop / tablet / mobile enable toggles, mobile position and offsets, mobile layout direction, mobile label visibility
Safe-area insets are respected on notched devices where supported.
10. Expandable mode (Pro)
- One main contact button (neutral contact icon)
- Click toggles a non-modal panel of all enabled items
- Escape closes the panel; click outside closes it
- Panel direction: up / down / left / right
- Layout direction: vertical or horizontal arrangement of items inside the panel
The main button only opens/closes the panel. Real contact URLs live on the items inside the panel.
11. Security & performance
- Output escaped; contact values validated per platform
- Scheme whitelist (no
javascript:URLs) rel="noopener"always on new-tab external links;noreferreroptional- No database tables; parameters only
- Assets under
media/mod_tr_social_contact/; Free ships CSS only, Pro adds JS for expandable
12. Troubleshooting
- Nothing appears — Publish the module, enable it in General, add at least one valid contact item, check menu assignment, clear cache. View source for
tr-social-contact. - WhatsApp link wrong — Include country code; avoid letters. Check the generated
wa.mepath in the page source. - Install error: media/js missing (Free) — Use the latest Free ZIP (no empty
jsfolder in the manifest). - Expandable / labels / extra platforms unavailable — Free by design. Install the Pro package over Free to unlock them.
- Only 3 items show — Free limit. Pro allows up to 20.
- Styles not updating — Save the module, clear Joomla cache, hard-refresh the browser (Ctrl+F5).
- Assets 404 — Confirm
/media/mod_tr_social_contact/css/frontend.css(and Pro:js/frontend.js) exist after install.