Download the PHP package tritum/form-element-linked-checkbox without Composer

On this page you can find all versions of the php package tritum/form-element-linked-checkbox. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package form-element-linked-checkbox

TYPO3 extension Total downloads Stability CGL TYPO3 versions Latest version

Custom form element "Linked checkbox"

This TYPO3 extension adds a custom form element "Linked checkbox" to the TYPO3 form framework. The user is able to define the link target and the link text.

Known incompatibilities

This extension is not fully compatible with EXT:form-mailtext. Both extensions override the same Fluid templates. Create a copy within your site package, adapt the template accordingly and configure TYPO3 properly to use this template.

Installation and configuration

Preferred Installation

  1. Require the extension via composer.
  2. Add the static TypoScript configuration to your TypoScript template.

Customization

The extension overrides templates for the following views:

This is necessary to render links correctly. By default, the core templates of the form framework escape any HTML in both email and plain text mails. Thus, your users would receive mails with broken links.

If you also override those templates, please adopt your files accordingly.

Usage

Open the TYPO3 form editor and create a new form/open an existing one. Add a new element to your form. The modal will list the new custom form element "Linked checkbox". Provide a label for the checkbox including the link text. Select a page you want to link to.

Combination of label and link

The default label consists of the label itself, followed by a link to the specified page with the given link text.

Example:

If want to use the link inside your label, define the link position in the label with a character substitution. We highly recommend this way.

Example:

You can also use more than one link in the checkbox label. For this, just use the field additionalLinks and provide a combination of Page UID and link text.

Example:

Link configuration

You can provide additional link configuration which will be used when generating the link within the label. Note that this can only be defined in the appropriate .form.yaml file but not in the form editor and applies to all generated links.

For a full list of available configuration take a look at the TypoScript reference.

Override default link target

By default, the link target is set to _blank. If you want to override it, just define a custom link configuration parameter – either an empty string or a custom target/additional parameter configuration:

Possible improvements or changes

Instead of creating a new form element, the existing Checkbox form element could have been extended. In order to provide a more complex example, the extension creates a new element.

At the time of writing this, you have to provide a small JavaScript snippet (see \Resources\Public\JavaScript\Backend\FormEditor\ViewModel.js). This snippet is needed to show the custom form element in the form editor. For future TYPO3 versions we are aiming to remove this stumbling block to smoothen the element registration.

Versions

News TYPO3 PHP Notes
master 11 - 12 7.4 - 8.2
4.x 11 - 12 7.4 - 8.2 Breaking changes. See comments below.
3.x 9 - 11 7.2 - 8.1 Breaking changes. See comments below.
2.x 9 - 11
1.x 8 - 9

Breaking changes version 4.x

Version 4.x includes the following breaking changes:

Breaking changes version 3.x

Version 3.x includes the following breaking changes:

Credits

This TYPO3 extension was created by Björn Jacob and has been highly improved by Elias Häußler. The idea was born at the TYPO3 CertiFUNcation Day 2017. The audience of my talk kindly asked for such an element. Lightheaded, I said it will not take more than 30 minutes to create such an extension. Unfortunately, I could not make it in this time. It took my 1.5 hours to come up with the initial version code. The JS part gave me a hard time.

Thank you

Jochen Weiland - TYPOholic at jweiland.net - supported this challenge in multiple ways. Thanks for being an outstanding part of our TYPO3 community.

Elias Häußler - Best man, providing awesome PRs and providing the beautiful TYPO3 badges. Use them. Give him some kudos!

All versions of form-element-linked-checkbox with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
symfony/polyfill-php80 Version ^1.15
typo3/cms-core Version ^11.5.0 || ^12.4.0
typo3/cms-form Version ^11.5.0 || ^12.4.0
typo3/cms-frontend Version ^11.5.0 || ^12.4.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tritum/form-element-linked-checkbox contains the following files

Loading the files please wait ....