pfaffenrodt/flux

The flux package from FluidTYPO3

Thursday, August 31, 2017
by pfaffenrodt
Repository
1 Watchers
0 Stars
17 Installations

PHP
0 Dependents
0 Suggesters
162 Forks
0 Open issues
25 Versions
13 % Grown

The README.md

, _(*1)

Flux: Fluid FlexForms

, _(*2)

Flux is a replacement API for TYPO3 FlexForms - with interfaces for Fluid, PHP and TypoScript, _(*3)

Flux lets you build and modify forms in Fluid:, _(*4)

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

In PHP:, _(*5)

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

In plain arrays (to allow sources like JSON):, _(*6)

$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:, _(*7)

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., _(*8)

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

The Versions

31/08 2017

dev-development

dev-development http://fluidtypo3.org

The flux package from FluidTYPO3

typo3-cms-extension flux

The flux package from FluidTYPO3

pfaffenrodt/flux

The README.md

Flux: Fluid FlexForms

Flux feature highlights

Known issues

Documentation

The Versions

dev-development

The Requires

The Development Requires

dev-master

The Requires

The Development Requires

8.2.1.x-dev

The Requires

The Development Requires

8.2.1.1

The Requires

The Development Requires

dev-staging

The Requires

The Development Requires

8.2.1

The Requires

The Development Requires

8.2.0

The Requires

The Development Requires

8.1.0

The Requires

The Development Requires

8.0.2

The Requires

The Development Requires

8.0.1

The Requires

The Development Requires

dev-legacy

The Development Requires

8.0.0

The Requires

The Development Requires

7.4.0

The Development Requires

7.3.0

The Development Requires

7.2.3

The Development Requires

7.2.2

The Development Requires

7.2.1

The Development Requires

7.2.0

The Development Requires

dev-workbench/classconstant

The Development Requires

7.1.2

The Development Requires

7.1.1

The Development Requires

dev-workbench/package

The Development Requires

7.1.0

7.0.0

dev-workbench/relationsettings