Typo3 Extensions mit FlexForms: Unterschied zwischen den Versionen

Aus Wikizone
Wechseln zu: Navigation, Suche
Zeile 70: Zeile 70:
 
Ein '''Beispiel mit allerlei Eingabefeldern''' könnte wie folgt aussehen. In diesem Beispiel wird für die Namen der Felder auf eine locallang_tca.php verwiesen. Man könnte die Namen der Labels aber auch einfach direkt reinschreiben.  
 
Ein '''Beispiel mit allerlei Eingabefeldern''' könnte wie folgt aussehen. In diesem Beispiel wird für die Namen der Felder auf eine locallang_tca.php verwiesen. Man könnte die Namen der Labels aber auch einfach direkt reinschreiben.  
  
−
'''Einleitender Code'''
+
===Einleitender Code===
 
<pre><nowiki>
 
<pre><nowiki>
 
<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>
 
<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>
Zeile 77: Zeile 77:
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
===Das erste Sheet===
 
Hier beginnt '''das erste Sheet''' man stellt vor den xml bezeichner gewöhnlich ein s für sheet. Das erste formspezifische Element ist der Titel des Tabs, dann kommt ein Array und das Einleitende el Tag indem alle Elemente des Tabs gespeichert sind.
 
Hier beginnt '''das erste Sheet''' man stellt vor den xml bezeichner gewöhnlich ein s für sheet. Das erste formspezifische Element ist der Titel des Tabs, dann kommt ein Array und das Einleitende el Tag indem alle Elemente des Tabs gespeichert sind.
 
<pre><nowiki>
 
<pre><nowiki>
Zeile 88: Zeile 89:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
'''Eingabefeld'''
+
===Eingabefeld===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleString>
 
  <exampleString>
Zeile 103: Zeile 104:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein '''Datumsfeld'''
+
===Datumsfeld===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleDate>
 
  <exampleDate>
Zeile 119: Zeile 120:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein '''Textfeld'''
+
===Ein Textfeld===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleArea>
 
  <exampleArea>
Zeile 148: Zeile 149:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
'''Das erste Blatt ist fertig'''
+
===Das erste Blatt ist fertig===
 
<pre><nowiki>
 
<pre><nowiki>
 
</el>
 
</el>
Zeile 155: Zeile 156:
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
===RTE===
 
Das nächste Blatt enthält einen '''RTE'''...
 
Das nächste Blatt enthält einen '''RTE'''...
 
<pre><nowiki>
 
<pre><nowiki>
Zeile 180: Zeile 182:
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
===Auswahlfelder===
 
Das nächste Blatt enthält Beispiele für '''Auswahlfelder'''...
 
Das nächste Blatt enthält Beispiele für '''Auswahlfelder'''...
 
<pre><nowiki>
 
<pre><nowiki>
Zeile 191: Zeile 194:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein einfaches '''Select Feld'''
+
===Ein einfaches Select Feld===
 +
Zu beachten ist hierbei, daß der Tag numIndex index="0" den Namen(oder das Label) des Optionspunktes enthält, index="1" dagegen den key, also den später nutzbaren Wert.
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleSelection>
 
  <exampleSelection>
Zeile 217: Zeile 221:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein Select-Feld mit '''Mehrfachauswahl'''
+
===Mehrfachauswahl===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleMultiselection>
 
  <exampleMultiselection>
Zeile 248: Zeile 252:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein '''Seitenbrowser'''
+
===Ein Seitenbrowser===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <examplePagebrowser>
 
  <examplePagebrowser>
Zeile 267: Zeile 271:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein '''Dateibrowser'''
+
===Ein Dateibrowser===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleFilebrowser>
 
  <exampleFilebrowser>
Zeile 286: Zeile 290:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Eine '''Checkbox'''
+
===Eine Checkbox===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleCheckbox>
 
  <exampleCheckbox>
Zeile 298: Zeile 302:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
'''Radio Buttons'''
+
===Radio Buttons===
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleRadio>
 
  <exampleRadio>
Zeile 324: Zeile 328:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
'''Ende des Sheets'''
+
===Ende des Sheets===
 
<pre><nowiki>
 
<pre><nowiki>
 
</el>
 
</el>
Zeile 341: Zeile 345:
 
</nowiki></pre>
 
</nowiki></pre>
  
