Template

Das Template bestimmt das Layout des Webauftritts. Wie Templates vom Prinzip her funktionieren und wie Sie das Template an Ihre Bedürfnisse anpassen, finden Sie unter Einführung in den Shop und Webauftritt.

Aufbau der Template-Definition

Ein Template besteht aus einer Reihe von Verweisen auf Feld-, Text- und Binär-Dateien:

SyntaxBeschreibung
Fields [URL der Feld-Datei]In den Feld-Dateien sind die Felder definiert. Die Feld-Dateien werden nacheinander eingelesen und die Feldnamen mit den zugehörigen Texten in der Datenbank gespeichert.
Text [URL der Text-Datei] [Name der Datei auf dem Webserver]Die in den Textdateien enthaltenden Felder werden ersetzt. Das Ergebnis wird unter dem angegebenen Namen auf den Webserver übertragen. Üblicherweise werden Textdateien für CSS oder JavaScript verwendet.
Binary [URL der Binär-Datei] [Name der Datei auf dem Webserver]Binärdateien werden ohne Veränderung gelesen unter dem angegebenen Namen auf den Webserver übertragen.

Allgemein

Im Template wird ein Feld mit FELD [FELDINHALT] definiert. Innerhalb des Feldinhalts kann mit $FELD$ der Feldinhalt von einem anderen Feld eingefügt werden. Einige Felder müssen im Template enthalten sein (z.B. Page), da beim Erzeugen der Seite auf diese Felder zurückgegriffen wird. Andere Felder repräsentieren Felder aus der Datenbank (z.B. ProductPrice). Diese werden beim Erzeugen der Seite mit den entsprechenden Werten aus Collmex ersetzt.

Sonderzeichen: Innerhalb von [FELDINHALT] sind alle Zeichen erlaubt. Das $-Zeichen muss als $$, und das ]-Zeichen als ]] notiert werden.

Zur Definition von eigenen Templates sind hier alle von Collmex unterstützten Felder aufgelistet.


Feld Beschreibung
Page Muss im Template definiert sein. Das Feld bestimmt den grundsätzlichen Aufbau einer Seite. Bei der Erzeugung der Seiten wird mit diesem Feld begonnen.
Content Wird ersetzt durch: Bei Freitext-Seiten durch den Inhalt der Seite, bei Produkten durch $Product$ und bei Kategorien durch $Category$
PageTitle Ersetzung bei Freitext-Seiten durch 'Titel'. Bei Shop-Produkt und Kategorie ist die Ermittlung wie folgt:
  1. 'Titel', wenn leer dann
  2. 'Kurztext', wenn leer dann
  3. Auf 80 Zeichen gekürzter 'Langtext', wenn leer dann
  4. Nur bei Produkt: Auf 80 Zeichen gekürzte Produktbeschreibung.
PageDescription Ersetzung durch $ProductShortDescription$, $CategoryShortDescripton$ oder bei Seiten die Beschreibung der Seite. Ist ein Produkt mehr als einer Kategorie zugeordnet, wird hinter $ProductShortDescription$ noch die $CategoryShortDescripton$ der jeweiligen Kategorie angefügt, um Seiten mit identischer Beschreibung zu vermeiden, da dies bei Suchmaschinen zu einer Abwertung führen kann.
PageKeywords Inhalt von 'Schlüsselwörter' des Produkts, Kategorie oder Seite
Currency Bei USD, EUR und BPD das Währungssymbol der Währung, sonst ISO-Code der Währung
CurrencyISO ISO-Code der Währung
AGBURL Url auf die Seite der Art 'AGB'
AGBHTML Der Inhalt der Seite AGB
AGBText Der Inhalt der Seite AGB ohne HTML-Tags
WiderrufURL Url auf die Seite der Art 'Widerruf'
WiderrufHTML Der Inhalt der Seite Widerruf
WiderrufText Der Inhalt der Seite Widerruf ohne HTML-Tags
ShippingConditionsURL Url auf die Seite der Art 'Versandkosten'
CollmexClientNumber Kunden- bzw. Mandantennummer bei Collmex
SalesAgent Vorname und Name des Vermittlers aus dem Webauftritt
Contact Vorname und Name des Bearbeiters aus dem Webauftritt
Message Meldung bei dynamisch erzeugten Seiten innerhalb des Frames. Wird ersetzt je nach Art der Meldung durch $InfoMessage$, $WarningMessage$, $ErrorMessage$ oder $SuccessMessage$.
MessageText Text der Meldung bei dynamisch erzeugten Seiten innerhalb des Frames

