# Cài widget trên WordPress

Gắn widget chat lên website WordPress bằng plugin miễn phí Hạ Tầng Chat, không cần sửa mã, và nhận diện người dùng đã đăng nhập.

Plugin **Hạ Tầng Chat** gắn widget chat lên mọi trang của website WordPress. Bạn chỉ dán một mã ID, plugin lo phần còn lại: không phải sửa file giao diện. Plugin còn gửi tên và email của khách đang đăng nhập WordPress để nhân viên biết ngay ai đang nhắn.

## Trước khi bắt đầu

- Bạn đã thêm website trong Hạ Tầng (**Hỗ trợ khách hàng → Kênh → Thêm kênh → Website**). Xem [Gắn widget chat lên website](https://hatang.dev/vi/help/widget/install-widget).
- Bạn đăng nhập được WordPress với quyền quản trị (Administrator).

## Lấy Site ID

1. Trong Hạ Tầng, vào **Hỗ trợ khách hàng → Kênh** và bấm vào website của bạn.
2. Trong thẻ **Cài lên website**, mở mục **WordPress**. Bước thứ hai có site id của bạn, bắt đầu bằng `site_`. Sao chép mã này.

![Thẻ Cài lên website với hướng dẫn WordPress và site id](https://hatang.dev/help/img/vi/widget/install-card.webp)

## Cài plugin

1. Trong WordPress, vào **Plugins → Add New Plugin** (giao diện tiếng Việt: **Plugin → Cài mới**) và tìm "Hạ Tầng Chat".
2. Bấm cài đặt, rồi kích hoạt plugin.
3. Vào **Settings → Hạ Tầng Chat** (tiếng Việt: **Cài đặt → Hạ Tầng Chat**).
4. Dán ID vào ô **Site ID** và lưu thay đổi.
5. Mở một trang bất kỳ của website. Bong bóng chat hiện ra.

Quay lại Hạ Tầng, thẻ **Cài lên website** của website giờ hiện **Đã cài trên** tên miền của bạn. Gửi thử một tin nhắn từ bong bóng chat: tin nhắn về **Hỗ trợ khách hàng → Hộp thư**.

Widget chỉ hiện ở các trang công khai, không bao giờ hiện trong trang quản trị WordPress. Khi ô **Site ID** trống, plugin không tải gì cả.

## Cài đặt của plugin

Mọi thiết lập nằm ở **Cài đặt → Hạ Tầng Chat**. Trang này hiện bằng tiếng Việt khi WordPress của bạn dùng tiếng Việt.

| Thiết lập | Tác dụng |
|---|---|
| **Site ID** | Nối plugin với website của bạn trong Hạ Tầng. |
| **Máy chủ widget** | Nơi tải widget. Giữ mặc định `https://chat.hatang.dev`. |
| **Vị trí** | **Góc dưới bên phải** hoặc **Góc dưới bên trái**. |
| **Ngôn ngữ** | **Theo ngôn ngữ WordPress (từng trang)** (mặc định), **Theo ngôn ngữ trình duyệt của khách**, **Tiếng Việt** hoặc **English**. |
| **Người dùng đã đăng nhập** | **Gửi tên và email của người dùng vào hộp thư** (bật sẵn). |

**Theo ngôn ngữ WordPress** chạy theo từng trang với Polylang và WPML: trang tiếng Việt có widget tiếng Việt, trang ngôn ngữ khác có widget tiếng Anh. **Theo ngôn ngữ trình duyệt của khách** để widget tự chọn theo trình duyệt của khách hoặc theo **Ngôn ngữ mặc định** trong Hạ Tầng.

Màu sắc, lời chào, giờ làm việc, form thông tin khách và mọi thứ khác lấy từ cài đặt của website trong Hạ Tầng, không nằm trong plugin. Xem [Tùy chỉnh giao diện widget](https://hatang.dev/vi/help/widget/appearance).

## Người dùng đã đăng nhập

Khi bật **Người dùng đã đăng nhập**, nếu một người đang đăng nhập website WordPress mở chat, nhân viên thấy ngay tên hiển thị và email WordPress của họ trong Hộp thư. Khách không phải gõ lại.

Trong Hộp thư, các thông tin này được đánh dấu **Chưa xác minh**, vì chúng đến từ trình duyệt của khách. Để được đánh dấu **Đã xác minh** và giữ cùng một lịch sử chat trên mọi thiết bị của khách, lập trình viên cần thêm một đoạn mã nhỏ để ký định danh người dùng. Xem [Nhận diện khách đã đăng nhập](https://hatang.dev/vi/help/widget/identify-users).

## Không dùng plugin

Nếu không cài được plugin, bạn dán đoạn mã vào giao diện: **Appearance → Theme File Editor** (**Giao diện → Sửa giao diện**), mở `footer.php` và dán đoạn mã từ thẻ **Cài lên website** ngay trước `</body>`. Khi cập nhật giao diện, file này có thể bị ghi đè, nên dùng plugin vẫn an toàn hơn.

## Gỡ plugin

Tắt kích hoạt rồi xoá plugin trong mục **Plugin**. Bong bóng chat biến mất khỏi website ngay. Các hội thoại vẫn còn trong Hạ Tầng.

> [!NOTE]
> Đang dùng plugin cache hoặc tối ưu tốc độ? Nếu cài xong mà chưa thấy bong bóng chat, hãy xoá cache của plugin đó. Xem [Widget không hiện trên website](https://hatang.dev/vi/help/widget/widget-not-showing).