Addon 2x [VNXF] Floating Contact - Nút liên hệ nổi đa kênh kết nối khách truy cập với bạn chỉ trong một cú nhấp cho XenForo 2.3 1.2.1

PVS · Lúc 16:52:56, Thứ hai

[VNXF] Floating Contact là add-on dành cho XenForo 2.3+, giúp bạn thêm một nút liên hệ nổi (floating button) cố định ở góc màn hình. Khi người dùng nhấn vào, một danh sách các kênh liên hệ sẽ bung ra với hiệu ứng trượt mượt mà — giúp khách truy cập dễ dàng liên lạc với quản trị viên mà không cần rời khỏi trang.

Add-on được thiết kế tối giản, hoạt động mượt trên cả desktop và mobile, không gây ảnh hưởng đến hiệu năng trang. Tất cả các kênh liên hệ đều được cấu hình trực tiếp từ Admin CP — không cần chỉnh sửa code hay template.

Tính năng nổi bật

6 kênh liên hệ — Facebook, Zalo, Telegram, YouTube, Email, Điện thoại
Hiệu ứng mượt mà — Cubic-bezier animation khi mở/đóng danh sách
Tùy chọn vị trí — Hiển thị góc trái hoặc góc phải màn hình
Responsive hoàn hảo — Tương thích mọi kích thước màn hình
Cấu hình dễ dàng — Quản lý toàn bộ từ Admin CP Options
Siêu nhẹ — Không thư viện ngoài, không ảnh hưởng tốc độ
Brand Colors — Mỗi kênh mang đúng màu thương hiệu riêng
Tooltip thông minh — Hiện nhãn tên kênh khi hover mỗi nút

Các kênh liên hệ được hỗ trợ

Add-on hỗ trợ sẵn 6 kênh liên hệ phổ biến. Chỉ cần điền link/thông tin vào Options — kênh nào để trống sẽ tự động ẩn:

Kênh	Mô tả	Loại
Facebook	Liên kết đến Fanpage hoặc Profile Facebook	Social
Zalo	Chat Zalo trực tiếp qua zalo.me	Chat
Telegram	Liên kết t.me đến kênh hoặc cá nhân	Chat
YouTube	Dẫn đến kênh YouTube	Media
Email	Mở ứng dụng email với mailto:	Contact
Điện thoại	Gọi trực tiếp trên mobile qua tel:	Call

Tùy chọn cấu hình (Admin CP)

Tất cả được quản lý tại Admin CP → Setup → Options → [VNXF] Floating Contact:

Tùy chọn	Mô tả	Mặc định
`Enable`	Bật/tắt nút liên hệ nổi toàn site	Bật
`Position`	Vị trí hiển thị: góc trái hoặc góc phải	Phải
`Facebook`	URL trang Facebook	Trống
`Zalo`	URL Zalo (zalo.me/...)	Trống
`Telegram`	URL Telegram (t.me/...)	Trống
`YouTube`	URL kênh YouTube	Trống
`Email`	Địa chỉ email liên hệ	Trống
`Phone`	Số điện thoại liên hệ	Trống

Mẹo: Kênh nào không cần sử dụng, chỉ cần để trống — nút đó sẽ tự động không hiển thị trên trang.

Hướng dẫn cài đặt

Tải add-on
Cài đặt từ Admin CP — Vào Admin CP → Add-ons → Install/upgrade from archive
Hoặc sử dụng CLI:
Mã:
```
php cmd.php xf:addon-install VNXF/FloatingContact
```
Cấu hình kênh liên hệ — Vào Options → [VNXF] Floating Contact và điền thông tin các kênh bạn muốn hiển thị
Hoàn tất! — Nút liên hệ nổi sẽ xuất hiện ngay trên tất cả các trang của forum

️ Yêu cầu hệ thống

XenForo 2.3.0+
PHP 8.0+
Không yêu cầu thư viện ngoài

Ghi chú kỹ thuật

Add-on sử dụng Template Modification để inject vào PAGE_CONTAINER — không ghi đè template gốc, hoàn toàn tương thích với các add-on và style khác.

JavaScript được viết theo chuẩn XenForo Element Handler (XF.Element.register), tự động đóng khi click bên ngoài widget, và không sử dụng bất kỳ thư viện bên thứ 3 nào.

Lưu ý: Add-on sử dụng z-index: 9999. Nếu site bạn có element khác sử dụng z-index cao, có thể cần điều chỉnh trong template vnxf_floating_contact.less.

Chúc các bạn thành công.

PVS - VNXF