Back to Main Site

Hướng dẫn tạo Custom Blocks và Templates cho MTBuilder trên RISE CRM

Last updated on Nov 22, 2026 7:38 AM 7:38 AM 2,174.95 ms

MTBuilder trong PolyCMS cho RISE CRM vận hành trên bộ máy trạng thái Virtual DOM tách biệt hoàn toàn giao diện kéo thả lúc thiết kế khỏi mã HTML sạch hiển thị cho khách truy cập. Lập trình viên có thể đăng ký khối nội dung tùy biến từ bất kỳ sub-plugin nào thông qua API MTBuilder.registerBlock(), mở rộng bảng điều khiển bằng JavaScript filters, nhúng trực tiếp biểu mẫu thu thập khách hàng tiềm năng của RISE CRM và biên dịch gói tài nguyên nén bằng Webpack.

Kiến trúc cốt lõi và vòng đời lưu trữ

Khi biên tập viên nhấn Save trong MTBuilder, hai lớp dữ liệu đồng bộ được lưu vào cơ sở dữ liệu MySQL của RISE CRM (sử dụng tiền tố động {db_prefix}, mặc định là rise_):

  1. Lược đồ JSON Virtual DOM (mtbuilder_data): Lưu trong bảng {db_prefix}blog_page_meta (rise_blog_page_meta). Cây JSON này bảo toàn toàn bộ cấu trúc phần, hàng, cột, cấu hình thuộc tính và lớp CSS để các phiên chỉnh sửa sau tải lại đúng nguyên trạng bố cục.
  2. Bộ nhớ đệm HTML sạch (content): Được biên dịch qua generateCleanHtml(), loại bỏ hoàn toàn khung bọc trình dựng, lớp phủ kéo thả và điều khiển quản trị trước khi ghi trực tiếp vào bảng {db_prefix}blog_pages (rise_blog_pages), giúp trang công khai đạt tốc độ tải gần như tức thì.

Các mẫu toàn trang và Template Parts tái sử dụng được lưu trong {db_prefix}blog_mtbuilder_templates (cùng các mẫu giao diện dựng sẵn trong rise_blog_templates / rise_blog_mtbuilder_templates).

API đăng ký khối bằng JavaScript

Lập trình viên đăng ký khối kéo thả mới từ sub-plugin PolyCMS thông qua MTBuilder.registerBlock(blockType, config). Mỗi khối khai báo nhóm thanh bên, biểu tượng, lược đồ cấu hình Inspector và hàm render() hỗ trợ song song hai ngữ cảnh (xem trước trong Editor và mã thực thi ngoài Frontend).

Ví dụ: Tạo khối Biểu mẫu Thu thập Khách hàng RISE CRM

Tạo tệp plugins/polycms/plugins/my-custom-plugin/assets/js/crm-lead-block.js:

MTBuilder.registerBlock('rise_crm_lead_form', {
    name: 'RISE CRM Lead Capture Form',
    icon: 'fa fa-user-plus',
    group: 'crm_integrations',
    acceptChildren: false,

    // Khai báo cấu hình hiển thị trên thanh bên Inspector
    settingsSchema: [
        {
            key: 'formId',
            label: 'Mã biểu mẫu RISE Lead',
            type: 'select',
            options: {
                '1': 'Biểu mẫu đăng ký nhận tin & tư vấn',
                '2': 'Biểu mẫu yêu cầu demo doanh nghiệp'
            },
            default: '1'
        },
        {
            key: 'bgColor',
            label: 'Màu nền',
            type: 'color',
            default: '#f8fafc'
        },
        {
            key: 'buttonText',
            label: 'Nhãn nút xem trước',
            type: 'text',
            default: 'Gửi yêu cầu'
        }
    ],

    // Hàm render cho cả khung soạn thảo Editor lẫn trang công khai Frontend
    render: function (node, renderChild, isFrontend) {
        const el = document.createElement('div');
        const formId = encodeURIComponent(node.settings.formId || '1');
        const bgColor = node.settings.bgColor || '#f8fafc';
        const btnText = node.settings.buttonText || 'Gửi yêu cầu';

        el.className = 'mtb-rise-lead-wrap rounded shadow-sm p-4 w-100';
        el.style.backgroundColor = bgColor;

        if (isFrontend) {
            // Frontend công khai: nhúng biểu mẫu thu thập Lead thực tế của RISE CRM
            el.innerHTML = `
                <div class="rise-crm-lead-form">