Formidable Documentation

Introduction

Formidable is a flexible and powerful form builder package for Concrete 5. It allows you to create custom forms, manage submissions, and integrate with other services—all from the Concrete 5 dashboard.

Installation

Prerequisites

• Concrete 5 version 9.0 or higher
• Access to your site's filesystem and dashboard

Steps

1. Download or Clone the Package

   Download the Formidable package or clone it from your repository:

   git clone https://github.com/your-username/formidable.git
   

2. Move the Package

   Place the formidable folder in the packages directory of your Concrete 5 installation:

   /path/to/concrete5/packages/formidable
   

3. Install via Dashboard

   • Log in to your Concrete 5 dashboard.
   • Go to Extend Concrete5 (/dashboard/extend/install).
   • Find Formidable in the list and click Install.

Configuration

Basic Settings

After installation, configure Formidable via the dashboard:

1. Go to Dashboard > Formidable.
2. Click Settings.
3. Configure options such as:
   • Default email address for notifications
   • Data storage preferences
   • CAPTCHA and spam protection
   • File upload settings

Permissions

• Set permissions for who can create, edit, and view forms and submissions.
• Go to Dashboard > System & Settings > Permissions & Access.

Integrations

• Enable integrations (e.g., Mailchimp, Zapier) from the Integrations tab in Formidable settings.
• Enter API keys and configure mapping as needed.

Usage

Creating a Form

1. Go to Dashboard > Formidable > Forms.
2. Click Add Form.
3. Use the drag-and-drop builder to add fields (text, email, dropdown, file upload, etc.).
4. Configure field properties, validation, and conditional logic.
5. Save the form.

Embedding a Form

• Use the Formidable Block to embed a form on any page:
  1. Edit the page where you want the form.
  2. Add a block and select Formidable.
  3. Choose your form from the dropdown.

Managing Submissions

• View submissions in Dashboard > Formidable > Submissions.
• Export submissions to CSV or Excel.
• Filter and search submissions by form, date, or field value.

Notifications

• Configure email notifications for admins and users in the form settings.
• Customize email templates and recipients.

Advanced Features

• Conditional Logic: Show/hide fields based on user input.
• Custom Validation: Add regex or custom PHP validation.
• Multi-Step Forms: Split long forms into multiple steps.
• File Uploads: Allow users to upload files with their submission.

Troubleshooting

• Form not displaying: Check permissions and ensure the block is configured correctly.
• Emails not sending: Verify email settings and server configuration.
• File uploads failing: Check upload folder permissions and max file size settings.

Uninstallation

1. Go to Dashboard > Extend Concrete5.
2. Find Formidable and click Uninstall.
3. Optionally, remove the package folder from /packages.

Support

• For help, visit the Concrete CMS Community Forums.
• Check the package documentation or contact the developer.

Happy form building!