Zielgruppe Site AdminVersion: GSB10.1Basis-Integration
Die grundsätzliche Funktionalität des Warenkorbs liegt in dem Zusammenstellen einer Liste von bestellten Waren (die als Dokumentliste verwaltet wird), das Verändern von Mengenangaben, das Erfassen der Bestellerdaten und das Versenden der Bestelldaten per E-Mail oder alternativ das Ablegen der Bestelldaten in einer Datenbank.
Die zur Integration eines Warenkorbs notwendigen Schritte müssen nicht zwingend in einer bestimmten Reihenfolge durchgeführt werden.
Die folgenden Informationen beschreiben die notwendigen Tätigkeiten für einen bestehenden Mandanten. Dabei wird davon ausgegangen, dass die Ordnerstruktur dem Aufbau der Standardlösung entspricht.
Hinweis
Die vorliegende Integrationsbeschreibung legt daher kein Abarbeitungsschema fest, sondern beschreibt lediglich die Aufgaben, die zur Integration erledigt werden müssen.
Die komplette Integration wurde in der Standardlösung umgesetzt und kann dort direkt im Content und in den Templates nachvollzogen werden.
Darstellungstemplates
Voraussetzung für die Integration sind einige Darstellungstemplates, die an den dafür vorgesehenen Stellen erwartet werden. Es werden folgende Darstellungstemplates benötigt:
FEShoppingCart/render[BestellungErfolg].jsp
FEShoppingCart/render[Link].jsp
FEShoppingCart/render[Standard].jsp
AbsDocument/addToCart.jsp
HFForm/renderAddToCart.jsp
HFTextInputField/render[Warenkorb].jsp
Diese Darstellungstemplates sind bereits in der ausgelieferten Standardlösung enthalten. Bei der Übernahme der Warenkorb-Funktionalität in einen GSB Mandanten muss das Layout des Warenkorbs noch an die konkreten Anforderungen des Mandanten angepasst werden.
Einbindung des Warenkorbs
Der Warenkorb wird als Link „In den Warenkorb“ in die Web-Seiten eingebunden, die einen Warenkorb-Link erhalten sollen. Dazu werden in die jeweilige Darstellungstemplates des Dokumenttyps (z. B. Publication/render[Standard]
) die Deklaration der cart-Bean
<jsp:useBean id="cart" class="de.bundonline.basis.web.beans.FEShoppingCartBean" scope="session"/>
und an der Aufrufstelle die Anweisung
cart.renderAddToCart(pageContext);
eingefügt.
Konfiguration-Linkliste UpdateCartForm
Der Link „In den Warenkorb“ verlinkt auf das Warenkorb-Formular. Das Linkziel, d.h. das angesteuerte Warenkorb-Formular wird mithilfe einer Konfiguration-Linkliste (ConfigLinkList) festgelegt, die entweder unter
/mandant/SiteGlobals/_config/UpdateCartForm
oder pfadabhängig in den regulären „_config“-Ordner angelegt werden kann. Die Konfiguration-Linkliste enthält folgende Parameter:
- Wert (value):
/mandant/SiteGlobals/Forms/Warenkorb/WarenkorbForm