Produkt

Die Produkt-Felder sind verfügbar innerhalb von $Product$, $CategoryProductListItem$, $CartItem$, $CartOrderItem$, $OrderConfirmationMailItem$ und $AdditionalPictureListItem$

Feld Beschreibung
Product Muss im Template definiert sein. Legt den Inhalt einer Produkt-Seite fest.
ProductNumber Wird ersetzt durch 'Produktnummer'. Verfügbar innerhalb $Product$, $CategoryProductListItem$, und im Warenkorb.
ProductDescription Ermittlung wie folgt:
  1. 'Langtext' aus Shop-Produkt, wenn leer dann
  2. Produktbeschreibung aus Produkt
ProductShortDescription Ermittlung wie folgt:
  1. 'Kurztext' aus Shop-Produkt, wenn leer dann
  2. 'Titel' aus Shop-Produkt, wenn leer dann
  3. Auf 80 Zeichen gekürzter 'Langtext' aus Shop-Produkt, wenn leer dann
  4. Auf 80 Zeichen gekürzte Produktbeschreibung aus Produkt.
ProductURL URL des Shop-Produkts.
ProductEAN EAN des Produkts.
ProductManufacturer Hersteller des Produkts.
ProductPictureURL URL des großen Produktbildes
ProductPictureHeight,
ProductPictureWidth
Höhe und Breite des Produkt-Bildes, wobei der Wert der Customfields-Felder $ProductImgMaxWidth$ und $ProductImgMaxHeight$ als Maximalwert berücksichtigt wird.
ProductThumbnailHeight,
ProductThumbnailWidth
Höhe und Breite des kleinen Produkt-Bildes, wobei der Wert der Customfields-Felder $ThumbnailImgMaxWidth$ und $ThumbnailImgMaxHeight$ als Maximalwert berücksichtigt wird.
ProductPrice Produktpreis ohne Währungssymbol. Wenn die Mengeneinheit nicht Stück ist, oder wenn die Bezugsmenge nicht 1 ist, wird die Mengeneinheit und die Bezugsmenge mit ausgegeben.
ProductPriceExclTax Nettopreis ohne Währungssymbol. Bei Bruttopreisen wird der Nettopreis durch Abzug der Steuer berechnet. Über das Feld kann bei Bruttopreisen der Nettopreis als Zusatzinformation mit ausgegeben werden. Wenn die Mengeneinheit nicht Stück ist, oder wenn die Bezugsmenge nicht 1 ist, wird die Mengeneinheit und die Bezugsmenge mit ausgegeben.
ProductPriceInclTax Bruttopreis ohne Währungssymbol. Bei Nettopreisen wird der Bruttopreis durch Aufschlag der Steuer berechnet. Über das Feld kann bei Nettopreisen der Bruttopreis als Zusatzinformation mit ausgegeben werden. Wenn die Mengeneinheit nicht Stück ist, oder wenn die Bezugsmenge nicht 1 ist, wird die Mengeneinheit und die Bezugsmenge mit ausgegeben.
ProductPriceRaw Produktpreis ohne Währungssymbol, ohne Tausender-Trennzeichen und mit Punkt als Nachkomma-Trennzeichen.
ProductBasePriceBlock Wird nur ersetzt, wenn ein Grundpreis im Shop-Produkt hinterlegt ist
ProductBasePrice Grundpreis pro Grundpreis-Mengeneinheit
ProductBasePriceUOM Grundpreis-Mengeneinheit
ProductPriceDetails Wird bei Bruttopreisen ersetzt durch $ProductPriceDetailsInclTax$ und bei Nettopreisen durch $ProductPriceDetailsExclTax$
ProductWeight Gewicht des Produkts mit Mengeneinheit
ProductShortText Die Bezeichnung aus dem Produkt im HTML-Format
ProductShortTextAsText Die Bezeichnung aus dem Produkt im Text-Format

