Hướng dẫn quản trị Template, Component, Position, Skin và LanguageKey
Giải thích từng giao diện cấu trúc template, các lựa chọn phạm vi trang, quan hệ module-skin và tác động khi sửa/xóa.
Giao diện danh sách Template
Mở Hệ thống → Template bằng quyền Admin. Template là bộ giao diện có component, vị trí, skin và khóa ngôn ngữ. Màn hình cấu hình cấu trúc dùng bởi doanh nghiệp, không phải trình kéo thả tạo file giao diện. Ví dụ T99 là tên template được doanh nghiệp gán trong cấu hình website; sửa cấu trúc có thể tác động nhiều trang cùng dùng template.
Tên / Hình: Mã template và ảnh nhận diện trong quản trị.
Dùng chung: Trạng thái công khai/dùng chung của định nghĩa template cho luồng chọn template có lọc cờ này; không tự xuất bản mọi nội dung.
Sử dụng: Cờ cho phép sử dụng template trong các luồng có áp dụng cờ này. Không đồng nghĩa công tắc tạm ẩn một bài hoặc đảm bảo website đang gán template sẽ được chuyển sang giao diện khác.
Bấm tên: Mở các khối LanguageKey, Component, Position và Skin của template đó.
Thêm / Sửa / Xóa: Quản lý định nghĩa; khi xóa phải đối chiếu doanh nghiệp và cấu hình đang sử dụng. Không dùng Xóa để đổi giao diện tạm thời.
Giao diện Thêm Template
Tên: Mã template phải phù hợp bộ tệp triển khai. Nhập Tên không tự tạo thư mục component/skin hoặc sao chép giao diện.
Hình: Ảnh giới thiệu template; chọn tệp rồi Thêm để ghi.
Dùng chung: Bật nếu định nghĩa dành cho luồng dùng chung phù hợp; tắt giữ phạm vi không công khai của định nghĩa.
Sử dụng: Chọn trạng thái hoạt động của định nghĩa theo nhu cầu triển khai.
Thêm / Đóng: Thêm ghi bản mới; Đóng bỏ phần chưa gửi.
Giao diện Cập nhật Template
Mở Sửa đúng tên, kiểm tra mã, hình, Dùng chung và Sử dụng rồi Lưu. Hai trạng thái trong form được ghi khi Lưu, không phải thay ngay mọi website vừa bấm checkbox. Giữ tên kỹ thuật phù hợp tệp và các tham chiếu; sửa ảnh template chỉ đổi ảnh giới thiệu, không thay logo website của doanh nghiệp.
Giao diện LanguageKey của Template
LanguageKey là mã câu chữ dùng chung, ví dụ nhãn nút hoặc tiêu đề khối mà template đọc. Đây không phải danh sách ngôn ngữ vi/en và không tự dịch bài viết. Bấm Thêm để mở ô Key, nhập mã rồi Lưu. Hủy đóng phần đang thêm. Xóa gỡ key theo xác nhận; kiểm tra code và các cấu hình ngôn ngữ đang dùng trước khi bỏ. Giao diện này không có form sửa key riêng: thay câu chữ người xem thấy ở Cấu hình ngôn ngữ của doanh nghiệp nếu key đó được cung cấp.
Giao diện danh sách và Thêm Component
Component là loại trang, chẳng hạn Article hoặc Articles nếu bộ template có triển khai. Danh sách hiển thị mã và mô tả. Bấm Thêm, nhập Tên component và Mô tả rồi Lưu; Hủy bỏ bản đang nhập. Tên phải trùng trang mà template có thể nạp. Một dòng DB không tự tạo trang ASPX hoặc logic lấy dữ liệu.
Giao diện Sửa Component
Bấm Sửa đúng dòng, đối chiếu Tên và cập nhật Mô tả/những trường form cho sửa, rồi Lưu. Kiểm tra danh mục đang chọn component, cấu hình SEO và các position thuộc component. Xóa component là thao tác tại danh sách với xác nhận, có thể làm các lựa chọn cấu hình trang không còn hợp lệ; không làm thay đổi bài viết thành một loại dữ liệu mới.
Giao diện danh sách và Thêm Position
Position là điểm đặt module/mã nhúng do template hoặc một component cung cấp. Danh sách hiển thị Component, Position, Mô tả. Bấm Thêm để khai báo nơi các cấu hình sẽ đặt nội dung.
Component — Tất cả các trang (Template): Giá trị rỗng tạo vị trí chung của template. Cần có vùng tương ứng trong tệp giao diện chung.
Component — một component cụ thể: Chọn mã và mô tả từ các component đã khai báo. Vị trí chỉ thuộc phạm vi trang đó, không tự trở thành vị trí chung.
Tên: Mã vị trí phải khớp điểm nạp module trong tệp template/component.
Mô tả: Tên dễ hiểu cho người chọn vị trí trong Cài đặt nâng cao.
Lưu / Hủy: Lưu tạo vị trí; Hủy bỏ phần chưa gửi.
Giao diện Sửa Position
Mở đúng cặp Component/Position, kiểm tra phạm vi trang, Tên và Mô tả rồi Lưu. Chuyển phạm vi hoặc mã vị trí có thể làm cấu hình cũ không còn khớp vùng hiển thị. Sau sửa rà các cấu hình module/mã nhúng dùng vị trí cũ. Xóa ở danh sách bỏ định nghĩa vị trí; không xem đây là cách xóa nội dung nguồn của các module.
Giao diện danh sách và Thêm Skin
Skin là cách trình bày một module trong template. Danh sách hiển thị Skin, Mô tả, Module. Bấm Thêm, chọn Module, nhập Tên skin và Mô tả rồi Lưu. Module lấy từ các định nghĩa hệ thống; Chọn Module là placeholder, không phải module hợp lệ. Khi chọn module ở form thêm, code tự điền Mô tả bằng mô tả module, nên sửa lại mô tả skin sau lần chọn cuối nếu muốn mô tả riêng.
Tên skin phải khớp tệp/triển khai của template. Thêm dòng skin không tự tạo bố cục. Ví dụ hai skin của cùng module có thể trình bày cùng bài theo dạng danh sách khác nhau; lựa chọn skin không tự nhân đôi dữ liệu bài viết.
Giao diện Sửa Skin
Mở Sửa, kiểm tra Tên, Module và Mô tả rồi Lưu. Đổi Module thay đổi chức năng mà skin được gắn; cần bảo đảm tệp skin tương thích dữ liệu và tham số module mới. Không chọn module theo mô tả gần giống khi chưa xác định hợp đồng dữ liệu. Xóa tại danh sách cần kiểm tra các ModuleConfig đang chọn skin; cấu hình website có thể mất cách hiển thị nếu skin không còn hợp lệ.
Quy trình kiểm tra cấu trúc template
- Xác nhận đúng template của doanh nghiệp và các tệp triển khai tương ứng.
- Khai báo component, position, skin và LanguageKey theo tệp thực tế.
- Tại doanh nghiệp, chọn cấu hình nguồn/module và đặt đúng vị trí.
- Nhập câu chữ theo ngôn ngữ khi template có sử dụng key.
- Mở từng loại trang liên quan, kiểm tra desktop/mobile, nguồn dữ liệu, liên kết và trạng thái cấu hình.
