MultiColumnWizard: Unterschied zwischen den Versionen

Aus Contao Community Documentation
K (→‎options_callback)
 
(10 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
 
{{ExtInfo
 
{{ExtInfo
 
| DevSite=http://www.men-at-work.de
 
| DevSite=http://www.men-at-work.de
−
| ExtVersion=1.0.0
+
| ExtVersion=3.0.0
−
| Version=2.9+
+
| Version=2.10+
 
| ERLink=http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html
 
| ERLink=http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html
−
| TrackerLink=http://contao-forge.org/projects/multicolumnwizard/issues
+
| TrackerLink=https://github.com/menatwork/MultiColumnWizard/issues
 
}}
 
}}
  
Zeile 40: Zeile 40:
 
'option2'    => 'Option 2',
 
'option2'    => 'Option 2',
 
),
 
),
−
'eval' => array('style' => 'width:250px', 'includeBlankOption'=>true)
+
'eval' => array('style' => 'width:250px', 'includeBlankOption'=>true, 'chosen'=>true)
 
),
 
),
 
'ts_client_browser' => array
 
'ts_client_browser' => array
Zeile 67: Zeile 67:
 
);
 
);
 
</source>
 
</source>
 +
Das ''''chosen'=>true'''im eval vom Select Feld (ts_client_os) ist für Contao 2.11 wichtig, da sonst die Anzeige nicht korrekt funktioniert.<br />Für Contao 2.10 ist das nicht nötig, stört aber nicht und ist somit kompatibel für beide Versionen.
  
 
==Angabe mit Callback==
 
==Angabe mit Callback==
Zeile 86: Zeile 87:
 
{| cellpadding="20" cellspacing="0"
 
{| cellpadding="20" cellspacing="0"
 
|-
 
|-
−
| '''Schlüssel''' || '''Wert''' || '''Beschreibung'''
+
| '''Schlüssel''' || '''Wert''' || '''Beschreibung''' || '''Beispiel'''
 
|-
 
|-
−
| columnPos || Gruppenname<br />''string'' || Gruppiert Felder und zeigt Sie untereinander an.
+
| columnPos || Gruppenname<br />''string'' || Gruppiert Felder und zeigt Sie untereinander an. ||
 
|-
 
|-
−
| maxCount || Menge<br />''integer'' || Legt die maximale Anzahl an Felder fest, die angelegt werden dürfen.
+
| maxCount || Menge<br />''integer'' || Legt die maximale Anzahl an Felder fest, die angelegt werden dürfen. || <source lang="php">$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['maxCount'] = 4;</source>
 
|-
 
|-
−
| minCount || Menge<br />''integer'' || Legt die minimale Anzahl an Felder fest, die angelegt werden dürfen.
+
| minCount || Menge<br />''integer'' || Legt die minimale Anzahl an Felder fest, die angelegt werden dürfen. || <source lang="php">$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['minCount '] = 2;</source>
 
|-
 
|-
−
| valign || Position<br />''string'' || Legt die vertikale Position der Zelle in der Tabelle fest.
+
| valign || Position<br />''string'' || Legt die vertikale Position der Zelle in der Tabelle fest. || <source lang="php">$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['valign'] = 'top';</source>
 
|-
 
|-
−
| buttonPos || Position<br />''string'' || Legt die vertikale Position der Zelle, in der sich die Buttons befinden, fest.
+
| buttonPos || Position<br />''string'' || Legt die vertikale Position der Zelle, in der sich die Buttons befinden, fest. ||
 +
|-
 +
| buttons || Buttonnamen<br />''associative array'' || Legt fest, mit welchem Icon die 4 Buttons "up", "down", "copy", "delete" dargestellt werden. Dabei ist der Buttonname der Schlüssel und der Pfad zum Icon der Wert. Wird ein Wert für einen Button explizit auf ''false'' gesetzt, so wird dieser versteckt. || <source lang="php">$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['buttons'] = array('copy' => false, 'delete' => false, 'up' => 'myUpIcon.png');</source>
 
|}
 
|}
  
 
==Unterstützte Contao Eval-Optionen==
 
==Unterstützte Contao Eval-Optionen==
 +
Diese Eval-Optionen werden für die "Kindwidgets" - oder besser "komponierten Widgets" - unterstützt.
  
 
{|
 
{|
Zeile 132: Zeile 136:
 
|-
 
|-
 
| minlength || Unterstützt
 
| minlength || Unterstützt
 +
|-
 +
| chosen || Unterstützt
 
|}
 
|}
 +
 +
==Hinweise==
 +
===options_callback===
 +
Im Beispiel oben wird für das Select Feld ein Optionsliste direkt definiert über 'options'. Das geht auch über 'options_callback'. Im Gegensatz zum Core wird der Methode jedoch kein Datacontainer $dc übermittelt.
 +
 +
Beispiel für eine Liste abhängig von der Contao Version:<br />
 +