−
Ein '''dynamisches Select Feld''' mit Werten aus der Tabelle static_template
+
===Ein dynamisches Select Feld===
 +
mit Werten aus der Tabelle static_template
 
<pre><nowiki>
 
<pre><nowiki>
 
  <exampleQuery>
 
  <exampleQuery>
Zeile 385: Zeile 390:
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
===XML-Struktur beenden===
 
Das letzte '''Sheet fertigstellen'''...
 
Das letzte '''Sheet fertigstellen'''...
 
<pre><nowiki>
 
<pre><nowiki>
Zeile 400: Zeile 406:
 
</nowiki></pre>
 
</nowiki></pre>
  
 +
 +
===Labels übersetzen - Sprachdatei===
 
Der Vollständigkeit halber ein Auszug aus der locallang_tca.php in der die Sprachlabels definiert werden:
 
Der Vollständigkeit halber ein Auszug aus der locallang_tca.php in der die Sprachlabels definiert werden:
  

Version vom 12. September 2007, 11:11 Uhr

Man braucht:

  1. Änderungen in ext_tables.php
  2. Die Datei flexform_ds.xml. In dieser befindet sich der XML code den Typo3 nutzt um das Flexform zu generieren.
    1. In der Datei wird im Abschnitt Label auf die Datei: locallang_db.xml verwiesen. In dieser wiederum werden die anderen Sprachen definiert.

Beispiel ext_tables.php (Ausschnitt): 

# Vor jeder Änderung im TCA Bereich im Frontend muß er auch geladen sein...
t3lib_div::loadTCA('tt_content');
# Wir nutzen FlexForms - deshalb blenden wir die Standard-Felder layout, select_key pages und recursive aus...
$TCA['tt_content']['types']['list']['subtypes_excludelist'][$_EXTKEY.'_pi1']='layout,select_key,pages,recursive';
# Dafür blenden wir das tt_content-Felod pi_flexform ein
$TCA['tt_content']['types']['list']['subtypes_addlist'][$_EXTKEY.'_pi1']='pi_flexform';
# Nun die Datei angeben in der das Flexform-Schema definiert ist...
t3lib_extMgm::addPiFlexFormValue($_EXTKEY.'pi1','FILE:EXT:'.$_EXTKEY.'/flexform_de.xml');

# Plugin aktivieren-dies sorgt dafür, dass das Plugin im Backend überhaupt ausgewählt werden kann (legt der EM automatisch an)
t3lib_extMgm::addPlugin(array('LLL:EXT:hfwupersonal/locallang_db.xml:tt_content.list_type_pi1', $_EXTKEY.'_pi1'),'list_type');

Beispiel flexform_ds.xml 


<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>
<T3FlexForms>
  <data type="array">
    <sDEF type="array">
      <lDEF type="array">
        <inputName type="array">
          <vDEF>Beispielwort</vDEF>
        </inputName>
        <inputTransformation type="array">
          <vDEF>lowercase</vDEF>
        </inputTransformation>
      </lDEF>
    </sDEF>
  </data>
</T3FlexForms>

Innerhalb von sheets stehen die Tabs, sDEF ist das aktuelle Sheet.

Flexforms gestalten

Ein Flexform hat folgende Grundstruktur: 

<T3DataStructure>
  <meta>
    <langDisable>1</langDisable>
  </meta>
  <ROOT>
     [...formatspezifisches Element ... ]
     <type>array</type>
     <el>
       <freierElementName1>
          [ ... formatspezifisches Element ... ]
       </freierElementName1>
       <freierElementName2>
          [ ... formatspezifisches Element ... ]
       </freierElementName2>
     </el>
  </ROOT>
</T3DataStructure>

Ein Beispiel mit allerlei Eingabefeldern könnte wie folgt aussehen. In diesem Beispiel wird für die Namen der Felder auf eine locallang_tca.php verwiesen. Man könnte die Namen der Labels aber auch einfach direkt reinschreiben.

Einleitender Code

<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>
<T3DataStructure>
  <sheets>

Das erste Sheet

Hier beginnt das erste Sheet man stellt vor den xml bezeichner gewöhnlich ein s für sheet. Das erste formspezifische Element ist der Titel des Tabs, dann kommt ein Array und das Einleitende el Tag indem alle Elemente des Tabs gespeichert sind. 

    <sInputs>
      <ROOT>
	<TCEforms>
	  <sheetTitle>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.sheetInputs</sheetTitle>
	</TCEforms>
	<type>array</type>
	<el>

