s_skaidocsTài liệu
CẤU HÌNH WEBSITE

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

  1. Mở website → Cài đặt → Mã tùy chỉnh.
  2. Bật “Mã tùy chỉnh”.
  3. Nhập CSS, mã Head hoặc mã cuối Body, rồi bấm “Lưu thay đổi”.
  4. 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

KeyNội dungVị trí
enabledBật/tắt toàn bộ mã tùy chỉnhÁp dụng cho cả ba vùng
custom_cssCSS thuần, không kèm thẻ styleTrong head_content, trước head_code
head_codeHTML: meta, link, scriptCuối head
body_end_codeHTML: script, widget hoặc mã nhúngCuố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.