MultiColumnWizard

2011-10-18T18:46:07Z

SharkeyO: Einleitungstext angepasst.

[[en:MultiSelectWizard]]
[[Category:Extensions]]
{{ExtInfo
| DevSite=http://www.men-at-work.de
| ExtVersion=1.0.0
| Version=2.9 - 2.9.5
| ERLink=http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html
| TrackerLink=http://contao-forge.org/projects/multicolumnwizard/issues
}}

Der MultiColumnWizard ist ein Widget zur Abbildung von mehreren Feldern ''gleichen'' und/oder ''unterschiedlichen'' Typs (''Inputtype'') in einem DCA-Element. Die einzelnen Felder des MCW werden im Backend spaltenweise geführt und sind als Gruppe zeilenweise erweiterbar. Die Anordnung entspricht einem multidimensionalen Array der Form ''array[Zeilen][Felder]'', das als serialisiertes Array in der Datenbank abgelegt wird. Das Widget ist quasi identisch zu [[MultiTextWizard]] oder [[MultiSelectWizard]]. Es erweitert die Funktionalitäten für beliebige Widgets.

=Aussehen=
Die Extension kann für jede Art von Inputtype verwendet werden, eine Mischung der einzelnen Typen ist kein Problem.
[[Datei:MultiColumnWizard.jpg|MultiColumnWizard|frame|center]]

=Verwendung=
Es gibt zwei Verwendungsmöglichkeiten. Entweder direkt mit der Angabe von "columnFields" im "eval"-Array oder mit einem Callback.

==Angabe mit columnFields==

<source lang="php">
$GLOBALS['TL_DCA']['tl_theme']['fields']['templateSelection'] = array
(
'label' => &$GLOBALS['TL_LANG']['tl_theme']['templateSelection'],
'exclude' => true,
'inputType' => 'multiColumnWizard',
'eval' => array
(
'columnFields' => array
(
'ts_client_os' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_theme']['ts_client_os'],
'exclude' => true,
'inputType' => 'select',
'options' => array
(
'option1' => 'Option 1',
'option2' => 'Option 2',
),
'eval' => array('style' => 'width:250px', 'includeBlankOption'=>true)
),
'ts_client_browser' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_theme']['ts_client_browser'],
'exclude' => true,
'inputType' => 'text',
'eval' => array('style'=>'width:180px')
),
'ts_client_mobile' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_theme']['ts_client_mobile'],
'exclude' => true,
'inputType' => 'checkbox',
'eval' => array('style'=>'width:40px')

),
'ts_extension' => array
(
'label' => &$GLOBALS['TL_LANG']['tl_theme']['ts_extension'],
'inputType' => 'text',
'eval' => array('mandatory'=>true, 'style'=>'width:115px')
),
)
)
);
</source>

==Angabe mit Callback==
<source lang="php">
$GLOBALS['TL_DCA']['tl_table']['fields']['anything'] = array
(
'label' => &$GLOBALS['TL_LANG']['tl_table']['anything'],
'exclude' => true,
'inputType' => 'multiColumnWizard',
'eval' => array('mandatory'=>true,'columnsCallback'=>array('Class', 'Method'))

);
</source>

Wobei natürlich der Return-Wert genau das selbe Array sein muss, wie bei der "columnFields"-Variante.

==Verfügbare MultiColumnWizard Eval-Optionen==

{| cellpadding="20" cellspacing="0"
|-
| '''Schlüssel''' || '''Wert''' || '''Beschreibung'''
|-
| columnPos || Gruppenname ''string'' || Gruppiert Felder und zeigt Sie untereinander an.
|-
| maxCount || Menge ''integer'' || Legt die maximale Anzahl an Felder fest, die angelegt werden dürfen.
|-
| minCount || Menge ''integer'' || Legt die minimale Anzahl an Felder fest, die angelegt werden dürfen.
|-
| valign || Position ''string'' || Legt die vertikale Position der Zelle in der Tabelle fest.
|-
| buttonPos || Position ''string'' || Legt die vertikale Position der Zelle, in der sich die Buttons befinden, fest.
|}

==Unterstützte Contao Eval-Optionen==

{|
|-
| '''Schlüssel''' || '''Status'''
|-
| nospace || ''Ungetestet''
|-
| multiple || Unterstützt
|-
| size || Unterstützt
|-
| rgxp || Unterstützt
|-
| style || Unterstützt
|-
| tl_class || Unterstützt
|-
| preserveTags || Unterstützt
|-
| allowHtml || Unterstützt
|-
| trailingSlash || ''Ungetestet''
|-
| mandatory || Unterstützt
|-
| spaceToUnderscore || Unterstützt
|-
| includeBlankOption || Unterstützt
|-
| maxlength || Unterstützt
|-
| minlength || Unterstützt
|}

Contao Community Documentation - Benutzerbeiträge [de]

MultiColumnWizard