<source lang="php">
 +
'ts_client_os' => array
 +
(
 +
'label'                => &$GLOBALS['TL_LANG']['tl_theme']['ts_client_os'],
 +
'exclude'              => true,
 +
'inputType'            => 'select',
 +
'options_callback'      => array('tl_theme', 'getOptions'),
 +
'eval' => array('style' => 'width:250px', 'includeBlankOption'=>true, 'chosen'=>true)
 +
),
 +
</source>
 +
 +
Nun wie üblich im DCA die Klasse mit der Methode:<br />
 +
<source lang="php">
 +
class tl_theme extends Backend
 +
{
 +
    /**
 +
    * Return options
 +
    * @return array
 +
    */
 +
    public function getOptions()
 +
    {
 +
        $arrOptions = array(
 +
'option1'      => 'Option 1',
 +
'option2'    => 'Option 2',
 +
'option3'    => 'Option 3',
 +
);
 +
        //option3 not in Contao 2.10
 +
        if (version_compare(VERSION, '2.11', '<'))
 +
        {
 +
            $arrOptions = array(
 +
'option1'      => 'Option 1',
 +
'option2'    => 'Option 2',
 +
);
 +
        }
 +
        return $arrOptions;
 +
    }
 +
}
 +
</source>

Aktuelle Version vom 17. August 2012, 15:45 Uhr


Erweiterungs-Übersicht
Entwickler Webseite http://www.men-at-work.de
Version der Erweiterung 3.0.0
Kompatibilität mit Contao Version 2.10+
Link zum Extension Repository http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html
Link zum Tracker https://github.com/menatwork/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.

MultiColumnWizard

Verwendung

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

Angabe mit columnFields

$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, 'chosen'=>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')
			),
		)
	)
);

Das 'chosen'=>trueim eval vom Select Feld (ts_client_os) ist für Contao 2.11 wichtig, da sonst die Anzeige nicht korrekt funktioniert.
Für Contao 2.10 ist das nicht nötig, stört aber nicht und ist somit kompatibel für beide Versionen.

Angabe mit Callback

$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'))
 
);

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

Verfügbare MultiColumnWizard Eval-Optionen

Schlüssel Wert Beschreibung Beispiel
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. 
$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['maxCount'] = 4;
minCount Menge
integer 		Legt die minimale Anzahl an Felder fest, die angelegt werden dürfen. 
$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['minCount '] = 2;
valign Position
string 		Legt die vertikale Position der Zelle in der Tabelle fest. 
$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['valign'] = 'top';
buttonPos Position
string 		Legt die vertikale Position der Zelle, in der sich die Buttons befinden, fest.
buttons Buttonnamen
associative array 		Legt fest, mit welchem Icon die 4 Buttons "up", "down", "copy", "delete" dargestellt werden. Dabei ist der Buttonname der Schlüssel und der Pfad zum Icon der Wert. Wird ein Wert für einen Button explizit auf false gesetzt, so wird dieser versteckt. 
$GLOBALS['TL_DCA']['tl_example']['fields']['mcwExample']['eval']['buttons'] = array('copy' => false, 'delete' => false, 'up' => 'myUpIcon.png');

Unterstützte Contao Eval-Optionen

Diese Eval-Optionen werden für die "Kindwidgets" - oder besser "komponierten Widgets" - unterstützt.

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
chosen Unterstützt

Hinweise

options_callback

Im Beispiel oben wird für das Select Feld ein Optionsliste direkt definiert über 'options'. Das geht auch über 'options_callback'. Im Gegensatz zum Core wird der Methode jedoch kein Datacontainer $dc übermittelt.

Beispiel für eine Liste abhängig von der Contao Version:

			'ts_client_os' => array
			(
				'label'                 => &$GLOBALS['TL_LANG']['tl_theme']['ts_client_os'],
				'exclude'               => true,
				'inputType'             => 'select',
				'options_callback'      => array('tl_theme', 'getOptions'), 
				'eval' 			=> array('style' => 'width:250px', 'includeBlankOption'=>true, 'chosen'=>true)
			),

Nun wie üblich im DCA die Klasse mit der Methode:

class tl_theme extends Backend
{
    /**
     * Return options
     * @return array
     */
    public function getOptions()
    {
        $arrOptions = array(
		'option1'       => 'Option 1',
		'option2'     	=> 'Option 2',
		'option3'     	=> 'Option 3',
		);
        //option3 not in Contao 2.10
        if (version_compare(VERSION, '2.11', '<'))
        {
            $arrOptions = array(
		'option1'       => 'Option 1',
		'option2'     	=> 'Option 2',
		);
        }
        return $arrOptions;
    }
}
Von „https://dev.contaowiki.org/index.php?title=MultiColumnWizard&oldid=5397“
Ansichten
Meine Werkzeuge

Contao Community Documentation

ich hook' mich gleich in die Abstraktion

Martin Mildner
In anderen Sprachen
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge