Cài đặt đầu trang và cuối trang bổ sung cho admin

Tính năng “Bổ sung đầu trang cho admin” và “Bổ sung cuối trang cho admin” cho phép quản trị viên chèn thêm mã HTML/CSS/JavaScript vào giao diện admin mà không cần sửa template hoặc build lại ứng dụng.
Tính năng này hữu ích khi cần gắn nhanh stylesheet, script theo dõi nội bộ, đoạn cấu hình UI, đoạn tùy biến nhỏ cho admin, hoặc mã tích hợp bên thứ ba chỉ áp dụng cho khu vực quản trị.

Phạm vi áp dụng

Hai vùng cấu hình này chỉ áp dụng cho giao diện admin.
Nó không ảnh hưởng tới website phía người dùng cuối. Phần web public có nhóm cài đặt riêng cho đầu trang/cuối trang web.
Có hai vị trí chèn mã:
  • Bổ sung đầu trang cho admin: dùng cho nội dung cần đưa vào vùng đầu trang, thường là <style>, <link>, <meta> hoặc script cần tải sớm.
  • Bổ sung cuối trang cho admin: dùng cho nội dung cần đưa vào cuối trang, thường là <script> hoặc mã cần chạy sau khi giao diện admin đã render.

Luồng hoạt động

Khi mở trang cài đặt admin, hệ thống đọc hai giá trị cấu hình đã lưu và hiển thị lại trong hai ô nhập mã nguồn.
Khi bấm lưu:
  • Nếu ô có nội dung, hệ thống cắt khoảng trắng đầu/cuối rồi lưu nội dung đó dưới dạng chuỗi cấu hình.
  • Nếu ô rỗng, hệ thống xóa cấu hình tương ứng.
  • Sau khi cả hai vùng được xử lý xong, admin hiển thị thông báo lưu thành công.
Khi một trang admin bất kỳ được render, hệ thống đọc lại cấu hình này. Nếu nội dung không rỗng, nội dung sẽ được gắn vào vùng đầu trang hoặc cuối trang bổ sung của layout admin. 
flowchart TD
    A[Quản trị viên mở trang Cài đặt] --> B[Hệ thống đọc cấu hình đầu trang và cuối trang admin]
    B --> C[Hiển thị nội dung trong mục Mã nguồn]
    C --> D[Quản trị viên chỉnh sửa và bấm Lưu]
    D --> E{Nội dung có rỗng không?}
    E -- Có --> F[Xóa cấu hình tương ứng]
    E -- Không --> G[Lưu nội dung dạng chuỗi]
    F --> H[Thông báo lưu thành công]
    G --> H
    H --> I[Trang admin khác được tải lại]
    I --> J[Layout admin chèn mã bổ sung vào head hoặc cuối trang]

Hành vi cần lưu ý

Nội dung được lưu là mã nguồn tự do. Vì vậy quản trị viên cần tự đảm bảo mã hợp lệ và an toàn.
Tính năng không tự kiểm tra cú pháp HTML/CSS/JavaScript. Nếu chèn script lỗi hoặc CSS ghi đè quá rộng, giao diện admin có thể hiển thị sai hoặc phát sinh lỗi JavaScript.
Nội dung chỉ có hiệu lực rõ ràng sau khi tải lại trang admin hoặc mở trang admin mới. Việc bấm lưu không tự reload toàn bộ giao diện.
Nếu muốn gỡ bỏ mã đã chèn, chỉ cần xóa trắng ô tương ứng rồi bấm Lưu.

Hướng dẫn thao tác trên admin

Đăng nhập vào admin bằng tài khoản có quyền truy cập phần cài đặt hỗ trợ.
Screenshot 2026-08-10 at 22.02.21.png
Từ menu admin, vào:
EzySupport → Cài đặt
Trong trang cài đặt, kéo tới mục:
Mã nguồn
Tại đây có hai ô nhập:
  • Bổ sung đầu trang cho admin
  • Bổ sung cuối trang cho admin
Nhập mã cần chèn vào ô phù hợp.
Ví dụ cho đầu trang:
<style>
.admin-custom-note {
    color: #0f766e;
    font-weight: 600;
}
</style>
Ví dụ cho cuối trang:
<script>
console.log('Admin customization loaded');
</script>
Bấm Lưu trong mục Mã nguồn.
Sau khi thấy thông báo lưu thành công, tải lại trang admin hoặc mở một trang admin khác để kiểm tra kết quả.

Khuyến nghị sử dụng

Nên đặt CSS, <link> stylesheet hoặc metadata vào phần đầu trang.
Nên đặt JavaScript vào phần cuối trang để tránh chạy quá sớm khi DOM chưa sẵn sàng.
Không nên chèn script từ nguồn không tin cậy. Vì mã này chạy trong khu vực admin, nó có quyền tác động trực tiếp tới trải nghiệm và dữ liệu đang hiển thị cho quản trị viên.
Với thay đổi lớn hoặc script phức tạp, nên thử trước trên môi trường staging.