Đây là hướng dẫn chi tiết về heritage, giao diện mặc định của Zittme. heritage là giao diện chính thức đi kèm lõi từ phiên bản 0.0.02, viết lại cấu trúc bố cục mặc định thời XE (menu trên cùng 2 cấp · thanh trượt hình ảnh · LNB trang con) bằng template v2 và thiết kế lại theo chuẩn hiện nay. Hỗ trợ sẵn chế độ tối và giao diện đáp ứng.

Thành phần

Mọi thành phần dùng chung một bộ design token (màu · phông chữ · khoảng cách) nên dù chuyển sang màn hình nào, tông màu vẫn thống nhất. Phông chữ mặc định là Pretendard.

Áp dụng

1. Vào Quản trị > Cài đặt thiết kế.
2. Chọn heritage trong danh sách giao diện và nhấn Áp dụng.
3. Layout và skin của từng mô-đun được áp dụng cùng lúc. Nếu muốn bỏ một thành phần nào đó, hãy bỏ chọn nó ở màn hình áp dụng.

Việc áp dụng giao diện ghi nhớ trạng thái trước đó, nên bạn có thể quay lại trạng thái trước khi áp dụng bất cứ lúc nào. Giao diện đang dùng sẽ bị vô hiệu hóa nút Xóa trong danh sách giao diện đã cài.

Toàn bộ mục cài đặt layout

Thay đổi tại Quản trị > Cài đặt layout, hoặc trong khi xem trang, tại mục "Cài đặt layout" của thanh quản trị phía trước ở góc dưới bên trái. Các cài đặt được chia thành 4 nhóm (tab).

Cơ bản

Mục	Mặc định	Mô tả
Kiểu bố cục	Trang con (LNB menu bên trái)	Kiểu mặc định trong: Chính (thanh trượt hình ảnh) / Trang con (LNB bên trái) / Trang con (nội dung toàn chiều rộng). Để ghi đè theo từng trang, xem "Loại trang" bên dưới
Ảnh logo	Không có	Hiển thị theo chiều cao chuẩn 40px. Để trống thì dùng chữ logo
Chữ logo	Không có	Để trống thì hiển thị tiêu đề trang
Màu nhấn	#6c5ce0	Quyết định luôn cả màu nút · liên kết · trạng thái đang chọn và màu nhấn của skin bảng tin
Chiều rộng tối đa của nội dung	1180px	Hẹp 1060 / Mặc định 1180 / Rộng 1320
Chiều rộng thanh menu	Theo chiều rộng nội dung	Nếu chọn "Phủ kín 100% hai bên", nền thanh sẽ kéo dài đến mép màn hình
Màu thanh menu	Tối	Tối / Màu nhấn / Sáng
Chế độ màu	Theo cài đặt thiết bị của khách truy cập	Tự động / Luôn sáng / Luôn tối

Màn hình đầu (thanh trượt hình ảnh)

Mục	Mặc định	Mô tả
Hiển thị thanh trượt hình ảnh	Chỉ khi ở kiểu Chính	Chỉ khi ở kiểu Chính / Hiển thị cả ở trang con / Không dùng. Nếu không đăng ký slide nào thì sẽ không hiển thị
Khoảng thời gian tự chuyển (giây)	6	Đặt 0 thì không tự chuyển
Slide hình ảnh	Không có	Trường lặp. Dùng nút Thêm để đăng ký nhiều slide và kéo thả để đổi thứ tự

Các mục của 1 slide: ảnh nền, tiêu đề, mô tả, tên nút, liên kết nút, căn lề chữ (trái/giữa).

Nội dung · thanh bên

Mục	Mặc định	Mô tả
Dùng tìm kiếm tích hợp	Bật	Có hiển thị ô tìm kiếm ở đầu trang hay không
Hiển thị hộp đăng nhập ở thanh bên	Tắt	Hiển thị widget đăng nhập ở thanh bên của trang con (LNB). Nếu tắt thì chỉ dùng liên kết đăng nhập ở menu trên cùng

