Mã tùy chỉnh
Thêm CSS, script và mã nhúng cho toàn website. Lưu một lần, áp dụng ngay cho preview và website; cấu hình được giữ khi đổi theme.
Cấu hình trên website
- Mở website → Cài đặt → Mã tùy chỉnh.
- Bật “Mã tùy chỉnh”.
- Nhập CSS, mã Head hoặc mã cuối Body, rồi bấm “Lưu thay đổi”.
- Tải lại trang preview hoặc website để xem kết quả.
Người quản lý cần quyền sửa mã nguồn source.edit. Chỉ thêm script từ nguồn tin cậy: mã chạy trong trình duyệt của khách truy cập. Tắt công tắc và lưu để ngừng chèn mã, vẫn giữ lại nội dung.
Các vùng cấu hình
| Key | Nội dung | Vị trí |
|---|---|---|
enabled | Bật/tắt toàn bộ mã tùy chỉnh | Áp dụng cho cả ba vùng |
custom_css | CSS thuần, không kèm thẻ style | Trong head_content, trước head_code |
head_code | HTML: meta, link, script | Cuối head |
body_end_code | HTML: script, widget hoặc mã nhúng | Cuối body |
Mỗi vùng tối đa 256 KiB. CSS không được chứa thẻ đóng style. Nội dung được lưu nguyên văn, không xử lý thành template Lingo.
Tích hợp vào theme
Đặt mỗi biến đúng một lần trong layout gốc, sau tài nguyên của theme:
<head>
<!-- Meta, CSS và stack của theme -->
{{ head_content }}
</head>
<body>
<!-- Nội dung, script và stack của theme -->
{{ body_end_content }}
</body>
head_content xuất CSS đã bọc thẻ style rồi mã Head. body_end_content xuất mã cuối Body. Engine trả HTML an toàn để render, không cần filter safe. Khi tắt cấu hình, cả hai biến trả chuỗi rỗng.
Các stack head/style/script của theme tiếp tục hoạt động như trước. Hai biến mới không tự di chuyển tài nguyên của theme. Theme cũ thiếu hook cần bổ sung vào tất cả layout tài liệu HTML được sử dụng; theme mẫu mới đã có sẵn.
Ví dụ
CSS tùy chỉnh:
.site-header { background: #123456; }
Mã trong Head:
<meta name="example-verification" content="your-verification-code">
Mã cuối Body:
<script>
console.log('Website custom code loaded');
</script>
Phạm vi và thời điểm áp dụng
Cấu hình thuộc application_id của website, lưu trong bảng website_custom_code; không nằm trong file hoặc phiên bản theme. Không có bước publish và không có phiên bản cấu hình riêng. Request tiếp theo đọc dữ liệu mới; website khác không nhận mã này.
Đổi theme giữ nguyên cấu hình, nhưng CSS dùng selector của theme cũ có thể cần sửa cho giao diện mới. Nếu chưa thấy thay đổi, kiểm tra công tắc, đúng website, hai hook trong layout và tải lại trình duyệt.