Eingabefeld

	  <exampleString>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleString.label</label>
	      <config>
		<type>input</type>
		<size>24</size>
		<max>48</max>
		<eval>trim</eval>
	      </config>
	    </TCEforms>
	  </exampleString>

Datumsfeld

	  <exampleDate>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleDate.label</label>
	      <config>
		<type>input</type>
		<size>8</size>
		<eval>date</eval>
		<max>20</max>
		<checkbox>1</checkbox>
	      </config>
	    </TCEforms>
	  </exampleDate>

Ein Textfeld

	  <exampleArea>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleArea.label</label>
	      <config>
		<type>text</type>
		<cols>24</cols>
		<rows>3</rows>
	      </config>
	    </TCEforms>
	  </exampleArea>

Ein Textfeld mit abgeschaltetem Zeilenumbruch für Code 

	  <exampleCode>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleCode.label</label>
	      <config>
		<type>text</type>
		<cols>35</cols>
		<rows>8</rows>
		<wrap>off</wrap>		
	      </config>
	    </TCEforms>
	  </exampleCode>

Das erste Blatt ist fertig

	</el>
      </ROOT>
    </sInputs>

RTE

Das nächste Blatt enthält einen RTE... 

    <sRTE>    
      <ROOT>
	<TCEforms>
	  <sheetTitle>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.sheetRTE</sheetTitle>
	</TCEforms>
	<type>array</type>
	<el>
	  <exampleRTE>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleRTE.label</label>
	      <config>
		<type>text</type>
		<cols>52</cols>
		<rows>5</rows>
	      </config>
	      <defaultExtras>richtext[*]:rte_transform[mode=ts_css]</defaultExtras>
	    </TCEforms>
	  </exampleRTE>
	</el>
      </ROOT>      
    </sRTE>

Auswahlfelder

Das nächste Blatt enthält Beispiele für Auswahlfelder... 

    <sSelections>    
      <ROOT>
	<TCEforms>
	  <sheetTitle>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.sheetSelections</sheetTitle>
	</TCEforms>
	<type>array</type>
	<el>

Ein einfaches Select Feld

Zu beachten ist hierbei, daß der Tag numIndex index="0" den Namen(oder das Label) des Optionspunktes enthält, index="1" dagegen den key, also den später nutzbaren Wert. 

	  <exampleSelection>
	    <TCEforms>	
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleSelection.label</label>
	      <config>
		<type>select</type>
		<items type="array">
		  <numIndex index="0" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleSelection.label1</numIndex>
		    <numIndex index="1">key1</numIndex>
		  </numIndex>
		  <numIndex index="1" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleSelection.label2</numIndex>
		    <numIndex index="1">key2</numIndex>
		  </numIndex>
		  <numIndex index="3" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleSelection.label3</numIndex>
		    <numIndex index="1">key3</numIndex>
		  </numIndex>
		</items>	
	      </config>
	    </TCEforms>
	  </exampleSelection>

Mehrfachauswahl

	  <exampleMultiselection>
	    <TCEforms>	
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleMultiselection.label</label>
	      <config>
		<type>select</type>
		<items type="array">
		  <numIndex index="0" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleMultiselection.label1</numIndex>
		    <numIndex index="1">key1</numIndex>
		  </numIndex>
		  <numIndex index="1" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleMultiselection.label2</numIndex>
		    <numIndex index="1">key2</numIndex>
		  </numIndex>
		  <numIndex index="3" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleMultiselection.label3</numIndex>
		    <numIndex index="1">key3</numIndex>
		  </numIndex>
		</items>	
		<maxitems>3</maxitems>
x		<size>3</size>
		<multiple>1</multiple>
		<selectedListStyle>width:150px</selectedListStyle>
		<itemListStyle>width:150px</itemListStyle>
	      </config>
	    </TCEforms>
	  </exampleMultiselection>

Ein Seitenbrowser

	  <examplePagebrowser>
	    <TCEforms>
	      <exclude>1</exclude>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.examplePagebrowser.label</label>
	      <config>
		<type>group</type>
		<internal_type>db</internal_type>
		<allowed>pages</allowed>
		<size>3</size>
		<maxitems>22</maxitems>
		<minitems>0</minitems>
		<show_thumbs>1</show_thumbs>
	      </config>
	    </TCEforms>
	  </examplePagebrowser>