Zusatzbilder

Feld Beschreibung
AdditionalPictureList Wird nur ausgewertet, wenn für ein Produkt auch Zusatzbilder angegeben sind
AdditionalPictureListItem Für jedes Zusatzbild ausgewertet
AdditionalPictureURL Die URL auf das Zusatzbild
AdditionalPictureNumber Die Bildnummer des Zusatzbildes
AdditionalPictureDescription Die Beschreibung des Zusatzbildes

Kategorie

Feld Beschreibung
Category Muss im Template definiert sein. Legt den Inhalt einer Kategorie-Seite fest.
CategoryDescription Ermittlung wie folgt:
  1. 'Langtext' aus Shop-Kategorie, wenn leer dann
  2. Produktbeschreibung aus Produkt
CategoryShortDescription Ermittlung wie folgt:
  1. 'Kurztext' aus Shop-Kategorie, wenn leer dann
  2. 'Titel' aus Shop-Kategorie, wenn leer dann
  3. Auf 80 Zeichen gekürzter 'Langtext' aus Shop-Kategorie
CategoryName Name der Kategorie
CategoryURL URL der Shop-Kategorie
CategoryPictureURL URL des großen Kategoriebildes
CategoryProductList Muss im Template definiert sein. Liste der in der Kategorie der ersten Ebene enthaltenen Produkte. Wird nur ersetzt, wenn in der Kategorie auch Produkte enthalten sind.
CategoryProductListItem Muss im Template definiert sein. Listen-Element der in der Kategorie enthaltenen Produkte.
SubCategoryList Muss im Template definiert sein. Liste der in der Kategorie ab der zweiten Ebene enthaltenen Produkte. Wird nur ersetzt, wenn in der Kategorie auch Produkte enthalten sind.
SubCategoryListItem Muss im Template definiert sein. Listen-Element der Unterkategorien
CategoryPictureHeight,
CategoryPictureWidth
Höhe und Breite des Produkt-Bildes, wobei der Wert der Customfields-Felder $CategoryImgMaxWidth$ und $CategoryImgMaxHeight$ als Maximalwert berücksichtigt wird.
CategoryThumbnailHeight,
CategoryThumbnailWidth
Höhe und Breite des kleinen Produkt-Bildes, wobei der Wert der Customfields-Felder $ThumbnailImgMaxWidth$ und $ThumbnailImgMaxHeight$ als Maximalwert berücksichtigt wird.

Menü

Feld Beschreibung
Menüname Muss im Template definiert sein. Für jedes im Webauftritt angelegtes Menü muss es im Template ein entsprechendes Feld geben.
MenuItem Menüname.Item oder Menüname.ItemSelected oder Menüname.SubLevelItem oder Menüname.SubLevelItemSelected
Menüname.Item Muss im Template definiert sein. Inaktiver Menüpunkt der ersten Ebene
Menüname.ItemSelected Muss im Template definiert sein. Aktiver Menüpunkt der ersten Ebene
Menüname.ItemSelectedWithSubmenu Muss im Template definiert sein. Aktiver Menüpunkt der ersten Ebene mit Untermenüpunkten
Menüname.SubLevelItem Muss im Template definiert sein. Inaktiver Menüpunkt der zweiten oder folgenden Ebenen
Menüname.SubLevelItemSelected Muss im Template definiert sein. Aktiver Menüpunkt der zweiten oder folgenden Ebenen
Menüname.SubLevelItemSelectedWithSubmenu Muss im Template definiert sein. Aktiver Menüpunkt der zweiten oder folgenden Ebenen mit Untermenüpunkten
MenuItemText Text des Menüpunkts
MenuItemOptions Wird mit ' target="_blank"' ersetzt, wenn im Menüpunkt die Option 'Neues Fenster' gewählt ist.
MenuItemURL URL des Menüpunkts

