DC Memory: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Buttons hinzufügen)
(Versionierung)
Zeile 68: Zeile 68:
 
(
 
(
 
array('class', 'dcMemory_onrestore_callback'),
 
array('class', 'dcMemory_onrestore_callback'),
 +
),
 +
'createInitialVersion_callback'    => array
 +
(
 +
array('class', 'createInitialVersion_callback'),
 
)
 
)
 
</source>
 
</source>
Zeile 98: Zeile 102:
 
{
 
{
 
// $strVersion enthält den value, also z.B. "version_1"
 
// $strVersion enthält den value, also z.B. "version_1"
 +
}
 +
</source>
 +
<source lang="php">
 +
/**
 +
* Ist dafür verantwortlich, was bei der Ersterstellung einer Version gemacht werden soll
 +
* @param DataContainer
 +
*/
 +
public function createInitialVersion_callback(DataContainer $dc)
 +
{
 +
// Erstversion anlegen
 
}
 
}
 
</source>
 
</source>

Version vom 29. August 2011, 16:44 Uhr

Danke für's Formatieren :D

Allgemeines

Die DC_Memory ist ein eigener DCA-Driver wie die DC_Table oder andere. Allerdings bietet diese für den Entwickler extrem viel mehr Flexibilität, also die DC_Table, weil die DC_Memory das Laden und Speichern der Daten vollständig dem Entwickler überlässt.

Daten laden und speichern

Zum Speichern und Laden der Daten werden die bekannten onload_callbacks und onsubmit_callbacks genutzt. Hier ein Beispiel:

'onload_callback'           => array
(
	array('class', 'onload_callback'),
),
'onsubmit_callback'           => array
(
	array('class', 'onsubmit_callback'),
)
/**
 * Laden der Daten
 * @param DataContainer
 */
public function onload_callback(DataContainer $dc)
{
	// Werte holen von der DB oder einem File oder was auch immer
 
	// Setzen eines Wertes
	$dc->setData('field', 'Wert');
 
	// auch das Setzen aller Werte auf einmal funktioniert:
	$arrData = array();
	$arrData['field1'] = 'Wert 1';
	$arrData['field2'] = 'Wert 2';
	$dc->setDataArray($arrData);
}
/**
 * Speichern der Daten
 * @param DataContainer
 */
public function onsubmit_callback(DataContainer $dc)
{
	// Holen eines Wertes
	$strField1 $dc->getData('field1');
 
	// auch das Holen aller Werte auf einmal funktioniert:
	$arrData = $dc->getDataArray();
 
	// und dann ab in die DB oder in ein File oder wohin auch immer
}

Versionierung

Es wäre ja gelacht, wenn wir die Standard-Versionierung von Contao nehmen würden, denn die bietet für die meisten Entwickler zu wenig Flexibilität (was aber nicht heisst, man kann die Core-Versionierung nicht auch einbauen).

Folgende Konfiguration ist notwendig:

'enableVersioning'			=> true,
'listversions_callback'     => array
(
	array('class', 'listversions_callback'),
),
'dcMemory_onrestore_callback'     => array
(
	array('class', 'dcMemory_onrestore_callback'),
),
'createInitialVersion_callback'     => array
(
	array('class', 'createInitialVersion_callback'),
)
/**
 * Ist dafür verantwortlich, welche Versionen im Dropdown angeboten werden
 * @param DataContainer
 * @param array
 * @return array
 */
public function listversions_callback(DataContainer $dc, $arrVersions)
{
	$arrVersions[] = array
	(
		'value'		=> 'version_1',
		'selected'	=> true, // Diese Version ist die jüngste
		'label'		=> 'Meine jüngste Version'
	);
 
	return $arrVersions;
}
/**
 * Ist dafür verantwortlich, was nach dem Klick auf "Wiederherstellen" passiert (also evtl. auch $this->reload() aufrufen!)
 * @param DataContainer
 * @param string | enthält die Version
 */
public function dcMemory_onrestore_callback(DataContainer $dc, $strVersion)
{
	// $strVersion enthält den value, also z.B. "version_1"
}
/**
 * Ist dafür verantwortlich, was bei der Ersterstellung einer Version gemacht werden soll
 * @param DataContainer
 */
public function createInitialVersion_callback(DataContainer $dc)
{
	// Erstversion anlegen
}

Mehrsprachigkeit

Ja, die DC_Memory unterstützt Mehrsprachigkeit. Da sie sich nicht darum kümmert, woher die Daten kommen und wohin sie gespeichert werden, bietet sie schlichtweg die Möglichkeit, Sprachen anzubieten und Methoden zur Abfrage, welche Sprache aktuell bearbeitet wird. Die Konfiguration erfolgt im onload_callback und könnte so aussehen:

/**
 * Laden der Daten
 * @param DataContainer
 */
public function onload_callback(DataContainer $dc)
{
	// Sprachwechsel-Konfiguration
	$objLangConfig = new stdClass();
 
	// Fallback zusätzlich zu den Sprachen anbieten
	$objLangConfig->enableFallback = true;
 
	// Sprachen-Array
	$objLangConfig->arrLanguages = array
	(
		'de'	=> array
		(
			'label'		=> 'Deutsch',
			'selected'	=> ($dc->getLanguage() == 'de')
		),
		'fr'	=> array
		(
			'label'		=> 'Französisch',
			'selected'	=> ($dc->getLanguage() == 'fr')
		)
	);
 
	// und jetzt das ganze noch aktivieren
	$dc->enableLanguageSwitch($objLangConfig);
 
	// die getLanguage()-Methode bietet die Möglichkeit, die aktuell bearbeitete Sprache zu holen	
	switch($dc->getLanguage())
	{
		case 'de':
			$dc->setData('name', 'Wir sprechen sowas von Deutsch!');
			break;
		case 'fr':
			$dc->setData('name', 'On parle le français aussi!');
			break;
		default:
			$dc->setData('name', 'What about a fallback?');
	}
 
	// Sprachen können auch gelöscht werden.
	$strEditMode = $dc->getLanguageEditMode() // enthält entweder "edit" wenn man eine Sprache bearbeitet oder "delete" wenn die Sprache gelöscht werden soll
}

Buttons hinzufügen

Im Contao-Core ist es äusserst mühsam eigene Buttons à la "Speichern und schliessen" hinzuzufügen. Mit der DC_Memory geht das ganz einfach:

/**
 * Laden der Daten
 * @param DataContainer
 */
public function onload_callback(DataContainer $dc)
{
	$arrData = array
	(
		'id'=>'saveNredirectToGoogle',
		'formkey'=>'saveNredirectToGoogle',
		'class'=>'',
		'accesskey'=>'g',
		'value'=>specialchars($GLOBALS['TL_LANG']['MSC']['saveNredirectToGoogle']),
		'button_callback' => array('class', 'saveNredirectToGoogleButtonCallback')
	);
	$dc->addButton('saveNredirectToGoogle', $arrData)
}
 
 
/**
 * Nach dem Speichern zu Google weiterleiten
 * @param DataContainer
 */
public function saveNredirectToGoogleButtonCallback(DataContainer $dc)
{
	$this->redirect('http://www.google.com');
}

Falls bei einem Button die Daten nicht gespeichert werden sollen, ist es am Programmierer, diesen Fall vorzusehen. Der onsubmit_callback wird zuerst aufgerufen. Die Speicherung sollte also in diesem Falle dort nicht vorgenommen werden, wenn z.B. $this->Input->post('myButton') gesetzt ist.

Ansichten
Meine Werkzeuge

Contao Community Documentation

Andreas, leg dich da hinten hin und schlaf, dann kommen wir vorwaerts.

Tristan Lins
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge