touch5/t5button2form

Adds a content element button2form, witch is a call to action button to a form

1.2.6 2025-09-18 14:43 UTC

Requires

• friendsoftypo3/content-blocks: ^1.0
• typo3/cms-core: ^12.0 || ^13.0

Replaces

• typo3-ter/t5button2form: 1.2.6

GPL-2.0-or-later

• Michael Scheunemann

README

This extension adds a content element that creates a button linking to a form, with the ability to pass a subject parameter to the form.

Features

• Choose between Bootstrap and Outline button styles
• Select from various button colors (primary, secondary, success, etc.)
• Define a button label
• Link to a specific page
• Pass a subject parameter to a form

Installation

Install the extension using Composer:

composer require touch5/t5button2form

Global Configuration

The extension provides global configuration options that can be set in the TYPO3 Extension Manager:

Extension Configuration

1. Enable Touch5 Group: Enable or disable the Touch5 group in the new content element wizard.
2. Group Name: Change the name of the group in the new content element wizard.

To access these settings:

1. Go to the TYPO3 backend
2. Navigate to Admin Tools > Settings > Extension Configuration
3. Select "t5button2form" from the list
4. Adjust the settings as needed
5. Save the configuration

Content Element Group

The extension registers a content element group in the new content element wizard. This group is configured in:

1. EditorInterface.yaml: Defines the group for the content block
2. config.yaml: Also defines the group for the content block
3. NewContentElementWizard.tsconfig: Defines the group globally for the TYPO3 backend

The group configuration can be customized through the extension configuration.

Usage

1. Add a new content element to your page
2. Select the "Button2Form" content element type from the "Touch5" group
3. Configure the button type, class, label, link, and subject
4. Save and close

How it works

The button creates a link to the selected page and passes the subject parameter as a query parameter. When a form on the target page has a field with the identifier "subject", the PreFormHook will automatically set the default value of that field to the subject parameter from the URL.

Example

<f:link.page pageUid="123" additionalParams="{subject: 'My Subject'}" class="btn btn-primary">
    Click me
</f:link.page>

This will create a link to page 123 with the subject parameter "My Subject". If there's a form on page 123 with a field with the identifier "subject", it will be pre-filled with "My Subject".