Giao diện
Cài đặt và sử dụng
Cài đặt
Plugin @digiforce-nc/plugin-block-template cần cả client và server. Kích hoạt qua trang Plugin Manager.
Sau khi cài, plugin tạo hai bảng trong database: blockTemplates và blockTemplateLinks.
Lưu block thành template
- Mở trang ở chế độ thiết kế (Schema Editor).
- Click Settings (biểu tượng bánh răng) trên block đã cấu hình xong.
- Chọn Save as template.
- Đặt tên và mô tả cho template.
- Template được lưu vào database, sẵn sàng tái sử dụng.
Sử dụng template
Tạo block từ template
- Click Add block → chọn Template (hoặc tìm trong danh sách block type tương ứng).
- Danh sách template hiện ra — lọc theo type (form, table, details...).
- Chọn template → block mới được tạo với cấu hình sẵn từ template.
Hai chế độ sử dụng
| Chế độ | Mô tả | Khi nào dùng |
|---|---|---|
| Duplicate | Tạo bản sao độc lập — sửa block không ảnh hưởng template | Muốn tùy chỉnh riêng |
| Inherited | Block liên kết với template — thay đổi template cập nhật tất cả | Muốn đồng bộ nhiều block |
Quản lý template
Vào Settings → Block Templates để quản lý:
- Danh sách template: Xem tất cả template đã tạo, lọc theo type.
- Preview: Xem trước layout template.
- Xóa: Xóa template không còn sử dụng (block inherited sẽ chuyển thành độc lập).
Chuyển đổi block ↔ template
| Hành động | Mô tả |
|---|---|
| Block → Template | Save as template từ menu Settings của block |
| Template → Block | "Convert to normal block" để ngắt liên kết inherited |
| Unlink | Giữ cấu hình hiện tại nhưng ngắt liên kết với template gốc |
Mẹo
Sử dụng template inherited khi nhiều trang cần block giống nhau (VD: form nhập liệu chuẩn). Thay đổi template một lần, tất cả block liên kết tự cập nhật.