README

A Craft CMS plugin that provides a paragraph field type for Verbb's Formie form builder, allowing styled paragraph content with configurable text sizes and Twig template support.

⚠️ Beta Notice

This plugin is currently in active development and provided under the MIT License for testing purposes.

Licensing is subject to change. We are finalizing our licensing structure and some or all features may require a paid license when officially released on the Craft Plugin Store. Some plugins may remain free, others may offer free and Pro editions, or be fully commercial.

If you are using this plugin, please be aware that future versions may have different licensing terms.

Requirements

• Craft CMS 5.0 or greater
• PHP 8.2 or greater
• Formie 3.0 or greater

Features

Flexible Text Sizing

• 5 Built-in Sizes: From Extra Small to Extra Large with responsive design
• Configurable Options: Add custom text sizes via config file
• Plugin Settings: Set default text size for new paragraph fields

Rich Content Support

• Twig Rendering: Content supports translations, variables, and filters
• Multi-line Content: Rich paragraph content with proper formatting
• Translation Ready: Works seamlessly with Craft's translation system

Seamless Integration

• Native Formie field type
• Inherits site's paragraph styling
• Responsive design out of the box
• Backward compatible with existing forms

Installation

Via Composer

cd /path/to/project

composer require lindemannrock/craft-formie-paragraph-field

./craft plugin/install formie-paragraph-field

Using DDEV

cd /path/to/project

ddev composer require lindemannrock/craft-formie-paragraph-field

ddev craft plugin/install formie-paragraph-field

Via Control Panel

In the Control Panel, go to Settings → Plugins and click "Install" for Formie Paragraph Field.

Configuration

Plugin Settings

Navigate to Settings → Plugins → Formie Paragraph Field to configure:

• Default Text Size: Set the default size for new paragraph fields

Config File

Create a config/formie-paragraph-field.php file to override default settings:

cp vendor/lindemannrock/craft-formie-paragraph-field/src/config.php config/formie-paragraph-field.php

Example configuration:

// config/formie-paragraph-field.php
return [
    // Plugin name (optional - usually set via Control Panel)
    'pluginName' => 'Custom Paragraph Field',

    // Default text size for new fields
    'defaultTextSize' => 'textLG',

    // Custom text size options (replaces built-in options when defined)
    'customTextSizes' => [
        'textHuge' => [
            'label' => 'Huge',
            'classes' => 'text-2xl md:text-4xl lg:text-6xl'
        ],
        'textBrand' => [
            'label' => 'Brand Text',
            'classes' => 'font-brand text-brand-primary custom-spacing'
        ]
    ]
];

See Configuration Documentation for all available options.

Note:

• You can use any CSS classes - Tailwind, Bootstrap, or your own custom styles
• When customTextSizes is defined, it replaces the built-in options entirely
• Without a config file, you get 5 built-in text sizes (XS to XL)

Built-in Text Size Classes

Usage

Adding a Paragraph Field

1. Open your form in Formie's form builder
2. Click "Add Field" and select "Paragraph"
3. Configure the field:
   • Content: Enter paragraph text (supports Twig syntax)
   • Text Size: Choose from available size options
4. The content renders with proper styling and responsive sizing

Twig Content Examples

{# Simple text #}
Welcome to our website!

{# With translations #}
{{ 'Welcome to our website!'|t }}

{# With variables #}
Hello {{ currentUser.name }}!

{# With filters #}
{{ 'important message'|upper }}

{# Multi-line content #}
This is the first paragraph.

This is the second paragraph with {{ 'translation'|t }}.

Templating

Paragraph fields are rendered automatically by Formie:

{# Render the entire form #}
{{ craft.formie.renderForm('contactForm') }}

{# Or render specific field #}
{% set form = craft.formie.forms.handle('contactForm').one() %}
{{ craft.formie.renderField(form, 'paragraphField') }}

Support

• Documentation: https://github.com/LindemannRock/craft-formie-paragraph-field
• Issues: https://github.com/LindemannRock/craft-formie-paragraph-field/issues
• Email: support@lindemannrock.com

License

This plugin is licensed under the MIT License. See LICENSE for details.

Developed by LindemannRock

Built for use with Formie by Verbb