Warenkorb

Feld Beschreibung
Cart Muss im Template definiert sein. Die Seite für den ersten Schritt im Warenkorb. Wenn der Warenkorb leer ist, wird das Feld ersetzt durch $CartEmpty$
CartItem Muss im Template definiert sein. Die Positionen im Warenkorb. Wird für jede Position ersetzt.
CartSurcharge Muss im Template definiert sein. Zu- und Abschläge des Warenkorbs. Wird für jeden Zu- und Abschlag ersetzt.
CartEmpty Muss im Template definiert sein. Wird ausgeführt, wenn der Warenkorb leer ist.
CartBillToAddress Muss im Template definiert sein. Die Seite für die Rechnungsadresse.
CartShipToAddress Muss im Template definiert sein. Die Seite für die abweichende Lieferadresse.
CartOrder Muss im Template definiert sein. Die Seite für die Kaufabschluss-Seite.
CartOrderItem Muss im Template definiert sein. Die Positionen des Warenkorbs auf der Kaufabschluss-Seite. Wird für jede Position ersetzt.
CartOrderSurcharge Muss im Template definiert sein. Zu- und Abschläge des Warenkorbs auf der Kaufabschluss-Seite.
OrderConfirmation Muss im Template definiert sein. Bestätigungs-Seite für den Auftrag nach dem Kauf. Wird für jeden Zu- und Abschlag ersetzt.
OrderConfirmationItem Muss im Template definiert sein. Die Positionen des Auftrags nach Kaufabschluss. Wird für jede Position ersetzt.
OrderConfirmationSurcharge Muss im Template definiert sein. Zu- und Abschläge des Auftrags nach Kaufabschluss. Wird für jeden Zu- und Abschlag ersetzt.
SurchargeText Text für einen Zu- oder Abschlag
SurchargeAmount Wert des Zu- oder Abschlags.
Quantity Die Menge einer Position im Warenkorb oder Auftrag.
QuantityUOM Die Mengeneinheit einer Position im Warenkorb oder Auftrag
Item Die Positions-Nummer der Warenkorbsposition oder Auftragsposition
ItemValue Wert (=Gesamtpreis) einer Position.
ItemDiscount Rabatt in Prozent einer Position.
Total Gesamtpreis für den Auftrag mit Tausender-Trennzeichen und Komma oder Punkt als Nachkomma-Trennzeichen in Abhängigkeit von der Sprache.
TotalRaw Gesamtpreis für den Auftrag ohne Tausender-Trennzeichen und mit Punkt als Nachkomma-Trennzeichen.
NetTotal Gesamt-Netto-Preis für den Auftrag mit Tausender-Trennzeichen und Komma oder Punkt als Nachkomma-Trennzeichen in Abhängigkeit von der Sprache.
NetTotalRaw Gesamt-Netto-Preis für den Auftrag ohne Tausender-Trennzeichen und mit Punkt als Nachkomma-Trennzeichen.
TotalWeight Gesamt-Gewicht des Warenkorbs.
PaymentOptions Die möglichen Zahlarten. Wird für jede Zahlart ersetzt durch eine 'Options' Definition.
CartBillToPaymentData Wird bei Bankeinzug ersetzt durch $CartBillToPaymentBankWithdrawal$, damit in der Rechnungsadresse bei Bankeinzug die Eingabefelder für die Bankverbindung ausgegeben werden können.
ShippingOptions Die möglichen Versandarten. Wird für jede Versandart ersetzt durch eine 'Options' Definition.
Voucher Die Nummer des Gutscheins
Memo Nachricht, die der Käufer in das mehrzeilige Textfeld eingeben kann
MemoInfoText Wird nur ersetzt, wenn $Memo$ nicht leer ist.
DifferingShippingAddressChecked Wird ersetzt durch 'checked', wenn der Käufer in der Rechnungsadresse eine abweichende Lieferadresse gewählt hat,
ShippingType Wird ersetzt durch die vom Käufer gewählte Versandart
PaymentType Wird ersetzt durch die vom Käufer gewählte Zahlart. Bei Bankeinzug wird auch die Kontoverbindung mit ausgegeben.
TrustedShopsPaymentType Codierte Zahlart nach trustedshops.de: 1 = Lastschrift/Bankeinzug, 4 = Rechnung, 5 = Nachnahme, 6 = Weitere Zahlungsart, 7 = Vorauskasse / Überweisung, = 10 PayPal, 22 = Sofortüberweisung
PaymentTypeText Wird ersetzt durch die vom Käufer gewählte Zahlart in Textform (kein HTML). Bei Bankeinzug wird auch die Kontoverbindung mit ausgegeben.
PaymentInfo Wird ersetzt durch $AdvancedPaymentInfo$ bei Vorkasse, $PaypalPaymentInfo$ bei Paypal, $BankWithdrawalPaymentInfo$ bei Bankeinzug oder $SofortueberweisungPaymentInfo$ bei Sofortüberweisung.
AdvancedPaymentInfo,
PaypalPaymentInfo,
BankWithdrawalPaymentInfo
SofortueberweisungPaymentInfo
Müssen im Template definiert sein. Dienen dazu dem Käufer in Abhängigkeit der Zahlart nach dem Kauf zusätzliche Informationen und Anweisungen zur Zahlung zu geben.
PaymentInfoText Wird ersetzt durch $AdvancedPaymentInfoText$ bei Vorkasse, $PaypalPaymentInfoText$ bei Paypal, $BankWithdrawalPaymentInfoText$ bei Bankeinzug, $SofortueberweisungPaymentInfoText$ bei Sofortüberweisung.
AdvancedPaymentInfoText,
PaypalPaymentInfoText,
BankWithdrawalPaymentInfoText
SofortueberweisungPaymentInfoText
Müssen im Template definiert sein. Dienen dazu dem Käufer in Abhängigkeit der Zahlart in der Kaufbestätigungs-Mail zusätzliche Informationen und Anweisungen zur Zahlung zu geben.
PaypalPaymentURL Der Link auf Paypal mit allen für die Zahlung wichtigen Informationen. Wenn der Käufer auf den Link klickt, kann er die Zahlung direkt auslösen.
SofortueberweisungPaymentURL Der Link auf Sofortueberweisung.de mit allen für die Zahlung wichtigen Informationen. Wenn der Käufer auf den Link klickt, kann er die Zahlung direkt auslösen.
BillToAddress Die komplette Rechnungsadresse bestehend aus mehreren Zeilen.
BillToAddressText Die komplette Rechnungsadresse bestehend aus mehreren Zeilen in Textform für Verwendung in E-Mails.
ShipToAddress Die komplette Lieferadresse bestehend aus mehreren Zeilen.
ShipToAddressText Die komplette Lieferadresse bestehend aus mehreren Zeilen in Textform für Verwendung in E-Mails.
CompanyAddress Die komplette eigene Firmenadresse bestehend aus mehreren Zeilen.
CompanyAddressText Die komplette eigene Firmenadresse bestehend aus mehreren Zeilen in Textform für Verwendung in E-Mails.
CompanyBankAccountNo, CompanyBankId, CompanyBankName, CompanyBankAccountOwner, CompanyBankBIC, CompanyBankAccountIBAN Bankverbindung der Firma: Kontonummer, BLZ, Name der Bank, Kontoinhaber, BIC und IBAN
OrderNumber Die Nummer des Kundenauftrags der für den abgeschlossenen Kauf angelegt wurde.
CustomerNumber Nummer des Kunden.
CustomerMemo Bemerkungsfeld des Kunden.
CustomerMail Mailadresse des Kunden.
ConversionTrackingItem Die Positionen im Warenkorb für das Conversion-Tracking. Wird für jede Position ersetzt.

Suche

Feld Beschreibung
SearchResultProductList Liste der gefundenen Produkte. Wird nur ersetzt, wenn Produkte gefunden wurden.
SearchResultProductItem Ein gefundenes Produkt innerhalb der Liste
SearchTerm Der vom Benutzer eingegebene Suchtext