Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
TYPO3 extension Flux: Dynamic Fluid FlexForms
PHP JavaScript Other
Failed to load latest commit information.
Classes [BUGFIX] Recognise negative relative UID in ConfigurationManager
Resources Merge pull request #854 from jmverges/fixForDragAndDropWithLegacySupport
Tests [BUGFIX] Recognise negative relative UID in ConfigurationManager
.editorconfig [BUGFIX] Change wrong brace expressions
.gitignore [TASK] Run coverage on PHP 5.6
.travis.yml [TASK] Update dependencies and restrict testing to 6.2
CHANGELOG.md [DOC] Update changelog for 7.2.1 release
CONTRIBUTING.md [DOC] Update contribution guide link
LICENSE.md [TASK] Add license file
README.md [TASK] Replace build status badge with Travis version
bower.json [BUGFIX] Change bower name to fluidtypo3-flux
class.ext_update.php [TASK] CGL - Remove multiple variable assignment, fix indents and exc…
composer.json [TASK] Update dependencies and restrict testing to 6.2
composer.lock [TASK] Update dependencies and restrict testing to 6.2
ext_conf_template.txt [TASK] Remove the disableCompiler option
ext_emconf.php [TASK] Raise maximum supported TYPO3 core version to 7.4.99
ext_icon.gif [INIT] Initial Git import
ext_localconf.php [TASK] CGL - Remove multiple variable assignment, fix indents and exc…
ext_tables.php [BUGFIX] Fix relation problems with Save and New button
ext_tables.sql [BUGFIX] No prefix length for integer columns
phpunit.xml.dist [TASK] Configure phpunit to render without colors

README.md

Flux: Fluid FlexForms

Build Status Coverage Status Documentation Build Status Coverage Status

Flux is a replacement API for TYPO3 FlexForms - with interfaces for Fluid, PHP and TypoScript

Flux lets you build and modify forms in Fluid:

<flux:form id="myform">
  <flux:field.input name="myField" label="My special field" />
</flux:form>

In PHP:

$form = \FluidTYPO3\Flux\Form::create();
$form->setName('myform');
$form->createField('Input', 'myField', 'My special field');

In plain arrays (to allow sources like JSON):

$json = '{name: "myform", fields: [{"name": "myField", "type": "Input"}]}';
$asArray = json_decode($json, JSON_OBJECT_AS_ARRAY);
$form = \FluidTYPO3\Flux\Form::create($asArray);

And in TypoScript:

plugin.tx_flux.providers {
  myextension_myplugin {
    tableName = tt_content
    fieldName = pi_flexform
    listType = myextension_myplugin
    extensionKey = Vendor.MyPlugin
    form {
      name = myform
      fields {
        myField {
          type = Input
          label = My special field
        }
      }
    }
  }
}

All of which create the same form with a single input field called myField with a label value of My special field. The last example shows the form structure nested in a Provider (another Flux concept) which connects the pi_flexform field of the related tt_content plugin record type to the form.

Flux feature highlights

  • Added features for content elements - add content grids (following the backend_layout approach) to any content/plugin.
  • Multiple APIs to access the same features from many different contexts using the same naming and nesting style.
  • Multiple levels of API abstraction - when you need more control, lower API abstraction levels can be used in your code.
  • Flexible ways to replace individual parts: templates, controller actions, etc.
  • Manipulation of properties of existing forms - change field labels, default values, add fields, sheets, etc.
  • Data type transformations - define the desired target type and let the TypeConverters of Extbase handle conversion.
  • Possibility for custom components of your own - with the same API support any other Flux component has.
  • Several Utility-type classes for advanced integrations with Fluid in particular.

Known issues

  • Keep In mind to have your PHP/HTTP configured correctly to accept a fairly large number of input fields. When nesting sections / objects the number of fields submitted, rises drastically. The php.ini configuration setting to think about is max_input_vars. If this number is too small then the TYPO3 Backend (being PHP) will decline the submission of the backend editing form and will exit with an "Invalid CSRF Token" message because of incomplete (truncated) POST data.

Documentation

Something went wrong with that request. Please try again.