flux

Flux: Fluid FlexFormen

Flux ist eine Ersatz-API für TYPO3 FlexForms - mit Schnittstellen für Fluid, PHP und TypoScript

Mit Flux können Sie Formulare in Fluid erstellen und ändern:

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

In PHP:

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

In einfachen Arrays (um Quellen wie JSON zuzulassen):

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

Und in TypoScript:

plugin.tx_flux.providers {
  myextension_myplugin {
    tableName = tt_content
    fieldName = pi_flexform
    listType = myextension_myplugin = myextension_myplugin
    extensionKey = Vendor.MyPlugin
    formular {
      name = myform
      felder {
        myField {
          typ = Eingang
          label = Mein Fachgebiet
        }
      }
    }
  }
}

Alle, die das gleiche Formular mit einem einzigen Eingabefeld namens myField mit einem Labelwert des Feldes My special erstellen. Die letzte beispiel zeigt die Formularstruktur, die in einen Provider verschachtelt ist (ein weiteres Flux-Konzept), der das pi_flexform-Feld des Parameters hat den Datensatztyp tt_content plugin auf das Formular bezogen.

Flux Feature-Highlights

• Zusätzliche Funktionen für Inhaltselemente - Fügen Sie Inhaltsraster (nach dem backend_layout-Ansatz) zu jedem Inhalt / Plugin hinzu.
• Mehrere APIs für den Zugriff auf dieselben Funktionen aus vielen verschiedenen Kontexten mit demselben Namen und Verschachtelungsstil.
• Mehrere Ebenen der API-Abstraktion - wenn Sie mehr Kontrolle benötigen, können niedrigere API-Abstraktionsebenen in Ihrem Code verwendet werden.
• Flexible Möglichkeiten, einzelne Teile zu ersetzen: Vorlagen, Steuerungsaktionen, etc.
• Manipulation von Eigenschaften bestehender Formulare - Ändern von Feldbezeichnungen, Standardwerten, Hinzufügen von Feldern, Blättern, etc.
• Datentyptransformationen - definieren Sie den gewünschten Zieltyp und überlassen Sie die Konvertierung den TypeConvertern von Extbase.
• Möglichkeit eigener Komponenten - mit der gleichen API-Unterstützung wie jede andere Flux-Komponente.
• Mehrere Utility-type-Klassen für fortgeschrittene Integrationen, insbesondere mit Fluid.

Bekannte Probleme

• Denken Sie daran, dass Ihr PHP/HTTP korrekt konfiguriert ist, um eine ziemlich große Anzahl von Eingabefeldern zu akzeptieren. Beim Verschachteln abschnitte / Objekte die Anzahl der eingereichten Felder, steigt drastisch an. Die php.ini-Konfigurationseinstellung, über die man nachdenken sollte, ist max_input_vars. Wenn diese Zahl zu klein ist, lehnt das TYPO3-Backend (als PHP) die Einreichung des backend-Bearbeitungsformular und wird mit einer "Invalid CSRF Token"-Meldung wegen unvollständiger (abgeschnittener) POST-Daten beendet.

Dokumentation

• ViewHelper Referenz für Flux
• Wie man die Flux-APIs verwendet