Documentation

Script URL (CDN) Required

The public URL where your widget JavaScript file is hosted. This is the most important field - customers' websites will load this script.

Icon URL Optional

URL to an icon/image representing your widget. Makes widgets easier to identify visually in your dashboard. Recommended size: 64x64px to 128x128px. Formats: PNG, SVG, JPG.

1. Widget Script Integration

Your widget script has access to a global helper function window.submitWidgetForm() that sends form data to the API.

// Example usage in your widget
document.getElementById('form').addEventListener('submit', function(e) {
    e.preventDefault();
    
    const formData = {
        name: document.getElementById('name').value,
        email: document.getElementById('email').value,
        message: document.getElementById('message').value
    };
    
    window.submitWidgetForm(formData)
        .then(response => {
            console.log('Submitted!', response);
        });
});

2. Data Storage

Form submissions are stored in the database with:

• ✅ All form fields (as JSON)
• ✅ Automatic email extraction
• ✅ Name, phone, message extraction
• ✅ Page URL and metadata
• ✅ Status tracking (new, read, replied, archived)

3. WordPress Dashboard

The WordPress plugin automatically shows a "Submissions" menu item (with type-specific labels) where customers can:

Activate Widget

When a widget instance is active:

• ✅ Widget script loads on customer websites
• ✅ Form submissions are accepted
• ✅ Analytics are tracked
• ✅ All features work normally

Deactivate Widget

When a widget instance is inactive:

• ❌ Widget script does NOT load
• ❌ Form submissions are rejected
• ❌ Widget disappears from customer website
• ✅ Can be reactivated instantly

Step 1: Create System

1. Go to Applications → Create New System
2. Enter a descriptive name (e.g., "Customer Management System")
3. Optionally link to a widget instance
4. Add description and icon (optional)
5. Click "Create System"

Step 2: Define Data Models

1. Click "Add Data Model"
2. Define model name (e.g., "Lead", "Customer")
3. Add fields with types and labels
4. Define relationships to other models
5. Save the data model

Step 3: Create Modules

1. Click "Add Module"
2. Choose module type (List, Kanban, Form, etc.)
3. Select which data model to use
4. Set display order and icon
5. Configure module-specific settings

Step 4: Generate Plugin

1. Click "Generate Plugin"
2. Enter plugin details (name, version, author)
3. Download the ZIP file
4. Install on WordPress sites
5. Manage installations from dashboard