Chân trang

Mục	Mô tả
Lời giới thiệu trang	Đoạn giới thiệu bên trái chân trang
Thông tin doanh nghiệp · liên hệ	Mỗi dòng xuống dòng được hiển thị thành một mục (tên công ty · người đại diện · mã số doanh nghiệp · địa chỉ, v.v.)
Ghi chú bản quyền	Dòng bản quyền ở cuối chân trang

Menu chân trang sẽ hiển thị khi bạn liên kết các mục vào "Menu chân trang" (footer_menu) trong phần Chỉnh sửa menu trang (1 cấp).

Loại trang (lớp menu m / sl / sf)

heritage hiển thị mỗi trang theo một trong ba khung.

Loại	Lớp menu	Hình thức
Kiểu chính	m	Dành cho trang chủ, có hiển thị hình ảnh chính (thanh trượt)
Kiểu trang con	sl	Trang nội bộ thông thường. Nếu menu hiện tại có menu con thì LNB bên trái sẽ hiển thị cùng
Kiểu trang con toàn chiều rộng	sf	Trang không có LNB, nội dung dùng toàn bộ chiều rộng

Cách chỉ định

1. Mở mục menu tại Quản trị > Chỉnh sửa menu trang.
2. Nhập một trong m, sl, sf vào ô Lớp.
3. Sau khi lưu, trang được vào qua menu đó sẽ hiển thị theo loại tương ứng.

Quy tắc hoạt động:

• Menu không chỉ định lớp sẽ theo Kiểu bố cục trong cài đặt layout (mặc định: Trang con).
• Nếu đặt lớp cho menu con thì tại trang đó giá trị của menu con được ưu tiên hơn menu cha; nếu menu con không chỉ định thì kế thừa lớp của menu cha (tối đa 3 cấp).
• Có thể ghi chung với lớp khác trong ô lớp, cách nhau bằng dấu cách. Ví dụ: sf highlight
• Các màn hình thành viên · tin nhắn · zittme Pay · tìm kiếm tích hợp sẽ tự động dùng toàn chiều rộng nếu không chỉ định lớp.

Kết hợp với hình ảnh chính

• Hiển thị hình ảnh "Chỉ khi ở kiểu Chính" (mặc định) + m cho menu trang chủ : cấu hình thông thường, thanh trượt chỉ hiện ở trang chủ
• Hiển thị hình ảnh "Hiển thị cả ở trang con" : thanh trượt ở đầu mọi trang, bất kể loại trang
• Hiển thị hình ảnh "Không dùng" : không hiển thị ở đâu cả

LNB (menu con bên trái)

Ở trang kiểu trang con (sl), nếu menu cấp 1 hiện tại có menu con thì danh sách menu con sẽ tự động hiện ở bên trái. Menu không có menu con chỉ hiển thị nội dung, không có LNB. Với trang không cần LNB, hãy chỉ định sf.

Menu trên cùng (GNB)

• Hiển thị các mục được liên kết vào "Menu trên cùng" (gnb) trong Chỉnh sửa menu trang, hỗ trợ tới 3 cấp. Di chuột lên menu cấp 1 thì menu con sẽ mở ra.
• Màu thanh menu (tối/màu nhấn/sáng) và chiều rộng (theo nội dung/toàn chiều rộng) được thay đổi ở nhóm Cơ bản trong cài đặt layout.
• Góc trên bên phải hiển thị đăng nhập/đăng xuất, nút chuyển chế độ tối và ô tìm kiếm tích hợp.

Skin bảng tin

Chọn heritage_default tại Cài đặt bảng tin > Cài đặt skin. Vì là giao diện đáp ứng nên không cần skin di động riêng.

• Kiểu hiển thị danh sách theo cài đặt của bảng tin.
• Số bình luận được hiển thị dạng [N] bên cạnh tiêu đề.
• Huy hiệu bài mới (N) theo "Thời gian hiển thị bài mới" trong cài đặt bảng tin (mặc định 24 giờ).
• Màu nhấn được liên kết với màu nhấn của layout.