Ein Dateibrowser

	  <exampleFilebrowser>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleFilebrowser.label</label>
	      <config>
		<type>group</type>
		<internal_type>file</internal_type>
		<allowed>tmpl,html</allowed>
		<max_size>100</max_size>
		<uploadfolder>uploads/</uploadfolder>
		<maxitems>1</maxitems>
		<size>1</size>
		<selectedListStyle>Width:180px</selectedListStyle>
	      </config>
	    </TCEforms>
	  </exampleFilebrowser>

Eine Checkbox

	  <exampleCheckbox>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleCheckbox.label</label>
	      <config>
		<type>check</type>
	      </config>
	    </TCEforms>
	  </exampleCheckbox>

Radio Buttons

	  <exampleRadio>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleRadio.label</label>
	      <config>
		<type>radio</type>
		<items type="array">
		  <numIndex index="0" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleRadio.label1</numIndex>
		    <numIndex index="1">key1</numIndex>
		  </numIndex>
		  <numIndex index="1" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleRadio.label2</numIndex>
		    <numIndex index="1">key2</numIndex>
		  </numIndex>
		  <numIndex index="3" type="array">
		    <numIndex index="0">LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleRadio.label3</numIndex>
		    <numIndex index="1">key3</numIndex>
		  </numIndex>
		</items>	
	      </config>
	    </TCEforms>
	  </exampleRadio>

Ende des Sheets

	</el>
      </ROOT>      
    </sSelections>

Auswahlfelder können Ihre Werte auch dynamisch aus der Datenbank beziehen, darum gehts im nächsten Sheet 

    <sDynamics>    
      <ROOT>
	<TCEforms>
	  <sheetTitle>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.sheetDynamics</sheetTitle>
	</TCEforms>
	<type>array</type>
	<el>

Ein dynamisches Select Feld

mit Werten aus der Tabelle static_template 

	  <exampleQuery>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleQuery.label</label>  
	      <config>
		<type>select</type>
		<items>
		  <numIndex index="0">
		    <numIndex index="0">--</numIndex>
		    <numIndex index="1">0</numIndex>
		  </numIndex>
		</items>
		<foreign_table>static_template</foreign_table>
		<foreign_table_where>
		  AND  static_template.uid < 30
		</foreign_table_where>
		<size>1</size>
		<minitems>0</minitems>
		<maxitems>1</maxitems>
	      </config>
	    </TCEforms>
	  </exampleQuery>

Eine Funktion kann ebenfalls genutzt werden um die WErte bereitzustellen 

	  <exampleFunction>
	    <TCEforms>
	      <label>LLL:EXT:sb_flexamples/locallang_tca.php:sb_flexamples.pi_flexform.exampleFunction.label</label>  
	      <config>
		<type>select</type>
		<items>
		  <numIndex index="0">
		    <numIndex index="0">--</numIndex>
		    <numIndex index="1">0</numIndex>
		  </numIndex>
		</items>
		<itemsProcFunc>tx_sbflexamples_itemFunctions->exampleFunction</itemsProcFunc>
	      </config>
	    </TCEforms>
	  </exampleFunction>

XML-Struktur beenden

Das letzte Sheet fertigstellen... 


	</el>
      </ROOT>      
    </sDynamics>

Die komplette Struktur beenden 

  </sheets>
</T3DataStructure>


Labels übersetzen - Sprachdatei

Der Vollständigkeit halber ein Auszug aus der locallang_tca.php in der die Sprachlabels definiert werden:

<?php 

$LOCAL_LANG = Array (
	'default' => Array (
...
		'hfwupersonal.pi_flexform.sheetSelections' => 'Selections',	
		'hfwupersonal.pi_flexform.sheetDynamics' => 'Dynamic Selections',	
		'hfwupersonal.pi_flexform.exampleDate.label' => 'Date',	
...
	),
	'de' => Array (
...
		'hfwupersonal.pi_flexform.sheetSelections' => 'Statische Auswahlfelder',	
		'hfwupersonal.pi_flexform.sheetDynamics' => 'Dynamische Auswahlfelder',	
		'hfwupersonal.pi_flexform.exampleDate.label' => 'Datum',	
...
	),
);
?>
Abgerufen von „https://wiki.stephanschlegel.de/index.php?title=Typo3_Extensions_mit_FlexForms&oldid=1123“