Isotope-Cart-ProductAddedFeedback: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Aufbereitung)
 
Zeile 1: Zeile 1:
<!-- begin Stub -->
+
{{stub}}
<div class="stub" align="center" style="margin-bottom:30px;">
+
[[Kategorie:Isotope eCommerce]]
{| cellpadding="2" cellspacing="0" style="text-align: left; color:#B65C5C; border: 1px solid #8E0505; background-color: #F2F2F2"
+
In der aktuellen Isotope Version (0.2.10 stable) wird dem Benutzer nach erfolgreichem Hinzufügen eines Produktes in den Warenkorb keine Meldung angezeigt. Mit den Boardmitteln von Contao und ein wenig Kreativität kann man das in wenigen Minuten ändern. Es gibt mehrere Wege dieses Verhalten zu implementieren. Die einzelnen Varianten werden hier vorgestellt.
| | [[Bild:msgError.png]] || <span class="title">'''Unvollständiger Artikel:'''</span> dieser Artikel ist noch nicht sauber bearbeitet.
+
Bitte [{{fullurl:{{FULLPAGENAME}}|action=edit}} erweitere ihn] und entferne erst anschliessend diesen Hinweis.<includeonly>[[Category:Stub]]</includeonly>
+
|}
+
</div>
+
<!-- end Stub -->
+
 