Chế độ tối

• Nếu chế độ màu là "Tự động" thì theo cài đặt sáng/tối trên thiết bị của khách truy cập, và khách cũng có thể tự đổi bằng nút chuyển ở đầu trang (lưu theo từng thiết bị).
• Các skin bảng tin · thành viên · tin nhắn · thương mại cũng được chuyển theo.
• Nếu ảnh logo không nhìn thấy trên nền tối, bạn nên dùng logo nền trong suốt thay cho logo dành cho nền sáng.

Tùy biến (biến CSS)

heritage quản lý màu bằng biến CSS. Phần lớn chỉ cần đổi màu nhấn là đủ, nhưng để chỉnh chi tiết hơn, hãy định nghĩa lại biến trong CSS con. Nếu sửa trực tiếp tệp bố cục, thay đổi có thể bị ghi đè khi cập nhật giao diện.

Biến	Ý nghĩa
--hr-brand	Màu nhấn (giá trị cài đặt layout được đưa vào)
--hr-ink	Màu chữ nội dung
--hr-muted	Màu chữ phụ
--hr-bg	Nền trang
--hr-surface	Nền thẻ · bảng điều khiển
--hr-line	Đường phân cách
--hr-nav-bg	Nền thanh menu
--hr-w	Chiều rộng tối đa của nội dung (giá trị cài đặt layout)

Cấu trúc trang chính

Khuyến nghị kết hợp layout heritage + Widget nội dung tổng hợp. Chỉ định menu trang chủ là m (kiểu chính) để hiện thanh trượt hình ảnh, rồi xếp Widget nội dung tổng hợp theo từng hàng trong nội dung trang bên dưới là bạn có trang chính kiểu cổng thông tin. Hãy chọn skin widget "Heritage" để thống nhất cách hiển thị với bảng tin. Xem chi tiết ở tài liệu "Widget nội dung tổng hợp" trong Tài liệu chính thức.

Câu hỏi thường gặp

• Thanh trượt hình ảnh không hiện: Hãy kiểm tra theo thứ tự ① đã đăng ký ít nhất 1 slide chưa ② hiển thị hình ảnh có đang là "Không dùng" không ③ trang hiện tại có phải kiểu chính (m) không (khi cài đặt hiển thị là "Chỉ khi ở kiểu Chính").
• Menu bên trái (LNB) không hiện: Trang phải là kiểu trang con (sl) và menu cấp 1 hiện tại phải có menu con.
• Chế độ tối không được áp dụng: Hãy kiểm tra chế độ màu có đang bị cố định ở "Luôn sáng" không.
• Một số màn hình mô-đun vẫn là thiết kế mặc định: Hãy kiểm tra skin trong cài đặt mô-đun đó đã chọn heritage_default chưa. Nếu bạn đã bỏ chọn khi áp dụng giao diện, bạn có thể chọn lại từng cái.
• Đổi màu nhấn nhưng chỉ một phần thay đổi: Có thể do bộ nhớ đệm. Hãy vào Quản trị > Tạo lại bộ nhớ đệm rồi tải lại trang.
• Không thấy nút Viết bài · Danh sách hoặc chữ Lượt xem · Đề xuất ở danh sách bảng tin: Đây là lỗi của phiên bản 1.0.4 trở xuống. Hãy nâng lên 1.0.5 trở lên rồi vào Quản trị > Tạo lại bộ nhớ đệm.
• Xem bằng ngôn ngữ khác tiếng Hàn nhưng một số câu chữ vẫn hiện tiếng Hàn: Ở 1.0.5, các câu chữ tiếng Hàn cố định còn sót trong skin đã được dọn dẹp. Màn hình thương mại cần thương mại 0.2.7 trở lên, màn hình đặt chỗ cần mô-đun đặt chỗ cũng ở bản mới nhất.