Documentation

Installation

1. Download or install via Marketplace
2. Copy plugin to:

plugins/okle/forms

3. Run migrations:

php artisan october:up

Creating a Form

1. Go to Forms in backend
2. Create a new form
3. Add groups
4. Add fields inside groups
5. Configure layout and validation
6. Save and publish

Rendering a Form

Use the component:

[formDisplay] slug = "your-form-slug"

Twig:

{% component 'formDisplay' %}

Field Types

Supported field types include:

• Text
• Textarea
• Select
• Radio
• Checkbox
• File upload
• Date / Time
• Hidden
• Custom types

Validation Rules

Each field can have validation rules such as:

• required
• email
• min / max
• digits
• url

Validation errors are automatically handled by October AJAX framework.

Layout Configuration

Each field supports layout width:

• 12 (full width)
• 6 (half width)
• custom (1–12)

Fields are rendered in a responsive grid.

Email Notifications

You can configure:

• Admin notifications
• Auto-reply to user
• Custom email templates

CRM Integration

Forms can send data to external systems:

• Map fields to API keys
• Configure integration per form
• Send data after submission

Extending the Plugin

You can override partials:

components/formdisplay/ default.htm group.htm field.htm

Troubleshooting

Form not submitting

Make sure your layout includes:

{% framework %} {% framework extras %}

Validation not working

Add:

data-request-validate

Support

For issues or feature requests, please contact the author.