+
[[Category:Dev_HOWTOS]]
+
In der aktuellen Isotope Version (0.2.10 stable), wird dem Benutzer nach erfolgreichem Hinzufügen eines Produktes in den Warenkorb, keine Meldung angezeigt. Mit den Boardmitteln von contao und ein wenig Kreativität kann man das in wenigen Minuten ändern. Es gibt mehrere Wege dieses Verhalten zu implementieren. Die einzelnen Varianten werden hier vorgestellt.
+
  
 
{{Hinweis
 
{{Hinweis
Zeile 16: Zeile 8:
  
 
==Variante1: Isotope Box und Hooks==
 
==Variante1: Isotope Box und Hooks==
Wir verwenden PHP, Javascript und CSS um nach erfolgreichem Hinzufügen eine HTML-Messagebox anzuzeigen. Schlussendlich würde es diese Technik auch erlauben Isotope Fehlermeldungen (Out of Stock, komplexere Validierungsresultate) anzuzeigen.
+
Zum Anzeigen einer HTML-Messagebox nach dem erfolgreichen Hinzufügen eines Artikels in den Warenkorb wird PHP, Javascript und CSS verwendet. Schlussendlich würde es diese Technik auch erlauben Isotope Fehlermeldungen (Out of Stock, komplexere Validierungsresultate) anzuzeigen.
  
[[Datei:IsotopeCartExt_ajaxBox.png]]
+
[[Datei:IsotopeCartExt_ajaxBox.png|HTML-Messagebox|frame|center]]
  
Zuerst erstellen wir ein neues Modul. In diesem Tutorial verwende ich den Modulnamen ''IsotopeExt''. Im Ordner TL_ROOT/system/modules erstellen wir folgende Verzeichnisse und Dateien: IsotopeExt/config/config.php, IsotopeExt/IsotopeCartExt.php
+
Zuerst erstellt man ein neues Modul namens''IsotopeExt''. Im Ordner TL_ROOT/system/modules erstellt man folgende Verzeichnisse und Dateien:  
 +
 
 +
*IsotopeExt/config/config.php
 +
*IsotopeExt/IsotopeCartExt.php
  
 
===Backend Konfiguration===
 
===Backend Konfiguration===
Zeile 26: Zeile 21:
  
 
===PHP Konfiguration===
 
===PHP Konfiguration===
In der config/config.php folgenden PHP-Code hinzufügen:
+
In der Datei ''IsotopeExt/config/config.php'' folgenden PHP-Code hinzufügen:
  
 
<source lang="php">
 
<source lang="php">
Zeile 34: Zeile 29:
 
(Am einfachsten eine config.php eines anderen Moduls kopieren und dessen Inhalt ersetzen.)
 
(Am einfachsten eine config.php eines anderen Moduls kopieren und dessen Inhalt ersetzen.)
  
Damit registrieren wir zwei neue Hooks, die jedes mal aufgerufen werden, wenn ein Produkt dem Warenkorb hinzugefügt wird. Im Folgenden nun die Implementation der zwei registrierten Funktionen.
+
Damit registriert man zwei neue Hooks, die jedes mal aufgerufen werden, wenn ein Produkt dem Warenkorb hinzugefügt wird. Im Folgenden nun die Implementation der zwei registrierten Funktionen.
  
In der IsotopeCartExt.php folgenden Code einfügen:
+
In der Datei ''IsotopeExt/IsotopeCartExt.php'' folgenden Code einfügen:
 
<source lang="php">
 
<source lang="php">
 
class IsotopeCartExt extends Model {
 
class IsotopeCartExt extends Model {
Zeile 58: Zeile 53:
  
 
===Templates & Isotope Box===
 
===Templates & Isotope Box===
Nun ist es möglich die erstellten Session Objekte im Frontend zu verwenden. Wir verwenden dazu ein angepasstes Produktleser Template. Dazu einfach das entsprechende Template iso_reader_default.tpl von TL_ROOT/modules/Isotope/templates nach TL_ROOT/templates kopieren. Wenn das Template umbenannt wird, nicht vergessen im Produktleser Modul das umbenannte Template anzuwählen.
+
Nun ist es möglich, die erstellten Session Objekte im Frontend zu verwenden. Man verwendet dazu ein [[Templates_bearbeiten|angepasstes]] Produktleser-Template. Dazu einfach das entsprechende Template ''iso_reader_default.tpl'' von TL_ROOT/modules/Isotope/templates nach TL_ROOT/templates kopieren. Wenn das Template umbenannt wird, nicht vergessen im Produktleser Modul das umbenannte Template anzuwählen.
 
Folgende Zeilen am Anfang einfügen:
 
Folgende Zeilen am Anfang einfügen:
  
Zeile 68: Zeile 63:
 
</source>
 
</source>
  
In der Session-Variabel $_SESSION['ISOTOPE']['FE_NOTIFY']['html'] steckt das ganze gerenderte HTML der anzuzeigenden Nachricht. Allerdings noch nicht sichtbar. Mit Javascript lesen wir das HTMl aus und zeigen es in einer Isotope Box an.  
+
In der Session-Variabel $_SESSION['ISOTOPE']['FE_NOTIFY']['html'] steckt das ganze gerenderte HTML der anzuzeigenden Nachricht, ist allerdings noch nicht sichtbar. Mit Javascript liest man das HTML aus und zeigen es in einer Isotope Box an.  
 
Dazu anschliessend an den PHP-Code folgendes einfügen:
 
Dazu anschliessend an den PHP-Code folgendes einfügen:
<source lang="php">
+
<source lang="javascript">
 
<script type='text/javascript'>
 
<script type='text/javascript'>
 
var notifyCtnr = jQuery("#isotope_notify"); // in mootools use: $('isotope_notify');
 
var notifyCtnr = jQuery("#isotope_notify"); // in mootools use: $('isotope_notify');
Zeile 85: Zeile 80:
 
====CSS====
 
====CSS====
 
Mit optional markierte Zeilen bzw. Blöcke können weggelassen werden, ohne die Funktion einzuschränken.
 
Mit optional markierte Zeilen bzw. Blöcke können weggelassen werden, ohne die Funktion einzuschränken.
Den Folgenden CSS Code direkt im Template einbinden, oder besser im CSS des Themes.
+
Den folgenden CSS-Code direkt im Template einbinden, oder besser im CSS des Themes.
 
<source lang="css">
 
<source lang="css">
 
#iso_ajaxBox{
 
#iso_ajaxBox{

Aktuelle Version vom 27. August 2011, 19:41 Uhr

MsgError.png Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.

In der aktuellen Isotope Version (0.2.10 stable) wird dem Benutzer nach erfolgreichem Hinzufügen eines Produktes in den Warenkorb keine Meldung angezeigt. Mit den Boardmitteln von Contao und ein wenig Kreativität kann man das in wenigen Minuten ändern. Es gibt mehrere Wege dieses Verhalten zu implementieren. Die einzelnen Varianten werden hier vorgestellt.


Hinweis.png Hinweis: Ab Version 1.3 wird ein solcher Mechanismus verfügbar sein.


Variante1: Isotope Box und Hooks

Zum Anzeigen einer HTML-Messagebox nach dem erfolgreichen Hinzufügen eines Artikels in den Warenkorb wird PHP, Javascript und CSS verwendet. Schlussendlich würde es diese Technik auch erlauben Isotope Fehlermeldungen (Out of Stock, komplexere Validierungsresultate) anzuzeigen.

HTML-Messagebox

Zuerst erstellt man ein neues Modul namensIsotopeExt. Im Ordner TL_ROOT/system/modules erstellt man folgende Verzeichnisse und Dateien:

  • IsotopeExt/config/config.php
  • IsotopeExt/IsotopeCartExt.php

Backend Konfiguration

Dieses Tutorial geht davon aus, dass im Isotope Produktleser Modul unter 'Add product jump to page' keine Seite angewählt ist. Die beschriebene Technik könnte aber auch dann verwendet werden.

PHP Konfiguration

In der Datei IsotopeExt/config/config.php folgenden PHP-Code hinzufügen:

$GLOBALS['TL_HOOKS']['iso_addProductToCollection'][] 		= array('IsotopeCartExt', 'addSuccess');
$GLOBALS['TL_HOOKS']['iso_addProductToCollection'][] 		= array('IsotopeCartExt', 'createFENotification');

(Am einfachsten eine config.php eines anderen Moduls kopieren und dessen Inhalt ersetzen.)

Damit registriert man zwei neue Hooks, die jedes mal aufgerufen werden, wenn ein Produkt dem Warenkorb hinzugefügt wird. Im Folgenden nun die Implementation der zwei registrierten Funktionen.

In der Datei IsotopeExt/IsotopeCartExt.php folgenden Code einfügen:

class IsotopeCartExt extends Model {
	public function addSuccess(IsotopeProduct $objProduct, $intQuantity){
		$_SESSION['ISOTOPE']['FE_NOTIFY']['messages']['add_success'] = array(
			'class'   => 'add_success',
			'message' => 'Produkt wurde dem Warenkorb hinzugefügt.'
		);
                return $intQuantity;
	}
 
	public function createFENotification(IsotopeProduct $objProduct, $intQuantity){
		$objTempl = new FrontendTemplate('iso_notification');
		$objTempl->messages = $_SESSION['ISOTOPE']['FE_NOTIFY']['messages'];
		$_SESSION['ISOTOPE']['FE_NOTIFY']['html'] = $objTempl->parse();
 
		return $intQuantity;
	}
}

Templates & Isotope Box

Nun ist es möglich, die erstellten Session Objekte im Frontend zu verwenden. Man verwendet dazu ein angepasstes Produktleser-Template. Dazu einfach das entsprechende Template iso_reader_default.tpl von TL_ROOT/modules/Isotope/templates nach TL_ROOT/templates kopieren. Wenn das Template umbenannt wird, nicht vergessen im Produktleser Modul das umbenannte Template anzuwählen. Folgende Zeilen am Anfang einfügen:

<?php
echo $_SESSION['ISOTOPE']['FE_NOTIFY']['html'];
unset($_SESSION['ISOTOPE']['FE_NOTIFY']);
?>

In der Session-Variabel $_SESSION['ISOTOPE']['FE_NOTIFY']['html'] steckt das ganze gerenderte HTML der anzuzeigenden Nachricht, ist allerdings noch nicht sichtbar. Mit Javascript liest man das HTML aus und zeigen es in einer Isotope Box an. Dazu anschliessend an den PHP-Code folgendes einfügen:

<script type='text/javascript'>
var notifyCtnr = jQuery("#isotope_notify"); // in mootools use: $('isotope_notify');
if(notifyCtnr.length > 0){
    Isotope.displayBox(notifyCtnr.html());
}
// optional jQuey Code, enhance isotope box overlay close operation
jQuery("#iso_ajaxOverlay").click(function(){
    Isotope.hideBox();
});
</script>

CSS

Mit optional markierte Zeilen bzw. Blöcke können weggelassen werden, ohne die Funktion einzuschränken. Den folgenden CSS-Code direkt im Template einbinden, oder besser im CSS des Themes.

#iso_ajaxBox{
	z-index: 1000;
	line-height: 1.4em; /*optional*/
	width: 250px; /*optional*/
	padding: 20px !important; /*optional*/
	border: 2px solid #93BA13 !important; /*optional*/
	border-radius: 4px; /*optional*/
}
#iso_ajaxBox .add_success{
/* Pfade zu Bilddateien anpassen */
	background: url("../../system/themes/default/images/help.gif") no-repeat scroll right center #FFFFFF;
	padding-right: 50px;
}
#iso_ajaxBox .add_fail{ /*optional*/
/* Pfade zu Bilddateien anpassen */
	background: url("../../system/themes/default/images/important.gif") no-repeat scroll right center #FFFFFF;
	padding-right: 50px;
}
#iso_ajaxBox a.close{ /*optional*/
	color: black;
	text-decoration: underline;
	float: right;
	margin-top: 20px;
}
#iso_ajaxOverlay{
	top: 0 !important;
	z-index: 999;
}
Ansichten
Meine Werkzeuge

Contao Community Documentation

Chuck Norris programmiert kein PHP, er diktiert das Ergebnis. Den Rest macht der Editor aus Angst.

Stefan Lindecke
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge