Texteingabefelder zum Produkt

Inhalt

1 Produktdaten-abhängige Text-Eingabefelder (TextInputFields)

2 Produktdaten-unabhängige Eingabefelder oder Checkboxen (ExtraInput)

3 Unsichtbares Eingabefeld für Eintrag in die Bestelldaten (SpecialInput)

 


Hinweis:

Wenn Sie Texteingabefelder oder Checkboxen pro (Split-)Position auf der Warenkorbseite (ws_basket.htm) wollen, finden Sie die Integrationsanleitung unter

Wegweiser: Freie Text-Eingabefelder im Warenkorb auf Positionsebene (AdditionalUserInput)
Wegweiser: Freie Felder (Input/Checkbox) auf Split-Positionsebene (BasketProductOptions)

 

1 Produktdaten-abhängige Text-Eingabefelder (TextInputFields)

Sie können zu jedem Produkt bis zu zehn Texteingabefelder auf der Produktdetailansicht (ws_product.htm) anlegen. Texteingabefelder können zum Beispiel dafür verwendet werden, um für ein Produkt eine persönliche Gravur oder Bestickung anzubieten. Der Kunde gibt dann in das Eingabefeld seinen gewünschten Text ein.

Voraussetzung: Anpassung der Produktdaten

Für jedes Eingabefeld müssen im WSPManager im Produktdatenfeld "Texteingabefelder" folgende Einstellungen definiert werden:

Anzahl der Zeilen

Anzahl der sichtbaren Zeichen

Anzahl maximal eingebbarer Zeichen

Deklaration als Pflichtfeld oder optionales Feld

Wenn keine Definitionen erfolgen, werden die Vorgabewerte des WSPManagers verwendet. Pflichtfelder sind durch ein Sternsymbol hinter dem Feldnamen gekennzeichnet.

Schritt 1: Fehlermeldung einfügen

Wenn ein Pflichtfeld keinen Eintrag hat, wird eine Fehlermeldung eingeblendet. Fügen Sie einen passenden Meldungstext in der Shopkonfiguration shop.config im Abschnitt <NotifiyMessages> mit dem Parameter TextInputFieldError ein.

<NotifyMessages-Txt>
   ...
   TextInputFieldError     = Die Angaben zum erforderlichen Feld "~PR-TextInputName~" fehlen. Bitte ergänzen Sie Ihre Eingaben.
   ...
</NotifyMessages-Txt>

Referenz: Abschnitt NotifyMessages-Txt

Schritt 2: Integration auf der Produktdetailansicht (ws_product.htm)

Zur Anzeige eines oder mehrerer Texteingabefelder auf der Produktseite wird der Bereich PR-TextInputFields verwendet, der für jedes vorgesehene Texteingabefeld einen Bereich PR-TextInputName1…10 enthält. Darin werden mit den Parametern PR-TextInputField1…10 und PR-TextInputName1…10 das Eingabefeld und sein Name angezeigt.

{PR-TextInputFields}
   {PR-TextInputName1}
      ~PR-TextInputName1~: ~PR-TextInputField1~
      ...
   {/PR-TextInputName1}
{/PR-TextInputFields}

Das Bereichs-Tag PR-InputFields prüft, ob Texteingabefelder beim entsprechenden Produkt vorliegen und zeigt diese ggf. tabellarisch an.

Das negative Bereichs-Tag PR-InputFields zeigt einen Ersatztext an, falls kein Texteingabefeld vorhanden ist.

{!PR-TextInputFields}
   <!-- Anzeige eines beliebigen Textes, falls kein Texteingabefeld vorhanden ist -->
{/!PR-TextInputFields}

Referenz: PR-TextInputFields

Referenz: PR-TextInputName1…10

Referenz: PR-TextInputField1…10

Schritt 3: Anzeige der eingegebenen Werte im Warenkorb

Um die Inhalte der Texteingabefelder im frei positionierbaren Warenkorb auszugeben, muss der Bereich BASKET-PR-TextInputFields mit der Schleife BASKET-PR-TextInputFields eingefügt werden. Mit den Einzel-Tags BASKET-PR-TextInputName und BASKET-PR-TextInputValue werden Name und eingegebener Text angezeigt.

{BASKET-PR-TextInputFields}
 
   {@BASKET-PR-TextInputFields}
      ~BASKET-PR-TextInputName~: ~BASKET-PR-TextInputValue~
   {/@BASKET-PR-TextInputFields}
 
{/BASKET-PR-TextInputFields}

Referenz: BASKET-PR-TextInputFields

Referenz: BASKET-PR-TextInputName

Referenz: BASKET-PR-TextInputValue

 


2 Produktdaten-unabhängige Eingabefelder oder Checkboxen (ExtraInput)

Neben den TextInputFields, die zwingend in den Produktdaten angelegt werden müssen, stehen pauschal bis zu 20 weitere Felder für Produktzusatzeingaben zur Verfügung. Die eingegebenen Inhalte werden pro Warenkorbposition in die Bestelldaten geschrieben.

Schritt 1: Integration auf der Produktdetailansicht (ws_product.htm)

Fügen Sie die gewünschten Inputs innerhalb der FORM-Product ein und vergeben die technischen Namen für jedes Feld durchnummeriert mit PR-ExtraInput_input_1_20.

{PR-Data}
   <form action="~FORM-Product~" ... >
      ...
      <input type="text" name="~PR-ExtraInput_input_1~" value=""><br>
      <input type="checkbox" name="~PR-ExtraInput_input_2~"><br>
      <input type="hidden" name="~PR-ExtraInput_input_3~" value="AKTION XYZ">
      ...
   </form>
{/PR-Data}

Referenz: PR-ExtraInput_input_1_20

Schritt 2: Ausgabe der eingegebenen Werte auf der Warenkorbseite (ws_basket.htm)

Für die Anzeige der eingegebenen Inhalte fügen Sie folgenden Code innerhalb der BASKET-PR-Data-Schleife ein.

{BASKET-PR-ExtraInput_1} 
   ~BASKET-PR-ExtraInput_1~<br>
{/BASKET-PR-ExtraInput_1}
{BASKET-PR-ExtraInput_2}
   ~BASKET-PR-ExtraInput_2~<br>
{/BASKET-PR-ExtraInput_2}
...

Referenz: BASKET-PR-ExtraInput_1_20

Schritt 3: Optionale Ausgabe der eingegebenen Werte auf der Produktdetailansicht (ws_product.htm) nur im "Ändern-Modus"

Es besteht die Möglichkeit die eingegebenen Inhalte auf der Produktseite anzuzeigen, jedoch nur wenn man sich im Ändern-Modus befindet. Verwenden Sie in diesem Fall das Tag PR-ExtraInput1_20.

{PR-ExtraInput_1}
   ~PR-ExtraInput_1~
{/PR-ExtraInput_1}
...

Referenz: PR-ExtraInput_1_20

 

3 Unsichtbares Eingabefeld für Eintrag in die Bestelldaten (SpecialInput)

Dieses "versteckte" Eingabefeld wird dazu verwendet, um einen beliebigen, vorgegebenen Wert in die Bestelldaten zu schreiben.

{PR-Data}
   <form action="~FORM-Product~" ... >
   ...
   <input type="hidden" name="~PR-SpecialInput_input~" value="AKTION XYZ">
   ...
   </form>
{/PR-Data}

Referenz: PR-SpecialInput_input